Skip to main content

Module keyring

Module keyring 

Source

Structs§

IdentityMismatch
The two sides of a sync hold different identity keys, or one holds none, so neither could open the other’s frames.
IdentityStatus
This device’s standing in its sync identity, as the store shows it.
Joined
What a joining device took from its admission.
Keyring
This device’s sync identity: its device keys and the identity key epochs it can open.
PeerStanding
RecoveryState
Removal
What sb device remove revokes, or would revoke.
RemovalRefused
A removal the caller asked for that can’t be done, as opposed to a store failure.
Retired
What sb recovery remove retired.
RetiredPhrase

Enums§

Continuity

Constants§

LEGACY_KEY_FILE
MIGRATED_PEERS_FILE
MIGRATION_WINDOW_MICROS
How long after this device’s upgrade a peer it knew before may still introduce itself with a self-signed row.
REMOVED

Functions§

migrate_sync_key
Turns a sync.key from sync protocol 3 or older into epoch 0 of this device’s identity key, wrapped to its device key, mints epoch 1 and writes this device’s self-signed row. The file is deleted only once the wrapped key is on disk and opens again. Safe to rerun after a crash at any step.
take_admission
On the joining device: takes the row the pairing device signed for it, the device list it vouched for over the channel, the epochs wrapped for it and its recovery recipients, adding them to the recipients this device trusted under an identity it leaves. Everything is checked before the first write, so a refused admission leaves this device as it was. Safe to rerun with the same admission.