ERC-7936 버전 선택형 프록시 인터페이스 (Versioned Proxy Contract Interface)

Review · 기타 · 2025-04-17 작성

프록시 컨트랙트에 여러 버전의 구현을 함께 등록해 두고, 호출자가 호출 시점에 원하는 버전을 직접 골라 쓸 수 있게 하는 표준입니다.

왜 필요한가

스마트 컨트랙트는 버그 수정이나 기능 추가를 위해 업그레이드가 필요하고 보통 프록시(proxy) 패턴으로 이를 처리합니다. 그런데 지금의 프록시 패턴은 모든 호출자를 최신 구현으로만 연결합니다. 새 버전에서 인터페이스가 바뀌면 기존에 연동해 둔 서비스가 깨질 수 있고 새 버전으로 천천히 옮겨 갈 표준적인 방법도 없습니다. 신뢰가 더 큰 문제입니다. 관리자 키나 거버넌스가 뚫려 악성 코드가 배포되더라도 사용자는 그 최신 구현을 쓰는 것 외에 선택지가 없고 컨트랙트 사용을 아예 그만두지 않는 한 해로운 업그레이드에서 빠져나올 수 없습니다. 결국 사용자는 관리자나 거버넌스를 영원히 믿어야 하며 감사를 거쳐 검증된 특정 버전만 골라서 믿을 방법이 없습니다. 이 표준은 이전 버전들을 계속 열어 두는 프록시 인터페이스로 이 문제를 풉니다.

구현해야 하는 것

심층 설명

버전 레지스트리와 필수 동작

프록시는 bytes32 버전 식별자를 구현 주소에 대응시키는 매핑을 반드시(MUST) 유지하고 버전을 지정하지 않은 호출에 쓸 기본 버전도 반드시 유지해야 합니다. 버전 등록과 기본 버전 변경 시에는 적절한 이벤트(VersionRegistered, DefaultVersionChanged)를 반드시 발생시켜야 합니다. 관리 함수는 registerVersion, removeVersion, setDefaultVersion이고 조회 함수로 getImplementation, getDefaultVersion, getVersions를 제공합니다. 버전 등록이나 기본 버전 설정 같은 관리 기능에는 접근 제어를 구현하는 것이 권장(SHOULD)됩니다.

executeAtVersion의 실행 규칙

executeAtVersion(bytes32 version, bytes calldata data)가 호출되면 프록시는 지정된 버전이 존재하는지 확인하고 해당 구현으로 호출을 전달한 뒤, 구현이 돌려준 데이터를 그대로 반환해야 합니다(MUST). 이 함수는 payable로 선언되어 있습니다. 버전 선택을 호출 데이터에 끼워 넣지 않고 별도 함수로 둔 것은, 버전 선택과 함수 호출을 깔끔히 분리하고 기존 함수 시그니처를 고치지 않으며 어떤 버전을 썼는지 명시적으로 감사할 수 있게 하기 위해서입니다.

폴백 함수와 기존 호환성

프록시는 버전이 지정되지 않은 호출을 기본 버전 구현으로 전달하는 폴백(fallback) 함수를 구현하는 것이 권장(SHOULD)됩니다. 이 덕분에 전통적인 프록시 패턴과의 호환이 유지되어 프록시와 상호작용하던 기존 컨트랙트는 수정 없이 계속 쓸 수 있습니다. 원문은 이 표준이 기존 이더리움 표준이나 구현과의 비호환을 만들지 않으며 오히려 스마트 컨트랙트의 하위 호환성을 강화하기 위한 설계라고 설명합니다. 또한 기존 도구와의 호환을 위해 EIP-1967 저장 슬롯을 구현할 수도(MAY) 있습니다.

버전 식별자를 bytes32로 정한 이유

버전 식별자는 시맨틱 버저닝 문자열이 아니라 bytes32로 정의됩니다. 이유는 네 가지입니다. 버저닝 방식 선택에 유연성을 주고 저장과 비교에 드는 가스 비용을 줄이며 문자열 기반 버전(bytes32로 변환)과 숫자 버전을 모두 허용하고 SHA-1이나 SHA-256 형태의 Git 커밋 식별자도 담을 수 있게 하기 위해서입니다. 주석의 예시처럼 "1.0.0" 같은 문자열을 변환해 쓰는 것도 가능합니다.

레지스트리 패턴을 고른 이유

설계 과정에서 두 가지 대안이 검토되었습니다. 첫째, 버전마다 프록시를 따로 두는 방식은 배포 비용과 복잡성이 커집니다. 둘째, 저장소에 현재 버전 하나만 두는 방식은 서로 다른 호출자가 서로 다른 버전을 동시에 쓰는 것을 허용하지 못합니다. 하나의 프록시 안에 버전과 구현 주소의 레지스트리를 두는 방식은 이 두 문제를 피하면서 기본 버전 메커니즘으로 전통적인 프록시 패턴과의 호환성도 유지합니다.

악성 업그레이드에 대한 선택권

전통적인 프록시에서는 업그레이드가 악성이어도 모든 사용자가 최신 구현에 노출됩니다. 이 표준에서는 사용자가 자신이 검증해 신뢰하는 버전에 머물 수 있으므로, 관리자 키 탈취나 거버넌스 과정의 문제로 해로운 코드가 배포되는 위험을 완화할 수 있습니다. 원문의 Security Considerations는 이 표준이 널리 쓰이는 프록시 패턴의 보안을 크게 개선하기 위한 것이라고 밝히며 그 외의 구체적인 주의 사항은 적지 않았습니다.

제안 상태 참고

이 문서의 상태는 Review입니다. 아직 검토 중인 제안이므로 인터페이스와 세부 요구 사항이 앞으로 바뀔 수 있습니다.

ERC 원문 · ← ERCs