메인 콘텐츠로 건너뛰기
이 가이드는 OP Stack의 Layer 1 컨트랙트를 op-contracts/v1.3.0에서 op-contracts/v1.8.0으로 업그레이드하는 구체적인 방법을 안내합니다. 이 업그레이드에는 시스템 구성에 대한 중요한 변경 사항이 포함되며 Fault Proof System이 도입됩니다.

Holocene 업그레이드 개요

Holocene 업그레이드는 프로토콜 업그레이드입니다. 자세한 내용은 Holocene 공지 페이지에서 확인하십시오. 이 가이드는 OP Stack 체인을 L2 Output Oracle System에서 Holocene 업그레이드와 연관된 허가형(permissioned) Fault Proof System 컨트랙트 버전으로 전환하는 방법을 보여 줍니다. OP Stack 컨트랙트 v1.8.0으로 업그레이드하고 허가형 결함 증명(fault proof)을 활성화하면, L1에서 생성된 대기 중인(최종 확정되지 않은) 모든 출금 증명이 무효화됩니다. 즉, 업그레이드 후 사용자가 출금을 수동으로 다시 증명해야 하며, 이 과정은 자동으로 이루어지지 않습니다.

구성 파일 형식 맞추기

체인의 deployments.json과 deploy-config.json이 필요합니다. 두 파일 모두 아래 예시에 표시된 정확한 필드 이름을 사용하여 올바른 형식으로 작성되어 있는지 확인하고, 모든 값(특히 관련 값)을 해당 체인에 맞게 업데이트하십시오. deployments.json:
deploy-config.json:
superchain-registry와 온체인 데이터를 교차 확인하여 중요한 주소(ProxyAdmin, ProxyAdminOwner, 모든 L1 주소, L2OO 등)가 실제로 최신 상태인지 확인하십시오(특히 deployments.json의 경우 op-fetcher를 사용하면 쉽게 확인할 수 있습니다).

단계별 업그레이드 과정

1. 작업 디렉터리 생성

작업 디렉터리를 생성합니다.
그런 다음 outputs 디렉터리를 생성합니다.

2. 구성 파일 복사

deployments.json과 deploy-config.json을 작업 디렉터리에 복사합니다.

3. 환경 구성 및 배포

필요한 정보로 .env 파일을 생성하고 업데이트합니다.

4. 배포 프로세스 실행

다음 명령으로 배포 프로세스를 실행합니다.
kfoplabs/upgrade-v1.3.0-v1.8.0-permissioned 이미지의 소스 코드는 Optimism 모노레포의 perm/op-contracts/v1.8.0 브랜치에서 확인할 수 있습니다. 업그레이드 스크립트를 포크하거나 사용자 지정해야 하는 경우(예: L3 지원) 해당 브랜치에서 시작하십시오.

5. 출력 확인

배포 결과로 네 개의 파일이 출력되어야 합니다.
  • deploy.log는 배포 과정의 로그입니다
  • deployments.json에는 새로 배포된 컨트랙트 주소가 포함됩니다
  • bundle.json은 safe 트랜잭션 번들입니다
  • transactions.json은 실행된 배포 트랜잭션의 요약입니다
  • standard-addresses.json은 SystemConfigImpl, OptimismPortal2Impl, L1CrossDomainMessengerImpl, L1StandardBridgeImpl, L1ERC721BridgeImpl, OptimismMintableERC20FactoryImpl의 주소입니다
  • validation.txt는 Tenderly 상태 diff 검증에 사용됩니다. superchain-ops task에 필요한 일부 정보가 이 파일에 누락되어 있을 수 있으며, 이 정보는 대신 Tenderly 시뮬레이션 중에 생성됩니다.

6. 출력 검증

이제 L1 컨트랙트 업그레이드를 수행하기 위해 온체인에서 실행할 수 있는 calldata가 준비되었습니다. 이 업그레이드를 시뮬레이션하여 변경 사항이 예상대로인지 확인해야 합니다. 예상되는 변경 사항은 superchain-ops 저장소에 있는 이전에 실행된 업그레이드 task의 검증 파일을 참고하십시오. 상태 변경이 예상대로라고 확신하면 업그레이드에 서명하고 실행할 수 있습니다.

추가 자료