feat(apple): exercise saved-device core contract harness

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-08-11 05:39:10 +02:00
parent 8e8cab9b24
commit 9c7697c90b
3 changed files with 1007 additions and 0 deletions

View File

@@ -22,6 +22,9 @@ mod limits_tests;
mod network_config_tests;
#[path = "tests/pairing_eligibility.rs"]
mod pairing_eligibility_tests;
#[cfg(any(target_os = "macos", target_os = "ios"))]
#[path = "tests/platform_contract_apple.rs"]
mod platform_contract_apple_tests;
#[path = "tests/repository.rs"]
mod repository_tests;
#[path = "tests/runtime.rs"]

View File

@@ -0,0 +1,837 @@
//! Apple core/platform contract harness for saved devices (ticket 14).
//!
//! Proves the protected Keychain bridge can drive identity restart, the public
//! saved-device lifecycle, fault isolation, event recovery, and binding hygiene
//! without product UI.
use std::{
collections::{HashMap, HashSet},
path::Path,
sync::{Arc, Mutex},
time::{Duration, Instant},
};
use crate::{
secure_secret::{
apple::{handle_for_test, AppleKeychainApi, AppleKeychainPolicy, AppleKeychainSecretStore},
FaultInjectingSecretStore, ReferenceStoreFailure, SecureSecretStore,
SecureSecretStoreError,
},
CoreEvent, CoreEventSink, CoreLimits, CoreNetworkConfig, DeviceRelationshipState,
ShareMetadataInput, ShareSource, SourceKind, TargetedTransferState, TransferAccessMode,
VnidropCore, VnidropError,
};
const ERR_SEC_INTERACTION_NOT_ALLOWED: i32 = -25_308;
const ERR_SEC_ITEM_NOT_FOUND: i32 = -25_300;
struct RecordingSink {
events: Mutex<Vec<CoreEvent>>,
}
impl CoreEventSink for RecordingSink {
fn on_event(&self, event: CoreEvent) {
self.events.lock().unwrap().push(event);
}
}
impl RecordingSink {
fn snapshot(&self) -> Vec<CoreEvent> {
self.events.lock().unwrap().clone()
}
fn clear(&self) {
self.events.lock().unwrap().clear();
}
}
/// Node backed by the Apple Keychain adapter (injectable API for headless cargo).
///
/// Production `initialize_with_experimental_saved_devices` uses the same
/// `AppleKeychainSecretStore` + profile scoping. CLI unit tests lack the app
/// Keychain entitlement, so the system Keychain returns Unavailable; the
/// injectable API exercises the identical adapter path. Swift XCTest covers
/// the real experimental constructor under the app entitlements.
struct KeychainNode {
data_dir: tempfile::TempDir,
api: RecordingKeychain,
sink: Arc<RecordingSink>,
core: Option<Arc<VnidropCore>>,
}
#[derive(Clone, Default)]
struct RecordingKeychain {
state: Arc<Mutex<RecordingState>>,
}
#[derive(Default)]
struct RecordingState {
entries: HashMap<(String, String), Vec<u8>>,
}
impl AppleKeychainApi for RecordingKeychain {
fn put(
&self,
service: &str,
account: &str,
material: &[u8],
_policy: AppleKeychainPolicy,
) -> Result<(), i32> {
self.state.lock().unwrap().entries.insert(
(service.to_string(), account.to_string()),
material.to_vec(),
);
Ok(())
}
fn get(&self, service: &str, account: &str) -> Result<Vec<u8>, i32> {
self.state
.lock()
.unwrap()
.entries
.get(&(service.to_string(), account.to_string()))
.cloned()
.ok_or(ERR_SEC_ITEM_NOT_FOUND)
}
fn delete(&self, service: &str, account: &str) -> Result<(), i32> {
self.state
.lock()
.unwrap()
.entries
.remove(&(service.to_string(), account.to_string()))
.map(|_| ())
.ok_or(ERR_SEC_ITEM_NOT_FOUND)
}
fn list_accounts(&self, service: &str) -> Result<Vec<String>, i32> {
Ok(self
.state
.lock()
.unwrap()
.entries
.keys()
.filter(|(entry_service, _)| entry_service == service)
.map(|(_, account)| account.clone())
.collect())
}
}
impl KeychainNode {
fn new() -> Self {
let data_dir = tempfile::tempdir().unwrap();
let sink = Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
});
let api = RecordingKeychain::default();
let store = crate::secure_secret::scope_store(
data_dir.path(),
Arc::new(AppleKeychainSecretStore::with_api(api.clone())),
);
let core = VnidropCore::initialize_with_test_secret_store(
data_dir.path().to_string_lossy().into_owned(),
sink.clone(),
store,
)
.expect("Apple Keychain-adapter core");
Self {
data_dir,
api,
sink,
core: Some(core),
}
}
fn core(&self) -> Arc<VnidropCore> {
self.core.as_ref().expect("core alive").clone()
}
fn restart(mut self) -> Self {
if let Some(core) = self.core.take() {
core.shutdown();
drop(core);
}
let sink = Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
});
let store = crate::secure_secret::scope_store(
self.data_dir.path(),
Arc::new(AppleKeychainSecretStore::with_api(self.api.clone())),
);
let core = VnidropCore::initialize_with_test_secret_store(
self.data_dir.path().to_string_lossy().into_owned(),
sink.clone(),
store,
)
.expect("restarted Apple Keychain-adapter core");
self.sink = sink;
self.core = Some(core);
self
}
}
impl Drop for KeychainNode {
fn drop(&mut self) {
if let Some(core) = self.core.take() {
core.shutdown();
}
}
}
fn try_experimental_keychain_init(app_data_dir: &Path) -> Result<Arc<VnidropCore>, VnidropError> {
VnidropCore::initialize_with_experimental_saved_devices(
app_data_dir.to_string_lossy().into_owned(),
Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
}),
CoreLimits::default(),
CoreNetworkConfig::default(),
)
}
struct FaultNode {
data_dir: tempfile::TempDir,
secret_store: Arc<FaultInjectingSecretStore>,
sink: Arc<RecordingSink>,
core: Option<Arc<VnidropCore>>,
}
impl FaultNode {
fn new() -> Self {
let data_dir = tempfile::tempdir().unwrap();
let sink = Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
});
let store = Arc::new(FaultInjectingSecretStore::default());
let core = VnidropCore::initialize_with_test_secret_store(
data_dir.path().to_string_lossy().into_owned(),
sink.clone(),
store.clone(),
)
.expect("fault-injecting protected core");
Self {
data_dir,
secret_store: store,
sink,
core: Some(core),
}
}
fn core(&self) -> Arc<VnidropCore> {
self.core.as_ref().expect("core alive").clone()
}
fn restart(mut self) -> Self {
if let Some(core) = self.core.take() {
core.shutdown();
}
let sink = Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
});
let core = VnidropCore::initialize_with_test_secret_store(
self.data_dir.path().to_string_lossy().into_owned(),
sink.clone(),
self.secret_store.clone(),
)
.expect("restarted fault-injecting core");
self.sink = sink;
self.core = Some(core);
self
}
fn try_restart(mut self) -> Result<Self, (Self, VnidropError)> {
if let Some(core) = self.core.take() {
core.shutdown();
}
let sink = Arc::new(RecordingSink {
events: Mutex::new(Vec::new()),
});
match VnidropCore::initialize_with_test_secret_store(
self.data_dir.path().to_string_lossy().into_owned(),
sink.clone(),
self.secret_store.clone(),
) {
Ok(core) => {
self.sink = sink;
self.core = Some(core);
Ok(self)
}
Err(error) => {
self.sink = sink;
Err((self, error))
}
}
}
}
impl Drop for FaultNode {
fn drop(&mut self) {
if let Some(core) = self.core.take() {
core.shutdown();
}
}
}
#[derive(Clone, Default)]
struct ControllableKeychain {
state: Arc<Mutex<ControllableState>>,
}
#[derive(Default)]
struct ControllableState {
entries: HashMap<(String, String), Vec<u8>>,
locked_accounts: HashSet<String>,
unavailable: bool,
}
impl ControllableKeychain {
fn lock_account(&self, account: &str) {
self.state
.lock()
.unwrap()
.locked_accounts
.insert(account.to_string());
}
fn set_unavailable(&self, unavailable: bool) {
self.state.lock().unwrap().unavailable = unavailable;
}
}
impl AppleKeychainApi for ControllableKeychain {
fn put(
&self,
service: &str,
account: &str,
material: &[u8],
_policy: AppleKeychainPolicy,
) -> Result<(), i32> {
let mut state = self.state.lock().unwrap();
if state.unavailable {
return Err(-25_291);
}
if state.locked_accounts.contains(account) {
return Err(ERR_SEC_INTERACTION_NOT_ALLOWED);
}
state.entries.insert(
(service.to_string(), account.to_string()),
material.to_vec(),
);
Ok(())
}
fn get(&self, service: &str, account: &str) -> Result<Vec<u8>, i32> {
let state = self.state.lock().unwrap();
if state.unavailable {
return Err(-25_291);
}
if state.locked_accounts.contains(account) {
return Err(ERR_SEC_INTERACTION_NOT_ALLOWED);
}
state
.entries
.get(&(service.to_string(), account.to_string()))
.cloned()
.ok_or(ERR_SEC_ITEM_NOT_FOUND)
}
fn delete(&self, service: &str, account: &str) -> Result<(), i32> {
let mut state = self.state.lock().unwrap();
if state.unavailable {
return Err(-25_291);
}
if state.locked_accounts.contains(account) {
return Err(ERR_SEC_INTERACTION_NOT_ALLOWED);
}
state
.entries
.remove(&(service.to_string(), account.to_string()))
.map(|_| ())
.ok_or(ERR_SEC_ITEM_NOT_FOUND)
}
fn list_accounts(&self, service: &str) -> Result<Vec<String>, i32> {
let state = self.state.lock().unwrap();
if state.unavailable {
return Err(-25_291);
}
Ok(state
.entries
.keys()
.filter(|(entry_service, _)| entry_service == service)
.map(|(_, account)| account.clone())
.collect())
}
}
fn share_path(core: &VnidropCore, source: &Path, transfer_id: u64) -> crate::ShareResult {
core.share_files(
vec![ShareSource {
kind: SourceKind::Path,
value: source.to_string_lossy().into_owned(),
display_name: Some("hello.txt".to_string()),
is_directory: false,
}],
ShareMetadataInput {
transfer_id,
transfer_name: Some("hello.txt".to_string()),
sender_name: Some("sender".to_string()),
access_mode: TransferAccessMode::ApprovalRequired,
},
)
.unwrap()
}
fn wait_for_receiver_request(sender: &VnidropCore, transfer_id: u64) -> crate::ReceiverRequest {
let started = Instant::now();
loop {
if let Some(request) = sender
.list_receiver_requests(transfer_id)
.unwrap()
.into_iter()
.find(|request| request.status == "requested")
{
return request;
}
assert!(
started.elapsed() < Duration::from_secs(15),
"timed out waiting for receiver request"
);
std::thread::sleep(Duration::from_millis(25));
}
}
fn complete_transfer(sender: &VnidropCore, receiver: &Arc<VnidropCore>, transfer_id: u64) {
let source_dir = tempfile::tempdir().unwrap();
let output_dir = tempfile::tempdir().unwrap();
let source_path = source_dir.path().join("hello.txt");
std::fs::write(&source_path, b"mutual consent").unwrap();
let share = share_path(sender, &source_path, transfer_id);
let output_dir = output_dir.path().to_string_lossy().to_string();
let receiver_core = receiver.clone();
let ticket = share.ticket.clone();
let handle = std::thread::spawn(move || {
receiver_core.receive(ticket, output_dir, Some("receiver".to_string()))
});
let request = wait_for_receiver_request(sender, share.transfer_id);
sender
.respond_receiver_request(request.id, true, None)
.unwrap();
handle.join().unwrap().unwrap();
let started = Instant::now();
let peer = receiver.status().endpoint_id.clone();
loop {
if sender
.list_pairing_eligibilities()
.unwrap()
.iter()
.any(|entry| entry.peer_endpoint_id == peer)
{
break;
}
assert!(
started.elapsed() < Duration::from_secs(10),
"eligibility never appeared"
);
std::thread::sleep(Duration::from_millis(25));
}
}
fn wait_for_relationship(
core: &VnidropCore,
peer: &str,
state: DeviceRelationshipState,
) -> crate::DeviceRelationship {
let started = Instant::now();
loop {
if let Some(relationship) = core
.list_device_relationships()
.unwrap()
.into_iter()
.find(|entry| entry.remote_endpoint_id == peer && entry.state == state)
{
return relationship;
}
assert!(
started.elapsed() < Duration::from_secs(15),
"relationship {peer} never reached {state:?}"
);
std::thread::sleep(Duration::from_millis(25));
}
}
fn establish_saved(alice: &Arc<VnidropCore>, bob: &Arc<VnidropCore>, transfer_id: u64) {
let alice_id = alice.status().endpoint_id.clone();
let bob_id = bob.status().endpoint_id.clone();
complete_transfer(alice, bob, transfer_id);
assert!(alice.request_saved_device_pairing(bob_id.clone()).unwrap());
wait_for_relationship(bob, &alice_id, DeviceRelationshipState::PendingIncoming);
assert!(bob
.respond_to_device_pairing(alice_id.clone(), true)
.unwrap());
wait_for_relationship(alice, &bob_id, DeviceRelationshipState::Saved);
wait_for_relationship(bob, &alice_id, DeviceRelationshipState::Saved);
}
fn wait_for_pending_offer(core: &VnidropCore) -> crate::PendingTargetedOffer {
let started = Instant::now();
loop {
let pending = core.list_pending_targeted_offers();
if let Some(offer) = pending.into_iter().next() {
return offer;
}
assert!(
started.elapsed() < Duration::from_secs(20),
"timed out waiting for pending targeted offer"
);
std::thread::sleep(Duration::from_millis(25));
}
}
fn targeted_source(path: &Path) -> ShareSource {
ShareSource {
kind: SourceKind::Path,
value: path.to_string_lossy().into_owned(),
display_name: Some(
path.file_name()
.unwrap_or_default()
.to_string_lossy()
.into_owned(),
),
is_directory: false,
}
}
fn approve_one(
alice: &Arc<VnidropCore>,
bob: &Arc<VnidropCore>,
payload: &[u8],
name: &str,
) -> (crate::TargetedTransfer, String) {
let bob_id = bob.status().endpoint_id.clone();
let source_dir = tempfile::tempdir().unwrap();
let source_path = source_dir.path().join(name);
std::fs::write(&source_path, payload).unwrap();
let bob_core = bob.clone();
let accept = std::thread::spawn(move || {
let offer = wait_for_pending_offer(&bob_core);
bob_core
.respond_to_targeted_offer(offer.transfer_id, true)
.unwrap()
});
let transfer = alice
.create_targeted_transfer(
bob_id,
vec![targeted_source(&source_path)],
Some(name.to_string()),
)
.unwrap();
let auth = accept.join().unwrap().expect("authorization");
(transfer, auth)
}
fn recover_authoritative_state(
live_events: &[CoreEvent],
replayed: &[CoreEvent],
) -> (HashSet<String>, u64) {
let mut seen_ids = HashSet::new();
let mut max_revision = 0u64;
for event in live_events.iter().chain(replayed.iter()) {
if !seen_ids.insert(event.id.clone()) {
continue;
}
max_revision = max_revision.max(event.revision);
}
(seen_ids, max_revision)
}
#[test]
fn experimental_keychain_identity_survives_core_restart() {
let node = KeychainNode::new();
let endpoint_id = node.core().status().endpoint_id.clone();
assert!(!endpoint_id.is_empty());
assert!(
!node.data_dir.path().join("iroh.secret").exists(),
"protected identity must not fall back to plaintext"
);
let node = node.restart();
assert_eq!(node.core().status().endpoint_id, endpoint_id);
assert!(!node.data_dir.path().join("iroh.secret").exists());
// When the process has Keychain entitlements (app/XCTest), the production
// constructor must also preserve identity. Headless cargo often lacks that
// entitlement and maps it to Unavailable — that path is covered by Swift.
let live = tempfile::tempdir().unwrap();
match try_experimental_keychain_init(live.path()) {
Ok(core) => {
let id = core.status().endpoint_id.clone();
core.shutdown();
drop(core);
let restarted = try_experimental_keychain_init(live.path()).expect("restart");
assert_eq!(restarted.status().endpoint_id, id);
restarted.shutdown();
cleanup_scoped_keychain(live.path());
}
Err(VnidropError::SecureStorageUnavailable { .. }) => {}
Err(error) => panic!("unexpected experimental init failure: {error:?}"),
}
}
fn cleanup_scoped_keychain(app_data_dir: &Path) {
let profile = blake3::hash(app_data_dir.to_string_lossy().as_bytes()).to_hex();
let prefix = format!("vnidrop/v1/scope-{profile}/");
let store = AppleKeychainSecretStore::new();
let Ok(handles) = store.list_handles() else {
return;
};
for handle in handles {
if handle.as_str().starts_with(&prefix) {
let _ = store.delete(&handle);
}
}
}
#[test]
fn public_api_contract_eligibility_through_unblock_on_apple_path() {
// Full lifecycle uses the same public UniFFI surface Apple bindings expose.
// FaultInjecting backs custody so the harness stays deterministic; Keychain
// restart + binding hygiene cover the real Apple adapter separately.
let alice = FaultNode::new();
let bob = FaultNode::new();
let alice_id = alice.core().status().endpoint_id.clone();
let bob_id = bob.core().status().endpoint_id.clone();
establish_saved(&alice.core(), &bob.core(), 14_001);
alice
.core()
.set_saved_device_label(bob_id.clone(), Some("Bob Mac".to_string()))
.unwrap();
let saved = alice.core().list_saved_devices().unwrap();
assert_eq!(saved.len(), 1);
assert_eq!(saved[0].endpoint_id, bob_id);
assert_eq!(saved[0].local_label.as_deref(), Some("Bob Mac"));
let (transfer, _auth) = approve_one(&alice.core(), &bob.core(), b"apple contract", "a.txt");
assert_eq!(transfer.receiver_endpoint_id, bob_id);
let alice = alice.restart();
let bob = bob.restart();
let resumed_output = tempfile::tempdir().unwrap();
bob.core()
.resume_targeted_transfer(
transfer.id.clone(),
resumed_output.path().to_string_lossy().into_owned(),
)
.unwrap();
assert_eq!(
std::fs::read(resumed_output.path().join("a.txt")).unwrap(),
b"apple contract"
);
let completed = bob
.core()
.get_targeted_transfer(transfer.id)
.unwrap()
.unwrap();
assert_eq!(completed.state, TargetedTransferState::Completed);
alice.core().forget_saved_device(bob_id.clone()).unwrap();
assert!(alice.core().list_saved_devices().unwrap().is_empty());
bob.core().block_device(alice_id.clone()).unwrap();
assert!(bob
.core()
.list_blocked_devices()
.unwrap()
.contains(&alice_id));
bob.core().unblock_device(alice_id.clone()).unwrap();
assert!(!bob
.core()
.list_blocked_devices()
.unwrap()
.contains(&alice_id));
assert!(
bob.core().list_saved_devices().unwrap().is_empty(),
"unblock must not restore a blocked relationship"
);
}
#[test]
fn locked_identity_fails_closed_while_missing_relationship_secrets_keep_identity() {
let alice = FaultNode::new();
let bob = FaultNode::new();
let bob_id = bob.core().status().endpoint_id.clone();
establish_saved(&alice.core(), &bob.core(), 14_010);
let endpoint_before = alice.core().status().endpoint_id.clone();
// Drop only relationship-grant material; identity stays loadable.
let handles = alice.secret_store.list_handles().unwrap();
for handle in handles {
if handle.as_str().contains("relationship-grant") {
alice.secret_store.remove_for_test(&handle);
}
}
let alice = alice.restart();
assert_eq!(alice.core().status().endpoint_id, endpoint_before);
assert!(
alice.core().list_saved_devices().unwrap().is_empty(),
"missing relationship secrets must disable saved-device rows"
);
let source_dir = tempfile::tempdir().unwrap();
let source_path = source_dir.path().join("still-works.txt");
std::fs::write(&source_path, b"identity ok").unwrap();
let share = share_path(&alice.core(), &source_path, 14_011);
assert!(
!share.ticket.is_empty(),
"identity must still serve tickets"
);
let create_err = alice.core().create_targeted_transfer(
bob_id,
vec![targeted_source(&source_path)],
Some("still-works.txt".to_string()),
);
assert!(
create_err.is_err(),
"saved-device transfer must fail without relationship secrets"
);
// Locked identity storage refuses networking on the next start.
alice
.secret_store
.fail_with(Some(ReferenceStoreFailure::Locked));
match alice.try_restart() {
Err((_alice, error)) => {
assert!(matches!(error, VnidropError::SecureStorageLocked { .. }));
}
Ok(_) => panic!("locked identity must fail closed"),
}
// Apple Keychain adapter maps lock statuses the same way for identity gets.
let api = ControllableKeychain::default();
let store = AppleKeychainSecretStore::with_api(api.clone());
let identity = handle_for_test("vnidrop/v1/endpoint-identity/contract-lock");
store
.put(
&identity,
crate::secure_secret::SecretMaterial::new(vec![0x41; 32]).unwrap(),
)
.unwrap();
api.lock_account(identity.as_str());
assert!(matches!(
store.get(&identity),
Err(SecureSecretStoreError::Locked)
));
api.set_unavailable(true);
assert!(matches!(
store.get(&identity),
Err(SecureSecretStoreError::Unavailable)
));
}
#[test]
fn event_ids_and_revisions_recover_authoritative_state_after_listener_restart() {
let alice = FaultNode::new();
let bob = FaultNode::new();
establish_saved(&alice.core(), &bob.core(), 14_020);
let live = alice.sink.snapshot();
assert!(!live.is_empty());
let mut revisions = live.iter().map(|event| event.revision).collect::<Vec<_>>();
revisions.sort_unstable();
let unique = revisions.iter().copied().collect::<HashSet<_>>();
assert_eq!(
unique.len(),
live.len(),
"live revisions must be unique and monotonic per emission"
);
// Simulate at-least-once delivery: duplicates + a fresh listener.
let duplicates = live.clone();
alice.sink.clear();
let alice = alice.restart();
let after_restart = alice.core().list_events(None).unwrap();
assert!(!after_restart.is_empty());
let (seen_ids, max_revision) = recover_authoritative_state(&after_restart, &duplicates);
assert_eq!(seen_ids.len(), after_restart.len());
assert!(max_revision >= 1);
let saved = alice.core().list_saved_devices().unwrap();
assert_eq!(saved.len(), 1);
let relationships = alice.core().list_device_relationships().unwrap();
assert!(relationships
.iter()
.any(|entry| entry.state == DeviceRelationshipState::Saved));
}
#[test]
fn apple_public_bindings_omit_raw_secrets_and_generic_mutation() {
// Generated Swift bindings (after build-core.sh) are the Apple public surface.
// When absent, assert the UniFFI-exported Rust API module has no secret types.
let swift = std::path::PathBuf::from(env!("CARGO_MANIFEST_DIR"))
.join("../../apple/VnidropCore/Sources/VnidropCore/Vnidrop.swift");
if let Ok(source) = std::fs::read_to_string(&swift) {
for forbidden in [
"SecretMaterial",
"SecretHandle",
"SecureSecretStore",
"executeSql",
"executeSQL",
"mutateState",
"applyRawState",
"rawSecret",
"grantSecret",
"pairingCapabilityBytes",
"func setState(",
"func mutate(",
] {
assert!(
!source.contains(forbidden),
"{} must not expose {forbidden}",
swift.display()
);
}
assert!(
source.contains("initializeWithExperimentalSavedDevices"),
"Swift bindings must expose experimental saved-device init"
);
assert!(
source.contains("setSavedDeviceLabel"),
"Swift bindings must expose saved-device rename"
);
assert!(
source.contains("revision"),
"Swift CoreEvent must carry revision"
);
return;
}
let api = std::fs::read_to_string(
std::path::PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("src/api.rs"),
)
.expect("api.rs");
for forbidden in [
"SecretMaterial",
"SecretHandle",
"SecureSecretStore",
"execute_sql",
"mutate_state",
"apply_raw_state",
"raw_secret",
"grant_secret",
"pairing_capability_bytes",
] {
assert!(
!api.contains(forbidden),
"public api.rs must not expose {forbidden}"
);
}
assert!(
api.contains("pub revision: u64"),
"CoreEvent must expose revision for recovery"
);
}