ERC-7546 업그레이드 가능한 클론 프록시 (Upgradeable Clone for Scalable Contracts)
Draft · 기타 · 2023-10-25 작성
함수별 구현 주소를 외부 사전(Dictionary) 컨트랙트에 등록해 두고 여러 프록시가 공유하게 하는 설계입니다. 프록시를 대량으로 복제하면서도 함수 단위로 한꺼번에 업그레이드할 수 있습니다.
왜 필요한가
이더리움 가상머신(EVM)에는 컨트랙트 하나의 코드 크기가 24.576kB로 제한되는 등 구조적 한계가 있고 배포한 뒤 발견되는 취약점을 고치려면 업그레이드 장치가 필요합니다. 그런데 기존 방식들은 각각 반쪽짜리였습니다. ERC-1167은 같은 로직의 복제본을 싸게 찍어낼 수 있지만 업그레이드가 안 됩니다. ERC-1822는 업그레이드가 되지만 복제본을 하나씩 따로 고쳐야 합니다. ERC-1967의 비컨(Beacon)은 복제본을 동시에 업그레이드할 수 있지만 구현 컨트랙트가 하나뿐이라 함수 단위 교체가 안 됩니다. ERC-2535 다이아몬드는 함수 단위 교체가 되지만 구현 주소 목록을 프록시 안에 두기 때문에 복제와 동시 업그레이드가 어렵습니다. 함수 단위 업그레이드와 팩토리 방식 복제를 동시에 지원하는 표준이 비어 있었고 이 제안이 그 자리를 채웁니다.
구현해야 하는 것
event DictionaryUpgraded(address dictionary);: 프록시가 바라보는 사전 컨트랙트 주소가 바뀔 때 발생시키는 이벤트입니다.event ImplementationUpgraded(bytes4 functionSelector, address implementation);: 사전에 등록된 함수 선택자와 구현 주소의 대응이 바뀔 때 발생시키는 이벤트입니다.function getImplementation(bytes4 functionSelector) external view returns(address implementation);: 함수 선택자를 받아 그 함수를 처리할 구현 컨트랙트 주소를 돌려줍니다. 사전 컨트랙트가 반드시 구현해야 합니다.function setImplementation(bytes4 functionSelector, address implementation) external;: 함수 선택자와 구현 컨트랙트 주소의 대응을 새로 등록하거나 갱신합니다.function supportsInterfaces() public view returns (bytes4[] memory);: 사전에 등록된 인터페이스 ID 목록을 돌려줍니다. 구현이 권장되는 함수입니다.
심층 설명
세 가지 컨트랙트로 역할 분리
EVM 계정의 구성 요소(nonce, 잔액, 코드, 스토리지)를 세 종류의 컨트랙트로 나눕니다. 프록시(Proxy) 컨트랙트는 계정의 상태(nonce, 잔액, 스토리지)를 보관하고 사전(Dictionary) 컨트랙트는 함수 선택자를 받아 알맞은 구현 컨트랙트로 라우팅하는 디스패처 역할을 하며 함수 구현(Function) 컨트랙트는 실제 실행 로직을 담습니다. 사전을 프록시 바깥으로 분리한 덕분에 팩토리로 복제하기 쉬워지고 동시 업그레이드가 가능해집니다.
프록시 컨트랙트 규칙
프록시는 사전 주소를 ERC-1967 방식에 따라 스토리지 슬롯 0x267691be3525af8a813d30db0c9e2bad08f63baecf6dceb85e2cf3676cff56f4(keccak256('erc7546.proxy.dictionary') 값에서 1을 뺀 값)에 저장해야 합니다(SHOULD). 사전 주소가 바뀌면 DictionaryUpgraded 이벤트를 발생시켜야 하고 CALL이나 STATICCALL로 들어오는 모든 호출에 대해 사전의 getImplementation으로 구현 주소를 받아 delegatecall해야 합니다(MUST). 또 사전에 등록된 선택자와 충돌하지 않도록 프록시 자신은 외부 함수를 정의하지 않아야 합니다(SHOULD NOT).
사전 컨트랙트 규칙
사전은 함수 선택자에서 구현 컨트랙트 주소로 가는 매핑을 반드시 유지해야 하고(MUST), getImplementation(bytes4)을 반드시 구현해야 합니다(MUST). 매핑을 바꾸거나 추가하는 setImplementation 구현과, 변경 시 ImplementationUpgraded 이벤트 발생은 권장 사항(SHOULD)입니다. 또 ERC-165의 supportsInterface(bytes4)와, 등록된 인터페이스 ID 목록을 돌려주는 supportsInterfaces() 구현이 권장됩니다(RECOMMENDED).
함수 구현 컨트랙트와 스토리지 관리
구현 컨트랙트는 자기 스토리지를 쓰지 않고 delegatecall을 통해 프록시의 스토리지에 저장해야 합니다(SHOULD). 여러 구현 컨트랙트가 프록시 하나의 스토리지 레이아웃을 공유하므로, 컴파일러 기본값처럼 슬롯 0부터 순서대로 할당하면 충돌이 날 수 있습니다. 충돌을 막기 위한 스토리지 관리는 필수(MUST)지만 아직 확정된 표준 기법이 없어 이 ERC는 구체적 방법을 정하지 않고 당시 가장 적절한 방법을 고르라고 권합니다. 예시로 ERC-7201 같은 레이아웃 패턴을 들고 있습니다. 또 구현 컨트랙트는 사전에 등록된 것과 같은 함수 선택자를 반드시 가져야 하며 등록 시 검증을 위해 ERC-165 supportsInterface 구현이 권장됩니다.
ERC-2535 다이아몬드와의 차이
두 표준 모두 함수 단위 업그레이드를 제공하지만 ERC-2535는 구현 컨트랙트(패싯)의 매핑을 프록시 자신 안에 보관하는 반면 이 ERC는 매핑을 외부 사전 컨트랙트에 둡니다. 매핑을 바깥으로 꺼낸 덕분에 프록시 복제가 쉬워지고 복제본들을 동시에 업그레이드할 수 있습니다. 이는 ERC-1967의 비컨 프록시와 비슷한 발상인데, 비컨이 컨트랙트 하나 단위로 구현을 갈아끼우는 것과 달리 이 표준은 함수 선택자 단위로 갈아끼웁니다.
언제 이 표준을 쓰는가
원문은 여섯 가지 경우를 구분합니다. 업그레이드도 팩토리도 필요 없으면 일반 배포, 팩토리만 필요하면 ERC-1167, 컨트랙트 단위 업그레이드만 필요하면 ERC-1822, 컨트랙트 단위 업그레이드와 팩토리가 함께 필요하면 ERC-1967의 비컨, 함수 단위 업그레이드만 필요하면 ERC-2535를 씁니다. 함수 단위 업그레이드와 팩토리가 둘 다 필요한 마지막 경우가 이 업그레이더블 클론 표준(UCS)의 자리입니다. 파운드리 프로젝트 형태의 참조 구현(Proxy.sol, Dictionary.sol)과 테스트도 함께 제공됩니다.
아직 초안 단계입니다
이 제안은 2023년 10월에 만들어졌고 현재 상태가 초안(Draft)입니다. 내용이 앞으로 바뀔 수 있으므로 구현하려면 원문의 최신 상태를 확인해야 합니다.
쓸 때 주의할 점
- 사전 관리자에 대한 신뢰: 모든 호출의 구현 결정을 사전 컨트랙트에 맡기는 구조이므로, 사전 관리자가 선의로 행동하고 부주의로 취약점을 넣지 않는다는 가정에 기댑니다. 신뢰할 수 없는 관리자의 사전에 프록시를 연결하면 안 되고 다른 관리자의 사전으로 갈아탈 수 있는 선택지를 제공하는 것이 권장됩니다. 사전 주소를 immutable이나 constant로 코드에 박아 넣을 수도 있지만 사전 관리자와 프록시 관리자가 다르면 구현을 바꿀 능력을 영구히 잃을 수 있어 신중한 설계가 필요합니다.
- 스토리지 충돌: 여러 함수 구현 컨트랙트가 프록시 하나의 스토리지를 공유하므로, 당시 가장 적절하다고 판단되는 스토리지 관리 기법을 써서 충돌을 예방해야 합니다.
- 함수 선택자 불일치: 사전에 등록된 선택자와 구현 컨트랙트가 실제로 가진 선택자가 어긋나면 실행이 실패합니다. 사전에 구현 주소를 등록하는 과정에서 그 구현이 해당 선택자(인터페이스)를 포함하는지 확인하는 것이 권장됩니다.
- DELEGATECALL로 프록시를 부르는 경우: 프록시는 CALL과 STATICCALL에 응답하도록 설계되어 있습니다. 다른 컨트랙트가 이 프록시에 DELEGATECALL을 하면 호출한 쪽의 스토리지 레이아웃이 기대와 다를 경우 의도한 결과가 나오지 않을 수 있습니다. 프록시 자체에 대한 직접적 위협은 아니지만 DELEGATECALL은 이 프록시와 상호작용하기에 부적합한 방식입니다.