Ed25519 Zero-PII Provenance Proof & Optical Score Generator
generate_zk_provenance_proofComputes a 0x01-prefixed SHA-256 custodial Merkle root, optical microtopography score (7200-9985 bps), underwriting recommendation, and Ed25519-signed ZK_PROV_V1 zero-PII provenance certificate. Use when: generating a pre-bind title attestation for an asset_id and policy_ref from custodial SHA-256 digests. Do not use when: verifying an existing certificate (use verify_zk_provenance_proof instead) or sizing multi-asset portfolio loans (use batch_underwrite_portfolio instead). Behavior: Read-only attestation (p99=380ms; $2.50 USD / 250 cents via X-API-Key or X-Payment; returns an unbilled 402 quote if unentitled).
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": {
"asset_id": "<asset_id>",
"policy_ref": "<policy_ref>"
},
"name": "generate_zk_provenance_proof"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset_id | Yes | Unique alphanumeric collateral or vault asset identifier, 3-64 chars allowing underscores, colons, or hyphens (e.g., "art_vault_basquiat_09"). | |
| policy_ref | Yes | Underwriting binder or specialty title policy reference ID, 3-64 chars (e.g., "POL-CHUBB-2026-441"). | |
| optical_scan_sha256 | No | Optional 64-character hex SHA-256 digest of the raking-light or XRF optical microtopography scan; derived from asset_id when omitted. | |
| custody_event_hashes | No | Ordered list of up to 128 SHA-256 hex digests of prior custodial transfers folded into the 0x01 Merkle root; defaults to a genesis leaf if empty. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | Yes | Commercial execution tier ("gated_production"). | |
| tool | Yes | Executed tool identifier ("generate_zk_provenance_proof"). | |
| asset_id | Yes | Attested collateral identifier. | |
| policy_ref | Yes | Bound underwriting policy or binder reference. | |
| custody_chain_depth | Yes | Number of custodial transfer leaves folded into the Merkle tree. | |
| execution_latency_ms | Yes | Server-side execution duration in milliseconds. | |
| optical_forensic_score_bps | Yes | Surface microtopography concordance score in basis points (7200-9985). | |
| zk_attestation_certificate | Yes | Ed25519-signed ZK_PROV_V1 zero-PII attestation envelope. | |
| underwriting_recommendation | Yes | Deterministic specialty-title bind recommendation. | |
| title_lien_clearance_merkle_root | Yes | 0x-prefixed 64-hex SHA-256 Merkle root with 0x01 internal node separation. |