A key proof was a signature by the account's signing key, which every signed-in device keeps in its keyring: whoever could read one, with a code from its authenticator, set a new password without the password or the phrase (the second reading's H1). The phrase now proves itself with an Ed25519 key derived from its bits alone (halkyon_keys' recoveryProofKeysOf, KDF context hlkrprf1, a sibling of the recovery key), whose public half every setup, new phrase and account reset sends and the register keeps (account_password.recoveryProofKey); the device derives the secret half only while the phrase is typed. An account without one (none exist outside development) proves no phrase until it sets a new one; decoys check against a decoy proof key alike. Migration (module, Learn's and Todo's servers, Learn's device schema): ALTER TABLE "account_password" ADD COLUMN "recoveryProofKey" bytea; nullable, so rows made before keep working and no data is touched. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
27 lines
1.2 KiB
Dart
27 lines
1.2 KiB
Dart
/// An account's keys on the device (ADR 0017): what the password unlocks
|
|
/// (Argon2id, split into SRP's x and the key-encryption key), the account's
|
|
/// key pairs and their wrapping, the recovery phrase and its key, data keys
|
|
/// sealed to the account, and content sealed and signed in ADR 0002's
|
|
/// envelope. libsodium (the `sodium` package, its sumo API for Argon2id)
|
|
/// does every primitive; nothing here is ever sent but what is wrapped,
|
|
/// sealed or public.
|
|
library;
|
|
|
|
export 'src/account_keys.dart'
|
|
show AccountKeys, WrappedAccountKeys, unwrapAccountKeys, wrapAccountKeys;
|
|
export 'src/data_keys.dart' show DataKey, openDataKey, sealDataKey;
|
|
export 'src/key_refused.dart';
|
|
export 'src/password_keys.dart'
|
|
show PasswordKdf, PasswordKeys, derivePasswordKeys, newPasswordSalt;
|
|
export 'src/password_text.dart'
|
|
show PasswordRefusal, PasswordRefused, normalizePassword;
|
|
export 'src/recovery_phrase.dart'
|
|
show
|
|
entropyOfRecoveryPhrase,
|
|
newRecoveryPhrase,
|
|
recoveryEntropyBytes,
|
|
recoveryKeyOf,
|
|
recoveryPhraseOf,
|
|
recoveryProofKeysOf,
|
|
recoveryProofPublicKeyOf;
|
|
export 'src/sealed_content.dart' show SealedContent, openContent, sealContent;
|