ERC-7406 멀티 네임스페이스 온체인 레지스트리 (Multi-Namespace Onchain Registry)

Draft · 이름·메타데이터 · 2023-07-23 작성

하나의 컨트랙트 안에 네임스페이스(이름 공간)를 여러 개 두고 각 네임스페이스마다 키-값 기록을 따로 관리하는 범용 온체인 등록부(레지스트리) 표준입니다.

왜 필요한가

블록체인 기반 등록부는 탈중앙 앱이 핵심 정보를 저장하고 찾아오는 기반 요소입니다. 그런데 ENS 레지스트리 같은 기존 방식은 특정 용도에 맞춰져 있어 더 복잡한 상황을 담기에는 유연성이 부족할 수 있습니다. 예를 들어 같은 키라도 쓰임새에 따라 다른 값을 가리키게 하고 싶거나, 세션 관리, 짧은 주소를 전체 주소로 변환하는 일처럼 서로 다른 종류의 데이터를 한곳에서 다루고 싶을 때, 용도마다 별도 등록부를 만들어야 하는 부담이 생깁니다. 또 데이터가 언제 어떻게 바뀌었는지 버전별로 추적하거나 되돌리는 일도 단일 구조로는 어렵습니다. 이 표준은 네임스페이스를 여러 개 지원하는 일반화된 매핑 구조를 정의해 등록부 하나로 다양한 용도를 효율적으로 처리할 수 있게 하자는 제안입니다.

구현해야 하는 것

심층 설명

(namespace, key) 2단계 매핑 구조

기존 ENS류 등록부가 키 하나에 기록 하나를 두는 것과 달리, 이 표준은 모든 조회와 설정 함수가 bytes32 namespace와 bytes32 key 두 값을 함께 받습니다. 같은 key라도 namespace가 다르면 서로 다른 소유자와 리졸버를 가질 수 있습니다. 원문은 이 구조로 등록부가 세션 저장소라면 네임스페이스를 세션 유형으로, 짧은 URL을 전체 URL로 매핑하는 저장소라면 해당 데이터 유형으로 지정하는 식의 활용을 예로 듭니다. 또 네임스페이스를 버전 번호로 구분해 쓰면 항목 버전 관리, 변경 이력 추적, 데이터 되돌리기, 폐기 처리(톰스토닝)를 한 컨트랙트 안에서 할 수 있다고 설명합니다.

조회 함수 owner와 resolver

owner(bytes32 namespace, bytes32 key)는 주어진 네임스페이스 아래 그 키의 소유자 주소를 돌려주고 resolver(bytes32 namespace, bytes32 key)는 같은 범위에서 리졸버 주소를 돌려줍니다. 둘 다 external view 함수로, 상태를 바꾸지 않고 읽기만 합니다. 참조 구현의 resolver는 네임스페이스가 존재하지 않으면(namespaces[namespace]가 0이면) 실행을 중단하도록 되어 있습니다.

소유권 이전 setOwner

setOwner(bytes32 namespace, bytes32 key, address newOwner)는 특정 네임스페이스 아래 키의 소유권을 새 소유자에게 넘깁니다. 이 함수는 그 네임스페이스에서 해당 키의 현재 소유자만 부를 수 있습니다(MAY only be called by the current owner). 같은 키라도 네임스페이스가 다르면 소유자가 다를 수 있습니다. 호출이 성공하면 Transfer(bytes32 namespace, bytes32 key, address newOwner) 이벤트가 기록됩니다.

네임스페이스 생성 createNamespace

createNamespace(bytes32 namespace)는 현재 등록부에 새 버전이나 새 프로토콜 유형 같은 새 네임스페이스를 만듭니다. 성공하면 NewNamespace(bytes32 namespace) 이벤트가 기록됩니다. 참조 구현에서는 배포 시 approver 주소를 records[0][0].owner로 저장해 두고 only_approver 제한자를 통해 이 approver만 네임스페이스를 만들 수 있게 합니다. 이미 존재하는 네임스페이스면 그대로 돌아갑니다.

리졸버 설정 setResolver와 ERC-137 호환

setResolver(bytes32 namespace, bytes32 key, address newResolver)는 주어진 네임스페이스 아래 키의 리졸버 주소를 설정하며 명세상 그 키의 소유자만 부를 수 있습니다. 같은 키라도 네임스페이스에 따라 리졸버가 다를 수 있고 성공 시 NewResolver(bytes32 namespace, bytes32 key, address newResolver) 이벤트가 기록됩니다. 리졸버 컨트랙트 자체는 ERC-137(ENS)에 정의된 명세를 그대로 쓸 수 있어 등록부는 포인터 역할을, 실제 값 해석은 리졸버가 맡는 ENS식 구조를 유지합니다.

기존 동작과의 호환성

이 제안은 새 기능을 추가할 뿐 기존 동작을 바꾸지 않으므로, 원문은 하위 호환성 문제가 없다고 밝힙니다. 다수 네임스페이스를 지원함으로써 신원 관리, 세션 관리, 기록 추적, 탈중앙 콘텐츠 발행 등 다양한 용도를 하나의 등록부로 다룰 수 있다는 것이 설계 근거입니다.

Draft 단계의 제안

이 문서는 2023년 7월 23일 작성된 Draft(초안) 상태의 표준 트랙 ERC입니다. 아직 확정되지 않아 명세가 바뀌거나 진행이 멈출 수 있으므로, 구현 전에 최신 상태를 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs