b-open-io/decode-bsv-transaction

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

# Skip prevout lookups (faster; no input values or fee)
bun run /path/to/skills/decode-bsv-transaction/scripts/decode.ts --txid <txid> --no-fees

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, size, format type
• Inputs: previous outpoint (txid:vout), sequence, and — resolved from the embedded source tx (EF/BEEF) or fetched by prevout txid — the input's funding satoshis and P2PKH address. Pass --no-fees to skip prevout lookups.
• Outputs: satoshis, derived P2PKH address (null for non-P2PKH), a type classification (p2pkh / op_return / nonstandard), and the full locking script hex (not truncated, so OP_RETURN payloads are inspectable).
• totalIn, totalOut, and computed fee (totalIn - totalOut). Fee is null when any prevout value is unavailable (e.g. --no-fees, or a source tx that could not be fetched).

Example

$ bun run decode.ts --txid 3ff71eb82058eb45062044091fad0ff9e115d7bb8a0f6b10d5d7f811a1a4fd2d
Transaction Decode (raw)
TXID:     3ff71eb82058eb45062044091fad0ff9e115d7bb8a0f6b10d5d7f811a1a4fd2d
Inputs:   2
  [0] 57277512...b8d19482:2  500000 sats 16j1aZn52BMH8r67kVhw7KE9y9PStwWJS6
  [1] 053ad5ff...53801f1c:18  75 sats 1MP354qMBv6BnSdzTbEEWqRXkLzxByBnq
Outputs:  7
  [0] 216919 satoshis 19Ao4zVRF6yzRaxiSHD34LCw7fBFn9nrDP
        script: 76a914599b34cbd9ec16e922ec3573b080f3fe7058333d88ac
  ...
Total in:  500075 satoshis
Total out: 500019 satoshis
Fee:       56 satoshis