Documentation

Block Explorer

The Norn Explorer is a block explorer web app for browsing the Norn network -- blocks, transactions, accounts, tokens, and smart contracts. Built with Next.js 15, React 19, and the @norn-protocol/sdk.

Live instance: explorer.norn.network

Key Pages

RouteDescription
/Dashboard with network stats, recent blocks, and transactions
/blocksPaginated block list
/block/[height]Block detail with metadata and activity counts
/transactionsLive transaction feed with pending transactions
/address/[address]Account balances, transaction history, primary NNS name and records
/tokensToken registry with supply information
/contractsDeployed smart contracts

Real-time updates are powered by WebSocket subscriptions -- blocks and transactions stream in as they are produced.

Address pages display the primary NNS name and any attached name records. Block detail pages show name transfers and name record updates alongside other block activity.

Running Locally

# Build the TypeScript SDK first
cd sdk/typescript && npm install && npm run build
 
# Then run the explorer
cd ../../explorer
npm install
npm run dev

Open http://localhost:3000. By default it connects to seed.norn.network.

Environment Variables

To point at a local node, create .env.local in the explorer directory:

NEXT_PUBLIC_RPC_URL=http://localhost:9741
NEXT_PUBLIC_WS_URL=ws://localhost:9741
VariableDefaultDescription
NEXT_PUBLIC_RPC_URLhttps://seed.norn.networkJSON-RPC endpoint
NEXT_PUBLIC_WS_URLwss://seed.norn.networkWebSocket endpoint for subscriptions