BSV.Block (bsv_sdk v1.5.0)

A Bitcoin block consisting of a BSV.BlockHeader and a list of transactions.

Supports parsing from binary/hex, serialization, merkle root calculation, and validation.

Summary

Types

t()

Block struct

Functions

calc_merkle_root(block)

Calculate the merkle root from the block's transactions.

from_binary(data)

Parse a block from a binary.

from_hex(hex)

Parse a block from a hex-encoded string.

genesis?(block)

Check if a block is a genesis block (prev_hash is all zeros).

hash(block)

Return the block hash (delegates to BlockHeader.hash/1).

hash_hex(block)

Return the block hash as a display-order hex string.

to_binary(block)

Serialize a block to binary.

to_hex(block)

Serialize a block to a hex-encoded string.

tx_count(block)

Return the number of transactions in the block.

valid_merkle_root?(block)

Validate that the calculated merkle root matches the header's merkle root.

Types

t()

@type t() :: %BSV.Block{header: BSV.BlockHeader.t(), txns: [BSV.Transaction.t()]}

Block struct

Functions

calc_merkle_root(block)

@spec calc_merkle_root(t()) :: <<_::256>>

Calculate the merkle root from the block's transactions.

from_binary(data)

@spec from_binary(binary()) :: {:ok, t(), binary()} | {:error, term()}

Parse a block from a binary.

Returns {:ok, block, rest} or {:error, reason}.

from_hex(hex)

@spec from_hex(String.t()) :: {:ok, t()} | {:error, term()}

Parse a block from a hex-encoded string.

genesis?(block)

@spec genesis?(t()) :: boolean()

Check if a block is a genesis block (prev_hash is all zeros).

hash(block)

@spec hash(t()) :: <<_::256>>

Return the block hash (delegates to BlockHeader.hash/1).

hash_hex(block)

@spec hash_hex(t()) :: String.t()

Return the block hash as a display-order hex string.

to_binary(block)

@spec to_binary(t()) :: binary()

Serialize a block to binary.

to_hex(block)

@spec to_hex(t()) :: String.t()

Serialize a block to a hex-encoded string.

tx_count(block)

@spec tx_count(t()) :: non_neg_integer()

Return the number of transactions in the block.

valid_merkle_root?(block)

@spec valid_merkle_root?(t()) :: boolean()

Validate that the calculated merkle root matches the header's merkle root.