Skip to main content
POST
/
v1
/
estimate
Estimate fees and expiration block heights for a transfer
curl --request POST \
  --url https://gateway-api-testnet.circle.com/v1/estimate \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "maxBlockHeight": "1000000000000000000",
    "maxFee": "1000000000000000000",
    "spec": {
      "version": 1,
      "sourceDomain": 0,
      "destinationDomain": 4,
      "sourceContract": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "destinationContract": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "sourceToken": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "destinationToken": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "sourceDepositor": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "destinationRecipient": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "sourceSigner": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "destinationCaller": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "value": "1000000000000000000",
      "salt": "0x1234567890123456789012345678901234567890123456789012345678901234",
      "hookData": "0x1a2b3c4d"
    }
  }
]'
[
  {
    "burnIntent": {
      "maxBlockHeight": "1000000000000000000",
      "maxFee": "1000000000000000000",
      "spec": {
        "version": 1,
        "sourceDomain": 0,
        "destinationDomain": 4,
        "sourceContract": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "destinationContract": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "sourceToken": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "destinationToken": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "sourceDepositor": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "destinationRecipient": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "sourceSigner": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "destinationCaller": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "value": "1000000000000000000",
        "salt": "0x1234567890123456789012345678901234567890123456789012345678901234",
        "hookData": "0x1a2b3c4d"
      }
    }
  }
]

Query Parameters

​
maxAttestationSize
integer

Maximum allowed size (in bytes) for the encoded attestation.

Required range: x >= 1

Body

application/json · object[]

Batch of partial burn intents or partial burn intent sets (without signatures).

  • Option 1
  • Option 2
​
spec
object
required
​
maxBlockHeight
string

The maximum block height at which this burn is valid (optional for estimation).

Example:

"1000000000000000000"

​
maxFee
string

The maximum fee the user is willing to pay (optional for estimation).

Example:

"1000000000000000000"

Response

Successfully calculated the estimated fees and expiration block heights

Array of burn intents or burn intent sets with calculated fees and expiration block heights.

  • Option 1
  • Option 2
​
burnIntent
object
required