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"
        }
      }
    ]
  }
}

POST

api

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

Show child attributes

intentEntries.routeData

object

required

Route configuration specifying source and destination chains and transfer details

Show child attributes

intentEntries.routeData.originChainID

string

required

Chain ID where the intent originates

Example:

"8453"

intentEntries.routeData.destinationChainID

string

required

Chain ID where the intent will be executed

Example:

"10"

intentEntries.routeData.inboxContract

string

required

Address of the inbox contract on the destination chain

Example:

"0x123abc456def789012345678901234567890abcd"

intentEntries.routeData.tokens

object[]

required

Array of ERC20 tokens and amounts involved in the destination calls

Show child attributes

intentEntries.routeData.tokens.token

string

required

Address of the ERC20 token contract

Example:

"0xA0b86a33E6441446C1c3df4c64B739C7e4a81ec0"

intentEntries.routeData.tokens.amount

string

required

Token amount in smallest unit (wei for ETH, base units for ERC20 tokens)

Example:

"1000000"

intentEntries.routeData.calls

object[]

required

Array of contract calls to be executed on the destination chain

Show child attributes

intentEntries.routeData.calls.target

string

required

Address of the contract to call or recipient for native token transfers

Example:

"0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa"

intentEntries.routeData.calls.data

string

required

Encoded function call data or empty for native token transfers

Example:

"0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b8d56c85e83f9d18fa0000000000000000000000000000000000000000000000000000000000989680"

intentEntries.routeData.calls.value

string

required

Native token value to send with the call (in wei)

Example:

"0"

intentEntries.routeData.salt

string

Salt for the intent (used when initiating gasless intents or publishing on-chain, set to '0x0' for quote requests)

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

intentEntries.rewardData

object

required

Reward configuration defining tokens and amounts offered to solvers for executing the intent

Show child attributes

intentEntries.rewardData.creator

string

required

Address of the user creating this intent, this will be the recipient of a refund if the intent expires

Example:

"0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa"

intentEntries.rewardData.proverContract

string

required

Address of the prover contract that validates intent execution

Example:

"0x1234567890abcdef1234567890abcdef12345678"

intentEntries.rewardData.deadline

string

required

Unix timestamp deadline for when this intent expires (in seconds)

Example:

"1699123456"

intentEntries.rewardData.nativeValue

string

required

Native token amount offered (in wei)

Example:

"0"

intentEntries.rewardData.tokens

object[]

required

Array of ERC20 tokens and amounts offered on the origin chain for fulfilling the intent

Show child attributes

intentEntries.rewardData.tokens.token

string

required

Address of the ERC20 token contract

Example:

"0xA0b86a33E6441446C1c3df4c64B739C7e4a81ec0"

intentEntries.rewardData.tokens.amount

string

required

Token amount in smallest unit (wei for ETH, base units for ERC20 tokens)

Example:

"1000000"

intentEntries.quoteID

string

required

Unique identifier of the quote being used to initiate the gasless intent

Example:

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

intentEntries.solverID

string

required

Address of the solver that provided the quote

Example:

"0x742d35Cc6634C0532925a3b8D56C85e83F9D18Fa"

intentEntries.salt

string

required

gaslessIntentData

object

required

Gasless intent configuration containing permit signatures and execution parameters

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 from the signature

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 for the permit signature

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

gaslessIntentData.permit3.signature

string

required

Cryptographic signature for the permit

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"

gaslessIntentData.permit3.deadline

string

required

Expiration timestamp for the permit signature

Example:

"1234567890"

gaslessIntentData.permit3.timestamp

number

required

Unix timestamp when the permit was created

Example:

1234567890

gaslessIntentData.permit3.merkleRoot

string

required

Merkle root hash representing all chain permit leaves

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd"

gaslessIntentData.permit3.leaves

string[]

required

Array of merkle tree leaf hashes for multi-chain permits

Example:

[
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
  "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
]

gaslessIntentData.permit3.allowanceOrTransfers

object[]

required

Array of allowance or transfer data organized by chain for multi-chain permits

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 allowance (0) or expiration timestamp for transfer

Example:

0

gaslessIntentData.permit3.allowanceOrTransfers.tokenKey

string

required

Token contract address

Example:

"0xA0b86a33E6441B8Ec2c8C7E5b0d77D5FdDa0c4E4"

gaslessIntentData.permit3.allowanceOrTransfers.account

string

required

Account address for the allowance or transfer

Example:

"0x742d35cc6634c0532925a3b8b0eff6a2db3b51a"

gaslessIntentData.permit3.allowanceOrTransfers.amountDelta

string

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

201 - application/json

Successfully initiated gasless intent transaction

data

object

required

Gasless intent execution response data

Show child attributes

data.successes

object[]

required

Array of successfully initiated gasless intent executions

Show child attributes

data.successes.chainID

number

required

Chain ID where the gasless intent was executed

Example:

1

data.successes.quoteIDs

string[]

required

Array of quote IDs associated with this execution

Example:

["quote_abc123def456", "quote_ghi789jkl012"]

data.successes.transactionHash

string

required

Transaction hash of the executed gasless intent

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

data.successes.error

object

Error details if the gasless intent execution failed

Example:

{
  "message": "Insufficient balance",
  "code": "INSUFFICIENT_FUNDS"
}

data.failures

object[]

required

Array of failed gasless intent execution attempts with error details

Show child attributes

data.failures.chainID

number

required

Chain ID where the gasless intent was executed

Example:

1

data.failures.quoteIDs

string[]

required

Array of quote IDs associated with this execution

Example:

["quote_abc123def456", "quote_ghi789jkl012"]

data.failures.transactionHash

string

required

Transaction hash of the executed gasless intent

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

data.failures.error

object

Error details if the gasless intent execution failed

Example:

{
  "message": "Insufficient balance",
  "code": "INSUFFICIENT_FUNDS"
}

Get Exact Out Quotes Get Intent Status

⌘I

Getting started

Quote endpoints

Registering a solver

API interface for solvers

Initiate Gasless Intent

Body

Response