Skip to main content
POST
Sign typed data with a wallet

Authorizations

x-api-key
string
header
required

Headers

x-idempotency-key
string<uuid>
required

Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.

A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or whitespace) with the same key within that window returns the original response with X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason can be corrected and retried under the same key. Request bodies that are not JSON (for example file uploads) are not compared.

Path Parameters

wallet_id
string
required

Wallet ID KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

A request for a wallet's EIP-712 signature over a typed-data document, endorsed by the approvers' signatures over the intent.

signatures
string[]
required

List of signatures over the intent

Cryptographic signature over the intent, base64-encoded. For an ES256 signer this is the ASN.1 DER ECDSA signature over the SHA-256 of the canonical intent. For a WEBAUTHN signer this is the base64 of the WebAuthn assertion JSON (id, rawId, type, and response.authenticatorData / clientDataJSON / signature). See the WebAuthn & Passkey Signing guide.

intent
object
required

The typed-data document a wallet is asked to sign, and the chain it is for.

Response

The wallet's signature over the document. A repeat with the same idempotency_key and the same intent returns the stored signature.

An EIP-712 signature a wallet gave over a typed-data document.

id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

wallet_id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

caip2
string
required

The chain the document is for, as sent in the intent.

Example:

"eip155:8453"

signature
string
required

The 65-byte signature (r, s and v) as 0x followed by 130 lower-case hex digits.

Pattern: ^0x[0-9a-f]{130}$
Example:

"0x8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f8e3f0a6c1d2b4e5f1b"

created_at
integer<int64>
required

Unix time the signature was created.

Example:

1781181600