Decode BSV Transaction

Decode BSV transaction hex into human-readable format. Supports raw hex, Extended Format (EF), and BEEF format.

Status

Complete - All tests passing

Transaction Formats

BSV transactions come in three formats:

Format	Parser	Starts With	Contains
Raw	Transaction.fromHex()	01000000	Just the transaction
EF (Extended Format)	Transaction.fromHexEF()	0100beef	Tx + source tx data for fee validation
BEEF	Transaction.fromHexBEEF()	0100beef	Tx + merkle proofs for SPV

The script auto-detects format. Pass --beef flag to force BEEF parsing.

Usage

# Decode raw or EF hex (auto-detected)
bun run /path/to/skills/decode-bsv-transaction/scripts/decode.ts <tx-hex>

# Decode BEEF hex (from WalletClient noSend)
bun run /path/to/skills/decode-bsv-transaction/scripts/decode.ts --beef <beef-hex>

# Decode transaction by txid (fetches from chain)
bun run /path/to/skills/decode-bsv-transaction/scripts/decode.ts --txid <txid>

# JSON output
bun run /path/to/skills/decode-bsv-transaction/scripts/decode.ts <tx-hex> --json

API Endpoints

JungleBus (primary):

• GET https://junglebus.gorillapool.io/v1/transaction/get/{txid}

WhatsOnChain (fallback):

• GET https://api.whatsonchain.com/v1/bsv/main/tx/{txid}/hex

Response

Returns decoded transaction with:

• Version, locktime
• Inputs (previous outputs, scripts, signatures)
• Outputs (value, addresses, scripts)
• Transaction size and format type