cetus-agg-kmp

Simplifies interacting with the Cetus Aggregator on Sui, offering smart routing, automatic gas and transaction construction, and a type-safe DSL for concise swap operations.

#service-sdk
#sdk
#dsl
#crypto
#client
#apple

Suggest an edit

Android JVMJVMKotlin/Native

GitHub stars0

Authorsmcxross

Open issues0

LicenseApache License 2.0

Creation dateabout 2 months ago

Last activityabout 2 months ago

Latest release0.1.0 (about 2 months ago)

GitHub repository Wiki page

KMP Cetus Aggregator

A Kotlin Multiplatform (KMP) SDK that makes interacting with the Cetus Aggregator on Sui insanely simple.

Built on top of ksui, this SDK handles all the complex routing, gas management, and transaction construction for you. It supports JVM, Android, iOS and macOS.

Why use this?

Insanely Simple API: Perform swaps in just a few lines of code.
Smart Routing: Automatically finds the best route for your swap.
Type-Safe: Built with a Kotlin DSL for safe and readable configuration.
Multiplatform: Write your swap logic once, run it everywhere.

Setup

Add the SDK to your commonMain dependencies in build.gradle.kts:

implementation("xyz.mcxross:aggregator:0.1.0") // Replace with actual version/path
implementation("xyz.mcxross.ksui:ksui:2.2.0")

Usage

1. Initialize

First, set up your Sui client (using ksui) and the Aggregator.

import xyz.mcxross.ksui.model.SuiConfig
import xyz.mcxross.ksui.model.SuiSettings
import xyz.mcxross.ksui.model.Network
import xyz.mcxross.agg.cetus.dsl.Aggregator

// Initialize ksui (Mainnet)
val sui = Sui(SuiConfig(SuiSettings(network = Network.MAINNET)))

// Initialize the Aggregator
val aggregator = Aggregator()

2. Perform a Swap

Use the simple DSL to build your swap transaction.

import xyz.mcxross.agg.cetus.dsl.*

// Build the transaction
val tx = aggregator.swap {
    from = Tokens.SUI
    to = Tokens.CETUS
    amount = 1.sui        // 1 SUI (automatically converts to mist)
    slippage = 0.5.percent // 0.5% slippage
    recipient = "0xYourAddress..."
}

// Sign and execute
val signer = Account.import(YOUR_PRIV_KEY)
val response = sui.signAndExecuteTransactionBlock(signer, tx)

println("Swap executed: ${response.digest}")

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.