Uniswap / unichain-node

Everything required to run your own Unichain node

Unichain Node

This repository contains the relevant configuration to run your own node on the Unichain network.

Troubleshooting

If you encounter problems with your node, please open a GitHub issue

Supported Networks

Network	Status
Testnet (Sepolia)	✅

Usage

1. Ensure you have an Ethereum L1 full node RPC available, and set OP_NODE_L1_ETH_RPC & OP_NODE_L1_BEACON (in the .env.sepolia file). If running your own L1 node, it needs to be synced before Unichain will be able to fully sync.
2. Run:

docker compose up -d

3. You should now be able to curl your Unichain node:

curl -d '{"id":1,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
  -H "Content-Type: application/json" http://localhost:8545

4. To stop your node, run:

docker compose down

Persisting Data

By default, the data directory is stored in ${PROJECT_ROOT}/geth-data. You can override this by modifying the value of HOST_DATA_DIR variable in the .env file.