Datoka API is an MCP server published by dev.workers.bhazarstudio.datoka-api, hosted at datoka-api.bhazarstudio.workers.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including prepare_api_exchange, issue_api_receipt, verify_api_receipt, get_api_public_keys.
Signed API declarations for agent handoffs. Free demo and verification; receipts cost 0.002 USDC.
6 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Free validation before buying a receipt. Supply an event built locally with the SDK from real captured bytes; never fabricate hashes. Returns the commitment without issuing a receipt or paying. Use when retaining verifiable evidence of an API response for a handoff or archive.
| Parameter | Type | Description |
|---|---|---|
| event * | object | Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies. |
{
"name": "prepare_api_exchange",
"title": "Prepare API Exchange",
"description": "Free validation before buying a receipt. Supply an event built locally with the SDK from real captured bytes; never fabricate hashes. Returns the commitment without issuing a receipt or paying. Use when retaining verifiable evidence of an API response for a handoff or archive.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event"
],
"properties": {
"event": {
"type": "object",
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"properties": {
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"method": {
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"type": "string",
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 200,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"startedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC start with milliseconds, for example 2026-10-07T08:00:00.000Z."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"targetHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself.",
"additionalProperties": false
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"completedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC completion with milliseconds; must be at or after startedAt."
},
"bodyEncoding": {
"type": "string",
"const": "application_bytes",
"description": "Hash application bytes after HTTP decoding, without JSON reserialization."
},
"headerEncoding": {
"type": "string",
"const": "jcs-selected-headers-v1",
"description": "Use the SDK header selection and JCS canonicalization before hashing."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application response bytes after HTTP decoding. Preserve those bytes; do not reserialize JSON."
},
"requestHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers.",
"additionalProperties": false
},
"responseHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected response headers.",
"additionalProperties": false
}
},
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies.",
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event",
"commitment",
"chain"
],
"properties": {
"chain": {
"type": "string"
},
"event": {
"type": "object",
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"properties": {
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"method": {
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"type": "string",
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 200,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"startedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC start with milliseconds, for example 2026-10-07T08:00:00.000Z."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"targetHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself.",
"additionalProperties": false
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"completedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC completion with milliseconds; must be at or after startedAt."
},
"bodyEncoding": {
"type": "string",
"const": "application_bytes",
"description": "Hash application bytes after HTTP decoding, without JSON reserialization."
},
"headerEncoding": {
"type": "string",
"const": "jcs-selected-headers-v1",
"description": "Use the SDK header selection and JCS canonicalization before hashing."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application response bytes after HTTP decoding. Preserve those bytes; do not reserialize JSON."
},
"requestHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers.",
"additionalProperties": false
},
"responseHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected response headers.",
"additionalProperties": false
}
},
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies.",
"additionalProperties": false
},
"commitment": {
"type": "object",
"required": [
"algorithm",
"encoding",
"digest"
],
"properties": {
"digest": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "jcs"
},
"algorithm": {
"type": "string",
"const": "sha256"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Buy a portable signed commitment to a declared API exchange when a recipient needs independently verifiable receipt integrity: response handoff, archived decision input, or change investigation. Costs 0.002 USDC per receipt via x402 when enabled; verification is free. A local log may suffice for disposable data. Requires caller-approved budget. Keep event, idempotency key and original payment unchanged on retry. Attests a client declaration, not provider origin, content truth or independent observation.
| Parameter | Type | Description |
|---|---|---|
| event * | object | Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies. |
| idempotencyKey * | string | One stable key per purchase, saved before payment. Keep it, the event and original payment authorization unchanged on retries. |
{
"name": "issue_api_receipt",
"title": "Issue API Receipt",
"description": "Buy a portable signed commitment to a declared API exchange when a recipient needs independently verifiable receipt integrity: response handoff, archived decision input, or change investigation. Costs 0.002 USDC per receipt via x402 when enabled; verification is free. A local log may suffice for disposable data. Requires caller-approved budget. Keep event, idempotency key and original payment unchanged on retry. Attests a client declaration, not provider origin, content truth or independent observation.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event",
"idempotencyKey"
],
"properties": {
"event": {
"type": "object",
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"properties": {
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"method": {
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"type": "string",
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 200,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"startedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC start with milliseconds, for example 2026-10-07T08:00:00.000Z."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"targetHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself.",
"additionalProperties": false
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"completedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC completion with milliseconds; must be at or after startedAt."
},
"bodyEncoding": {
"type": "string",
"const": "application_bytes",
"description": "Hash application bytes after HTTP decoding, without JSON reserialization."
},
"headerEncoding": {
"type": "string",
"const": "jcs-selected-headers-v1",
"description": "Use the SDK header selection and JCS canonicalization before hashing."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application response bytes after HTTP decoding. Preserve those bytes; do not reserialize JSON."
},
"requestHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers.",
"additionalProperties": false
},
"responseHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected response headers.",
"additionalProperties": false
}
},
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies.",
"additionalProperties": false
},
"idempotencyKey": {
"type": "string",
"pattern": "^[\\x21-\\x7e]{16,200}$",
"description": "One stable key per purchase, saved before payment. Keep it, the event and original payment authorization unchanged on retries."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Free signature and declaration verification. To try before buying, read datoka-api://demo-receipt or /demo/receipt.json and pass the returned JSON here. No wallet needed for public verification. Verifies issuer, scope and event commitment; compare original response bytes locally with the SDK or /verify/.
| Parameter | Type | Description |
|---|---|---|
| event * | object | Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies. |
| receipt * | object | Unmodified signed receipt returned by issuance or the public synthetic demo; verify against trusted issuer keys. |
{
"name": "verify_api_receipt",
"title": "Verify API Receipt",
"description": "Free signature and declaration verification. To try before buying, read datoka-api://demo-receipt or /demo/receipt.json and pass the returned JSON here. No wallet needed for public verification. Verifies issuer, scope and event commitment; compare original response bytes locally with the SDK or /verify/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event",
"receipt"
],
"properties": {
"event": {
"type": "object",
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"properties": {
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"method": {
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"type": "string",
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 200,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"startedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC start with milliseconds, for example 2026-10-07T08:00:00.000Z."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"targetHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself.",
"additionalProperties": false
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"completedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$",
"description": "Declared UTC completion with milliseconds; must be at or after startedAt."
},
"bodyEncoding": {
"type": "string",
"const": "application_bytes",
"description": "Hash application bytes after HTTP decoding, without JSON reserialization."
},
"headerEncoding": {
"type": "string",
"const": "jcs-selected-headers-v1",
"description": "Use the SDK header selection and JCS canonicalization before hashing."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application response bytes after HTTP decoding. Preserve those bytes; do not reserialize JSON."
},
"requestHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers.",
"additionalProperties": false
},
"responseHeadersHash": {
"type": "object",
"required": [
"algorithm",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
},
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
}
},
"description": "SHA-256 of locally canonicalized selected response headers.",
"additionalProperties": false
}
},
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies.",
"additionalProperties": false
},
"receipt": {
"type": "object",
"required": [
"body",
"algorithm",
"signature"
],
"properties": {
"body": {
"type": "object",
"required": [
"version",
"id",
"issuer",
"keyId",
"issuedAt",
"request",
"sequence",
"previous"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"keyId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"issuer": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"request": {
"type": "object",
"required": [
"scope",
"chain",
"eventType",
"subject"
],
"properties": {
"chain": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"scope": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"subject": {
"type": "object",
"required": [
"algorithm",
"encoding",
"digest"
],
"properties": {
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"encoding": {
"enum": [
"jcs",
"bytes"
],
"type": "string"
},
"algorithm": {
"type": "string",
"const": "sha256"
}
},
"additionalProperties": false
},
"eventType": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
}
},
"additionalProperties": false
},
"version": {
"type": "string",
"const": "datoka.receipt.v1"
},
"issuedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$"
},
"previous": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"sequence": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"algorithm": {
"type": "string",
"const": "Ed25519"
},
"signature": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{86}$"
}
},
"description": "Unmodified signed receipt returned by issuance or the public synthetic demo; verify against trusted issuer keys.",
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"valid",
"receiptId",
"scope",
"apiId",
"exchangeId",
"attestation"
],
"properties": {
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"scope": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"valid": {
"type": "boolean",
"const": true
},
"receiptId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"attestation": {
"type": "string",
"const": "client_declared"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return issuer public keys. Establish issuer trust independently before offline verification.
No parameters.
{
"name": "get_api_public_keys",
"title": "Get API Public Keys",
"description": "Return issuer public keys. Establish issuer trust independently before offline verification.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"issuer",
"keys"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "object",
"required": [
"keyId",
"jwk"
],
"properties": {
"jwk": {
"type": "object",
"required": [
"kty",
"crv",
"x"
],
"properties": {
"x": {
"type": "string"
},
"crv": {
"type": "string",
"const": "Ed25519"
},
"ext": {
"type": "boolean"
},
"kty": {
"type": "string",
"const": "OKP"
},
"key_ops": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"keyId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
}
},
"additionalProperties": false
}
},
"issuer": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Receipts attest signed declarations, not independently observed HTTP exchanges. Public issuance costs 0.002 USDC when payments are enabled. Preserve event, idempotencyKey AND the original x402 payment payload across retries. A pending payment must not be replaced with a new authorization. EOA EIP-3009 wallets on the advertised network are supported. Start without paying: resources/read datoka-api://demo-receipt then verify_api_receipt with that JSON. Read datoka-api://integration for capture and recoverable purchase instructions. Smithery payment forwarding is not validated; direct HTTP purchase is supported.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.