CMerkleBlock Class Reference

Used to create a Merkle proof (usually from a subset of transactions), which consists of a block header and partial Merkle Tree. More...

#include <merkleblock.h>

Collaboration diagram for CMerkleBlock:

Public Member Functions
	CMerkleBlock (const CBlock &block, CBloomFilter &filter)
	Create a Merkle proof according to a bloom filter.
	CMerkleBlock (const CBlock &block, const std::set< TxId > &txids)
	Create a Merkle proof for a set of transactions.
	CMerkleBlock ()
	SERIALIZE_METHODS (CMerkleBlock, obj)

Public Attributes
CBlockHeader	header
	Public only for unit testing.
CPartialMerkleTree	txn
std::vector< std::pair< size_t, uint256 > >	vMatchedTxn
	Public only for unit testing and relay testing (not relayed).

Private Member Functions
	CMerkleBlock (const CBlock &block, CBloomFilter *filter, const std::set< TxId > *txids)
	Combined constructor to consolidate code.

Detailed Description

Used to create a Merkle proof (usually from a subset of transactions), which consists of a block header and partial Merkle Tree.

SPV clients typically use this Merkle proof to limit bandwidth and computation requirements to process incoming transactions. From the peer-node's perspective, the SPV client is a "filtered node". See BIP37 for details: https://github.com/bitcoin/bips/blob/master/bip-0037.mediawiki

NOTE: The class assumes that the given CBlock has at least 1 transaction. If the CBlock has 0 txs, it will hit an assertion.

Definition at line 147 of file merkleblock.h.

Constructor & Destructor Documentation

CMerkleBlock() [1/4]

CMerkleBlock::CMerkleBlock ( const CBlock &  block, CBloomFilter &  filter  )

inline

Create a Merkle proof according to a bloom filter.

Note that this will call IsRelevantAndUpdate on the filter for each transaction, thus the filter will likely be modified.

Definition at line 166 of file merkleblock.h.

CMerkleBlock() [2/4]

CMerkleBlock::CMerkleBlock ( const CBlock &  block, const std::set< TxId > &  txids  )

inline

Create a Merkle proof for a set of transactions.

Definition at line 172 of file merkleblock.h.

CMerkleBlock() [3/4]

CMerkleBlock::CMerkleBlock ( )

inline

Definition at line 175 of file merkleblock.h.

CMerkleBlock() [4/4]

CMerkleBlock::CMerkleBlock ( const CBlock &  block, CBloomFilter *  filter, const std::set< TxId > *  txids  )

private

Combined constructor to consolidate code.

At most one of filter or txids may be provided.

Definition at line 27 of file merkleblock.cpp.

Here is the call graph for this function:

Member Function Documentation

SERIALIZE_METHODS()

CMerkleBlock::SERIALIZE_METHODS ( CMerkleBlock  , obj    )

inline

Definition at line 177 of file merkleblock.h.

Here is the call graph for this function:

Member Data Documentation

header

CBlockHeader CMerkleBlock::header

Public only for unit testing.

Definition at line 150 of file merkleblock.h.

txn

CPartialMerkleTree CMerkleBlock::txn

Definition at line 151 of file merkleblock.h.

vMatchedTxn

std::vector<std::pair<size_t, uint256> > CMerkleBlock::vMatchedTxn

Public only for unit testing and relay testing (not relayed).

Used only when a bloom filter is specified to allow testing the transactions which matched the bloom filter.

Definition at line 159 of file merkleblock.h.

---

The documentation for this class was generated from the following files:

• src/merkleblock.h
• src/merkleblock.cpp