ERC-7511 PUSH0 최소 프록시 컨트랙트 (Minimal Proxy Contract with PUSH0)
Draft · 기타 · 2023-09-04 작성
상하이 업그레이드에서 추가된 PUSH0 명령어로 기존 최소 프록시 컨트랙트(ERC-1167)를 최적화한 표준입니다. 기능은 똑같이 유지하면서 배포 가스 200, 실행 가스 5를 아낍니다.
왜 필요한가
같은 로직의 컨트랙트를 여러 개 만들 때는 코드를 통째로 복사해 배포하는 대신, 호출을 원본(구현 컨트랙트)에 그대로 넘겨 주는 아주 작은 대리 컨트랙트인 최소 프록시(Minimal Proxy, ERC-1167)를 쓰는 방법이 있습니다. 그런데 기존 최소 프록시 코드는 상하이(Shanghai) 업그레이드로 새로 생긴 PUSH0 명령어가 없던 시절에 설계되었습니다. 그래서 스택에 0을 올리기 위해 값을 복제하는 DUP(개당 3가스)나 자리를 바꾸는 SWAP 같은 우회 명령을 쓰고 그만큼 코드가 1바이트 더 길고 실행 가스도 더 듭니다. 이 표준은 PUSH0(개당 2가스)를 써서 프록시 코드를 처음부터 다시 설계해 코드 길이와 가스를 줄이고 읽기도 더 쉽게 만듭니다.
구현해야 하는 것
function clone0(address impl) public payable returns (address addr): 구현 컨트랙트 주소를 받아 PUSH0 최소 프록시(clone0)를 배포하고 그 주소를 돌려줍니다. 배포에 실패하면 FailedCreateClone 오류로 되돌립니다.
심층 설명
런타임 코드 명세
표준 런타임 코드는 365f5f375f5f365f73bebe...be5af43d5f5f3e5f3d91602a57fd5bf3이고 길이는 정확히 44바이트입니다. 이 중 인덱스 9부터 28까지(포함) 20바이트 자리에 마스터 구현 컨트랙트의 주소를 넣습니다. 0xbebe...는 그 자리를 표시하는 자리표시자입니다. 기존 ERC-1167 런타임 코드보다 1바이트 짧으며 RETURNDATASIZE와 DUP로 0을 만들던 자리를 PUSH0으로 바꿔 코드 가독성도 높였습니다.
최소 생성 코드
배포에 쓰는 최소 생성 코드는 602c8060095f395ff3 뒤에 런타임 코드 44바이트를 붙인 총 53바이트입니다. 앞의 9바이트 602c8060095f395ff3이 초기화 코드(initcode)로, 뒤따르는 런타임 코드를 메모리에 복사해 컨트랙트 코드로 반환하는 역할을 합니다. 나머지 44바이트가 실제 프록시의 런타임 코드가 됩니다.
동작 구조 네 단계
프록시의 핵심 동작은 네 단계입니다. 1단계는 CALLDATACOPY로 호출 데이터를 복사하는 것으로, 인자 [0, 0, cds](cds는 호출 데이터 크기)를 PUSH0 두 개와 CALLDATASIZE로 만듭니다. 2단계는 DELEGATECALL로, 인자 [gas, 주소, 0, cds, 0, 0]을 쌓고 실행해 성공 여부 suc를 받습니다. 3단계는 RETURNDATACOPY로 반환 데이터를 복사합니다. 4단계는 suc에 따라 분기하는데, 옵코드에는 if/else가 없으므로 JUMPI와 JUMPDEST를 씁니다. JUMPI의 목적지는 0x2a이고, 성공하면 JUMPDEST를 거쳐 RETURN, 실패하면 REVERT를 실행합니다. REVERT와 RETURN의 인자 [0, rds]는 JUMPI 전에 한 번만 준비해 중복을 피합니다.
SWAP2가 하나 남는 이유
4단계에서 SWAP2 연산 하나는 제거할 수 없습니다. 반환 데이터 크기 rds는 DELEGATECALL이 끝난 뒤에만 얻을 수 있어서 먼저 쌓인 suc와 나중에 쌓인 [0, rds]의 순서를 SWAP2로 [suc, 0, rds]로 바꿔야 JUMPI와 RETURN·REVERT 인자가 맞기 때문입니다. 대신 기존 코드에 있던 불필요한 SWAP 하나를 없애 코드를 1바이트 줄였습니다.
절감 효과와 Solidity 배포
DUP 두 개(각 3가스)를 PUSH0 두 개(각 2가스)로 바꾸고 코드를 1바이트 줄인 결과, 배포 시 200가스, 실행 시 5가스를 아낍니다. 원문은 create 명령으로 배포하는 Clone0Factory 예시 컨트랙트를 제시합니다. clone0 함수는 생성 코드의 앞 18바이트와 뒤 15바이트 사이에 구현 주소를 끼워 전체 생성 코드를 조립한 뒤 create로 배포하고 주소가 0이면 FailedCreateClone 오류를 냅니다. PUSH0이 필요하므로 Solidity 0.8.20 초과 버전과 상하이 이후 EVM 버전이 필요합니다.
하위 호환성
PUSH0 명령어(EIP-3855)를 쓰기 때문에 이 프록시는 상하이 업그레이드 이후에만 배포할 수 있습니다. 배포된 뒤의 동작은 기존 최소 프록시(ERC-1167)와 완전히 동일합니다.
제안 상태
이 문서는 아직 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있는 제안이라는 점을 감안해야 합니다.
쓸 때 주의할 점
- 업그레이드 불가: 최소 프록시는 로직을 구현(implementation) 컨트랙트에 위임하는데, 이 연결은 배포 시점에 고정됩니다. 생성 후에는 어떤 구현을 가리킬지 바꿀 수 없습니다.
- 초기화 주의: 프록시 컨트랙트에는 생성자가 없으므로 배포 후 초기화 함수를 호출해야 합니다. 이 단계를 빠뜨리면 컨트랙트가 안전하지 않은 상태로 남을 수 있습니다.
- 로직 컨트랙트의 안전성: 로직 컨트랙트에 취약점이 있으면 그것을 가리키는 모든 프록시 컨트랙트가 함께 영향을 받습니다.
- 투명성 문제: 구조가 복잡해서 사용자는 프록시를 빈 컨트랙트로 오해할 수 있고 실제 로직 컨트랙트를 추적하기 어려울 수도 있습니다.