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§
- Account
Label - A validated, canonical account label.
- Account
Label Registry - Filesystem-backed, never-reuse account-label registry.
- Reserved
Account Label - 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.