DAO Docs

Quickstarter

🧩 Everclear Intents Overview

The Everclear system supports multiple types of intents, depending on user needs — speed, cost, and liquidity availability. Each intent represents a user’s instruction to transfer or swap assets across chains.

🔹 Intent Types

1. Basic Intent (Netting Path)

  • Description: The standard route for intent execution.

  • Speed: ~20 minutes

  • Fees: Lowest among all intent types

  • Path: Uses the regular netting path where settlement happens after batching.

2. Priority Settlement (Same Asset)

  • Description: Faster settlement for transfers of the same asset across chains.

  • Speed: < 2 minutes

  • Fees: Slightly higher than Basic

  • Execution: Filled directly by the solver from inventory.

3. Priority Settlement Swap (Bridge + Swap)

  • Description: Enables cross-chain swaps (different assets between chains).

  • Speed: < 2 minutes

  • Fees: Depends on liquidity and route (includes swap fees)

  • Execution: Solver fulfills both bridge + swap in a single fast operation.

⚙️ Creating Intents

All intents are created through the API. Before creation, it’s recommended to fetch quotes to understand fees, expected output, and available routes.

💬 Getting Quotes

Use the /routes/quotes endpoint to get an estimate of:

  • Expected output amount after fees

  • Fee breakdown (fixed + variable)

  • Route limits

  • Settlement time estimates

  • Availability of fast path options

🧠 Example: Get Quote for Sending 10K USDC Optimism → USDT Ethereum

const axios = require('axios');

const data = JSON.stringify({
  "origin": "10", // Origin chain ID (Optimism)
  "destinations": ["1"], // Destination chain IDs (Ethereum)
  "inputAsset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", // USDC on OP
  "amount": "10000000000", // Amount in asset decimals (10,000 USDC = 1e10)
  "to": "0xade09131C6f43fe22C2CbABb759636C43cFc181e", // Receiver address
  "from": "0xade09131C6f43fe22C2CbABb759636C43cFc181e" // Sender address
});

const config = {
  method: 'post',
  url: 'https://api.everclear.org/routes/quotes',
  headers: { 
    'Content-Type': 'application/json'
  },
  data
};

axios.request(config)
  .then((response) => console.log(JSON.stringify(response.data, null, 2)))
  .catch((error) => console.error(error));

💡 For Priority Settlement Swap

To request a quote for Priority Settlement Swap (different input/output assets), include outputAsset on the destination chain:

const data = JSON.stringify({
  "origin": "10",
  "destinations": ["1"],
  "inputAsset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", // USDC on OP
  "outputAsset": "0xdAC17F958D2ee523a2206206994597C13D831ec7", // USDT on ETH
  "amount": "10000000000",
  "to": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "from": "0xade09131C6f43fe22C2CbABb759636C43cFc181e"
});

📦 Sample Response

{
  "fixedFeeUnits": "537600",
  "variableFeeBps": 0,
  "totalFeeBps": 0.5376,
  "expectedAmount": "9999462400",
  "currentLimit": "4999959549397",
  "settlementEstimate": {
    "p25Minutes": 11.75,
    "p50Minutes": 15,
    "p75Minutes": 19.75
  },
  "splitCount": 1,
  "fastPathQuote": {
    "fixedFeeUnits": "537600",
    "variableFeeBps": 3,
    "totalFeeBps": 3.5376,
    "expectedAmount": "9996462400"
  },
  "reqType": "bridge"
}

🧾 Response Fields Explained

Field
Description

fixedFeeUnits

Flat fee for the route

variableFeeBps

Variable fee (in basis points) based on liquidity

totalFeeBps

Combined total fee in basis points

expectedAmount

Expected output after all fees

currentLimit

Current route capacity

settlementEstimate

Estimated time (in minutes) for completion

splitCount

Number of route splits (if multi-path)

fastPathQuote

Fee + output estimate for Fast Path execution

reqType

