ERC-7506 신뢰 힌트 레지스트리 (Trusted Hint Registry)
Draft · 이름·메타데이터 · 2023-08-31 작성
클레임(주장)의 해석과 검증에 필요한 온체인 메타데이터인 힌트(hint)를 네임스페이스와 리스트 구조로 저장하고 관리하는 표준 레지스트리입니다. 폐기 정보, 신뢰 발급자 목록, 타임스탬프 해시 등을 기록할 수 있습니다.
왜 필요한가
기업이나 커뮤니티 같은 생태계는 구성원에 대해 여러 주장, 곧 클레임(claim)을 발급합니다. 예를 들어 어떤 자격 증명이 아직 유효한지, 어떤 발급자를 믿어도 되는지 같은 정보입니다. 그런데 실제 응용에서는 검증 가능한 클레임만으로는 부족하고 그 클레임이 폐기되지 않았는지, 발급자가 신뢰할 만한지 확인할 보조 정보가 필요합니다. 이런 정보를 체인 위에서 구조적으로 관리하는 표준이 없으면 생태계마다 제각각의 방식을 만들게 되고 참여자 사이의 신뢰 형성과 유지가 어려워집니다. 이 표준은 그런 보조 정보를 힌트라고 부르고 누구나 자기 주소 아래에 힌트 리스트를 만들어 관리할 수 있는 공통 컨트랙트 인터페이스를 정의합니다. 관리 권한을 다른 주소에 위임하거나 서명만으로 대리 실행하게 하는 기능도 함께 표준화해 탈중앙 생태계에서 클레임을 믿고 쓸 수 있는 기반층을 제공합니다.
구현해야 하는 것
function getHint(address _namespace, bytes32 _list, bytes32 _key) external view returns (bytes32);: 네임스페이스의 힌트 리스트에서 키에 해당하는 힌트 값을 조회합니다. 필수 구현입니다.function setHint(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value) public;: 네임스페이스의 힌트 리스트에서 힌트 값을 변경합니다. 필수 구현입니다.function setHintSigned(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, address _signer, bytes calldata _signature) public;: 서명자가 만든 EIP-712 서명을 받아 다른 주소가 대신 힌트 값을 변경합니다.function setHints(address _namespace, bytes32 _list, bytes32[] calldata _keys, bytes32[] calldata _values) public;: 한 리스트의 여러 힌트 값을 한 번에 변경합니다. 필수 구현입니다.function setHintsSigned(address _namespace, bytes32 _list, bytes32[] calldata _keys, bytes32[] calldata _values, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 여러 힌트 값을 한 번에 대신 변경합니다. 필수 구현입니다.function setHintDelegated(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value) public;: 사전에 승인된 위임자가 힌트 값을 변경합니다.function setHintDelegatedSigned(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, address _signer, bytes calldata _signature) public;: 위임자의 EIP-712 서명을 받아 다른 주소가 대신 힌트 값을 변경합니다.function setHintsDelegated(address _namespace, bytes32 _list, bytes32[] calldata _keys, bytes32[] calldata _values) public;: 위임자가 여러 힌트 값을 한 번에 변경합니다.function setHintsDelegatedSigned(address _namespace, bytes32 _list, bytes32[] calldata _keys, bytes32[] calldata _values, address _signer, bytes calldata _signature) public;: 위임자의 EIP-712 서명을 받아 여러 힌트 값을 한 번에 대신 변경합니다.function setListStatus(address _namespace, bytes32 _list, bool _revoked) public;: 힌트 리스트의 유효 상태를 바꿉니다. 리스트를 폐기하면 그 안의 모든 힌트 값을 무효화하는 용도로 쓸 수 있습니다.function setListStatusSigned(address _namespace, bytes32 _list, bool _revoked, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 리스트의 유효 상태를 대신 바꿉니다.function setListOwner(address _namespace, bytes32 _list, address _newOwner) public;: 힌트 리스트의 소유권을 다른 주소로 넘깁니다. 리스트가 속한 네임스페이스는 바뀌지 않습니다.function setListOwnerSigned(address _namespace, bytes32 _list, address _newOwner, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 리스트 소유권을 대신 넘깁니다.function addListDelegate(address _namespace, bytes32 _list, address _delegate, uint256 _untilTimestamp) public;: 지정한 시점까지 유효한 위임자를 힌트 리스트에 추가합니다.function addListDelegateSigned(address _namespace, bytes32 _list, address _delegate, uint256 _untilTimestamp, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 위임자를 대신 추가합니다.function removeListDelegate(address _namespace, bytes32 _list, address _delegate) public;: 힌트 리스트에서 위임자를 제거합니다.function removeListDelegateSigned(address _namespace, bytes32 _list, address _delegate, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 위임자를 대신 제거합니다.function getMetadata(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value) external view returns (bytes memory);: 특정 힌트에 붙은 메타데이터를 조회합니다.function setMetadata(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, bytes calldata _metadata) public;: 특정 힌트에 메타데이터를 기록합니다.function setMetadataSigned(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, bytes calldata _metadata, address _signer, bytes calldata _signature) public;: EIP-712 서명을 받아 메타데이터를 대신 기록합니다.function setMetadataDelegated(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, bytes calldata _metadata) public;: 사전 승인된 위임자가 힌트의 메타데이터를 기록합니다.function setMetadataDelegatedSigned(address _namespace, bytes32 _list, bytes32 _key, bytes32 _value, bytes calldata _metadata, address _signer, bytes calldata _signature) public;: 위임자의 EIP-712 서명을 받아 메타데이터를 대신 기록합니다.
심층 설명
네임스페이스 중심의 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를 구현한 다른 배포본에서 재사용될 가능성이 있습니다. 원문은 EIP-712 사용으로 이 문제를 다룬다고 밝힙니다.
- 권한 관리: 역할별 권한은 허가받지 않은 주체의 변경을 막기 위한 것입니다. 힌트 리스트 소유자는 자기 리스트와 그 쓰기 권한을 항상 완전히 통제할 수 있어야 합니다.
- 거버넌스는 각 생태계의 몫: 힌트 리스트 변경에 별도 절차가 필요한 생태계가 있을 수 있습니다. 이 ERC는 거버넌스를 정의하지 않으며 특정 함수에 거버넌스 기능을 덧붙인 확장, 멀티시그 지갑, 오프체인 절차 등으로 각자 요구에 맞게 적용할 수 있습니다.