ERC-8143 스마트 크리덴셜 조회 인터페이스 (Smart Credential Resolution Interface)

Draft · 서명·인증 · 2025-12-15 작성

KYC, 사람 증명, 평판 같은 제3자 발급 크리덴셜을 모든 컨트랙트에서 동일한 함수와 이벤트로 조회할 수 있게 하는 표준입니다.

왜 필요한가

크리덴셜 발급자마다 함수 이름과 반환 형식이 다르면 지갑이나 에이전트 같은 클라이언트는 발급자마다 별도의 연동 코드를 만들어야 합니다. 또한 새로운 크리덴셜이 온체인에 추가되어도 클라이언트가 이를 미리 알 방법이 없어 어떤 키가 존재하는지 외부에서 전달받아야만 조회할 수 있습니다. ERC-3668을 쓰면 오프체인에 저장된 크리덴셜도 다룰 수 있지만 발급자별로 호출 방식이 제각각이면 클라이언트가 이를 통일된 방식으로 처리하기 어렵습니다. 특히 AI 에이전트 같은 자동화된 클라이언트가 늘어나는 상황에서는 발급자마다 다른 인터페이스를 일일이 파악하는 비용이 커집니다.

구현해야 하는 것

심층 설명

인터페이스 구성과 ERC-165

IERC8143은 getCredential(string key) 함수 하나와 CredentialSet(string key) 이벤트 하나로 구성됩니다. 스마트 크리덴셜은 ERC-165를 구현해야 하며 이 인터페이스의 ID인 0xd091187f로 supportsInterface가 호출될 때 true를 반환해야 합니다. 클라이언트의 구현 부담을 줄이려는 의도적 설계로 인터페이스를 단일 함수로 제한했습니다.

키 형식과 반환값 형식은 비표준

이 표준은 키 형식이나 getCredential이 반환하는 bytes의 데이터 형식을 규정하지 않습니다. 크리덴셜 발급자가 자신의 키와 데이터 형식을 직접 정의하고 문서화해야 합니다. 키는 선택적으로 ERC-8119의 파라미터화된 형식(key:param 또는 key/param, 구분자 뒤에 공백 없음)을 쓸 수 있지만 필수는 아닙니다.

CredentialSet 이벤트의 역할

컨트랙트는 특정 키의 크리덴셜이 설정되거나 갱신될 때 반드시 CredentialSet(key)를 발생시켜야 합니다. 이를 통해 에이전트 시스템을 포함한 클라이언트가 어떤 키가 존재하는지 사전에 알지 못해도 온체인에 추가된 새 크리덴셜을 발견할 수 있습니다.

오프체인 크리덴셜과 ERC-3668

크리덴셜이 오프체인에 저장된 경우 컨트랙트는 ERC-3668의 OffchainLookup으로 리버트할 수 있으며 클라이언트는 ERC-3668의 클라이언트 조회 프로토콜을 반드시 따라야 합니다. 명세의 예시에서는 getCredentialCallback 함수가 게이트웨이 응답을 서명이나 머클 증명 등으로 검증한 뒤 디코딩해 반환하는 구조를 보여줍니다.

클라이언트의 조회 절차

호환 클라이언트는 먼저 ERC-3668을 사용해 getCredential 함수를 호출해야 하며 일부 라이브러리는 기본적으로 ERC-3668을 쓰지 않으므로 이를 활성화하는 별도 호출이 필요할 수 있습니다. 반환된 값은 해당 키에 대해 발급자가 정의한 형식으로 디코딩해야 하고 알려진 형식이 없으면 원시 UTF-8 바이트로 해석해야 합니다.

설계 근거: ZKP 지원과 단순성

W3C Verifiable Credentials와 비교하면 스마트 크리덴셜은 온체인 ZKP 검증기를 활용해 영지식 증명을 지원할 수 있다는 점이 독특합니다. 또한 KYC, 사람 증명처럼 사용자가 직접 통제하지 않고 신뢰할 수 있는 제3자가 관리해야 하는 기록에 대한 요구를 충족시키기 위한 것이며 인터페이스를 단일 함수로 한정해 여러 발급자 간 상호운용성을 쉽게 확보하도록 설계했습니다.

제안 상태 안내

이 ERC는 현재 Draft 상태입니다. 아직 확정된 표준이 아니며 향후 내용이 바뀌거나 논의가 중단될 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs