KAkairos
On-chain intents (preview)

Commit an on-chain intent with its signatures

Preview: available on staging (https://staging-execution.kairos.trade); production returns 503 until release.

Commits the intent before executeBefore. consentSignature is always required; nativeSignature is required when submissionOwner is kairos and must be omitted when it is client. Kairos checks every dependency is confirmed, checks the finalized token balances cover the debits net of the wallet's other reservations, then commits: ready (Kairos submits once, then reconciling → confirmed) or awaiting_client (you submit, see below).

Calling it again after a successful commit, with valid signatures, returns the current intent.

Client submission. POST submission.body with "signature": <native signature> added to submission.endpoint, then POST /v3/onchain-intents/{id}/reports with the transaction hash. Do not send the batch from the wallet or the deposit wallet.

post/v3/onchain-intents/{id}/execute

Request

  • Base URL
    https://execution.kairos.trade
  • Auth
    • API key in header X-Kairos-Partner-Id and API key in header Authorization
    • or API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret and API key in header Authorization
    • or API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret
    • or API key in header X-Kairos-Partner-Id and API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret
    • or API key in header X-Kairos-Partner-Id and HTTP bearer

Path parameters

idstring uuid required

On-chain intent id (intent.terms.id).

Request body

intentHashstring required

Must equal intent.intentHash.

consentSignaturestring required

Signature of consentRequest — 0x + 65 bytes (r‖s‖v, low-s, v 0/1/27/28).

nativeSignaturestring

Signature of nativeRequest, same format. Required when submissionOwner is kairos; must be omitted when client.

Response

The committed intent (committed: true; ready or awaiting_client).

Changes

No recorded changes to this operation across all 1 revision of this API.