Upgrade 20

​

Upgrade 20이 필요한 이유

​

포함 내용

​

Super Root Dispute Game

• SUPER_PERMISSIONED(game type 5): permissioned 결함 증명을 사용하는 체인용입니다.
• SUPER_CANNON_KONA(game type 9): permissionless 결함 증명을 사용하는 체인용입니다.

​

SystemConfig 인터페이스 정리

​

호환성을 깨는 변경 사항

​

체인 운영자

• 컨트랙트 전환 시점에 op-proposer를 새로운 Super Root RPC와 game type으로 전환합니다.
• op_proposer_default_refs_number{layer="l2"}를 사용하는 op-proposer 대시보드와 알림을 op_proposer_default_proposed_sequence_number로 업데이트합니다.
• 이미 진행 중인 게임을 완료하는 데 필요한 구성은 유지하면서, op-challenger와 op-dispute-mon이 Super Root Dispute Game을 지원하도록 구성합니다.
• permissionless 결함 증명의 경우, 전환 전에 검토된 kona-client Interop variant prestate를 준비해 둡니다.
• 제거된 SystemConfig 함수를 호출하는 운영 도구를 업데이트합니다.

​

노드 운영자

​

앱 개발자 및 인프라 통합 업체

• SystemConfig.batchInbox() 또는 SystemConfig.setGasConfig(uint256,uint256)를 호출하는 경우
• FEE_SCALARS ConfigUpdate 이벤트의 첫 번째 word를 현재 overhead() 값으로 디코딩하는 경우
• SystemConfig.overhead()를 읽고 레거시 값이 변경되지 않을 것으로 기대하는 경우
• Dispute Game root claim을 직접 읽고 해당 claim이 Output Root라고 가정하는 경우
• OP Stack SDK를 사용하여 L2에서 L1으로의 출금을 확인, 증명 또는 최종 확정하는 경우

​

사용자

​

OP Stack 구성 요소 준비

​

업데이트 순서

• op-challenger와 op-dispute-mon은 L1 컨트랙트 전환 이전에 업데이트합니다. 첫 번째 Super Root Dispute Game이 생성될 때 두 서비스 모두 Super Root 구성이 적용되어 있어야 합니다.
• op-proposer는 전환 시점에 또는 전환 직후에 전환합니다. proposer는 컨트랙트가 업그레이드되기 전까지 새 game type에 대해 제안할 수 없으며, 전환 시점부터 proposer가 전환될 때까지 제안 오류를 기록하므로 의도적으로 공백을 두지 마세요.

​

SystemConfig 통합 업데이트

• batch inbox 주소는 체인의 롤업 구성 또는 Superchain Registry의 해당 항목에서 읽습니다.
• base fee 및 blob base fee scalar의 경우 setGasConfig(uint256,uint256) 호출을 setGasConfigEcotone(uint32,uint32)로 교체합니다.
• FEE_SCALARS ConfigUpdate 이벤트를 디코딩하는 경우, 첫 번째 word를 overhead()가 반환하는 현재 값이 아니라 0으로 처리합니다.
• overhead()를 읽는 경우 0을 예상해야 합니다. 업그레이드 시 모든 레거시 값이 지워집니다.

​

출금 도구 업데이트

const receipt = await publicClientL2.getTransactionReceipt({
  hash: withdrawalHash
});
const withdrawalBlock = await publicClientL2.getBlock({
  blockNumber: receipt.blockNumber
});

const { game, withdrawal } = await publicClientL1.waitToProve({
  receipt,
  l2Timestamp: withdrawalBlock.timestamp,
  targetChain: publicClientL2.chain
});

const proveArgs = await publicClientL2.buildProveWithdrawal({
  game,
  withdrawal
});

​

absolute prestate 찾기 또는 빌드

0x031ac6f15c19010da258f5cb633ef6ca9318c2d0f244bea6b2045ce6b790e1df

just reproducible-prestate-kona
jq -r .pre rust/kona/prestate-artifacts-cannon-interop/prestate-proof.json

cd rust
KONA_CUSTOM_CONFIGS_DIR=/absolute/path/to/custom-configs \
  just build-kona-reproducible-prestate-variant \
  kona-client-int prestate-artifacts-cannon-interop
jq -r .pre kona/prestate-artifacts-cannon-interop/prestate-proof.json

https://storage.googleapis.com/oplabs-network-data/proofs/kona/cannon/0x031ac6f15c19010da258f5cb633ef6ca9318c2d0f244bea6b2045ce6b790e1df.bin.gz

OP_CHALLENGER_GAME_TYPES="cannon-kona,permissioned,super-cannon-kona"
# or
--game-types=cannon-kona,permissioned,super-cannon-kona

--prestates-url=<PRESTATES_URL>

--cannon-kona-prestates-url=<CANNON_KONA_PRESTATES_URL>

--superroot-rpc=<SUPER_ROOT_RPC>
--cannon-kona-depset-config=/path/to/depset.json   # only if --network is not set

OP_CHALLENGER_CANNON_KONA_SERVER=/path/to/kona-host
# or
--cannon-kona-server=/path/to/kona-host

​

업그레이드 일정

​

준비 상태 확인

• op-proposer, op-challenger, op-dispute-mon이 준비된 Super Root 구성으로 시작되고, 구성된 Super Root RPC에 접근할 수 있는지 확인합니다.
• permissionless 체인에서는 kona-client Interop variant prestate를 재현하고, 해당 해시가 검토된 Upgrade 20 값과 일치하는지 확인합니다.
• 이 공지에 나열된 모든 직접 SystemConfig 호출과 모든 출금 또는 Dispute Game 코드 경로를 다루는 통합 테스트를 실행합니다.