Lookup Block Info

Retrieve detailed block information from the BSV blockchain.

API

Uses WhatsOnChain for complete block data (size, txcount, difficulty, previousblockhash). JungleBus /v1/block_header/get/{hash} only provides header fields - use that directly if you only need hash, height, time, merkleroot.

When to Use

• Get block data by height
• Get block data by hash
• View block statistics (size, tx count, etc.)

Usage

# Lookup by height
bun run skills/lookup-block-info/scripts/lookup.ts --height 800000

# Lookup by hash
bun run skills/lookup-block-info/scripts/lookup.ts --hash 00000000000000000320e...

# JSON output
bun run skills/lookup-block-info/scripts/lookup.ts --height 800000 --json

# Show help
bun run skills/lookup-block-info/scripts/lookup.ts --help

Output

Default Format

Block #1
Hash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048
Time: 2009-01-09 02:54:25 UTC
Size: 215 bytes
Transactions: 1
Merkle Root: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098
Previous: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f
Difficulty: 1

JSON Format (--json)

{
  "height": 1,
  "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048",
  "time": 1231469665,
  "size": 215,
  "txCount": 1,
  "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098",
  "previousHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
  "difficulty": 1
}

Error Handling

• Invalid height (negative): "Error: Height must be non-negative integer", exit 1
• Invalid hash format: "Error: Hash must be 64 hex characters", exit 1
• Block not found: "Error: Block not found", exit 1
• Network/API error: "Error: API request failed: <reason>", exit 1

Status

Complete - All tests pass