ERC-7760 최소 업그레이드 프록시 (Minimal Upgradeable Proxies)

Draft · 기타 · 2024-08-19 작성

업그레이드 가능한 프록시 컨트랙트의 바이트코드를 최소 형태로 표준화합니다. 투명, UUPS, 비컨 세 패턴을 다루고 불변 인자 첨부와 온체인 구현 주소 조회를 지원합니다.

왜 필요한가

이더리움에서 컨트랙트를 나중에 고칠 수 있게 하려면 프록시(proxy)라는 중계 컨트랙트를 앞에 세우고 실제 로직은 뒤의 구현 컨트랙트에 두는 방식을 많이 씁니다. 그런데 프록시의 바이트코드가 프로젝트마다 제각각이면 블록 익스플로러가 이 컨트랙트가 어떤 프록시인지 자동으로 알아보고 검증하기 어렵습니다. 다른 컨트랙트가 프록시의 구현 주소를 온체인에서 믿을 수 있게 확인할 방법도 마땅치 않고 배포 시 넣어 둔 고정 값(불변 인자)이 어디에 저장되는지도 구현마다 달라 조회하기 어렵습니다. 바이트코드가 불필요하게 크면 배포 비용과 호출 때마다 드는 실행 비용도 늘어납니다. 이 표준은 업그레이드 가능한 프록시의 바이트코드를 최소 형태로 못 박아 이런 문제를 한꺼번에 풀려고 합니다.

심층 설명

세 가지 패턴과 ERC-1967 슬롯

이 표준은 ERC-1967 프록시의 최소 바이트코드를 투명(transparent), UUPS, 비컨(beacon) 세 패턴으로 정의합니다. 모든 패턴은 구현 주소를 ERC-1967 구현 슬롯 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc에 둡니다. 업그레이드 로직이 없는 UUPS와 비컨 프록시는 초기화 코드가 반드시 이 슬롯에 구현 주소를 저장해야 합니다. 초기화 때 ERC-1967 이벤트 발생은 선택 사항이며 인덱서는 초기화 코드가 이벤트를 낸다고 기대해서는 안 됩니다. 넓은 EVM 호환성을 위해 PUSH0 명령어는 일부러 쓰지 않았고 최소 바이트코드 크기보다 최소 실행 가스를 먼저 최적화했습니다.

투명 프록시의 업그레이드 방식

투명 프록시는 업그레이드 권한을 가진 팩토리 주소를 런타임 바이트코드에 직접 새깁니다. 호출 때마다 스토리지를 읽는 SLOAD 한 번을 아끼기 위해서입니다. 팩토리가 업그레이드할 때는 새 구현 주소를 32바이트로 늘린 값, ERC-1967 구현 슬롯, 그리고 설정 후 구현에 delegatecall로 넘길 선택적 calldata를 이어 붙여 프록시를 호출합니다. 업그레이드 로직은 임의의 32바이트 슬롯에 임의의 32바이트 값을 쓸 수 있는데, 이는 유연성과 바이트코드 간결성을 위한 것이며 구현 컨트랙트도 어차피 모든 슬롯을 고칠 수 있으므로 보안을 잃지 않습니다. 업그레이드 로직은 ERC-1967 이벤트를 내지 않으므로 인덱서는 이벤트에 의존하면 안 됩니다. 팩토리에 권한 교체 같은 맞춤 인증 로직을 둘 수 있어 유연성도 유지됩니다.

I-변형과 온체인 구현 주소 검증

I-변형은 구현 주소를 돌려주는 로직이 바이트코드에 들어 있는 변형입니다. 길이가 1바이트인 calldata로 호출하면 calldata를 구현에 넘기지 않고 왼쪽을 0으로 채운 32바이트 구현 주소를 반환합니다. 1바이트를 고른 이유는 일반 ETH 전송은 0바이트, 일반 Solidity 함수 호출은 4바이트 이상의 calldata를 쓰므로 충돌을 피할 수 있기 때문입니다. 반환값을 믿으려면 바이트코드를 검증해야 합니다. EXTCODECOPY로 불변 인자 앞부분의 바이트코드를 가져오고 안에 새겨진 팩토리 주소를 0으로 지운 뒤, 해시가 기대한 값과 일치하는지 확인합니다. 해시가 다르면 반환된 구현 주소를 신뢰해서는 안 됩니다.

불변 인자 처리

모든 프록시는 런타임 바이트코드 끝에 선택적으로 데이터(불변 인자)를 붙일 수 있습니다. 표준 바이트코드 뒤의 같은 오프셋에 저장되므로 온체인에서 위치를 알고 조회할 수 있습니다. 다만 이 인자는 구현으로 전달되는 calldata에 덧붙이지 않습니다. calldata 끝에 추가 데이터를 붙이는 다른 ERC 표준들과의 호환성 문제와 안전성 문제를 피하기 위해서입니다. 불변 인자가 필요하면 EXTCODECOPY 명령어로 바이트코드에서 직접 읽어 옵니다. 참조 구현에서는 전체 길이가 0xffff를 넘으면 배포가 거부됩니다.

14바이트 팩토리 주소 하위 변형

투명 프록시에는 팩토리 주소를 20바이트 그대로 새기는 변형과 14바이트로 줄여 새기는 변형이 있습니다. 14바이트 변형은 앞 6바이트가 0인 주소(vanity address)에 팩토리를 배포했을 때 쓸 수 있고 그만큼 프록시 바이트코드가 짧아집니다. 14바이트는 주소 채굴 비용과 바이트코드 크기 사이의 균형점으로 선택되었습니다. 참조 구현은 팩토리 주소의 상위 비트가 0인지 보고 두 변형 중 하나를 자동으로 고릅니다.

범위 밖 주제와 최소성 원칙

프록시 배포용 팩토리, I-변형의 구현 주소를 읽고 검증하는 로직, 비컨 프록시가 바라보는 비컨 자체는 맞춤 로직이 들어갈 수 있어 이 표준의 범위 밖입니다. 다만 보안과 정확성을 위해 신중한 구현이 필요하다고 명시합니다. 초기화 코드도 고정하지 않는데, UUPS와 비컨처럼 필요한 경우 ERC-1967 슬롯만 초기화하면 되기 때문입니다. 바이트코드는 손으로 만든 EVM 코드라 더 최적화될 여지가 있지만 이미 실전에서 쓰인 변형은 블록 익스플로러 자동 검증의 이점이 소량의 가스 절감보다 크므로 기존 배치를 유지하는 쪽을 선호합니다.

표준 상태

이 제안은 현재 Draft(초안) 상태입니다. 내용이 아직 바뀔 수 있으므로 바이트코드와 규칙이 확정된 것으로 보기 전에 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs