Bitcoin Block Data

Inherent Raw Data Fields and Derived or Indexer-Generated Fields

Inherent Block Data (prefix "IB")

Number	Field Name	Description	Type/Size
IB1	magic	Network identifier	4 bytes
IB2	blockSize	Size of the block	4 bytes
IB3	version	Block version number	4 bytes
IB4	hashPrevBlock	Hash of the previous block	32 bytes
IB5	hashMerkleRoot	Root of the Merkle tree of transactions	32 bytes
IB6	time	Block creation time	4 bytes
IB7	bits	Compact representation of the target difficulty	4 bytes
IB8	nonce	Value used in the mining process	4 bytes
IB9	vtx	Vector of transactions in the block	Variable

Derived Block Data (prefix "DB")

Number	Field Name	Description	Type/Size
DB1	hash	Double SHA256 hash of the block header	32 bytes (hex string)
DB2	height	Block height in the blockchain	Integer
DB3	strippedsize	Block size without witness data	Integer
DB4	weight	Block weight (for SegWit)	Integer
DB5	versionHex	Hexadecimal representation of block version	Hex string
DB6	mediantime	Median time of past several blocks	Timestamp
DB7	difficulty	Current mining difficulty	Float
DB8	chainwork	Total work done to produce the chain up to this block	Hex string

Inherent Transaction Data (prefix "IT")

Number	Field Name	Description	Type/Size
IT1	version	Transaction version number	4 bytes
IT2	vin	Vector of input information	Variable
IT2.1	txid	Hash of the transaction containing the UTXO being spent	32 bytes
IT2.2	vout	The index of the specific output in the previous transaction	4 bytes
IT2.3	scriptSig	Unlocking script	Variable
IT2.3.1	scriptSig.length	Length of the unlocking script	Variable (1-9 bytes)
IT2.3.2	scriptSig.asm	The assembly code of the unlocking script	Variable
IT2.4	nSequence	Input sequence number	4 bytes
IT3	vout	Vector of output information	Variable
IT3.1	value	Amount of satoshis to send	8 bytes
IT3.2	scriptPubKey	Locking script	Variable
IT3.2.1	scriptPubKey.length	Length of the locking script	Variable (1-9 bytes)
IT3.2.2	scriptPubKey.asm	The assembly code of the locking script	Variable
IT4	nLockTime	Transaction-level timelock	4 bytes
IT5	vwitness	Vector of witness data (one for each input)	Variable

Derived Transaction Data (prefix "DT")

Number	Field Name	Description	Type/Size
DT1	txid	Transaction ID (hash without witness data)	32 bytes (hex string)
DT2	hash	Transaction hash (with witness data for SegWit)	32 bytes (hex string)
DT3	size	Total transaction size	Integer
DT4	vsize	Virtual transaction size	Integer
DT5	weight	Transaction weight (for SegWit)	Integer
DT6	fee	Transaction fee in BTC	Float
DT7	is_coinbase	Whether the transaction is a coinbase transaction	Boolean
DT8	has_witness	Whether the transaction uses SegWit	Boolean

Bitcoin Addresses

An ID to reference bitcoin addresses within specific block height transactions is also supported. Bitcoin addresses themselves are not stored onchain but are derived from transaction data (scriptPubKey). Patterns can still be defined and use addresses as the block data target. This is aligned with current support for other derived block data in addition to inherent raw block data.

This ID combines the ID for block height (DB2) followed by ADDR and this is followed by a height number, a transaction index number and optionally a transaction output index number. These are all separated by colons.

DB2:ADDR:<HEIGHT#>:<TXINDEX#>:<OUTPUTINDEX#>

Patterns can target specific transactions and one level deeper to specific outputs in those transactions. If not output index is included, the pattern search uses all addresses in the transaction to find matches.