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
bash
# 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
code
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)
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