Base Blockchain · Node Operations

Safe wrapper
for Base Node

Replaces manual docker compose with one command. Automatic preflight checks, safe shutdown, monitoring and notifications.

$ curl -fsSL https://base.sh/install | sh
0 preflight checks
0 commands
0 platforms
How it works
1
bnh doctor

Checks 8 conditions before launch: Docker running, ports free, disk speed, NTP sync, peer count.

[PASS] docker running
[PASS] ports 30303, 9222 free
[WARN] disk latency 210µs
[PASS] ntp offset < 1s
2
bnh start

Runs all preflight checks first. Launches the node only when all checks are PASS or WARN. Blocks on FAIL.

→ running preflight checks…
→ docker compose up -d
✓ node started
3
bnh monitor

Polls node health every 60 s. Sends Discord or webhook notification on state transitions.

[10:42] syncing=true low_peers=false
[10:43] syncing=true low_peers=false
[10:44] syncing=false low_peers=false
All commands
bnh init Interactive profile setup
bnh start Preflight + docker compose up
bnh stop Graceful shutdown (300 s timeout)
bnh status Container state
bnh doctor Full preflight report
bnh monitor Polling loop + Discord notifications
bnh upgrade git pull + optional restart
bnh down --force --i-understand (dangerous)
AI-Assisted Development

Claude Code Skill New

One command gives Claude instant context for this entire codebase — architecture, security rules, Azul upgrade dates, dev workflow, test patterns. No re-explaining the project every session.

/ bnh-developer
Full package map: 9 packages, key file roles
11 security invariants — Claude won't break them
Azul upgrade awareness: activation timestamps, migration path
Step-by-step guides: add preflight check, CLI command, profile field
CI gate, coverage threshold, release process
claude-code · /bnh-developer
Skill loaded: bnh-developer
─────────────────────────────
✓ Package architecture loaded (9 pkgs)
✓ CLI commands + flags loaded
✓ Security invariants loaded (11)
→ path validation, SSRF, overflow guards
→ Azul gate, lockfile, --i-understand
✓ Azul upgrade context loaded
⚠ Mainnet activation: 2026-05-21
✓ Dev workflow + coverage gate (≥60%)