Tutorial — Run a node

Run a light node

A light client syncs headers and verified state from peers without producing blocks. Useful for wallets, read-only services, and anywhere you want strong guarantees without validator cost.

Level: Beginner
Time: ~15 min
Prerequisites: Any Linux or macOS box
Stack: CLI

Install the node binary

The same binary runs every role — light client mode just skips block production and consensus voting.

cargo install --git https://github.com/tenzro/tenzro-network tenzro-node

Boot in light-client mode

The light client sources headers from public bootstrap peers and verifies state proofs against finalized roots.

tenzro-node \
  --role light-client \
  --data-dir ~/.tenzro-light \
  --rpc-addr 127.0.0.1:8545

Run state-sync to skip the historical chain

State sync pulls a recent snapshot rather than replaying every block since genesis.

tenzro-node --role light-client --state-sync-from https://rpc.tenzro.network

Query through the local RPC

Once synced, point any SDK or wallet at 127.0.0.1:8545. The node verifies responses against the trusted root before returning them.

curl -s http://127.0.0.1:8545 -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Open the docs →Browse all tutorials

← All tutorials