ERC-8176 ERC-7730 서술자 검증 증명 (Descriptor Attestations for ERC-7730)

Draft · 서명·인증 · 2026-02-26 작성

EAS를 이용해 ERC-7730 서술자 파일에 특정 검토자가 서명했음을 증명하는 방식을 정의합니다. 지갑은 이를 통해 신뢰하는 검토자가 서술자를 확인했는지 알 수 있습니다.

왜 필요한가

ERC-7730 서술자는 지갑이 서명 전 거래 내용을 사람이 읽을 수 있게 보여주는 데 쓰입니다. 그런데 레지스트리나 저장소에 악의적 기여자가 중요 필드를 숨기거나 잘못 표시한 서술자를 올릴 수 있고, 네트워크 공격자가 전송 중 서술자를 바꿔치기할 수도 있으며, 레지스트리 미러나 CDN, 피닝 게이트웨이가 위조된 서술자를 대신 제공할 수도 있습니다. ERC-7730의 컨텍스트 바인딩은 서술자가 맞는 컨트랙트와 체인을 가리키는지는 확인하지만 표시 형식 자체를 신뢰할 당사자가 검토했는지는 알려주지 않습니다. 또한 git 커밋 서명은 저장소 안에서는 작성자를 증명하지만, 서술자가 API로 제공되거나 독립 파일로 추출되는 순간 사라집니다. 즉 서술자가 저장소를 벗어나 유통되는 전체 과정을 보장할 수단이 없었습니다.

구현해야 하는 것

심층 설명

정식 EAS 스키마

이 ERC가 쓰는 스키마는 bytes32 descriptorHash 하나뿐이며, 스키마 UID는 0xe023eef113c1670774801c34b377fdf612dd8a4d2fa92fe382e15bd91fafb5c2로 이더리움 메인넷(chainId=1)의 EAS 컨트랙트(0xA1207F3BBa224E2c9c3c6D5aF63D0eb1582Ce587)에 등록되어 있습니다. resolver는 0x0으로, 누구나 증명을 발행할 수 있는 permissionless 스키마이며 revocable은 true입니다. 이 ERC를 따르는 모든 증명은 반드시 이 스키마 UID를 참조해야 하고, 다른 UID를 참조하는 증명은 내용이 같아도 범위 밖입니다.

descriptorHash 계산 절차

먼저 서술자 JSON을 파싱하고, ERC-7730의 병합 규칙에 따라 includes 참조를 더 이상 남지 않을 때까지 재귀적으로 풀어 완전히 해소된 결과물을 만듭니다. 이를 RFC 8785(JCS, JSON 정규화 체계)로 바이트 문자열로 직렬화한 뒤 Keccak-256(NIST SHA3-256이 아닌 이더리움 황서 방식) 해시를 계산한 32바이트 값이 descriptorHash입니다. includes로 참조된 파일이 해시 계산 시점에 구할 수 없으면 해시를 계산할 수 없고, 그에 의존하는 증명의 검증은 결론을 내릴 수 없습니다.

온체인/오프체인 증명 형식

두 형식은 같은 정보를 담습니다. 온체인 증명은 EAS 컨트랙트의 attest() 호출로 생성되어 컨트랙트 상태에 결정적 UID로 저장됩니다. 오프체인 증명은 EAS 오프체인 어테스테이션 v2 형식을 따르는 EIP-712 서명 JSON으로, 온체인에 제출되지 않고 서술자와 함께 배포됩니다. data 필드는 항상 32바이트 descriptorHash여야 합니다. 오프체인 서명의 EIP-712 도메인은 name "EAS Attestation", version "0.26", chainId 1, verifyingContract가 캐노니컬 EAS 컨트랙트로 고정되며, primaryType은 Attest이고 version, schema, recipient, time, expirationTime, revocable, refUID, data, salt 순서의 필드를 가집니다. 이 ERC의 증명에서 version은 반드시 2, schema는 캐노니컬 UID, data는 abi.encode(descriptorHash)여야 합니다.

증명 검증 절차

검증자는 먼저 schema 필드가 캐노니컬 UID와 같은지 확인하고, data를 descriptorHash로 디코딩한 뒤 검증 대상 서술자에서 직접 계산한 descriptorHash와 비교합니다. expirationTime이 0이 아니고 현재 시각을 넘었으면 만료로 취급합니다. 어테스터 복구는 오프체인의 경우 EIP-712 다이제스트로 ECDSA 복구(EOA)하거나 현재 블록에서 ERC-1271 isValidSignature를 호출(컨트랙트)하며, ERC-1271 결과를 캐시하는 구현은 캐시 유지 기간을 제한해야 합니다. 온체인은 EAS 컨트랙트 레코드의 attester를 그대로 신뢰합니다. 철회 여부는 캐노니컬 EAS 컨트랙트에서 직접 조회해야 하며(오프체인은 getRevokeOffchain, 온체인은 getAttestation의 revocationTime), 증명을 전달한 출처의 철회 보고는 신뢰하지 않아야 합니다. 마지막으로 attester가 지갑의 신뢰 목록에 있는지 확인합니다.

철회(Revocation)

어테스터는 자신이 발행한 증명을 철회할 수 있습니다. 철회는 원래 증명이 온체인이든 오프체인이든 항상 캐노니컬 EAS 컨트랙트로 보내는 온체인 트랜잭션입니다. 오프체인 증명은 revokeOffchain(uid)를 호출해 (msg.sender, uid) 쌍에 타임스탬프를 기록하고, 온체인 증명은 revoke()를 호출해 레코드의 revocationTime을 설정합니다. 이 ERC에서는 원래 어테스터 본인의 철회만 증명을 무효화합니다.

수명 관리(TTL) 권고

어테스터는 키 유실, 조직 변화, 서비스 중단 등으로 운영 능력을 잃었을 때 노출을 제한하기 위해 expirationTime을 미래의 유한한 시점으로 설정하는 것이 권장됩니다. expirationTime을 0으로 두면 증명이 영원히 만료되지 않고 오로지 능동적 철회에만 의존하게 되므로, 지갑은 이런 증명을 받을 때 이 특성을 신뢰 정책에 반영해야 합니다.

다중 어테스터 시맨틱스

같은 서술자에 대해 여러 어테스터가 각자 독립적으로 증명을 발행할 수 있습니다. 각 증명은 독립적으로 검증되며, 하나의 증명이 실패해도 다른 증명이나 서술자 자체를 무효로 만들지 않습니다. 몇 개의 증명이, 어느 어테스터로부터 필요한지 결정하는 정책은 지갑의 책임입니다.

제안 상태

이 제안은 아직 Draft 상태입니다. 세부 규격이 앞으로 바뀌거나 논의가 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs