Overview
Ferra Aggregator V2 SDK
The Ferra Aggregator V2 SDK is a powerful TypeScript library for integrating decentralized exchange (DEX) aggregation functionality into your Sui blockchain applications. It aggregates quotes from multiple external DEX providers and executes swaps through Ferra's unified wrapper contracts.
Key Features
Multi-Provider Aggregation: Get the best quotes from Cetus, FlowX, and Bluefin aggregators
Unified Execution: Execute swaps through Ferra's wrapper contracts for consistent interface
Flexible Configuration: Enable/disable providers dynamically
Customizable Slippage: Configure slippage tolerance in basis points
Type Safety: Full TypeScript support with comprehensive type definitions
Transaction Composability: Build complex multi-step transactions with customizable swap functions
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ Ferra Aggregator V2 SDK │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Cetus │ │ FlowX │ │ Bluefin │ │
│ │ Aggregator │ │ Aggregator │ │ Aggregator │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └───────────────────┼───────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ Quote Router │ │
│ │ │ │
│ └────────┬─────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ TxBuilder │ │
│ │ (Swap Builder) │ │
│ └────────┬─────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────┐ │
│ │ Ferra Wrapper Contracts (Sui) │ │
│ │ ┌────────┐ ┌────────┐ ┌──────────┐ │ │
│ │ │ Cetus │ │ FlowX │ │ Bluefin │ │ │
│ │ │Wrapper │ │Wrapper │ │ Wrapper │ │ │
│ │ └────────┘ └────────┘ └──────────┘ │ │
│ └──────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Supported Providers
Cetus
✅ Active
Cetus Aggregator - primary provider
FlowX
✅ Active
FlowX DEX aggregator
Bluefin
✅ Active
Bluefin 7K aggregator
Last updated