Running the Network

This guide covers basic operations for your local PoA network.

Starting Services

Start Both (Geth + Blockscout)

pnpm start

Start Just Geth

pnpm run start:geth

Stopping Services

pnpm stop

Reading Logs

View all logs:

pnpm run logs

View Geth logs only:

pnpm run logs:geth

View Blockscout logs only:

pnpm run logs:blockscout

Using RPC to Communicate

The node exposes standard Ethereum JSON-RPC at:

• HTTP: http://localhost:8545
• WebSocket: ws://localhost:8546

Test the connection:

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  http://localhost:8545

Attach Geth console:

pnpm run geth:attach

For detailed commands you can use in the Geth console and other full nodes via RPC, see Geth documentation .

Using Blockscout

Access at http://localhost:4000

Blockscout provides:

• Block and transaction explorer
• Address balance and history lookup
• Smart contract verification
• Token tracking (ERC-20/721/1155)
• API for programmatic access

For detailed features and usage, see Blockscout documentation .

Deleting Data

Clean Everything

pnpm run clean

Stops containers, removes Docker volumes, deletes blockchain data. Requires running setup again.

Clean All Generated Files

pnpm run clean:all

Nuclear option - removes data, genesis, keystore, Blockscout clone, and .env file.