Optimism Documentation

op-deployer 구성을 마쳤으니 이제 rollup의 sequencer를 실행할 차례입니다. 작동하는 sequencer를 만들려면 op-reth와 op-node를 모두 실행해야 합니다.

5단계 중 2단계: 이 튜토리얼은 op-deployer 실행하기를 기반으로 합니다. 해당 단계를 먼저 완료했는지 확인하십시오.

op-geth는 지원이 종료되었으며(2026-05-31) 현재 활성화된 Karst 하드포크를 지원하지 않으므로, op-geth node는 더 이상 정식(canonical) 체인을 따라갈 수 없습니다. 주요 지원 실행 클라이언트인 op-reth로 마이그레이션하십시오. 전체 마이그레이션 계획은 op-geth 지원 중단 공지를 참조하십시오.

이 튜토리얼은 이전에 op-geth를 실행 클라이언트로 안내했지만, 이제 이 페이지 전체에서 op-reth를 사용합니다.

설정할 항목

sequencer node는 두 가지 핵심 구성 요소로 이루어집니다.

op-reth: 트랜잭션을 처리하고 상태를 유지하는 실행 계층
op-node: 트랜잭션 순서를 정하고 L2 블록을 생성하는 합의 계층

sequencer는 다음을 담당합니다.

사용자 트랜잭션의 순서 지정
L2 블록 빌드
P2P 네트워크에서 블록 서명

소프트웨어 설치

sequencer를 실행할 때는 더 간단한 설정과 일관된 환경을 제공하는 Docker 사용을 권장합니다. 이 가이드에서는 더 많은 제어와 쉬운 디버깅이 필요한 경우를 위해 소스에서 빌드하는 방법도 대안으로 제공합니다.

이 가이드에서 사용하는 버전(op-node/v1.19.3 및 op-reth/v2.4.0)은 작성 시점의 최신 릴리스입니다. 현재 버전은 op-node 릴리스와 op-reth 릴리스를 확인하고, 호환성 정보는 항상 릴리스 노트를 읽으십시오.

Docker 사용
소스에서 빌드

디렉터리 구조 설정 및 구성 파일 복사

컨테이너 기반 배포를 선호한다면 공식 Docker 이미지를 사용하여 다음과 같이 진행할 수 있습니다.

# Create your sequencer directory inside rollup
cd ../    # Go back to rollup directory if you're in deployer
mkdir sequencer
cd sequencer

# Copy configuration files from deployer
cp ../deployer/.deployer/genesis.json .
cp ../deployer/.deployer/rollup.json .

# Generate JWT secret
openssl rand -hex 32 > jwt.txt
chmod 600 jwt.txt

환경 변수 파일 생성

# Create .env file with your actual values
cat > .env << 'EOF'
# L1 Configuration - Replace with your actual RPC URLs
L1_RPC_URL=https://sepolia.infura.io/v3/YOUR_ACTUAL_INFURA_KEY
L1_BEACON_URL=https://ethereum-sepolia-beacon-api.publicnode.com

# Private keys - Replace with your actual private key
PRIVATE_KEY=YOUR_ACTUAL_PRIVATE_KEY

# P2P configuration - Replace with your actual public IP
# Run `curl ifconfig.me` in a separate shell to obtain the value, then paste it below 
P2P_ADVERTISE_IP=YOUR_ACTUAL_PUBLIC_IP

EOF

중요: 모든 플레이스홀더 값(YOUR_ACTUAL_*)을 실제 구성 값으로 바꾸십시오.

Docker 애플리케이션이 실행 중인지 확인

같은 디렉터리에 docker-compose.yml 파일을 생성합니다.

