README.md

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)	✅

Prerequisites

Before starting, ensure you have the following installed:

• Docker: If you haven't installed Docker yet, follow the Docker installation guide.

• Docker Compose: Docker Compose is required for running the services. Follow the Docker Compose installation guide.

• Ethereum L1 full node RPC: You need access to an Ethereum Layer 1 full node, either by running your own or using a service like Infura or Alchemy.

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.