Skip to main content

Crate hns_light_chain

Crate hns_light_chain 

Source
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§

ChainLimits
Bounds for header admission.
ChainSnapshotFloor
Caller-held rollback floor for an authenticated checkpoint.
CurrencyPolicy
Currency requirements applied before a name proof becomes authoritative.
CurrentChain
A chain tip that passed explicit currency policy.
DelegationSigner
One HNS resource DS payload.
HeaderEntry
One fully validated header summary.
HnsAnchor
Metadata for the exact current header that authenticated a resource.
HnsResource
Strictly decoded HSD name resource.
LightChain
A linear, consensus-validated Handshake header chain.
ResourceName
Expanded uncompressed DNS name from an HNS resource.
VerifiedHnsResource
A name resource authenticated by a current Handshake header and Urkel proof.

Enums§

HnsResourceRecord
One assigned HSD resource record.
LightChainError
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.