inkonchain/node

This repository provides a Docker Compose setup for running an Ink blockchain node. Ink is a Layer 2 blockchain network built on the Optimism (OP Stack) framework, meaning it processes transactions faster and cheaper than Ethereum mainnet, but periodically anchors its state to Ethereum for security. Running your own Ink node means you have a local copy of the blockchain that you can query for transaction data, smart contract calls, and historical state, rather than relying entirely on a third-party RPC provider. The way it works is that Docker Compose starts several services together: an execution client (currently op-geth, a modified version of the standard Ethereum client) that actually processes and stores blocks, an op-node consensus layer component that communicates with Ethereum to verify rollup data, a one-time initialization container (bedrock-init) that sets up the data directory and a shared JWT secret for secure communication between the clients, and monitoring services (Prometheus, Grafana, InfluxDB) that give you a dashboard to watch sync progress. You point the node at an Ethereum L1 RPC endpoint, and it begins syncing Ink's chain by downloading and validating blocks. Both mainnet and testnet (Sepolia) configurations are supported. You would run this if you are a developer building applications on Ink who needs reliable, private access to blockchain data, or an infrastructure operator who wants to verify the chain independently. Note that the current op-geth execution client will be deprecated at the Ethereum Glamsterdam hardfork (May 31, 2026) and a migration to op-reth will be required. The tech stack is Shell scripts for initialization logic, Docker Compose for service orchestration, and the OP Stack (op-geth, op-node) as the underlying blockchain software.