Nostr Protocol

NIP-333

A standard for distributing Bitcoin block headers over Nostr, enabling lightweight clients to verify the blockchain without running a full node.

Read the Specification GitHub

Compact Headers

Each Bitcoin block header is just 80 bytes — the cryptographic proof needed to verify transactions without full blocks.

Kind 33333 Events

Parameterized replaceable events ensure relays store only the latest headers. Subscribe once, stay synced.

Light Client Ready

Build SPV wallets and apps that verify Bitcoin payments using only headers and merkle proofs.

How It Works

Bitcoin Network
Publisher
Nostr Relays
Your App
Archive  (completed epochs) + Current  (this epoch) + Tip  (latest 12 headers)
Full header chain in three pieces, all verifiable

Live Status

Chain Tip
--
block height
Archive
--
headers
Current Epoch
--
headers

Updated: --

Subscribe via Nostr

// Request the latest Bitcoin headers
["REQ", "headers", {
  "kinds": [33333],
  "#d": ["latest"],
  "#n": ["btc"],
  "limit": 1
}]

Implementations

bitcoin.cc
SPV wallet and block explorer using NIP-333 headers
btc-archive
Header archive — all completed epochs
btc-current
Current epoch headers — updated hourly