Struct Stock 

pub struct Stock;

The stock 80-byte Bitcoin header, hashed with double SHA-256 (parents btc and tbtc4). Version 0x20000000, bit 31 clear, so a Knots node never mistakes it for a v2 header. The stock header does not carry the height, so beside a stock parent the coinbase is the only place the height is written (coinbase_height).

Trait Implementations

impl Clone for Stock

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Stock

impl Debug for Stock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Stock

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Stock

impl HeaderFamily for Stock

fn decode_header(&self, bytes: &[u8]) -> Result<Header>

Exactly 80 bytes with bit 31 of the version clear; a set bit 31 is refused as the kernel’s structVariants would select the v2 layout for it (and as sidestr-header’s StockHeader::decode refuses it).

fn version_number(&self, header: &Header) -> i64

i32le: bit 31 set reads as a negative version.

const FAMILY: Family = Family::Stock

Which family this is.

const HEADER_LEN: usize = 80

The serialised header length: 80 or 164.

type Header = Header

The header: the parent’s layout, decoded.

type Block = Block

The block: this header followed by the transactions. bitcoin::Block for the stock family; FamilyBlock otherwise.

fn encode_header(&self, header: &Header) -> Vec<u8>

The header’s wire bytes.

fn block_hash(&self, header: &Header) -> BlockHash

The block hash: the parent’s proof-of-work hash over the header.

fn signed_prefix(&self, header: &Header) -> Vec<u8>

The bytes the block signature commits to (SPEC 4): the header’s first 72 bytes, version, prev, merkle root and time on wire — never the nonce, which is found after signing.

fn header_height(&self, _header: &Header) -> Option<u32>

The height the header itself carries, when the family writes it there.

fn new_header( &self, prev: BlockHash, merkle_root: TxMerkleNode, time: u32, bits: CompactTarget, _height: u32, _tx_count: usize, ) -> Header

An unsigned header on prev with this family’s version and zero nonce (siding/lib/block.mjs buildBlock). height and tx_count are for the families whose header commits to them; the stock header ignores both.

fn version(&self, header: &Header) -> u32

The raw wire version word, unsigned.

fn prev(&self, header: &Header) -> BlockHash

The previous block’s hash.

fn merkle_root(&self, header: &Header) -> TxMerkleNode

The merkle root.

fn time(&self, header: &Header) -> u32

The consensus time: for a v2 header, the wire time with its offset applied.

fn bits(&self, header: &Header) -> CompactTarget

The compact target.

fn nonce(&self, header: &Header) -> u32

The (first) nonce.

fn set_merkle_root(&self, header: &mut Header, root: TxMerkleNode)

Replace the merkle root; seal_block does so once the solution is in.

fn set_nonce(&self, header: &mut Header, nonce: u32)

Replace the nonce; seal_block grinds it.

fn family(&self) -> Family

Which family this is.

fn header_len(&self) -> usize

The serialised header length.

fn header_rules(&self, header: &Self::Header, height: u32) -> Vec<RuleResult>

The header rules the parent’s fork adds beyond Bitcoin’s (the Knots overlay’s knots:rule-header-*), judged for a header at height. None for the stock family.

fn block_rules(&self, header: &Self::Header, tx_count: usize) -> Vec<RuleResult>

The block rules the parent’s fork adds (knots:rule-block-txcount), given the header and the block’s transaction count.

fn sighash_rules(&self, height: u32) -> SighashRules

The signature-hash rules a spend at height is judged by: BIP 341 on a stock chain; Knots’ unified opt-in sighash from the fork height on a BLAKE2b chain, which for a sidestr chain is height 0 (siding/lib/overlay.mjs: unifiedSighashParam: 'blake2bHeight', blake2bHeight: 0).

impl PartialEq for Stock

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Stock