verify_receipt_log
Validate whole-file cryptographic integrity of an on-disk JSONL receipt log, returning aggregate chain and Merkle root status for CI gates or post-session audits.
Instructions
Validate whole-file cryptographic integrity of an on-disk JSONL receipt log written by epistemic-guard mcp-proxy, returning aggregate chain and Merkle root status rather than individual entries (use inspect_receipt to fetch entries). Call in CI gates or post-session audits; do not use to check assistant prose (use verify_narration) or mint receipts (signing is confined to the isolated mcp-proxy parent process). Passing both pubkey_file and expected_pubkey_hex requires them to encode the identical 32-byte key (omitting both checks self-consistency against entry 0), and any missing file, key conflict, sequence gap, or tampered digest returns isError=true naming the failing seq.
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": {
"log_path": "<log_path>"
},
"name": "verify_receipt_log"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| log_path | Yes | Filesystem path to the JSONL receipt log file. | |
| pubkey_file | No | Optional path to a pinned public key JSON or hex file. | |
| expected_pubkey_hex | No | Optional pinned 64-character hex Ed25519 public key. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| log_valid | Yes | True when all signatures, chain links, and Merkle roots hold. | |
| key_pinned | Yes | True when verified against an explicit caller-pinned key. | |
| entry_count | Yes | Total verified receipt records in the JSONL file. | |
| merkle_root | Yes | Hex-encoded 64-char RFC 6962 SHA-256 Merkle root. | |
| public_key_hex | Yes | Hex-encoded 32-byte Ed25519 public key verified across entries. | |
| head_chain_hash | Yes | Hex-encoded cumulative sequential SHA-256 chain tip. |