Base V1 업그레이드

Base 노드를 V1용 base-reth-node와 base-consensus로 마이그레이션하는 방법을 안내합니다.

Base V1은 Base에 Osaka 기능과 TEE/ZK 증명 시스템을 도입하는 업그레이드입니다. Base 네이티브 클라이언트로 마이그레이션이 필요합니다.

base-reth-node (EL)와 base-consensus (CL)만 V1을 지원합니다. op-node, op-geth, op-reth, nethermind, 또는 kona를 실행하는 노드는 네트워크 업그레이드를 지원하지 않으므로 활성화 전에 마이그레이션해야 합니다.

포함된 내용에 대한 전체 세부 사항은 V1 사양을 참조하세요.

활성화 일정

네트워크	날짜	타임스탬프
Sepolia	2026년 4월 20일 18:00 UTC	1776708000
메인넷	2026년 5월 초	TBD

필요한 소프트웨어

레이어	소프트웨어	버전
실행 (EL)	base-reth-node	v0.7.0+
합의 (CL)	base-consensus	v0.7.0+

두 클라이언트 모두 base/node 저장소에서 사용할 수 있으며, 대부분의 설정이 사전 구성되어 있고 환경 변수를 통해 재정의할 수 있습니다. 설정 가능한 옵션의 전체 목록은 .env.mainnet 및 .env.sepolia 파일을 참조하세요.

base/base 저장소에서 직접 빌드하는 경우 새 BASE_NODE_* 환경 변수를 사용하도록 base-consensus 설정을 업데이트해야 합니다. base-reth-node의 경우 기존의 모든 Reth 도구 및 설정을 계속 사용할 수 있습니다.

실행 레이어 마이그레이션

OP Reth에서 마이그레이션

base/node를 통해 OP Reth를 이미 실행 중인 경우 최신 버전으로 업데이트하면 노드가 자동으로 base-reth-node를 사용합니다. 기존 ./reth-data 디렉토리가 완전히 호환됩니다 — 재동기화나 스냅샷 복원이 필요하지 않습니다.

1. 노드 중지:

   docker compose down
   

2. base/node의 최신 버전으로 업데이트:

   git pull origin main
   

3. 노드 시작:

   docker compose up
   

4. 클라이언트 버전 확인: web3_clientVersion에 버전 문자열에 base가 포함되어야 합니다 (예: reth/v1.11.3-.../base/v0.7.0)

다른 클라이언트에서 마이그레이션

op-geth와 nethermind는 더 이상 지원되지 않습니다. base-reth-node로 새로 시작해야 합니다.

1. 노드 중지:

   docker compose down
   

2. base/node의 최신 버전으로 업데이트:

   git pull origin main
   

3. 기존 데이터 디렉토리(예: ./geth-data 또는 ./nethermind-data)를 삭제합니다.

4. .env.mainnet 또는 .env.sepolia 파일을 편집하여 원하는 설정에 맞게 조정합니다.

5. 전체 동기화를 피하기 위해 Reth 스냅샷에서 부트스트랩합니다.

6. 노드 시작:

   docker compose up
   

합의 레이어 마이그레이션

환경 변수를 업데이트하여 op-node를 base-consensus로 교체합니다.

1. .env 파일에서 USE_BASE_CONSENSUS=true를 설정합니다.

2. 새 BASE_NODE_* 환경 변수로 .env 파일을 업데이트합니다(아래 표 참조).

3. 노드 재시작:

   docker compose up
   

4. 확인:

   • 합의 로그 확인: docker compose logs -f node
   • 동기화 상태 확인: optimism_syncStatus가 계속 작동하는지 확인

환경 변수 매핑

base/node를 사용하는 경우 대부분의 변수가 이미 .env.mainnet 및 .env.sepolia에 설정되어 있습니다. base/base에서 빌드하는 경우 아래 표를 사용하여 op-node 환경 변수를 base-consensus로 매핑하세요. 대부분은 선택 사항입니다. 전체 목록은 base-consensus node --help를 실행하세요.

