# 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.

- Skill: `jsgforever/decode-bsv-transaction` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jsgforever/decode-bsv-transaction`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jsgforever/decode-bsv-transaction/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jsgforever (https://skillmd.com/u/jsgforever)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jsgforever/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

```bash
# 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