services:
  op-reth:
    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-reth:v2.4.0
    volumes:
      # Mount entire directory to avoid file mounting issues
      - .:/workspace
    working_dir: /workspace
    ports:
      - "8545:8545"
      - "8546:8546"
      - "8551:8551"
    command:
      - "node"
      - "--chain=/workspace/genesis.json"
      - "--datadir=/workspace/op-reth-data"
      - "--http"
      - "--http.addr=0.0.0.0"
      - "--http.port=8545"
      - "--http.corsdomain=*"
      - "--http.api=admin,debug,eth,net,txpool,web3"
      - "--ws"
      - "--ws.addr=0.0.0.0"
      - "--ws.port=8546"
      - "--ws.origins=*"
      - "--ws.api=admin,debug,eth,net,txpool,web3"
      - "--authrpc.addr=0.0.0.0"
      - "--authrpc.port=8551"
      - "--authrpc.jwtsecret=/workspace/jwt.txt"
      - "--rollup.disable-tx-pool-gossip"
      - "--builder.deadline=2"
      - "--builder.interval=100ms"

  op-node:
    image: us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:v1.19.3
    depends_on:
      - op-reth
    volumes:
      - .:/workspace
    working_dir: /workspace
    ports:
      - "8547:8547"
      - "9222:9222"
    environment:
      - L1_RPC_URL=${L1_RPC_URL}
      - L1_BEACON_URL=${L1_BEACON_URL}
      - PRIVATE_KEY=${PRIVATE_KEY}
      - P2P_ADVERTISE_IP=${P2P_ADVERTISE_IP}
    command:
      - "op-node"
      - "--l1=${L1_RPC_URL}"
      - "--l1.beacon=${L1_BEACON_URL}"
      - "--l2=http://op-reth:8551"
      - "--l2.jwt-secret=/workspace/jwt.txt"
      - "--l2.enginekind=reth"
      - "--rollup.config=/workspace/rollup.json"
      - "--sequencer.enabled=true"
      - "--sequencer.stopped=false"
      - "--verifier.l1-confs=4"
      - "--p2p.listen.ip=0.0.0.0"
      - "--p2p.listen.tcp=9222"
      - "--p2p.listen.udp=9222"
      - "--p2p.advertise.ip=${P2P_ADVERTISE_IP}"
      - "--p2p.advertise.tcp=9222"
      - "--p2p.advertise.udp=9222"
      - "--p2p.sequencer.key=${PRIVATE_KEY}"
      - "--rpc.addr=0.0.0.0"
      - "--rpc.port=8547"
      - "--rpc.enable-admin"
      - "--log.level=info"
      - "--log.format=json"

알아 둘 만한 몇 가지 플래그는 다음과 같습니다.

--chain=/workspace/genesis.json은 op-reth가 op-deployer로 생성한 genesis 파일을 사용하도록 지정합니다. op-geth와 달리 op-reth는 별도의 init 단계가 필요하지 않으며, 처음 시작할 때 체인 스펙으로부터 데이터베이스를 초기화합니다.
--l2.enginekind=reth는 op-node가 reth 기반 실행 클라이언트를 구동하고 있음을 알려 줍니다.
--rollup.disable-tx-pool-gossip은 op-geth의 --rollup.disabletxpoolgossip=true에 해당하는 op-reth 플래그입니다.
--builder.deadline=2와 --builder.interval=100ms는 2초 L2 블록 시간에 맞게 op-reth의 블록 빌더를 조정합니다(기본값은 Ethereum의 12초 슬롯을 기준으로 합니다).
op-reth는 기본적으로 아카이브 node로 실행되므로 --gcmode=archive에 해당하는 설정을 지정할 필요가 없습니다.

이 튜토리얼은 0.0.0.0:8547에서 op-node의 admin API(--rpc.enable-admin)를 활성화합니다. op-node RPC는 인증되지 않으므로(JWT secret은 Engine API만 보호합니다), 해당 포트에 접근할 수 있는 사람은 누구나 admin_stopSequencer와 같은 admin 메서드를 호출할 수 있습니다. admin API를 공용 인터넷에 노출하지 않도록 주의하십시오. 포트를 "8547:8547" 대신 localhost에만("127.0.0.1:8547:8547") 게시하십시오. Docker로 게시된 포트는 기본적으로 ufw와 같은 호스트 방화벽을 우회합니다.

서비스 시작

# Start both services
docker-compose up -d

# View logs
docker-compose logs -f

최종 디렉터리 구조

rollup/
├── deployer/              # From previous step
│   └── .deployer/         # Contains genesis.json and rollup.json
└── sequencer/             # You are here
    ├── jwt.txt            # Generated JWT secret
    ├── genesis.json       # Copied from deployer
    ├── rollup.json        # Copied from deployer
    ├── .env               # Environment variables
    ├── docker-compose.yml # Docker configuration
    ├── opnode_discovery_db/ # Created by Docker
    ├── opnode_peerstore_db/ # Created by Docker
    └── op-reth-data/      # Created by Docker (op-reth database)

이제 sequencer node가 작동하며 트랜잭션을 처리할 준비가 되었습니다.

호환되는 최신 버전의 OP Stack 구성 요소를 사용하려면 항상 공식 릴리스 페이지를 확인하십시오.sequencer 배포에 필요한 주요 구성 요소는 다음과 같습니다.