op-node	base-consensus
OP_NODE_NETWORK	BASE_NODE_NETWORK
OP_NODE_ROLLUP_CONFIG	BASE_NODE_ROLLUP_CONFIG
—	BASE_NODE_LOG_VERBOSITY
—	BASE_NODE_LOG_FORMAT
OP_NODE_L1_ETH_RPC	BASE_NODE_L1_ETH_RPC
OP_NODE_L1_BEACON	BASE_NODE_L1_BEACON
OP_NODE_L1_TRUST_RPC	BASE_NODE_L1_TRUST_RPC
OP_NODE_L2_ENGINE_RPC	BASE_NODE_L2_ENGINE_RPC
OP_NODE_L2_ENGINE_AUTH	BASE_NODE_L2_ENGINE_AUTH
—	BASE_NODE_L2_ENGINE_AUTH_ENCODED
OP_NODE_P2P_BOOTNODES	BASE_NODE_P2P_BOOTNODES
OP_NODE_P2P_LISTEN_IP	BASE_NODE_P2P_LISTEN_IP
OP_NODE_P2P_LISTEN_TCP_PORT	BASE_NODE_P2P_LISTEN_TCP_PORT
OP_NODE_P2P_LISTEN_UDP_PORT	BASE_NODE_P2P_LISTEN_UDP_PORT
OP_NODE_P2P_ADVERTISE_IP	BASE_NODE_P2P_ADVERTISE_IP
OP_NODE_P2P_ADVERTISE_TCP	BASE_NODE_P2P_ADVERTISE_TCP_PORT
OP_NODE_P2P_ADVERTISE_UDP	BASE_NODE_P2P_ADVERTISE_UDP_PORT
OP_NODE_P2P_PRIV_PATH	BASE_NODE_P2P_PRIV_PATH
OP_NODE_P2P_PEER_SCORING	BASE_NODE_P2P_SCORING
OP_NODE_P2P_PEER_BANNING	BASE_NODE_P2P_BAN_PEERS
OP_NODE_P2P_PEER_BANNING_THRESHOLD	BASE_NODE_P2P_BAN_THRESHOLD
OP_NODE_P2P_PEER_BANNING_DURATION	BASE_NODE_P2P_BAN_DURATION
OP_NODE_METRICS_ENABLED	BASE_NODE_METRICS_ENABLED
OP_NODE_METRICS_ADDR	BASE_NODE_METRICS_ADDR
OP_NODE_METRICS_PORT	BASE_NODE_METRICS_PORT
OP_NODE_RPC_ADDR	BASE_NODE_RPC_ADDR
OP_NODE_RPC_PORT	BASE_NODE_RPC_PORT
OP_NODE_RPC_ENABLE_ADMIN	BASE_NODE_RPC_ENABLE_ADMIN
OP_NODE_RPC_ADMIN_STATE	BASE_NODE_RPC_ADMIN_STATE
OP_NODE_SAFEDB_PATH	BASE_NODE_SAFEDB_PATH
OP_NODE_SYNCMODE	—
OP_NODE_VERIFIER_L1_CONFS	—
OP_NODE_L2_ENGINE_KIND	—
OP_NODE_L1_RPC_KIND	—
OP_NODE_L1_BEACON_FETCH_ALL_SIDECARS	—
OP_NODE_L1_BEACON_FALLBACKS	—
OP_NODE_ROLLUP_LOAD_PROTOCOL_VERSIONS	—
OP_NODE_P2P_STATIC	—
OP_NODE_P2P_DISABLE	—
OP_NODE_P2P_NAT	—

FAQ

• 재동기화가 필요한가요? OP Reth를 이미 실행 중인 경우 필요하지 않습니다. 기존 데이터가 호환됩니다.
• op-geth 또는 nethermind를 사용 중이라면? base-reth-node로 전환해야 합니다. Reth 스냅샷을 사용하여 부트스트랩하세요.
• OP 네임스페이스 RPC가 여전히 작동하나요? 예, 모든 기존 RPC가 지원됩니다.