Ed25519 Zero-PII Provenance Certificate & Merkle Verifier
verify_zk_provenance_proofVerifies an ariadne-zk-ed25519-v1 (ZK_PROV_V1) provenance certificate across Ed25519 signature validity, zero-PII enforcement, signed claim parity, optional pinned oracle key, and optional 0x01 SHA-256 custodial Merkle recomputation. Use when: auditing a certificate from generate_zk_provenance_proof before policy bind or loan closing. Do not use when: generating a new proof (use generate_zk_provenance_proof instead), checking a manifest digest (use verify_asset_hash instead), or auditing portfolio LTV cap compliance (use verify_underwriting_compliance instead). Behavior: Read-only, stateless cryptographic check (p99=18ms; free discovery tier at 60 RPM without billing).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"zk_attestation_certificate": "<zk_attestation_certificate>"
},
"name": "verify_zk_provenance_proof"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset_id | No | Optional outer asset_id cross-checked against the signed asset claim. | |
| policy_ref | No | Optional outer policy_ref cross-checked against the signed policy claim. | |
| custody_event_hashes | No | Optional ordered custodial SHA-256 digests used to independently recompute and verify the 0x01-prefixed Merkle root. | |
| pinned_oracle_pubkey_b64 | No | Optional out-of-band pinned base64 Ed25519 oracle public key enforced during verification. | |
| optical_forensic_score_bps | No | Optional outer optical score (0-10000 bps) cross-checked against signed optical_bps. | |
| zk_attestation_certificate | Yes | Signed ZK_PROV_V1 certificate object emitted by generate_zk_provenance_proof. | |
| title_lien_clearance_merkle_root | No | Optional outer 64-hex Merkle root cross-checked against signed merkle_root. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | Yes | Commercial execution tier ("free_discovery"). | |
| tool | Yes | Executed tool identifier ("verify_zk_provenance_proof"). | |
| scheme | Yes | Evaluated certificate scheme identifier. | |
| verified | Yes | True only when signature, zero-PII, claims, pinned key, and Merkle checks all pass. | |
| failure_code | Yes | Verification disposition code ("NONE" when verified is true). | |
| signed_claims | Yes | Parsed key-value claims from the signed ZK_PROV_V1 statement. | |
| failure_detail | No | Diagnostic explanation populated when verified is false. | |
| signature_valid | Yes | True when the Ed25519 signature over public_statement verified cleanly. | |
| zero_pii_confirmed | Yes | True when seller_pii_exposed is strictly false. | |
| pinned_key_enforced | Yes | True when pinned_oracle_pubkey_b64 was supplied and matched. | |
| execution_latency_ms | Yes | Server-side execution duration in milliseconds. | |
| oracle_pubkey_sha256_hex | Yes | Lowercase 64-hex SHA-256 fingerprint of the raw 32-byte Ed25519 public key. | |
| oracle_pubkey_ed25519_b64 | Yes | Base64 Ed25519 public key extracted from the certificate. | |
| merkle_chain_independently_recomputed | Yes | True when custody_event_hashes were supplied and matched signed merkle_root. |