Getting started
Quote endpoints
Registering a solver
API interface for solvers
curl --request POST \
--url https://api.example.com/api/v2/quote \
--header 'Content-Type: application/json' \
--data '
{
"quoteID": "quote:966ee977-586b-4bca-abf1-e7def508a19c",
"dAppID": "<string>",
"intentExecutionTypes": [
"SELF_PUBLISH"
],
"quoteRequest": {
"sourceChainID": 123,
"destinationChainID": 123,
"sourceToken": "<string>",
"destinationToken": "<string>",
"sourceAmount": "<string>",
"funder": "<string>",
"recipient": "<string>",
"refundRecipient": "<string>"
},
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
},
"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
}
}
'Post apiv2quote
curl --request POST \
--url https://api.example.com/api/v2/quote \
--header 'Content-Type: application/json' \
--data '
{
"quoteID": "quote:966ee977-586b-4bca-abf1-e7def508a19c",
"dAppID": "<string>",
"intentExecutionTypes": [
"SELF_PUBLISH"
],
"quoteRequest": {
"sourceChainID": 123,
"destinationChainID": 123,
"sourceToken": "<string>",
"destinationToken": "<string>",
"sourceAmount": "<string>",
"funder": "<string>",
"recipient": "<string>",
"refundRecipient": "<string>"
},
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
},
"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
}
}
'Body
Unique identifier for the quote request
"quote:966ee977-586b-4bca-abf1-e7def508a19c"
Array of intent execution types to fetch quotes for
SELF_PUBLISH, GASLESS ["SELF_PUBLISH"]Show child attributes
Show child attributes
Show child attributes
Show child attributes
Contract address for the intent source (where intents are created and managed)
"0x1234567890abcdef1234567890abcdef12345678"
Contract address for the inbox (receives and processes cross-chain messages)
"0x567890abcdef1234567890abcdef1234567890ab"
Contract address for the prover (handles cross-chain proof verification)
"0xabcdef1234567890abcdef1234567890abcdef12"
Optional gasless intent data containing permit signatures for token approvals and execution configuration
Show child attributes
Show child attributes
Permit3 signature data for multi-chain token approvals
Show child attributes
Show child attributes
The original chain ID where the request is being signed or executed
1
Address of the Permit3 contract
"0x1234567890123456789012345678901234567890"
Owner address of the tokens being permitted
"0x0987654321098765432109876543210987654321"
Unique salt value used for EIP-712 signature and nonce tracking
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
EIP-712 cryptographic signature from the token owner
"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"
Expiration timestamp for the permit signature (uint48)
1699999999
Unix timestamp when the permit was created (uint48)
1699988888
Merkle root hash representing all chain permit leaves
"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd"
Optional array of Merkle tree leaves (hashed ChainPermits), useful for client-side debugging or proof regeneration
[
"0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321"
]Flattened list of all permits across chains used to construct ChainPermits and Merkle tree leaves
Show child attributes
Show child attributes
The chain ID where the allowance or transfer occurs
1
Mode for transfer (0) or expiration timestamp for allowance update
0
Encoded tokenKey (ERC20: padded address, NFT: hash of token + tokenId)
"0x000000000000000000000000a0b86a33e6441b8ec2c8c7e5b0d77d5fdda0c4e4"
Account address receiving the allowance or transfer
"0x742d35cc6634c0532925a3b8b0eff6a2db3b51a"
Amount delta for the allowance or transfer (in wei)
"1000000000000000000"
Whether to allow partial funding of the intent
false