Optimism Documentation

This guide reviews the basics of rollup operations, such as how to start your rollup, stop your rollup, get your rollup config, and add nodes.

Stopping your rollup

An orderly shutdown is done in the reverse order to the order in which components were started:

To stop the batcher, use this command:

    curl -d '{"id":0,"jsonrpc":"2.0","method":"admin_stopBatcher","params":[]}' \
        -H "Content-Type: application/json" http://localhost:8548 | jq

This way the batcher knows to save any data it has cached to L1. Wait until you see Batch Submitter stopped in batcher’s output before you stop the process.

Stop `op-proposer`

To stop the proposer, terminate the process directly. This can be done by:

Pressing Ctrl+C in the terminal running the process
Using system commands like kill -TERM <pid> to stop the process gracefully

Ensure that the proposer process has terminated completely before proceeding to stop other components.

Stop `op-node`

This component is stateless, so you can just stop the process.

Stop `op-reth`

Use CTRL-C (SIGINT) so the execution client shuts down gracefully and flushes its database. Killing the process abruptly can leave the database in an inconsistent state and cause problems on the next start.

Starting your rollup

To restart the blockchain, use the same order of components you did when you initialized it.

Start `op-reth`

Start `op-node`

Start `op-batcher`

If op-batcher is still running and you just stopped it using RPC, you can start it with this command:

curl -d '{"id":0,"jsonrpc":"2.0","method":"admin_startBatcher","params":[]}' \
    -H "Content-Type: application/json" http://localhost:8548 | jq   

Start `op-proposer`

Start the proposer using the appropriate command. Here’s an example:

./bin/op-proposer \
  --poll-interval=12s \
  --rpc.port=8560 \
  --rollup-rpc=http://localhost:8547 \
  --l2oo-address=0xYourL2OutputOracleAddress \
  --private-key=$PROPOSER_PRIVATE_KEY \
  --l1-eth-rpc=$L1_RPC_URL

Parameter	Description
poll-interval	How often to check for new output proposals (recommended: 12s)
rpc.port	Local RPC port for the proposer service
l2oo-address	The L2 Output Oracle contract address (0x-prefixed hex)
private-key	Private key for signing proposals
l1-eth-rpc	L1 network RPC endpoint URL

Synchronization takes timeop-batcher might have warning messages similar to:

WARN [03-21|14:13:55.248] Error calculating L2 block range         err="failed to get sync status: Post \"http://localhost:8547\": context deadline exceeded"
WARN [03-21|14:13:57.328] Error calculating L2 block range         err="failed to get sync status: Post \"http://localhost:8547\": context deadline exceeded"

This means that op-node is not yet synchronized up to the present time. Just wait until it is.

Getting your rollup config

Use this tool to get your rollup config from op-node. This will only work if your chain is already in the superchain-registry and op-node has been updated to pull those changes in from the registry.

This script will NOT work for chain operators trying to generate this data in order to submit it to the registry.

Get your rollup config from `op-node`

You’ll need to run this tool:

./bin/op-node networks dump-rollup-config --network=op-sepolia   
{
  "genesis": {
    "l1": {
      "hash": "0x48f520cf4ddaf34c8336e6e490632ea3cf1e5e93b0b2bc6e917557e31845371b",
      "number": 4071408
    },
    "l2": {
      "hash": "0x102de6ffb001480cc9b8b548fd05c34cd4f46ae4aa91759393db90ea0409887d",
      "number": 0
    },
    "l2_time": 1691802540,
    "system_config": {
      "batcherAddr": "0x8f23bb38f531600e5d8fddaaec41f13fab46e98c",
      "overhead": "0x00000000000000000000000000000000000000000000000000000000000000bc",
      "scalar": "0x00000000000000000000000000000000000000000000000000000000000a6fe0",
      "gasLimit": 30000000
    }
  },
  "block_time": 2,
  "max_sequencer_drift": 600,
  "seq_window_size": 3600,
  "channel_timeout": 300,
  "l1_chain_id": 11155111,
  "l2_chain_id": 11155420,
  "regolith_time": 0,
  "canyon_time": 1699981200,
  "delta_time": 1703203200,
  "ecotone_time": 1708534800,
  "batch_inbox_address": "0xff00000000000000000000000000000011155420",
  "deposit_contract_address": "0x16fc5058f25648194471939df75cf27a2fdc48bc",
  "l1_system_config_address": "0x034edd2a225f7f429a63e0f1d2084b9e0a93b538",
  "da_challenge_address": "0x0000000000000000000000000000000000000000",
  "da_challenge_window": 0,
  "da_resolve_window": 0,
  "use_plasma": false
}

Check the flags

Ensure that you are using the appropriate flag. The --network=op-sepolia flag allows the tool to pick up the appropriate data from the registry, and uses the OPChains mapping under the hood.

Adding nodes

To add nodes to the rollup, you need to initialize op-node and op-reth, similar to what you did for the first node. You should not add an op-batcher because there should be only one.

Configure the OS and prerequisites as you did for the first node

Install `op-reth` and `op-node` as you did for the first node

Copy from the first node these files:

    ~/op-reth/genesis.json
    ~/optimism/op-node/rollup.json

Create a new `jwt.txt` file as a shared secret:

    cd ~/op-reth
    openssl rand -hex 32 > jwt.txt
    cp jwt.txt ~/optimism/op-node

Initialize the new op-reth:

    cd ~/op-reth
    op-reth init --chain=./genesis.json --datadir=./datadir

Turn on peer to peer synchronization to enable L2 nodes to synchronize directly

If you do it this way, you won’t have to wait until the transactions are written to L1. If you already have peer to peer synchronization, add the new node to the --p2p.static list so it can synchronize.

Start `op-reth` (using the same command line you used on the initial node)

Important: Make sure to configure the --rollup.sequencer flag (alias --rollup.sequencer-http) to point to your sequencer node. This endpoint is crucial because op-reth will route eth_sendRawTransaction calls to this URL. The OP Stack does not currently have a public mempool, so configuring this is required if you want your node to support transaction submission.

Start `op-node` (using the same command line you used on the initial node)

Next steps

See the Consensus Client Configuration and Execution Client Configuration guides for additional explanation or customization.
If you experience difficulty at any stage of this process, please reach out to developer support.

​Stopping your rollup

​Starting your rollup

​Getting your rollup config

​Adding nodes

​Next steps

Stopping your rollup

Starting your rollup

Getting your rollup config

Adding nodes

Next steps