Verify the journal hash chain
chain_verifyRecompute a tenant's entire journal hash chain and report whether each receipt's sequence and previous-hash link are valid. Read-only check for tenant owners, issuers, support readers, and auditors.
Instructions
Recompute the caller's tenant journal hash chain end to end and report whether every receipt's sequence and previous-hash link check out. Returns ok, the receipt count, the head hash, and -- on failure -- the sequence it failed at and why (sequence_gap or prev_hash_mismatch). Caller must be a principal of class tenant_owner, issuer, support_reader, or auditor. Use chain_verify_anchored instead when an externally witnessed anchor must be honoured. Read-only.
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": {
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "chain_verify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _tenant_id | Yes | Tenant the call acts for. The tenant must exist; an unknown tenant is refused with state LICENSE_UNKNOWN. Transport authentication is a deployment concern -- this parameter scopes the call, it does not authenticate it. | |
| _principal_id | Yes | Acting principal inside the tenant. Principal-gated tools refuse unknown principals and principals of the wrong class; executions (tier T2) additionally require a live, unexpired mandate covering the product and the operation class. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| count | No | ||
| reason | No | ||
| failed_at | No | ||
| head_hash | No |