ERC-8084 ZK 증명 메타데이터 표준 (Zero-knowledge proof metadata)
Draft · 이름·메타데이터 · 2025-11-10 작성
컨트랙트가 ZK 증명의 회로 식별자·버전·공개 입력값 스키마·검증키 위치를 표준 함수로 공개해 지갑·탐색기·증명망이 맞춤 연동 없이 증명을 해석하고 처리하게 합니다.
왜 필요한가
ZK 애플리케이션은 증명의 모양을 공개하는 표준 방법이 없습니다. Groth16, Plonk, Halo2, zkVM 등 증명 시스템마다 프로젝트가 각자 다른 아티팩트를 배포하다 보니, 통합하려는 쪽은 새 프로젝트가 나올 때마다 맞춤 어댑터를 새로 만들어야 합니다. 그 결과 블록 탐색기는 증명의 공개 입력값을 해독하지 못해 원시 16진수만 보여주고 증명 생성망(솔버)은 새 작업을 자동으로 찾아 회로 아티팩트를 받아올 방법이 없어 매번 수동 연동이 필요합니다. 또한 회로 버전이 조용히 취약한 과거 버전으로 되돌려지거나 제약 조건이 공지 없이 바뀌어도 이를 감지할 표준적 수단이 없습니다.
구현해야 하는 것
event CircuitMetadataUpdated(bytes32 indexed circuitId, uint64 circuitVersion, bytes4 proofSystem);: 저장된 회로 메타데이터가 바뀔 때 발생하는 이벤트입니다.function circuitId() external view returns (bytes32);: 검증키를 도출하는 데 쓰인 회로 정의 아티팩트의 콘텐츠 주소 식별자를 돌려줍니다.function circuitVersion() external view returns (uint64);: 회로 버전을 돌려줍니다. 상위 32비트는 메이저, 하위 32비트는 마이너 버전입니다.function publicInputsSchemaHash() external view returns (bytes32);: 공개 입력값 스키마 문서의 정본 해시를 돌려줍니다.function publicInputsSchemaURI() external view returns (string memory);: 공개 입력값 스키마 문서의 위치(URI)를 돌려줍니다.function verificationKeyURI() external view returns (string memory);: 검증키를 찾을 수 있는 위치(URI)를 돌려줍니다.function proofSystem() external view returns (bytes4);: 사용 중인 증명 시스템 식별자(예: Groth16, Plonk, Halo2)를 돌려줍니다.
심층 설명
핵심 필드 6종
IZKMetadata는 circuitId(회로 정의 아티팩트의 콘텐츠 해시), circuitVersion(semver 식으로 uint32.uint32를 uint64에 패킹한 버전), publicInputsSchemaHash와 publicInputsSchemaURI(공개 입력값 스키마 문서의 해시와 위치), verificationKeyURI(검증키 발견 위치), proofSystem(증명 시스템 식별자) 6개 getter와 CircuitMetadataUpdated 이벤트로 구성됩니다. 이 조합이 곧 'ZK ABI' 역할을 해 통합기가 각 프로젝트의 증명 형태를 코드로 질의할 수 있게 합니다.
증명 시스템 레지스트리
bytes4 식별자로 proofSystem을 표현하며 0x0001은 Groth16(BN254, 예: snarkjs), 0x0002는 Plonk(BN254 변형), 0x0003은 Halo2(Plonkish 계열), 0x0004는 zkSTARK(일반 STARK 프로버), 0x0005는 zkVM(RISC-V/Jolt/RISC Zero 등)을 가리킵니다. 추가 식별자는 토론 스레드에서 제안해야 하고 기존 값과 충돌해서는 안 되며 알려지지 않은 식별자는 툴링이 미지원으로 처리해야 합니다.
콘텐츠 해시와 버전 규칙
circuitId()는 검증키를 도출하는 데 쓴 정본 회로 아티팩트의 콘텐츠 해시(keccak256 또는 multihash)여야 합니다. circuitVersion()은 제약 조건이나 공개 입력값 의미에 호환되지 않는 변경이 생길 때마다 반드시 증가해야 하며 프로젝트는 uint64의 상위 32비트를 메이저, 하위 32비트를 마이너로 쓰는 것이 권장됩니다.
스키마·검증키 무결성 요구
publicInputsSchemaHash()는 publicInputsSchemaURI()에 있는 문서와 반드시 일치해야 합니다. 스키마와 검증키 URI는 ipfs://, ar://, bzz:// 같은 콘텐츠 주소를 쓰는 것이 권장되며 HTTPS를 쓸 경우 URI에 자원 내용의 Keccak-256 해시를 16진수로 담은 URL 프래그먼트(예: #0x...)를 반드시 포함해야 합니다. 툴링은 받아온 스키마 문서의 해시가 publicInputsSchemaHash()와 일치하는지 반드시 검증해야 하고 검증키 콘텐츠 해시가 URI의 해시 프래그먼트와 일치하는지도 확인해야 합니다.
이벤트 기반 갱신
CircuitMetadataUpdated는 새 메타데이터가 관측 가능해지는 같은 트랜잭션 안에서 반드시 발생해야 합니다. 이는 인덱서의 경쟁 상태를 막기 위한 요구 사항입니다. 인덱서와 탐색기는 getter를 주기적으로 조회하는 대신 이 이벤트를 구독하는 것이 권장됩니다.
하위 호환성
기존 컨트랙트는 IZKMetadata를 구현하는 어댑터를 별도로 배포해 대응할 수 있습니다. 읍체인 전용 파사드나 오프체인 라우터 형태로 둘 수 있으며 기존 ERC를 수정하지는 않습니다.
아직 확정되지 않은 제안
이 표준은 현재 Draft 상태로, 세부 필드나 요구 사항이 논의 과정에서 바뀌거나 제안이 멈출 수 있습니다.
쓸 때 주의할 점
- 스키마 무결성: 툴링이 publicInputsSchemaHash()를 다운로드한 문서와 대조해 검증하지 않으면, 악성 프런트엔드나 게이트웨이가 변조된 스키마를 제공할 수 있습니다. 이 경우 공격자가 가령 토큰 수량 항목을 논스 항목으로 둔갑시켜 사용자가 증명이 실제로 무엇을 입증하는지 속을 수도 있습니다.
- 검증키 변경 가능성: 해시 프래그먼트가 없는 HTTP URI에 의존하면 서버 관리자가 검증키를 몰래 바꿀 수 있습니다. 컨트랙트가 여전히 옛 URI를 가리키는 동안, 관리자가 변조된 회로로 가짜 증명을 만들어낼 위험이 있습니다.
- 인덱서 경쟁 상태: CircuitMetadataUpdated 이벤트가 상태 변경과 원자적으로 발생하지 않으면, 오프체인 인덱서가 이벤트를 처리하는 동안 옛 메타데이터(예: 오래된 검증키)를 읽을 여지가 있습니다. 이는 증명 생성에 광범위한 서비스 거부로 이어질 수 있습니다.