Skip to main content

Module account_label

Module account_label 

Source
Expand description

Account-label grammar and never-reuse allocation policy (#1160 / A2).

Account labels are permanent DNS names and are therefore treated as a one-way door. The policy is deliberately narrow: callers must provide a canonical, lowercase ASCII LDH label. Unicode input is rejected rather than normalized; this makes NFKC, mixed-script, and confusable handling fail closed without depending on a locale or a changing Unicode table. Punycode A-labels (xn--…) are accepted as opaque ASCII labels, while the corresponding Unicode spelling is never accepted at this boundary.

AccountLabelRegistry reserves a label with an exclusive file create. A reservation file is the durable tombstone: it is never removed, even if a later mint fails or an operator retires the account. A crash can leave an empty reservation file, which is intentionally still reserved and therefore cannot cause a later account to inherit the old label.

Structs§

AccountLabel
A validated, canonical account label.
AccountLabelRegistry
Filesystem-backed, never-reuse account-label registry.
ReservedAccountLabel
A label returned after an exclusive durable reservation.

Constants§

MAX_ACCOUNT_LABEL_LEN
The maximum DNS label length in octets (RFC 1035).
RESERVED_ACCOUNT_LABELS
Names owned by infrastructure or protocol endpoints rather than accounts. Keep this list conservative: once a name is minted it cannot be reclaimed.