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, registered names
/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.

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