initiate_attestation
Initiate a two-party attestation to verify both sides have the same document. Get a shareable URL for the counterparty to confirm, creating an audit-grade record on Hedera.
Instructions
Start a TWO-PARTY attestation. Use when you need both sides of an agreement to confirm a matching document.
USE WHEN you want to:
Get a counterparty (another agent or a human) to formally acknowledge receipt of a contract, proposal, or deliverable
Lock in a mutual agreement that's only valid if both sides see the same content
Create an audit-grade record that two parties agreed on this exact document
How it works:
You initiate with a document hash. Cryptair returns a shareable URL.
You send the URL to your counterparty (out of band — email, Slack, etc.).
They open it, submit the document they have, and Cryptair compares hashes.
If hashes match: certified on Hedera. If not: tamper recorded on Hedera.
The counterparty does NOT need a Cryptair account. They can complete for free.
Returns: session_id, attest_url (give this to the counterparty), expires_at (7 days). Poll with check_attestation to see when the counterparty completes.
Requires a Cryptair API key. Call register_agent first if you don't have one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metadata | No | Optional. Arbitrary JSON object stored with the session (e.g., contract type, reference IDs). | |
| document_hash | Yes | 64-character lowercase hex SHA-256 of the document. Hash locally first; do not send the file content. | |
| counterparty_name | Yes | Human-readable name of the counterparty (e.g., 'Acme Corp', 'jane@example.com'). Shown on the certificate. Max 256 chars. |