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

PUT /v1.1/safes/operations
Submit credential

⏳

Wait for Execution

Bundler submits to blockchain
Operation status: EXECUTED

2. Status Tracking Flow

📊

Check Status

GET /v1.1/safes/operations/{userOpHash}
Poll until CONFIRMED

✅

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

1. Swap Execution Flow
GET /v1.1/safes/swap/quote : Get swap quote
POST /v1.1/safes/operations : Create swap operation
PUT /v1.1/safes/operations : Finalize swap execution
2. Status Tracking Flow
GET /v1.1/safes/operations/{userOpHash} : Check operation status

⚙️ 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