Verify catch record on chain
verify_catchVerify a GYOTAK catch record DIRECTLY from the Midnight blockchain. Reads on-chain state and returns the raw hex plus decoded fields for independent verification. Unlike get_catch_reports (GYOTAK's own list of records: date, district and verify links, never GPS), this lets you verify without trusting GYOTAK. The exact position is not on the chain (only a commitment to it). The region name is a label set by GYOTAK. GYOTAK checks the region range when recording, but the range used is not part of the record, so a third party cannot confirm it from the chain. Supports both preprod and mainnet. batchId also accepts several IDs separated by commas: they are all checked against a single fetch of the contract state, and the response lists found/not-found per ID.
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": {
"contractAddress": "<contractAddress>"
},
"name": "verify_catch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batchId | No | Filter to a specific catch record by batchId (e.g. "CR-20261021-37b2b7be"). Omit to return all records in the contract. | |
| network | No | Midnight network (default: mainnet) | |
| contractAddress | Yes | Midnight contract address (64-char hex). Example: bc33d8c05852decd4ef183201a8a9f3c25eabaa46a81786f306b95397ed118ab |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Same text as content when the input or the lookup failed | |
| found | No | ||
| source | No | Where the on-chain state was read from | |
| message | No | Same text as content when there is nothing to show | |
| records | No | All catch records (no batchId given) | |
| results | No | Several batch IDs | |
| raw_state | No | ||
| match_type | No | ||
| occurrences | No | ||
| verify_urls | No | ||
| match_offsets | No | ||
| batchId_queried | No | ||
| gps_recoverable | No | ||
| customer_summary | No | ||
| raw_state_sha256 | No | ||
| tentative_records | No | ||
| verification_note | No | ||
| presentation_guidance | No | ||
| raw_state_length_bytes | No | ||
| tentative_records_note | No |