op-node: 최신 op-node/v* 릴리스를 찾으십시오
op-reth: 최신 op-reth/v* 릴리스를 찾으십시오

두 구성 요소 모두 optimism 모노레포에 있습니다. op-node를 빌드하려면 Go와 just가 필요하고, op-reth를 빌드하려면 Rust 툴체인이 필요합니다(빌드 시 rust/rust-toolchain.toml에 고정된 버전이 자동으로 사용됩니다).소스에서 빌드하면 바이너리를 완전히 제어할 수 있습니다.

op-node 클론 및 빌드

# Clone the optimism monorepo
git clone https://github.com/ethereum-optimism/optimism.git
cd optimism

# Checkout the latest op-node release tag
git checkout op-node/v1.19.3

# Generate the embedded superchain config bundle (initializes the
# superchain-registry submodule; op-node embeds this file at compile time)
just build-superchain-go

# Build op-node
cd op-node
just

# Binary will be available at ./bin/op-node
cd ..

op-reth 빌드

# Still inside the optimism monorepo:
# checkout the latest op-reth release tag
git checkout op-reth/v2.4.0

# Sync the superchain-registry submodule to this tag
# (the op-reth build generates its chain configs from it)
just update-superchain-registry-submodule

# Build op-reth (release build; this can take a while)
cd rust
cargo build --release --bin op-reth

# Binary will be available at ./target/release/op-reth
cd ..

op-node와 op-reth는 같은 저장소에서 서로 다른 태그로 릴리스되므로, 두 빌드는 순서대로 서로 다른 태그를 체크아웃합니다. 아래의 --version 확인으로 실제로 빌드한 버전을 확인할 수 있습니다. 원한다면 모노레포를 두 개의 별도 클론으로 사용해도 됩니다.

설치 확인

필요한 구성 요소가 올바르게 설치되었는지 확인합니다.

# From the optimism monorepo root
./op-node/bin/op-node --version
./rust/target/release/op-reth --version

구성 설정

작업 공간 정리

바이너리를 빌드하고 나면 다음과 같은 디렉터리 구조가 됩니다.

rollup/
├── deployer/              # From previous step
│   └── .deployer/         # Contains genesis.json and rollup.json
└── optimism/              # Optimism monorepo
    ├── op-node/
    │   └── bin/
    │       └── op-node
    └── rust/
        └── target/
            └── release/
                └── op-reth

이제 sequencer 작업 디렉터리를 생성합니다.

cd ../
mkdir sequencer
cd sequencer

JWT secret 생성

openssl rand -hex 32 > jwt.txt
chmod 600 jwt.txt

디렉터리 구조 설정 및 파일 복사

mkdir scripts
cp ../deployer/.deployer/genesis.json .
cp ../deployer/.deployer/rollup.json .

환경 변수

구성을 생성하기 전에 몇 가지 정보를 수집해야 합니다.

L1 네트워크 접근 권한 확보

L1 네트워크(Ethereum mainnet 또는 Sepolia testnet)와 해당 beacon node에 대한 접근 권한이 필요합니다.L1 RPC URL 옵션:

Infura: infura.io
Alchemy: alchemy.com

L1 Beacon URL 옵션:

https://ethereum-sepolia-beacon-api.publicnode.com
https://ethereum-beacon-api.publicnode.com

지갑에서 개인 키 가져오기

이 기본 sequencer 설정에서는 op-node 초기화 시에만 개인 키가 필요합니다.

공인 IP 주소 확인

curl ifconfig.me
curl ipinfo.io/ip

포트 선택

8545: op-reth HTTP RPC
8546: op-reth WebSocket RPC
8551: op-reth Auth RPC(Engine API)
8547: op-node RPC
9222: P2P 네트워킹

.env 템플릿

L1_RPC_URL=https://sepolia.infura.io/v3/YOUR_ACTUAL_INFURA_KEY
L1_BEACON_URL=https://ethereum-sepolia-beacon-api.publicnode.com
SEQUENCER_ENABLED=true
SEQUENCER_STOPPED=false
PRIVATE_KEY=YOUR_ACTUAL_PRIVATE_KEY
P2P_LISTEN_PORT=9222
P2P_ADVERTISE_IP=YOUR_ACTUAL_PUBLIC_IP
OP_NODE_RPC_PORT=8547
OP_RETH_HTTP_PORT=8545
OP_RETH_WS_PORT=8546
OP_RETH_AUTH_PORT=8551
JWT_SECRET=./jwt.txt

sequencer 전용 구성

sequencer용 op-reth 구성

