프라이버시 Audit Authorization과 Disclosure

mechanism privacy

모든 비공개 요청은 이제 audit 봉투와 output별 disclosure 메타데이터를 함께 전달합니다. 체인은 활성 audit 키와 회로 세트를 고정하며, 클라이언트는 IPrivacy의 view 메서드로 이 둘을 확인합니다.

IPrivacy의 상태 변경 요청(deposit, transfer, withdraw, 배치와 *WithAuthorization 변형)은 이제 재사용 가능한 두 가지 페이로드를 중심으로 구성됩니다. 요청에 실리는 PrivacyAuditAuthorization { keyId, epoch, envelope }과, output마다 실리는 PrivacyOutputEffect는 commitment, ciphertext, view tag, 그리고 disclosure 필드 묶음(userPrivacyPolicy, userDisclosureMode, userDisclosureDigest, userDisclosureTargetPubkey, userDisclosurePayload, selfFullDisclosureDigest, selfViewDisclosurePayload)을 포함합니다. 체인은 지정된 epoch의 audit 키 레코드를 기준으로 audit 봉투를 검증하고, 체인 전역의 PrivacyDisclosureConfig를 기준으로 각 output의 disclosure 필드를 검증합니다.

모든 요청에 실리는 audit authorization

PrivacyAuditAuthorization은 keyId(audit 기관 식별자), envelope가 생성된 키의 epoch, 직렬화된 envelope 자체를 담습니다. 체인은 해당 epoch에 등록된 audit 키, 즉 auditKey(epoch) view가 반환하는 레코드로 봉투를 검증하고, 검증되지 않는 요청을 거부합니다. (auditKey view를 직접 호출하면 표준 필드 재검증을 위해 400,640 gas가 사전 과금됩니다. 이 비용은 view 호출의 것이며 모든 요청에 부과되지 않습니다.) epoch를 선택하려면 먼저 auditKeySchedule()을 읽습니다. activeEpoch가 체인이 받는 값이며, nextActivationHeight / nextEpoch는 곧 교체될 것이라는 경고이고, halted가 true이면 체인이 현재 비공개 요청을 전혀 받지 않는 상태입니다.
import { createPublicClient, http } from "viem";
import { iPrivacyAbi, iPrivacyAddress } from "@maroo-chain/contracts/abi/precompiles/privacy/IPrivacy";

const publicClient = createPublicClient({ transport: http("https://rpc-testnet.maroo.io") });
const schedule = await publicClient.readContract({
  address: iPrivacyAddress,
  abi: iPrivacyAbi,
  functionName: "auditKeySchedule",
});
if (schedule.halted) throw new Error("비공개 표면이 중단되었습니다");

const audit = {
  keyId: "0x" as const,            // audit 공급자가 반환한 keyId 바이트
  epoch: schedule.activeEpoch,
  envelope: "0x" as const,         // 증명자가 생성한 직렬화 봉투
};

Output disclosure 메타데이터

모든 외부 노트는 PrivacyOutputEffect입니다. 암호학적 필드(commitment, ciphertext, viewTag)와 함께 사용자 대상 disclosure 필드 5개와 self-view 필드 2개를 포함합니다. userPrivacyPolicy(uint32)와 userDisclosureMode(uint32)는 체인이 disclosureConfig().supportedUserPolicies / supportedUserModes에 선언한 정책 / 모드 쌍을 선택합니다. 세 개의 userDisclosure* 필드와 두 개의 self* 필드는 output이 선택한 정책 / 모드의 실제 페이로드를 담습니다. all-private 센티넬을 사용하는 output은 모드 NONE을 사용하고 digest / target / payload를 0으로 두어야 하며, 특정 target 공개키로 disclose하는 output은 userDisclosureTargetPubkey를 채워야 합니다.

클라이언트가 disclosureConfig와 circuitConfig를 읽는 이유

disclosureConfig()는 payloadVersion 문자열(클라이언트는 스캔된 output의 payloadVersion과 일치시켜야 함)과 userPrivacyPolicy / userDisclosureMode의 enum 공간을 반환합니다. circuitConfig()는 activeSetId, 타원 곡선, manifest 파일명, 아티팩트 목록(verifying key / wasm 파일명과 SHA-256), 각 회로의 verifying key 다이제스트를 고정한 PrivacyCircuitSetIdentity를 반환합니다. 시작 시 두 값을 한 번 읽습니다. 지갑은 체인이 공지하지 않은 회로 세트로 증명을 구성하지 않으며, 중간에 회로가 교체되는 것을 감지하기 위해 activeSetId를 고정합니다. auditConfiguration()은 체인의 networkNonce, initialHeight, 그리고 동일한 PrivacyCircuitSetIdentity를 반환합니다. nonce를 배포된 체인의 지문으로 취급하여, 사전 조회와 제출 사이에 값이 바뀌면 요청 전송을 거부합니다.
const dc = await publicClient.readContract({
  address: iPrivacyAddress,
  abi: iPrivacyAbi,
  functionName: "disclosureConfig",
});
console.log(dc.payloadVersion, dc.auditDisclosureRequired);
console.log("지원 정책:", dc.supportedUserPolicies);
console.log("지원 모드:  ", dc.supportedUserModes);

const cc = await publicClient.readContract({
  address: iPrivacyAddress,
  abi: iPrivacyAbi,
  functionName: "circuitConfig",
});
console.log("활성 회로 세트:", cc.activeSetId, cc.curve);

스캔된 output에서 audit 메타데이터가 흐르는 방식

체인이 privacyScan으로 전달하는 노트는 생성 시 사용된 audit / 회로 식별자를 담습니다. circuitSetId, payloadVersion, scanSchemaVersion, auditKeyId, auditKeyEpoch, auditTargetPubkey와 fullDisclosureDigest, auditDisclosurePayload, selfViewDisclosurePayload를 포함합니다. 지갑은 복호화하기 전에 output의 circuitSetId와 payloadVersion을 circuitConfig()와 disclosureConfig()에서 고정한 값과 일치시켜야 합니다. 값이 어긋나면 체인이 교체된 것이므로, 새 요청을 구성하기 전에 설정 view를 다시 읽습니다.

저장된 레코드가 잘못되었을 때 privacyScan이 보고하는 내용

요청으로 발생하는 오류가 아닙니다. privacyScan은 저장된 레코드를 반환하기 전에 검증하며, 아래 형식을 어긴 레코드를 만나면 실패합니다. 이 실패는 공통 타입 오류 QueryFailed("privacyScan", reason)로 도달하며, reason에는 다음 문자열 중 하나가 들어 있습니다. 보통 앞에 privacy scan output N does not match summary/state: … 같은 맥락이 붙습니다. "privacy scan all-private disclosure must use mode NONE and zero digest/target/payload", "privacy scan deposit output must use encrypted_note and an empty ciphertext/view tag", "privacy scan output must use exact zero disclosure sentinels", "undisclosed amount must use zero sentinel", "undisclosed recipient keys must use zero sentinels", "undisclosed sender keys must use zero sentinels", 그리고 audit 식별자 불일치의 경우 "privacy scan output audit identity does not match summary". QueryFailed는 IPrivacy ABI로 디코드하고 reason을 텍스트로 표시합니다. 이 오류를 만난 스캐너는 해당 페이지를 신뢰할 수 없으므로, output을 건너뛰지 말고 보고합니다.
ESC
검색어를 입력하세요