Request type (bridge / swap)

🧭 Notes

  • Always check currentLimit to ensure your intent can be routed immediately.

  • Fast path routes may be unavailable if solver liquidity is low.

  • Basic path provides more predictable execution but slower settlement.

🚀 Creating Intents

After obtaining a quote via the /routes/quotes endpoint, you can create an Intent using the /intents/ endpoint. The intent defines the exact on-chain transaction parameters required to initiate a transfer or swap through Everclear.

🧭 Intent Creation Flow

  1. Get Quote → /routes/quotes Preview available routes, estimated output, and fees.

  2. Create Intent → /intents/ Submit chosen parameters (origin, destination, input/output assets).

  3. Execute Transaction → On-chain Use the returned calldata + target address from the API response.

🔹 Endpoint

POST https://api.everclear.org/intents/

⚙️ Common Request Parameters

Field
Type
Required
Description

amount

string

✅

Amount to send (in token decimals).

origin

string

✅

Chain ID of the source network.

destinations

string[]

✅

Array of destination chain IDs.

inputAsset

string

✅

Asset address on the origin chain.

outputAsset

string

Optional

Destination asset address (only for swaps).

to

string

✅

Receiver wallet address.

from

string

✅

Sender wallet address.

callData

string

Optional

Additional encoded calldata (if any).

isFastPath

boolean

Optional

true for Fast Path, omit or false for Basic Path.

🧠 Example 1: Basic Intent (Netting Path)

For the regular 15–20 minute netting route (lowest fees), ➡️ Remove both outputAsset and isFastPath.

const data = JSON.stringify({
  "amount": "10000000000",
  "origin": "10",
  "destinations": ["1"],
  "inputAsset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", // USDC on OP
  "to": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "from": "0xade09131C6f43fe22C2CbABb759636C43cFc181e"
});

This will route the intent through the standard netting system, ideal for larger or lower-fee transfers.

🧠 Example 2: Fast Path (Same Asset)

Transfer 10,000 USDT from Optimism → Ethereum, same token (no swap). ➡️ Remove the outputAsset field.

const data = JSON.stringify({
  "amount": "10000000000",
  "origin": "10",
  "destinations": ["1"],
  "inputAsset": "0xdAC17F958D2ee523a2206206994597C13D831ec7", // USDT on OP
  "to": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "from": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "isFastPath": true
});

🧠 Example 3: Fast Path Swap (Bridge + Swap)

Transfer 10,000 USDC from Optimism (chainId 10) → Ethereum (chainId 1) as USDT, via Fast Path.

const axios = require('axios');

const data = JSON.stringify({
  "amount": "10000000000", // 10,000 USDC (in decimals)
  "origin": "10", // Optimism
  "destinations": ["1"], // Ethereum
  "inputAsset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", // USDC on OP
  "outputAsset": "0xdAC17F958D2ee523a2206206994597C13D831ec7", // USDT on ETH
  "to": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "from": "0xade09131C6f43fe22C2CbABb759636C43cFc181e",
  "callData": "",
  "isFastPath": true // Fast Path = under ~2 mins
});

const config = {
  method: 'post',
  url: 'https://api.everclear.org/intents/',
  headers: { 
    'Content-Type': 'application/json'
  },
  data
};

axios.request(config)
  .then((response) => console.log(JSON.stringify(response.data, null, 2)))
  .catch((error) => console.error(error));

📦 Response

{
  "to": "0xd0185bfb8107c5b2336bC73cE3fdd9Bfb504540e",
  "data": "0x...",
  "chainId": 10,
  "value": "0"
}

🧾 Response Fields

Field
Type
Description

to

string

The Fees Adapter contract address — transaction target.

data

string

Encoded calldata required for execution.

chainId

number

Origin chain ID where transaction must be broadcast.

value

string

Native token (in wei) to send along with the transaction (typically "0").

PreviousGuidesNextPriority Settlement

Last updated