# Lookup Block Info

> This skill should be used when the user asks to "get block info", "lookup block by height", "block by hash", "block header details", or needs to retrieve BSV block information.

- Skill: `jsgforever/lookup-block-info` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jsgforever/lookup-block-info`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jsgforever/lookup-block-info/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/lookup-block-info

---


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