Skip to main content
POST
/
api
/
v3
/
quotes
/
initiateGaslessIntent
Initiate Gasless Intent
curl --request POST \
  --url https://quotes.eco.com/api/v3/quotes/initiateGaslessIntent \
  --header 'Content-Type: application/json' \
  --data '{
  "intentGroupID": "group:01234567-89ab-cdef-0123-456789abcdef",
  "dAppID": "my-dapp",
  "intentEntries": [
    {
      "routeData": {
        "originChainID": "8453",
        "destinationChainID": "10",
        "inboxContract": "0x123abc456def789012345678901234567890abcd",
        "tokens": [
          {
            "token": "0xA0b86a33E6441446C1c3df4c64B739C7e4a81ec0",
            "amount": "1000000"
          }
        ],
        "calls": [
          {
            "target": "0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa",
            "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b8d56c85e83f9d18fa0000000000000000000000000000000000000000000000000000000000989680",
            "value": "0"
          }
        ],
        "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      },
      "rewardData": {
        "creator": "0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa",
        "proverContract": "0x1234567890abcdef1234567890abcdef12345678",
        "deadline": "1699123456",
        "nativeValue": "0",
        "tokens": [
          {
            "token": "0xA0b86a33E6441446C1c3df4c64B739C7e4a81ec0",
            "amount": "1000000"
          }
        ]
      },
      "quoteID": "quote:01234567-89ab-cdef-0123-456789abcdef",
      "solverID": "0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa",
      "salt": "<string>"
    }
  ],
  "gaslessIntentData": {
    "permit3": {
      "chainId": 1,
      "permitContract": "0x1234567890123456789012345678901234567890",
      "owner": "0x0987654321098765432109876543210987654321",
      "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b",
      "deadline": "1234567890",
      "timestamp": 1234567890,
      "merkleRoot": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "leaves": [
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
        "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
      ],
      "allowanceOrTransfers": [
        {
          "chainID": 1,
          "modeOrExpiration": 0,
          "tokenKey": "0xA0b86a33E6441B8Ec2c8C7E5b0d77D5FdDa0c4E4",
          "account": "0x742d35cc6634c0532925a3b8b0eff6a2db3b51a",
          "amountDelta": "1000000000000000000"
        }
      ]
    },
    "allowPartial": false
  }
}'
{
  "data": {
    "successes": [
      {
        "chainID": 1,
        "quoteIDs": [
          "quote_abc123def456",
          "quote_ghi789jkl012"
        ],
        "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "error": {
          "message": "Insufficient balance",
          "code": "INSUFFICIENT_FUNDS"
        }
      }
    ],
    "failures": [
      {
        "chainID": 1,
        "quoteIDs": [
          "quote_abc123def456",
          "quote_ghi789jkl012"
        ],
        "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "error": {
          "message": "Insufficient balance",
          "code": "INSUFFICIENT_FUNDS"
        }
      }
    ]
  }
}

Body

application/json
intentGroupID
string
required

Unique identifier of the group of intents being used

Example:

"group:01234567-89ab-cdef-0123-456789abcdef"

dAppID
string
required

Identifier for the client application initiating the gasless intent

Example:

"my-dapp"

intentEntries
object[]
required

Array of intent request entries

gaslessIntentData
object
required

Gasless intent configuration containing permit signatures and execution parameters

Response

201 - application/json

Successfully initiated gasless intent transaction

data
object
required

Gasless intent execution response data

I