Initiate Gasless Intent

curl --request POST \
  --url https://api.example.com/api/v2/intentInitiation/initiateGaslessIntent \
  --header 'Content-Type: application/json' \
  --data '
{
  "intentGroupID": "<string>",
  "dAppID": "<string>",
  "intents": [
    "<string>"
  ],
  "gaslessIntentData": {
    "permit3": {
      "chainId": 1,
      "permitContract": "0x1234567890123456789012345678901234567890",
      "owner": "0x0987654321098765432109876543210987654321",
      "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b",
      "deadline": 1699999999,
      "timestamp": 1699988888,
      "merkleRoot": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "leaves": [
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
      ],
      "allowanceOrTransfers": [
        {
          "chainID": 1,
          "modeOrExpiration": 0,
          "tokenKey": "0x000000000000000000000000a0b86a33e6441b8ec2c8c7e5b0d77d5fdda0c4e4",
          "account": "0x742d35cc6634c0532925a3b8b0eff6a2db3b51a",
          "amountDelta": "1000000000000000000"
        }
      ]
    },
    "allowPartial": false
  }
}
'

{
  "successes": [
    "<string>"
  ],
  "failures": [
    "<string>"
  ]
}

POST

api

intentInitiation

initiateGaslessIntent

Initiate Gasless Intent

curl --request POST \
  --url https://api.example.com/api/v2/intentInitiation/initiateGaslessIntent \
  --header 'Content-Type: application/json' \
  --data '
{
  "intentGroupID": "<string>",
  "dAppID": "<string>",
  "intents": [
    "<string>"
  ],
  "gaslessIntentData": {
    "permit3": {
      "chainId": 1,
      "permitContract": "0x1234567890123456789012345678901234567890",
      "owner": "0x0987654321098765432109876543210987654321",
      "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b",
      "deadline": 1699999999,
      "timestamp": 1699988888,
      "merkleRoot": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "leaves": [
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
      ],
      "allowanceOrTransfers": [
        {
          "chainID": 1,
          "modeOrExpiration": 0,
          "tokenKey": "0x000000000000000000000000a0b86a33e6441b8ec2c8c7e5b0d77d5fdda0c4e4",
          "account": "0x742d35cc6634c0532925a3b8b0eff6a2db3b51a",
          "amountDelta": "1000000000000000000"
        }
      ]
    },
    "allowPartial": false
  }
}
'

{
  "successes": [
    "<string>"
  ],
  "failures": [
    "<string>"
  ]
}

Body

application/json

intentGroupID

string

required

dAppID

string

required

intents

string[]

required

gaslessIntentData

object

required

Show child attributes

gaslessIntentData.permit3

object

required

Permit3 signature data for multi-chain token approvals

Show child attributes

gaslessIntentData.permit3.chainId

number

required

The original chain ID where the request is being signed or executed

Example:

1

gaslessIntentData.permit3.permitContract

string

required

Address of the Permit3 contract

Example:

"0x1234567890123456789012345678901234567890"

gaslessIntentData.permit3.owner

string

required

Owner address of the tokens being permitted

Example:

"0x0987654321098765432109876543210987654321"

gaslessIntentData.permit3.salt

string

required

Unique salt value used for EIP-712 signature and nonce tracking

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

gaslessIntentData.permit3.signature

string

required

EIP-712 cryptographic signature from the token owner

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"

gaslessIntentData.permit3.deadline

integer<int64>

required

Expiration timestamp for the permit signature (uint48)

Example:

1699999999

gaslessIntentData.permit3.timestamp

number

required

Unix timestamp when the permit was created (uint48)

Example:

1699988888

gaslessIntentData.permit3.merkleRoot

string

required

Merkle root hash representing all chain permit leaves

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd"

gaslessIntentData.permit3.leaves

string[]

required

Optional array of Merkle tree leaves (hashed ChainPermits), useful for client-side debugging or proof regeneration

Example:

[
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
]

gaslessIntentData.permit3.allowanceOrTransfers

object[]

required

Flattened list of all permits across chains used to construct ChainPermits and Merkle tree leaves

Show child attributes

gaslessIntentData.permit3.allowanceOrTransfers.chainID

number

required

The chain ID where the allowance or transfer occurs

Example:

1

gaslessIntentData.permit3.allowanceOrTransfers.modeOrExpiration

number

required

Mode for transfer (0) or expiration timestamp for allowance update

Example:

0

gaslessIntentData.permit3.allowanceOrTransfers.tokenKey

string

required

Encoded tokenKey (ERC20: padded address, NFT: hash of token + tokenId)

Example:

"0x000000000000000000000000a0b86a33e6441b8ec2c8c7e5b0d77d5fdda0c4e4"

gaslessIntentData.permit3.allowanceOrTransfers.account

string

required

Account address receiving the allowance or transfer

Example:

"0x742d35cc6634c0532925a3b8b0eff6a2db3b51a"

gaslessIntentData.permit3.allowanceOrTransfers.amountDelta

integer<int64>

required

Amount delta for the allowance or transfer (in wei)

Example:

"1000000000000000000"

gaslessIntentData.allowPartial

boolean

default:false

Whether to allow partial funding of the intent

Example:

false

Response

default - application/json

successes

string[]

required

failures

string[]

required

Post apiv2quotereverse

⌘I

Getting started

Quote endpoints

Registering a solver

API interface for solvers

Initiate Gasless Intent

Body

Response