halkyon/packages/halkyon_base_client
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Tizian 「ティツィアーン」 a3a8ed3890
feat(auth): a password with TOTP on the register, and resets
The register's side of signing in with an address, a password that never
leaves the device (SRP-6a) and a code from an authenticator (ADR 0017),
with members forwarding every step through AccountRegister:

- password.set: salt, Argon2id's costs, SRP's verifier, the public keys
  and the private keys wrapped twice, all made on the device; with the
  address a mailed code proves, an anonymous person becomes identified
  under their ID. It signs in once an authenticator is confirmed.
- passwordSignIn.begin and complete: SRP's two steps with a TOTP or
  recovery code. An address nobody has is answered from a decoy key as
  an account would be; every wrong credential is refused alike.
- authenticator: secrets sealed under totpKey (XChaCha20-Poly1305, bound
  to their row), each code accepted once, ten recovery codes with the
  first, the last one kept.
- accountRecovery: a lost authenticator reset 72 hours after the
  password and a mailed code or the recovery phrase ask, a lost password
  set anew with the phrase's signature, or the account reset with new
  keys 72 hours after a mailed code asks; a mail at each start, a
  sign-in calling it off.
- An account with a password no longer signs in by a mailed code or
  GitHub; no new GitHub account is linked where passwords are offered,
  and from GITHUB_SIGN_IN_ENDS GitHub signs nobody in and its IDs go.

Five tables, added by the module's migration; deletePerson deletes
their rows.

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
..
lib feat(auth): a password with TOTP on the register, and resets 2026-10-22 18:11:10 +02:00
test feat(crypto): SRP-6a, the register's half and the device's 2026-10-22 18:11:08 +02:00
.gitignore halkyon_base: a Serverpod module for sign-in, accounts and instance basics 2026-10-19 14:29:28 +02:00
analysis_options.yaml feat(crypto): SRP-6a, the register's half and the device's 2026-10-22 18:11:08 +02:00
CHANGELOG.md halkyon_base: a Serverpod module for sign-in, accounts and instance basics 2026-10-19 14:29:28 +02:00
LICENSE build: Melos, a Dart check and every path for the single repository 2026-10-22 18:11:04 +02:00
pubspec.yaml feat(crypto): SRP-6a, the register's half and the device's 2026-10-22 18:11:08 +02:00
README.md feat(crypto): SRP-6a, the register's half and the device's 2026-10-22 18:11:08 +02:00

halkyon_base_client

The client of halkyon_base, generated by Serverpod: what a Halkyon app calls to sign in, to manage its account, and to learn an instance's basics, under client.base in the app's own client. Never edited by hand; run serverpod --no-analytics generate in halkyon_base_server instead.

The one exception is SRP-6a's client half (ADR 0017), written by hand beside the generated code, which the generator leaves alone (it writes only lib/src/protocol/): package:halkyon_base_client/srp.dart, tested by dart test here. The module's README says how it pairs with the register's half.

Under the GNU Affero General Public License 3.0 or later.