ERC-8349 인덱스 기반 멀티파셋 프록시 (Index-Based Multi-Facet Proxy)

Draft · 기타 · 2026-07-25 작성

여러 구현 모듈(파셋)을 한 주소로 묶는 모듈형 프록시에서, 함수 선택자 대신 calldata 끝에 붙인 1바이트 라우팅 인덱스로 어떤 파셋이 실행될지 직접 식별하게 하는 표준입니다.

왜 필요한가

여러 컨트랙트(파셋)를 하나의 주소로 묶는 모듈형 프록시 표준인 ERC-2535(Diamond)는 각 함수를 식별하는 4바이트 함수 선택자를 라우팅 식별자로도 함께 사용합니다. 그런데 함수 선택자는 원래 지갑, 블록 익스플로러, SDK 같은 외부 도구와의 호환성을 위한 식별자이지, 어떤 파셋이 실행돼야 하는지를 가리키는 값은 아닙니다. 이 둘을 하나로 묶어 쓰다 보면 프로토콜이 커질수록 라우팅 메타데이터가 파셋 수가 아니라 외부에 노출된 함수 수에 비례해 늘어나고 독립적으로 만든 파셋끼리 함수 선택자가 우연히 겹치는 충돌을 늘 신경 써야 하며 파셋 하나를 교체할 때도 거기 속한 함수 선택자를 전부 손봐야 합니다. 라우팅(어떤 모듈을 실행할지)과 호환성(어떤 표준 인터페이스를 호출했는지)이라는 서로 다른 관심사가 선택자 하나에 뒤섞여 있기 때문입니다.

구현해야 하는 것

심층 설명

프로토콜 라우팅: 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)와 공존하는 대안으로 제시된 설계이며 아직 논의 중이라 세부 사항이 바뀌거나 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs