decode-bsv-transaction

name	decode-bsv-transaction
description	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.
allowed-tools	Bash(bun:*)

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