decode-bsv-transaction

This skill should be used when the user asks to "decode transaction", "parse tx hex", "transaction details", "analyze transaction", "decode BEEF", "parse BEEF hex", "decode EF transaction", "inspect transaction", or needs to decode BSV transaction hex (raw, Extended Format, or BEEF) into human-readable format.

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