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

Provider	Status	Description
Cetus	✅ Active	Cetus Aggregator - primary provider
FlowX	✅ Active	FlowX DEX aggregator
Bluefin	✅ Active	Bluefin 7K aggregator