halkyon/packages/halkyon_keys/lib/halkyon_keys.dart
Tizian 「ティツィアーン」 200a2df32f
feat(keys): passwords taken as RFC 8265's OpaqueString
Other spaces become a plain space and the text is composed (NFC) before
Argon2id, so a password typed on another system, accents composed or
not, unlocks the same keys; empty passwords and control characters are
refused. The normalisation (unorm_dart) is pinned exactly, as it must
never change once an account exists. ADR 0017 records both decisions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
2026-10-22 18:11:10 +02:00

25 lines
1.1 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;
export 'src/sealed_content.dart' show SealedContent, openContent, sealContent;