Running Matchain Node

This guide provides instructions on launching a full node on Matchain using a simple Docker Compose script. Follow the steps below to set up your full node.

Network update for node operators (October 2026)

1. Transaction forwarding: if your op-geth uses https://matchain-mainnet.alt.technology as --rollup.sequencerhttp (SEQUENCER_HTTP), change it to https://rpc.matchain.io

2. Add the Matchain seed for op-geth (bootnodes and static peers): enode://4fabb9a1f34cc553617ec0e706dc37fad1e4f533401d267b953a5acc32fb5b7207a8f49df81fbbe6d3832d7ae87bdcdb5bdebb0ad38912ed86d9414e2e071cc1@162.19.80.175:10010

3. Add the Matchain seed for op-node (--p2p.static): /ip4/162.19.80.175/tcp/20010/p2p/16Uiu2HAm5hjiTU198Yw4tQ9pmvNysTS1WZRVU5saiKSSEgAE1iTY

4. Allow outbound TCP and UDP 10010 and 20010 to 162.19.80.175.

5. Remove the alt.technology seed entries at your next configuration change.

The example configuration in the matchain/node and matchain/opstack-fullnode-sync repositories still carries the old values. Apply the changes above when you use it.

---

Prerequisites

Clone the Repository

Before starting, clone the opstack-fullnode-sync repository:

git clone -b v0.3.0 https://github.com/matchain/opstack-fullnode-sync.git
cd opstack-fullnode-sync

---

Recommended Hardware

• CPU: 4 Cores

• RAM: 16 GB+

• Storage: 1TB SSD (NVMe Recommended)

• Network: 100 MB/s+ Download

---

Preparation

1. Generate JWT File Run the following command to generate a JWT file:

   openssl rand -hex 32 > jwt.txt

2. Configure Environment Variables Copy the .env.example file to create your .env file, and update the values as needed:

   cp .env.example .env

   Modify .env to set your parameters, or request a preconfigured .env file from the Matchain team.

---

Operating the Node

Start the Node

Use Docker Compose to start the node:

docker compose --env-file .env up -d

View Logs

• Logs for OP Node:

  docker compose logs -f node

• Logs for OP Geth:

  docker compose logs -f geth

---

Sanity Test

Check Sync Status

To check the sync status, use:

curl --location 'localhost:8545' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 2
}'

• If the node is still syncing, you will see output similar to:

  {
    "jsonrpc": "2.0",
    "id": 2,
    "result": {
      "currentBlock": "0x7d0f5",
      ...
      "highestBlock": "0xd8674",
      ...
    }
  }

• When syncing completes, you will see:

  {"jsonrpc":"2.0","id":2,"result":false}

Check Block Number

After syncing completes, verify by checking the latest block number:

curl --location 'localhost:8545' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "id": 2
}'

• Example response:

  {
    "jsonrpc": "2.0",
    "id": 2,
    "result": "0x2139"
  }

---

Stop the Node

To stop the node, use:

docker compose down

---

Reference

For further details, refer to the Optimism Documentation.