Authorize intent

curl --request POST \
  --url https://sequencer.example.com/v1/credit/authorize \
  --header 'Content-Type: application/json' \
  --data '{
  "intent": {
    "version": 1,
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentPubKey": "0xabcdef1234567890abcdef1234567890abcdef12",
    "signatureScheme": "eip712-secp256k1",
    "agentNonce": "0",
    "amountMicros": "1000000",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "requiredChainRef": "eip155:8453",
    "expiresAt": "1735689600",
    "requestId": "0x9999888877776666555544443333222211110000aaaabbbbccccddddeeeeffff"
  },
  "agentSig": "0x123456789abcdef..."
}'

{
  "authorization": {
    "version": 1,
    "intentId": "0xaabbccdd11223344556677889900aabbccdd11223344556677889900aabbccdd",
    "authId": "0x1122334455667788990011223344556677889900112233445566778899001122",
    "authorizedAmountMicros": "1000000",
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentNonce": "0",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "chainRef": "eip155:8453",
    "issuedAt": "1735689000",
    "expiresAt": "1735689600",
    "sequencerEpochHint": "1",
    "logSeqNo": "42",
    "sequencerKeyId": "seq-key-1"
  },
  "sequencerSig": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "idempotent": false
}

POST

credit

authorize

curl --request POST \
  --url https://sequencer.example.com/v1/credit/authorize \
  --header 'Content-Type: application/json' \
  --data '{
  "intent": {
    "version": 1,
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentPubKey": "0xabcdef1234567890abcdef1234567890abcdef12",
    "signatureScheme": "eip712-secp256k1",
    "agentNonce": "0",
    "amountMicros": "1000000",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "requiredChainRef": "eip155:8453",
    "expiresAt": "1735689600",
    "requestId": "0x9999888877776666555544443333222211110000aaaabbbbccccddddeeeeffff"
  },
  "agentSig": "0x123456789abcdef..."
}'

{
  "authorization": {
    "version": 1,
    "intentId": "0xaabbccdd11223344556677889900aabbccdd11223344556677889900aabbccdd",
    "authId": "0x1122334455667788990011223344556677889900112233445566778899001122",
    "authorizedAmountMicros": "1000000",
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentNonce": "0",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "chainRef": "eip155:8453",
    "issuedAt": "1735689000",
    "expiresAt": "1735689600",
    "sequencerEpochHint": "1",
    "logSeqNo": "42",
    "sequencerKeyId": "seq-key-1"
  },
  "sequencerSig": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "idempotent": false
}

This endpoint validates and authorizes a payment intent, creating an authorization that can be executed by a relayer. The sequencer verifies the agent’s signature, checks their balance, and returns a signed authorization if successful.

Request body

intent

object

required

The payment intent to authorize.

Show properties

intent.version

number

required

Intent version. Must be 1.

intent.agentId

string

required

32-byte hex identifier of the agent (derived from public key).

intent.agentPubKey

string

required

Agent’s public key as hex. For EIP-712, this is the Ethereum address. For Ed25519, this is the raw public key.

intent.signatureScheme

string

required

Signature scheme used. Either eip712-secp256k1 or ed25519-sha256-v1.

intent.agentNonce

string

required

Uint64 string representing the agent’s current nonce. Must match the sequencer’s expected nonce.

intent.amountMicros

string

required

Uint64 string representing payment amount in micros (1/1,000,000 of a unit). Must be greater than 0.

intent.merchantId

string

required

32-byte hex identifier of the merchant receiving the payment.

intent.requiredChainRef

string

required

Chain reference for execution (e.g., eip155:8453 for Base or solana:devnet).

intent.expiresAt

string

required

Uint64 Unix timestamp (seconds) when the intent expires.

intent.requestId

string

required

32-byte hex idempotency key. Using the same requestId with a different intent will fail.

intent.serviceHash

string

Optional 32-byte hex hash for service-specific metadata.

intent.memoHash

string

Optional 32-byte hex hash for memo/note data.

agentSig

string

required

Hex-encoded signature of the intent by the agent’s private key.

Response

authorization

object

required

The signed authorization object.

Show properties

version

number

Authorization version (always 1).

intentId

string

32-byte hex hash of the intent.

authId

string

32-byte hex unique identifier for this authorization.

authorizedAmountMicros

string

Uint64 string of authorized amount in micros.

agentId

string

32-byte hex agent identifier.

agentNonce

string

Uint64 string of the agent nonce used.

merchantId

string

32-byte hex merchant identifier.

chainRef

string

Chain reference for execution.

issuedAt

string

Uint64 Unix timestamp when authorization was issued.

expiresAt

string

Uint64 Unix timestamp when authorization expires.

sequencerEpochHint

string

Uint64 epoch identifier hint for commitment tracking.

logSeqNo

string

Uint64 sequence number in the sequencer’s append-only log.

sequencerKeyId

string

Identifier of the sequencer key used to sign.

sequencerSig

string

required

Hex-encoded Ed25519 signature of the authorization by the sequencer.

idempotent

boolean

required

Whether this response is idempotent (true if requestId was previously used with the same intent).

Error codes

Code	Description
`INVALID_REQUEST`	Malformed request payload or validation error
`intent expired`	Intent’s `expiresAt` timestamp has passed
`unsupported requiredChainRef`	Chain reference not supported by sequencer
`invalid agent signature`	Agent signature verification failed
`agentId does not match agentPubKey`	Agent ID doesn’t match the derived ID from public key
`requestId already used for a different intent`	Idempotency key reused with different intent
`invalid agent nonce`	Nonce doesn’t match expected value
`insufficient sequencer balance`	Agent’s balance is insufficient for the payment

curl --request POST \
  --url https://sequencer.example.com/v1/credit/authorize \
  --header 'Content-Type: application/json' \
  --data '{
  "intent": {
    "version": 1,
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentPubKey": "0xabcdef1234567890abcdef1234567890abcdef12",
    "signatureScheme": "eip712-secp256k1",
    "agentNonce": "0",
    "amountMicros": "1000000",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "requiredChainRef": "eip155:8453",
    "expiresAt": "1735689600",
    "requestId": "0x9999888877776666555544443333222211110000aaaabbbbccccddddeeeeffff"
  },
  "agentSig": "0x123456789abcdef..."
}'

{
  "authorization": {
    "version": 1,
    "intentId": "0xaabbccdd11223344556677889900aabbccdd11223344556677889900aabbccdd",
    "authId": "0x1122334455667788990011223344556677889900112233445566778899001122",
    "authorizedAmountMicros": "1000000",
    "agentId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "agentNonce": "0",
    "merchantId": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "chainRef": "eip155:8453",
    "issuedAt": "1735689000",
    "expiresAt": "1735689600",
    "sequencerEpochHint": "1",
    "logSeqNo": "42",
    "sequencerKeyId": "seq-key-1"
  },
  "sequencerSig": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "idempotent": false
}

Report execution

⌘I

Build docs developers (and LLMs) love

Get started for free Talk to us

Sequencer API

Relayer API

Protocol

Request body

Response

Error codes

Build docs developers (and LLMs) love

Sequencer API

Relayer API

Protocol

Documentation Index

​Request body

​Response

​Error codes

Build docs developers (and LLMs) love

Request body

Response

Error codes