ERC-8349 인덱스 기반 멀티파셋 프록시 (Index-Based Multi-Facet Proxy)
Draft · 기타 · 2026-07-25 작성
여러 구현 모듈(파셋)을 한 주소로 묶는 모듈형 프록시에서, 함수 선택자 대신 calldata 끝에 붙인 1바이트 라우팅 인덱스로 어떤 파셋이 실행될지 직접 식별하게 하는 표준입니다.
왜 필요한가
여러 컨트랙트(파셋)를 하나의 주소로 묶는 모듈형 프록시 표준인 ERC-2535(Diamond)는 각 함수를 식별하는 4바이트 함수 선택자를 라우팅 식별자로도 함께 사용합니다. 그런데 함수 선택자는 원래 지갑, 블록 익스플로러, SDK 같은 외부 도구와의 호환성을 위한 식별자이지, 어떤 파셋이 실행돼야 하는지를 가리키는 값은 아닙니다. 이 둘을 하나로 묶어 쓰다 보면 프로토콜이 커질수록 라우팅 메타데이터가 파셋 수가 아니라 외부에 노출된 함수 수에 비례해 늘어나고 독립적으로 만든 파셋끼리 함수 선택자가 우연히 겹치는 충돌을 늘 신경 써야 하며 파셋 하나를 교체할 때도 거기 속한 함수 선택자를 전부 손봐야 합니다. 라우팅(어떤 모듈을 실행할지)과 호환성(어떤 표준 인터페이스를 호출했는지)이라는 서로 다른 관심사가 선택자 하나에 뒤섞여 있기 때문입니다.
구현해야 하는 것
function getFacets() external view returns (address[] memory);: 현재 설치된 모든 파셋의 주소 목록을 반환합니다.function getFacetEntries() external view returns (Facet[] memory);: 라우팅 인덱스와 파셋 주소가 짝지어진 전체 라우팅 테이블을 반환합니다.function getFacetAt(uint8 index) external view returns (address);: 특정 라우팅 인덱스에 설치된 파셋 주소를 반환합니다(빈 슬롯이면 0 주소).function getFacetCount() external view returns (uint16);: 설치된 파셋의 개수를 반환합니다.function getFirstFreeSlot() external view returns (uint8);: 비어 있는 가장 앞쪽 라우팅 인덱스를 반환합니다(모든 슬롯이 찼으면 revert됩니다).
심층 설명
프로토콜 라우팅: calldata 끝에 붙는 1바이트 인덱스
Cento의 Protocol Routing은 calldata 끝에 라우팅 인덱스(1바이트)를 붙여 호출합니다. 앞부분은 ABI로 인코딩된 함수 호출일 수도, 원시 바이트일 수도, 아예 없을 수도 있습니다. 라우터는 (1) 인덱스가 붙은 호출을 받고 (2) calldata 마지막 바이트에서 인덱스를 추출하고 (3) 그 인덱스가 활성 파셋을 가리키는지 확인하고 (4) 위임할 calldata에서 라우팅 바이트를 제외하고 (5) DELEGATECALL로 해당 파셋에 실행을 위임해야 합니다(MUST). 라우터는 남은 calldata를 그대로 전달하며 파셋은 이를 표준 ABI 디코딩, 원시 파싱, 또는 빈 calldata라면 receive 함수로 해석합니다. 또한 라우터는 모든 가용 가스를 전달하고 반환값(리버트 포함)을 그대로 호출자에게 돌려줘야 합니다(MUST).
호환성 라우팅: 표준 선택자는 그대로 동작
ERC-165(인터페이스 감지), ERC-173(소유권) 같은 표준화된 이더리움 인터페이스는 기존처럼 4바이트 함수 선택자로 호출합니다. 라우터는 표준 인터페이스 선택자를 감지해 Interface Compatibility 어댑터를 통해 해당 호환 함수(Compatibility Function)로 디스패치해야 하며(MUST), 이때는 라우팅 인덱스를 붙이지 않습니다. 이 경로는 Protocol Routing과 서로 간섭 없이 공존합니다. 선택자를 쓰는 표준 인터페이스라면 그 외에도 호환 라우팅으로 지원하는 것이 권장됩니다(SHOULD).
파셋당 정확히 하나의 라우팅 인덱스, 8비트 폭
설치된 각 파셋은 라우팅 테이블에서 정확히 하나의 라우팅 인덱스와 연결됩니다(SHALL). Facet 구조체는 uint8 index와 address facet 필드로 구성됩니다. 라우팅 인덱스는 8비트(0~255)로 표준화되어 있어 최대 256개의 파셋을 지원하고 calldata 오버헤드는 1바이트에 불과합니다. 같은 파셋이 여러 개의 프로토콜 함수를 구현해도 추가 라우팅 메타데이터가 필요 없으며 프로토콜 함수의 선택자는 다른 파셋과 전역적으로 겹치지 않아도 됩니다. 더 많은 파셋이 필요한 경우 인덱스 폭을 넓히는 확장은 이 표준의 범위 밖입니다.
atomicUpdate로 처리하는 파셋 관리
구현체는 함수 단위가 아니라 파셋 단위로 업그레이드를 수행해야 하며(MUST), 파셋 설치·교체·삭제를 지원해야 합니다. IFacetManager.atomicUpdate(setF, addI, remI, migrator, _calldata)는 여러 파셋의 설치·교체·삭제, 지원 인터페이스 식별자(bytes4)의 등록·해제, 스토리지 마이그레이션 실행을 한 트랜잭션에서 원자적으로 처리합니다. 마이그레이션 컨트랙트가 주어지면 라우팅 메타데이터가 갱신된 직후 DELEGATECALL로 실행되며 마이그레이션이 실패하면 전체 업데이트가 revert되어야 합니다(MUST). 모든 초기화 이후의 파셋 변경은 이 인터페이스를 거쳐야 하며 구현체는 매 아토믹 업데이트마다 AtomicUpdate 이벤트를 발생시켜야 합니다(MUST).
IObservability로 라우팅 테이블 조회
getFacets()는 설치된 파셋 주소 목록을, getFacetEntries()는 (인덱스, 주소) 전체 매핑을, getFacetAt(index)는 특정 슬롯의 파셋 주소를, getFacetCount()는 설치된 파셋 수를, getFirstFreeSlot()은 비어 있는 첫 라우팅 슬롯을 반환합니다(모든 슬롯이 차 있으면 revert). 이 함수들은 모두 view로 상태를 바꾸지 않아 지갑, 익스플로러, SDK, 거버넌스, 감사 도구가 반복 호출해도 안전합니다.
초기 상태와 ERC-165 보고 의무
라우터는 배포 시 세 개의 핵심 파셋을 표준 인덱스에 설치한 상태로 초기화되어야 합니다(MUST): 인덱스 0에 IFacetManager, 인덱스 1에 소유권(Ownership) 메커니즘, 인덱스 2에 IERC165와 IObservability입니다. 라우터는 0x01ffc9a7(IERC165), 0x5378f98e(IFacetManager), 0x1c60a259(IObservability)를 포함해 자신이 지원하는 인터페이스 식별자를 정확히 보고해야 하고 설치된 파셋이 노출하는 인터페이스 식별자도 ERC-165를 통해 함께 보고해야 합니다(MUST). 초기 배포 시 AtomicUpdate 이벤트를 발생시키는 것은 선택 사항입니다.
스토리지 레이아웃은 규정하지 않음
이 표준은 라우팅 의미론을 스토리지 레이아웃과 독립적으로 정의하며 특정 스토리지 레이아웃 모델을 요구하거나 금지하지 않습니다. 참조 구현은 ERC-7201 스토리지 네임스페이스로 공유 프로토콜 상태를 관리하고 라우팅 인덱스 점유 상태는 비트맵 기반 자료구조(LibBitmap)로 추적합니다. 참조 구현은 CentoRouter.sol과 FacetManager, Observability, Ownership 파셋, IFacetManager/IObservability/IERC173 인터페이스, LibCento 라이브러리 등으로 구성되며 배포 스크립트나 테스트는 포함하지 않습니다.
아직 확정되지 않은 제안입니다
이 표준은 현재 Draft 상태로, ERC-2535(Diamond)와 공존하는 대안으로 제시된 설계이며 아직 논의 중이라 세부 사항이 바뀌거나 멈출 수 있습니다.
쓸 때 주의할 점
- 권한 통제: atomicUpdate()는 인가된 주체만 호출할 수 있도록 제한해야 하며 민감한 업그레이드에는 타임락이나 다중서명 같은 거버넌스 메커니즘을 고려하고 모든 라우팅 메타데이터 변경을 기록해야 합니다.
- DELEGATECALL 위험: 위임된 코드는 라우터의 저장공간에서 실행되므로 파셋 간 스토리지 레이아웃이 충돌하면 상태가 손상될 수 있고 악의적인 파셋은 자금을 탈취하거나 상태를 훼손할 수 있습니다. ERC-7201 같은 네임스페이스로 충돌을 막고 설치 전 모든 파셋을 감사하고 아토믹 업데이트를 적절한 인가·거버넌스로 보호해야 합니다.
- 파셋 유효성 검증: 라우터는 외부 소유 계정(EOA, 위임 시 코드 없이 조용히 성공해 버림), 코드가 없는 빈 컨트랙트, EIP-7702로 위임된 EOA(라우터 통제 밖의 2차 인가 경로를 만듦)를 파셋으로 설치하는 것을 거부해야 합니다.
- 라우팅 입력 검증: 라우터는 빈 calldata, 등록된 파셋을 가리키지 않는 인덱스, 0 주소로 위임하는 경우, 자기 자신으로 위임하는 경우를 모두 실행 전에 검증해 되돌려야 합니다. 검증을 빠뜨리면 CALLDATACOPY 언더플로로 가스가 소진되거나, 0 주소 위임으로 조용히 실패하거나, 라우터가 자기 자신에게 위임되는 예기치 않은 상황이 생길 수 있습니다.
- 빈 calldata 처리: 빈 calldata에서 라우팅 인덱스를 제거하면 계산된 길이가 언더플로되어 CALLDATACOPY가 방대한 메모리 영역을 복사하려다 가스를 소진할 수 있습니다. receive() 함수로 빈 calldata를 먼저 소비하거나 fallback()에 명시적인 길이 검사를 두어야 합니다.