IBEx.Fi Token Swap Flow

1. Swap Execution Flow
💱
Get Quote
GET /v1.1/safes/swap/quote
Returns quoteId + amounts
💼
Create Swap Operation
POST /v1.1/safes/operations
SWAP_FROM_QUOTE + quoteId
🔐
Sign Operation
PUT /v1.1/safes/operations
navigator.credentials.get()
User signs with passkey
✍️
Finalize Execution
Wait for Execution
Bundler submits to blockchain
Operation status: EXECUTED
2. Status Tracking Flow
📊
Check Status
Swap Complete
status = "CONFIRMED"
Tokens swapped on-chain

📋 Data to Store

  • quoteId : Unique quote identifier (required for execution)
  • buyAmount : Amount of tokens to receive (after fees)
  • feeAmount : Fees associated with the swap
  • validTo : Unix timestamp (quote expires ~5 minutes)
  • bestProvider : Recommended provider (COWSWAP or 1INCH)
  • userOpHash : Operation hash for status tracking

🔧 Endpoints

⚙️ Technical Details

  • Multi-provider support (CoW Protocol, 1inch)
  • Automatic provider comparison
  • Safe Account Abstraction (ERC-4337)
  • Gasless transactions (bundler/paymaster)
  • Quote validity: ~5 minutes
  • Status tracking: CREATED → SIGNED → EXECUTED → CONFIRMED
← Back to Swap Token Guide