ERC-7861 ERC-721 검증가능 자격증명 확장 (ERC-721 Verifiable Credential Extension)
Draft · NFT·멀티토큰 · 2025-01-14 작성
ERC-721 NFT에 발급자, 자격증명 종류, 암호화·검증 방법을 컬렉션 단위로 명시하고 개별 NFT의 자격증명 위치와 폐기 여부를 표준 방식으로 조회할 수 있는 확장입니다.
왜 필요한가
ERC-721 컬렉션들이 신원증명, 학력증명 같은 검증 가능한 자격증명(Verifiable Credential)을 NFT에 연결하려 할 때, 저장 위치, 암호화 여부, 검증 방법, 폐기 여부를 확인하는 방식이 컬렉션마다 제각각이었습니다. 이 때문에 지갑이나 검증 서비스 같은 제3자 플랫폼은 자격증명을 다루는 컬렉션마다 개별 통합 로직을 새로 만들어야 했습니다. 자격증명은 신원이나 학력처럼 민감한 정보를 담는 경우가 많은데, 암호화 상태와 검증 방법을 미리 알 수 없으면 안전하게 다루기 어렵고 폐기된 자격증명을 표준 방법으로 구분할 수 없어 신뢰성 있는 활용과 실시간 추적이 힘들었습니다.
구현해야 하는 것
event CredentialIssued(uint256 indexed tokenId, address indexed to);: 새 자격증명이 발급될 때 발생하는 이벤트입니다.event CredentialRevoked(uint256 indexed tokenId);: 자격증명이 폐기될 때 발생하는 이벤트입니다.function issuer() external view returns (string memory);: 자격증명 컬렉션의 발급자 DID 또는 주소를 반환합니다.function credentialType() external view returns (string memory);: 컬렉션에 속한 자격증명의 종류를 반환합니다.function encryptionMethod() external view returns (string memory);: 자격증명의 암호화 방법을 반환하며, 암호화되지 않았으면 빈 문자열을 반환합니다.function verificationMethod() external view returns (string memory);: 자격증명의 증명을 검증하는 방법을 반환합니다.function credentialURI(uint256 tokenId) external view returns (string memory);: 해당 NFT의 자격증명 위치를 가리키는 URI를 반환합니다.function isRevoked(uint256 tokenId) external view returns (bool);: 해당 자격증명이 폐기되었는지 여부를 반환합니다.
심층 설명
컬렉션 단위 발급자·종류 정보
issuer()와 credentialType()은 컬렉션 전체에 공유되는 속성으로, 모든 토큰에 공통으로 적용되는 발급자와 자격증명 종류를 한 번에 관리할 수 있습니다. issuer()가 빈 문자열이면 발급자가 없다는 뜻입니다.
credentialURI로 오프체인 위치 지정
credentialURI(tokenId)는 ERC-721의 tokenURI와 비슷하게, 개별 자격증명의 저장 위치를 가리킵니다. IPFS 같은 공개 저장소나 접근 제어가 있는 커스텀 저장소를 가리킬 수 있습니다. tokenId가 유효하지 않은 NFT면 호출이 실패해야 하며 다른 방식으로 자격증명을 조회하는 구현이라면 빈 문자열을 반환해야 합니다.
encryptionMethod와 복호화 흐름
encryptionMethod()는 암호화되지 않은 경우에만, 그리고 반드시 빈 문자열을 반환해야 합니다. 암호화된 경우에는 암호화 방법 이름만 반환하는 것이 권장되며 복호화에 필요한 추가 정보는 별도 함수나 컨트랙트 메타데이터로 따로 제공될 수 있습니다. 복호화 과정에는 사용자 지갑 서명 등 동의 절차가 포함될 수 있습니다.
verificationMethod와 진위 검증
verificationMethod()는 자격증명의 진위와 무결성을 검증하는 방법을 반환합니다. 반환값의 형식은 구현자가 정하지만 W3C의 verification method 개념과 호환되는 것이 권장됩니다. 영지식증명을 쓰는 경우 자격증명 전체를 공개하지 않고도 특정 질의만 검증할 수 있습니다.
isRevoked와 폐기 처리
isRevoked(tokenId)는 폐기되지 않았으면 false, 폐기되었으면 true를 반환해야 하며 존재하지 않는 자격증명에는 true를 반환할 수 있습니다. 폐기 구현은 의무가 아니며 NFT를 소각하는 방식, 컨트랙트 내 별도 구조, 또는 오프체인 폐기 목록으로 구현할 수 있습니다. 소각 방식이라면 NFT가 소각되지 않았다는 사실만으로 유효성이 확인됩니다.
이벤트를 통한 생애주기 추적
CredentialIssued와 CredentialRevoked는 해당 작업이 수행될 때 발생할 수 있으며(MAY) 오프체인 시스템은 이 이벤트로 자격증명 상태를 효율적으로 실시간 모니터링할 수 있습니다. 이벤트 발생이 의무는 아니지만 생애주기 추적을 위해 권장됩니다.
ERC-165 지원과 ERC-721 호환성
supportsInterface는 0x7861069로 호출될 때 true를 반환해야 합니다. 이 표준은 ERC-721의 기존 기능을 변경하지 않고 새 함수만 추가하므로 기존 ERC-721 컨트랙트와 완전히 호환됩니다.
아직 Draft 단계인 제안
이 표준은 현재 Draft 상태이며 Rationale 섹션도 아직 작성되지 않았습니다. 함수 구성이나 세부 규칙이 앞으로 바뀌거나 논의가 멈출 수 있습니다.
쓸 때 주의할 점
- 엄격한 접근 제어 필요: 자격증명을 발급하거나 폐기할 수 있는 권한과, 발급자·종류 같은 컬렉션 속성을 설정하는 권한에 엄격한 접근 제어를 적용해 컬렉션 정보의 무결성을 지켜야 합니다.
- 양도 불가 처리 권장: 자격증명의 진위를 유지하고 무단 전송을 막기 위해 자격증명 NFT는 전송이 불가능하도록 전송 함수를 재정의하는 것이 좋습니다.
- credentialURI에 민감정보 노출 금지: credentialURI는 누구나 조회할 수 있으므로 민감한 정보를 직접 담으면 안 됩니다. 민감한 데이터는 암호화해 오프체인에 저장하고 credentialURI는 그 암호화된 데이터의 위치만 가리켜야 합니다.