certify_document
Certify a document by generating a tamper-evident, on-chain proof of its existence at a specific moment. Returns a verifiable receipt with timestamp and blockchain transaction ID.
Instructions
Create a tamper-evident, on-chain proof that a document exists in this exact state right now.
USE WHEN you want to:
Lock in a contract, proposal, or agreement at a specific moment
Prove a deliverable existed before a deadline
Anchor a code commit, report, or any digital artifact to an immutable timestamp
Generate a receipt that anyone can verify (no Cryptair account required to verify)
This is a SINGLE-PARTY operation. It writes a SHA-256 hash of the file to Hedera Hashgraph. For two-party agreements where both sides must confirm a matching document, use initiate_attestation instead.
Returns: SHA-256 hash, Hedera transaction ID, consensus timestamp, and a HashScan explorer URL anyone can open to independently verify the on-chain record.
Requires a Cryptair API key. If none is configured, call register_agent first.
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": {
"file_path": "<file_path>"
},
"name": "certify_document"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Absolute path to the file to certify. SHA-256 hashed locally before sending. | |
| notify_email | No | Optional. If set, Cryptair emails a PDF certificate to this address. Useful when a human counterparty needs the receipt. |