bitcoin

package

v0.3.0-rc1 Latest Latest Go to latest Published: Apr 15, 2026 License: MIT Imports: 7 Imported by: 0

Details

Package bitcoin provides BIP 37 partial merkle tree verification and thin wrappers around btcsuite/btcd for transaction and txoutproof parsing.

This section is empty.

This section is empty.

func ComputeTxID(rawTxHex string) (string, error)

ComputeTxID computes the txid from raw transaction hex (display order, handles segwit).

func DecodeTransaction(rawTxHex string) (*wire.MsgTx, error)

DecodeTransaction decodes raw transaction hex into a wire.MsgTx.

func DecodeTxOutProof(txoutproofHex string) (*wire.MsgMerkleBlock, error)

DecodeTxOutProof decodes a txoutproof hex string into a wire.MsgMerkleBlock.

func ExtractOpReturn(rawTxHex string) (string, error)

ExtractOpReturn parses a raw transaction and returns the OP_RETURN data as hex.

func ParseBlockHash(txoutproofHex string) (string, error)

ParseBlockHash decodes a txoutproof hex string and returns the block hash (display order).

type MerkleResult struct {
	Valid        bool
	ComputedRoot *chainhash.Hash
	MatchedTxIDs []*chainhash.Hash
}

MerkleResult holds the result of a partial merkle tree verification.

func VerifyPartialMerkleTree(
	hashes []*chainhash.Hash,
	flagBytes []byte,
	totalTxs uint32,
	expectedRoot *chainhash.Hash,
) MerkleResult

VerifyPartialMerkleTree verifies a Bitcoin BIP 37 partial merkle tree. Takes the hashes and raw flag bytes from wire.MsgMerkleBlock directly.