ERC-8084 ZK 증명 메타데이터 표준 (Zero-knowledge proof metadata)

Draft · 이름·메타데이터 · 2025-11-10 작성

컨트랙트가 ZK 증명의 회로 식별자·버전·공개 입력값 스키마·검증키 위치를 표준 함수로 공개해 지갑·탐색기·증명망이 맞춤 연동 없이 증명을 해석하고 처리하게 합니다.

왜 필요한가

ZK 애플리케이션은 증명의 모양을 공개하는 표준 방법이 없습니다. Groth16, Plonk, Halo2, zkVM 등 증명 시스템마다 프로젝트가 각자 다른 아티팩트를 배포하다 보니, 통합하려는 쪽은 새 프로젝트가 나올 때마다 맞춤 어댑터를 새로 만들어야 합니다. 그 결과 블록 탐색기는 증명의 공개 입력값을 해독하지 못해 원시 16진수만 보여주고 증명 생성망(솔버)은 새 작업을 자동으로 찾아 회로 아티팩트를 받아올 방법이 없어 매번 수동 연동이 필요합니다. 또한 회로 버전이 조용히 취약한 과거 버전으로 되돌려지거나 제약 조건이 공지 없이 바뀌어도 이를 감지할 표준적 수단이 없습니다.

구현해야 하는 것

심층 설명

핵심 필드 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 상태로, 세부 필드나 요구 사항이 논의 과정에서 바뀌거나 제안이 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs