ERC-7506 신뢰 힌트 레지스트리 (Trusted Hint Registry)

Draft · 이름·메타데이터 · 2023-08-31 작성

클레임(주장)의 해석과 검증에 필요한 온체인 메타데이터인 힌트(hint)를 네임스페이스와 리스트 구조로 저장하고 관리하는 표준 레지스트리입니다. 폐기 정보, 신뢰 발급자 목록, 타임스탬프 해시 등을 기록할 수 있습니다.

왜 필요한가

기업이나 커뮤니티 같은 생태계는 구성원에 대해 여러 주장, 곧 클레임(claim)을 발급합니다. 예를 들어 어떤 자격 증명이 아직 유효한지, 어떤 발급자를 믿어도 되는지 같은 정보입니다. 그런데 실제 응용에서는 검증 가능한 클레임만으로는 부족하고 그 클레임이 폐기되지 않았는지, 발급자가 신뢰할 만한지 확인할 보조 정보가 필요합니다. 이런 정보를 체인 위에서 구조적으로 관리하는 표준이 없으면 생태계마다 제각각의 방식을 만들게 되고 참여자 사이의 신뢰 형성과 유지가 어려워집니다. 이 표준은 그런 보조 정보를 힌트라고 부르고 누구나 자기 주소 아래에 힌트 리스트를 만들어 관리할 수 있는 공통 컨트랙트 인터페이스를 정의합니다. 관리 권한을 다른 주소에 위임하거나 서명만으로 대리 실행하게 하는 기능도 함께 표준화해 탈중앙 생태계에서 클레임을 믿고 쓸 수 있는 기반층을 제공합니다.

구현해야 하는 것

심층 설명

네임스페이스 중심의 4단 매핑 구조

저장 구조는 mapping(address => mapping(bytes32 => mapping(bytes32 => bytes32))) hints 입니다. 네임스페이스 주소가 힌트 리스트로, 리스트가 힌트 키로, 키가 힌트 값으로 이어집니다. 네임스페이스는 소유자의 이더리움 주소 그 자체이므로, 별도의 선점 절차 없이 그 주소 아래 모든 리스트의 초기 소유권이 암묵적으로 정해집니다. 덕분에 쓰기 권한 검증이 단순해지고 공격 표면이 줄어듭니다. 위임자 관리나 리스트 소유권 이전 같은 기능은 별도의 보조 자료구조로 권한을 검사하며 기본 네임스페이스 구조에는 영향을 주지 않습니다.

필수 함수와 선택 함수의 구분

컨트랙트 이름은 TrustedHintRegistry입니다. getHint, setHint, setHints, setHintsSigned는 반드시(MUST) 구현해야 하는 핵심 함수입니다. setHintSigned와 위임 계열(setHintDelegated 등), 리스트 관리 계열(setListStatus, setListOwner, addListDelegate, removeListDelegate와 각 Signed 변형), 메타데이터 계열(getMetadata, setMetadata 등)은 선택(MAY)입니다. 쓰기 함수들은 _metadata 파라미터를 추가한 오버로드 버전을 함께 구현할 수 있습니다. 거버넌스는 이 ERC에서 의도적으로 제외되었고 생태계의 필요에 따라 구현할 수 있습니다. 다섯 가지 이벤트(HintValueChanged 등)는 모두 해당 상황에서 반드시 발생해야 합니다.

EIP-712 메타 트랜잭션과 논스

Signed 계열 함수는 트랜잭션 서명자와 트랜잭션 전송자를 분리합니다. 서명자는 데이터에 서명만 하고 전송자가 그 서명을 받아 컨트랙트에 제출합니다. 서명은 반드시 EIP-712 형식을 따라야 하며 함수별로 정해진 타입 해시를 씁니다. 예를 들어 setHintSigned는 SetHintSigned(address namespace,bytes32 list,bytes32 key,bytes32 value,address signer,uint256 nonce)의 keccak256 해시를 씁니다. 서명된 페이로드는 한 번만 쓸 수 있어야 하고 이를 위해 메타 트랜잭션 전용 논스 매핑을 두는 것이 권장됩니다. 서명 검증이 끝나면 컨트랙트가 서명자의 논스를 올려 같은 트랜잭션의 재실행을 막습니다.

위임자에게 기한부 쓰기 권한 부여

네임스페이스 소유자는 addListDelegate로 특정 힌트 리스트에 위임자 주소를 추가할 수 있습니다. _untilTimestamp 파라미터로 권한이 언제까지 유효한지 정합니다. 위임자는 setHintDelegated, setHintsDelegated, setMetadataDelegated 같은 전용 함수로 해당 리스트에만 쓰기 권한을 가집니다. removeListDelegate로 위임자를 제거할 수 있고 각 동작마다 HintListDelegateAdded, HintListDelegateRemoved 이벤트가 발생합니다. 이 구조 덕분에 소유자가 개인키를 공유하지 않고도 운영을 분담할 수 있습니다.

리스트 단위 폐기와 소유권 이전

setListStatus는 힌트 리스트 전체의 유효 상태를 바꿉니다. 리스트를 폐기(revoked)하면 그 리스트 안의 모든 힌트 값을 한 번에 무효화하는 용도로 쓸 수 있습니다. setListOwner는 리스트 소유권을 다른 주소로 넘기지만 리스트가 속한 네임스페이스는 바뀌지 않아야 합니다(SHALL NOT). 힌트 값까지 가는 경로 참조를 그대로 유지하기 위해서입니다. 두 기능 모두 Signed 변형이 있으며 상태 변경 시 HintListStatusChanged, HintListOwnerChanged 이벤트가 발생합니다.

힌트별 메타데이터

힌트 하나는 네임스페이스, 리스트, 키, 값의 조합으로 특정되고 getMetadata와 setMetadata로 그 조합에 bytes 형식의 메타데이터를 붙일 수 있습니다. 소유자 직접 호출, 위임자 호출(setMetadataDelegated), 그리고 각각의 EIP-712 서명 변형이 정의되어 있습니다. 또한 setHint 같은 쓰기 함수들도 _metadata를 함께 받는 오버로드를 구현해 힌트 값과 메타데이터를 한 번에 기록할 수 있으며 이때는 metadata가 포함된 별도 타입 해시를 씁니다.

ENS를 통한 신뢰 앵커

ENS 도메인을 가진 생태계는 서브도메인 레코드로 자기 레지스트리를 알릴 수 있습니다. 선택 사항입니다. 각 용도별 서브도메인에 레지스트리 컨트랙트 주소(ADDRESS ETH)와 네임스페이스 소유자 주소(TEXT 키 hint.namespace)를 반드시 기록하고 hint.list, hint.key, hint.value TEXT 레코드와 컨트랙트 ABI는 선택적으로 기록합니다. 양방향 연결을 위해 네임스페이스 소유자는 자기 네임스페이스에서 힌트 리스트와 힌트 키를 0x0으로 두고 힌트 값을 ENS 서브도메인의 keccak256 해시로 하는 메타데이터를 설정해야 합니다. 이렇게 하면 도메인의 신뢰도를 빌려 레지스트리를 찾고 검증하기 쉬워집니다.

표준 상태: 초안

이 ERC는 2023년 8월 31일에 만들어졌고 현재 상태는 초안(Draft)입니다. 내용이 앞으로 바뀔 수 있는 제안 단계이므로, 구현 전에 최신 원문을 확인하는 것이 좋습니다. EIP-712를 필수로 요구합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs