Expand description
Locally validated Handshake header chains and name-tree resources.
This crate starts at the selected network genesis, validates every
contiguous header with the shared hns-rs consensus implementation, and
retains exactly the history required by Handshake’s median-time and
difficulty rules. A current-chain attestation can then verify one strict
HSD Urkel inclusion proof and decode the committed NameState and resource.
The resulting VerifiedHnsResource has private fields so downstream
DNSSEC code cannot manufacture a Handshake trust anchor.
Structs§
- Chain
Limits - Bounds for header admission.
- Chain
Snapshot Floor - Caller-held rollback floor for an authenticated checkpoint.
- Currency
Policy - Currency requirements applied before a name proof becomes authoritative.
- Current
Chain - A chain tip that passed explicit currency policy.
- Delegation
Signer - One HNS resource DS payload.
- Header
Entry - One fully validated header summary.
- HnsAnchor
- Metadata for the exact current header that authenticated a resource.
- HnsResource
- Strictly decoded HSD name resource.
- Light
Chain - A linear, consensus-validated Handshake header chain.
- Resource
Name - Expanded uncompressed DNS name from an HNS resource.
- Verified
HnsResource - A name resource authenticated by a current Handshake header and Urkel proof.
Enums§
- HnsResource
Record - One assigned HSD resource record.
- Light
Chain Error - Header, currency, proof, name-state, or HNS resource failure.
Constants§
- DEFAULT_
MAX_ HEADERS_ PER_ BATCH - Default maximum headers accepted in one transactional batch.
- MAX_
HEADERS_ PER_ BATCH_ LIMIT - Hard upper bound for a configured atomic header batch.
- MAX_
LIGHT_ CHAIN_ SNAPSHOT_ BYTES - Maximum encoded authenticated light-chain checkpoint.
- MAX_
LOCATOR_ HASHES - Maximum exponential locator entries for a 32-bit height plus genesis.
- MEDIAN_
TIME_ SPAN - Handshake median-time-past window.
- REQUIRED_
DIFFICULTY_ HISTORY - Headers needed for both three-block suitable points around a 144-block window.