intents_submit

POST

/intents

curl --request POST \
  --url https://example.com/intents \
  --header 'Content-Type: application/json' \
  --data '{ "intent": { "attrs": { "fields": { "additionalProperty": "example" } }, "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "policy_id": "example" }, "signature": { "Ed25519": { "pub_key": "example", "signature": "example" } } }'

Submit a signed intent.

The signature is verified and the referenced policy must exist before the intent is stored.

Request Body ^required

Media type application/json

Intent signed by the user.

The signature is over the JCS (JSON Canonicalization Scheme, RFC 8785) serialization of the intent. The intent must therefore be serialized with JCS and signed, for instance as follows in Typescript.

import canonicalize from "canonicalize";

const jcs = canonicalize(json_intent)
const bytes = new TextEncoder().encode(jcs)
const signed = signer.signBytes(bytes)

object

intent

required

The intent that is being signed.

object

attrs

Attribute values that parameterize the policy.

In JSON, omit this field instead of putting "attrs": null.

object

fields

required

object

key

additional properties

id

required

Unique identifier for this intent.

string format: uuid

policy_id

required

ID of the policy that defines the rules for fulfilling this intent.

string

signature

required

One of:

object

Ed25519 signature

object

Ed25519

required

Ed25519 signature

object

pub_key

required

The [PubKey] of the signer

string

signature

required

The [Signature]

string

object

Passkey signature

object

Passkey

required

Passkey signature

object

authenticator_data

required

The bs58-encoded bytes of the authenticator data.

string

client_data

required

String containing the client data JSON.

This field is a string because JSON does not define property order, and we must guarantee that the UTF8 bytes of this string are exactly the same as those used by the passkey device.

string

pub_key

required

ECDSA Public Key

string

signature

required

ECDSA signature

string

object

Multisig signature

object

Multisig

required

Multisig signature

object

pub_key

required

The multisig descriptor to be checked against

object

signers

required

The list of signers and their associated weight

object

threshold

required

The threshold above which a subset of the signers can emit a valid signature

integer format: int64

signatures

required

The list of signatures

Array

One of:

object

Ed25519 signature

object

Ed25519

required

Ed25519 signature

object

pub_key

required

The [PubKey] of the signer

string

signature

required

The [Signature]

string

object

Passkey signature

object

Passkey

required

Passkey signature

object

authenticator_data

required

The bs58-encoded bytes of the authenticator data.

string

client_data

required

String containing the client data JSON.

This field is a string because JSON does not define property order, and we must guarantee that the UTF8 bytes of this string are exactly the same as those used by the passkey device.

string

pub_key

required

ECDSA Public Key

string

signature

required

ECDSA signature

string

recursive object

object recursive

Example ^generated

{
  "intent": {
    "attrs": {
      "fields": {
        "additionalProperty": "example"
      }
    },
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "policy_id": "example"
  },
  "signature": {
    "Ed25519": {
      "pub_key": "example",
      "signature": "example"
    }
  }
}

Responses

200

Intent accepted

400

Bad request

Media type application/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

409

Intent already exists

Media type application/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

500

Internal error

Media type application/json

object

message

required

string

Example ^generated

{
  "message": "example"
}