Datoka API
Signed API declarations for agent handoffs. Free demo and verification; receipts cost 0.002 USDC.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWget_api_public_keys에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"api": {
"url": "https://datoka-api.bhazarstudio.workers.dev/mcp"
}
}
}원격 엔드포인트
https://datoka-api.bhazarstudio.workers.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (4)
🟢prepare_api_exchange(event)
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.
입력 스키마
{
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"minimum": 200,
"maximum": 599,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"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."
},
"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."
},
"targetHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"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",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers."
},
"responseHeadersHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected response headers."
},
"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."
}
},
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"additionalProperties": false,
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies."
}
},
"required": [
"event"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"minimum": 200,
"maximum": 599,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"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."
},
"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."
},
"targetHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"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",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers."
},
"responseHeadersHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected response headers."
},
"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."
}
},
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"additionalProperties": false,
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies."
},
"commitment": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256"
},
"encoding": {
"type": "string",
"const": "jcs"
},
"digest": {
"type": "string"
}
},
"required": [
"algorithm",
"encoding",
"digest"
],
"additionalProperties": false
},
"chain": {
"type": "string"
}
},
"required": [
"event",
"commitment",
"chain"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡issue_api_receipt(event, idempotencyKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"minimum": 200,
"maximum": 599,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"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."
},
"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."
},
"targetHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"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",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers."
},
"responseHeadersHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected response headers."
},
"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."
}
},
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"additionalProperties": false,
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies."
},
"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."
}
},
"required": [
"event",
"idempotencyKey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢verify_api_receipt(event, receipt)
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/.
입력 스키마
{
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "datoka.api.exchange.v1",
"description": "Declaration format version; preserve this literal."
},
"attestation": {
"type": "string",
"const": "client_declared",
"description": "The caller declares the exchange; Datoka does not independently observe it."
},
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"exchangeId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Stable identifier for one declared HTTP exchange."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
],
"description": "Actual HTTP method of the locally captured exchange, for example GET."
},
"status": {
"type": "integer",
"minimum": 200,
"maximum": 599,
"description": "Actual HTTP response status, including error responses; for example 200 or 404."
},
"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."
},
"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."
},
"targetHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of the exact UTF-8 target URL, computed locally. Never invent a digest or send the URL itself."
},
"requestBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "SHA-256 of exact application request bytes; null means no body, not an empty body."
},
"responseBodyHash": {
"anyOf": [
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"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",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected request headers. Never send raw headers."
},
"responseHeadersHash": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256",
"description": "Digest algorithm; always sha256."
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "SHA-256 of exact locally captured bytes, encoded as 64 lowercase hexadecimal characters."
}
},
"required": [
"algorithm",
"digest"
],
"additionalProperties": false,
"description": "SHA-256 of locally canonicalized selected response headers."
},
"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."
}
},
"required": [
"version",
"attestation",
"apiId",
"exchangeId",
"method",
"status",
"startedAt",
"completedAt",
"targetHash",
"requestBodyHash",
"responseBodyHash",
"requestHeadersHash",
"responseHeadersHash",
"bodyEncoding",
"headerEncoding"
],
"additionalProperties": false,
"description": "Commitment-only HTTP exchange declaration built locally with the SDK. No raw URLs, headers or bodies."
},
"receipt": {
"type": "object",
"properties": {
"body": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "datoka.receipt.v1"
},
"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)$"
},
"issuer": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"keyId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"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))$"
},
"request": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"chain": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"eventType": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"subject": {
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"const": "sha256"
},
"encoding": {
"type": "string",
"enum": [
"jcs",
"bytes"
]
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"algorithm",
"encoding",
"digest"
],
"additionalProperties": false
}
},
"required": [
"scope",
"chain",
"eventType",
"subject"
],
"additionalProperties": false
},
"sequence": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"previous": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
}
},
"required": [
"version",
"id",
"issuer",
"keyId",
"issuedAt",
"request",
"sequence",
"previous"
],
"additionalProperties": false
},
"algorithm": {
"type": "string",
"const": "Ed25519"
},
"signature": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{86}$"
}
},
"required": [
"body",
"algorithm",
"signature"
],
"additionalProperties": false,
"description": "Unmodified signed receipt returned by issuance or the public synthetic demo; verify against trusted issuer keys."
}
},
"required": [
"event",
"receipt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"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)$"
},
"scope": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"apiId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
"description": "Caller-chosen API identifier; not a certified provider identity."
},
"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"
}
},
"required": [
"valid",
"receiptId",
"scope",
"apiId",
"exchangeId",
"attestation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_api_public_keys
Return issuer public keys. Establish issuer trust independently before offline verification.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"issuer": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"keys": {
"type": "array",
"items": {
"type": "object",
"properties": {
"keyId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"jwk": {
"type": "object",
"properties": {
"kty": {
"type": "string",
"const": "OKP"
},
"crv": {
"type": "string",
"const": "Ed25519"
},
"x": {
"type": "string"
},
"key_ops": {
"type": "array",
"items": {
"type": "string"
}
},
"ext": {
"type": "boolean"
}
},
"required": [
"kty",
"crv",
"x"
],
"additionalProperties": false
}
},
"required": [
"keyId",
"jwk"
],
"additionalProperties": false
}
}
},
"required": [
"issuer",
"keys"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}커뮤니티
증거