scripts/start-op-reth.sh를 생성합니다.

#!/bin/bash
source .env

../optimism/rust/target/release/op-reth node \
  --chain=./genesis.json \
  --datadir=./op-reth-data \
  --http \
  --http.addr=0.0.0.0 \
  --http.port=$OP_RETH_HTTP_PORT \
  --http.corsdomain="*" \
  --http.api=admin,debug,eth,net,txpool,web3 \
  --ws \
  --ws.addr=0.0.0.0 \
  --ws.port=$OP_RETH_WS_PORT \
  --ws.origins="*" \
  --ws.api=admin,debug,eth,net,txpool,web3 \
  --authrpc.addr=0.0.0.0 \
  --authrpc.port=$OP_RETH_AUTH_PORT \
  --authrpc.jwtsecret=$JWT_SECRET \
  --rollup.disable-tx-pool-gossip \
  --builder.deadline=2 \
  --builder.interval=100ms

op-reth는 처음 시작할 때 genesis 파일로부터 데이터베이스를 초기화하므로 geth init 같은 별도의 단계가 없습니다. 또한 기본적으로 아카이브 node로 실행됩니다.

sequencer용 op-node 구성

scripts/start-op-node.sh를 생성합니다.

#!/bin/bash
source .env

../optimism/op-node/bin/op-node \
  --l1=$L1_RPC_URL \
  --l1.beacon=$L1_BEACON_URL \
  --l2=http://localhost:$OP_RETH_AUTH_PORT \
  --l2.jwt-secret=$JWT_SECRET \
  --l2.enginekind=reth \
  --rollup.config=./rollup.json \
  --sequencer.enabled=$SEQUENCER_ENABLED \
  --sequencer.stopped=$SEQUENCER_STOPPED \
  --verifier.l1-confs=4 \
  --p2p.listen.ip=0.0.0.0 \
  --p2p.listen.tcp=$P2P_LISTEN_PORT \
  --p2p.listen.udp=$P2P_LISTEN_PORT \
  --p2p.advertise.ip=$P2P_ADVERTISE_IP \
  --p2p.advertise.tcp=$P2P_LISTEN_PORT \
  --p2p.advertise.udp=$P2P_LISTEN_PORT \
  --p2p.sequencer.key=$PRIVATE_KEY \
  --rpc.addr=0.0.0.0 \
  --rpc.port=$OP_NODE_RPC_PORT \
  --rpc.enable-admin \
  --log.level=info \
  --log.format=json

sequencer 시작하기

op-reth 시작

cd rollup/sequencer
chmod +x scripts/start-op-reth.sh
chmod +x scripts/start-op-node.sh
./scripts/start-op-reth.sh

op-node 시작

두 번째 터미널에서 다음을 실행합니다.

./scripts/start-op-node.sh

sequencer 실행 확인

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  http://localhost:8545

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"admin_sequencerActive","params":[],"id":1}' \
  http://localhost:8547

이제 sequencer node가 작동하며 트랜잭션을 처리할 준비가 되었습니다.

다음 단계

잘하셨습니다! sequencer가 실행되어 트랜잭션을 처리하고 있습니다. 다음 단계는 트랜잭션 데이터를 L1에 게시하는 batcher를 설정하는 것입니다.

batcher 실행하기 →

다음: 데이터 가용성을 위해 L2 트랜잭션 데이터를 L1에 게시하도록 op-batcher를 구성하고 시작합니다.

도움이 필요하신가요?

op-reth 실행: 실행 클라이언트 구성
op-reth CLI 레퍼런스: op-reth node 명령
모범 사례: 체인 운영자 모범 사례
지원: Optimism 모노레포에서 이슈를 보고하거나 질문하십시오

체인 출시

가이드

튜토리얼

도구

참조

아카이브

sequencer 실행하기

설정할 항목

소프트웨어 설치

구성 설정

sequencer 전용 구성

sequencer용 op-reth 구성

sequencer용 op-node 구성

sequencer 시작하기

다음 단계

batcher 실행하기 →

도움이 필요하신가요?

​설정할 항목

​소프트웨어 설치

​구성 설정

​sequencer 전용 구성

​sequencer용 op-reth 구성

​sequencer용 op-node 구성

​sequencer 시작하기

​다음 단계

batcher 실행하기 →

​도움이 필요하신가요?

설정할 항목

소프트웨어 설치

구성 설정

sequencer 전용 구성

sequencer용 op-reth 구성

sequencer용 op-node 구성

sequencer 시작하기

다음 단계

도움이 필요하신가요?