Expand description
Hosted-account record and mint state machine.
The mint path is intentionally split around the user signature:
HostedAccountMint::beginconsumes an already-allocated account name and generates a fresh per-account ES256#atprotokey.HostedAccountMint::seal_did_documentbuilds the canonical DID document (B2/#1164) from that generated key, andHostedAccountMint::prepare_genesisbinds the sealed artifact.- The user signs
PendingHostedAccountMint::signing_byteswith the required priority-zero Hybrid rotation key. PendingHostedAccountMint::sealverifies that signature before it can produce anAccountRecord.
A host never receives the user’s rotation private key. The generated ES256 private key is returned separately from the public account record so a caller can place it in the deployment’s secret store; it is never serialized into the record or genesis operation.
A2 (#1160) owns label allocation and never-reuse. A3 (#1162) owns deriving
the host from the configured deployment zone. This module consumes the
narrow seam between them as AllocatedAccountName and independently
revalidates the permanent host-form DID before signing anything.
Structs§
- Account
Record - The public durable record locating a hosted account’s permanent genesis.
- Allocated
Account Name - The output of the A2 allocation + A3 configured-zone seam.
- Directory
Hosted Account Store - Fail-closed filesystem persistence for newly minted hosted accounts.
- Hosted
Account Mint - Mint state after label allocation and per-account ES256 generation.
- Pending
Hosted Account Mint - Mint state waiting for the user-held priority-zero signature.
- Sealed
Hosted Account - Fully sealed account artifacts ready for an atomic persistence boundary.
Constants§
- ACCOUNT_
RECORD_ VERSION - Version of the durable hosted-account record.
- ATPROTO_
SIGNING_ KEY_ FILE - Secret account-specific P-256 key paired with the public
#atprotoverification method in the immutable account record and DID document. - DID_
DOCUMENT_ FILE - GENESIS_
DID_ OP_ FILE
Functions§
- is_
hosted_ account_ staging_ directory - Return whether
nameis an unpublished account-mint staging directory.