Module types

Expand description

Essential Bitcoin types for consensus validation

Structs§

Bip54BoundaryTimestamps: BIP54 timewarp: timestamps of boundary blocks for period-boundary checks.
Block: Block: ℬ = ℋ × 𝒯𝒳*
BlockContext: Block validation context
BlockHash: Block hash: newtype wrapper for type safety
BlockHeader: Block Header: ℋ = ℤ × ℍ × ℍ × ℕ × ℕ × ℕ
BlockHeight: Block height: newtype wrapper for type safety
OutPoint: OutPoint: 𝒪 = ℍ × ℕ
ScriptContext: Script execution context
SharedByteString: Shareable script_pubkey for UTXO: small scripts use inline storage; longer use Arc<[u8]>. Clone is cheap (inline copies up to SHARED_BYTE_INLINE_CAP bytes, shared is Arc::clone). Serde matches ByteString.
TimeContext: Time context for consensus validation
Transaction: Transaction: 𝒯𝒳 = ℕ × ℐ* × 𝒯* × ℕ
TransactionInput: Transaction Input: ℐ = 𝒪 × 𝕊 × ℕ
TransactionOutput: Transaction Output: 𝒯 = ℤ × 𝕊
UTXO: UTXO: 𝒰 = ℤ × 𝕊 × ℕ

ForkId: Stable identifier for each consensus-affecting fork (BIP or soft-fork bundle).
Network: Network type for consensus validation
ValidationResult: Validation result

ARC_BLOCKHEADER_CREATED: Total Arc heap allocations created (each Arc::new(header) call). Compare to jemalloc bin112 curregs to see how many have been freed.
ARC_BLOCK_CREATED: Total Arc heap allocations created on IBD production paths. Incremented at: download received_put (live + CHUNK_OBSOLETE drain), local_block gap inject. Test dummies do not increment (not in MEM_REPORT).
SBS_SHARED_LIVE: Live count of SharedByteString instances using heap Arc<u8> (script > 25 bytes). Each live Shared variant holds one Arc heap allocation of (16 + script_len) bytes. If this grows unboundedly it means Arc<u8> script refs are being retained somewhere.
SBS_SHARED_TOTAL: Total Shared variants ever created (never decremented).

utxo_set_insert: Insert owned UTXO into UtxoSet (wraps in Arc). Convenience for tests and one-off inserts.
utxo_set_with_capacity: Pre-allocate a UtxoSet for n entries. Avoids costly reallocation spikes when loading large checkpoints (at 50M entries the HashMap table alone is ~2.5 GB; a growth-triggered realloc temporarily doubles that).