Tizian 「ティツィアーン」
bc499713b8
ADR 0017's step 1. Generic over group and hash (SrpGroup); production takes RFC 5054's 3072-bit group with SHA-256. k = H(N | PAD(g)), u = H(PAD(A) | PAD(B)), K = H(PAD(S)), M1 = H(H(N) xor H(g) | H(I) | s | PAD(A) | PAD(B) | K), M2 = H(PAD(A) | M1 | K). A and B must lie in 1..N-1 and u must not be 0; a and b are 256 bits from Random.secure(); proofs are compared in constant time. x comes from the caller (halkyon_keys makes it); RFC 5054's own x is there for the vectors only. - The register's half in halkyon_base_server (base.dart: srpChallenge, srpVerify), the device's written by hand in halkyon_base_client (srp.dart: SrpClient, srpVerifier). Serverpod's generator cleans and writes only a client's lib/src/protocol/ (serverpod_cli 4.0.4's _getDirectoriesRequiringCleaning; a generate leaves srp/ untouched). - Tests: RFC 5054 Appendix B on both halves; the client against the register, succeeding and every refusal. - The module's tests depend on its client, and pub resolves every member's dev dependencies, so Learn's server image takes the module's client into its workspace too. - The format check covers the hand-written half. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
13 lines
709 B
Markdown
13 lines
709 B
Markdown
# halkyon_base_client
|
|
|
|
The client of [`halkyon_base`](../halkyon_base_server/README.md), 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.
|