Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CetusProtocol/cetus-clmm-sui-sdk
The clmm sdk on Sui.
https://github.com/CetusProtocol/cetus-clmm-sui-sdk
Last synced: 2 months ago
JSON representation
The clmm sdk on Sui.
- Host: GitHub
- URL: https://github.com/CetusProtocol/cetus-clmm-sui-sdk
- Owner: CetusProtocol
- License: apache-2.0
- Created: 2023-03-07T09:50:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-15T12:05:01.000Z (6 months ago)
- Last Synced: 2024-08-02T15:03:27.140Z (5 months ago)
- Language: TypeScript
- Size: 1.48 MB
- Stars: 17
- Watchers: 3
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-sui - cetus-clmm-sui-sdk
- awesome-sui - Cetus CLMM SDK - The official Cetus SDK specifically designed for seamless integration with Cetus-CLMM on Sui. (Client SDKs & Libraries / DeFi SDKs)
- awesome-sui - Cetus CLMM SDK - The official Cetus SDK specifically designed for seamless integration with Cetus-CLMM on Sui. (Client SDKs & Libraries / DeFi SDKs)
README
Cetus-CLMM-SUI-SDK
Integrating Cetus-CLMM-SUI-SDK: A Comprehensive Guide, Please see details in document.
Explore the document »
View Demo
·
Report Bug
·
- [SDK configuration parameters](#sdk-configuration-parameters)
- [Introduction](#introduction)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Setting Up Configuration](#setting-up-configuration)
- [Features Available Right Now](#features-available-right-now)
- [Query data](#query-data)
- [Pool and Position (Liquidity)](#pool-and-position-liquidity)
- [Swap with Partner](#swap-with-partner)
- [Smart Router for Swap](#smart-router-for-swap)
- [Smart Router V1](#smart-router-v1)
- [Smart Router V2](#smart-router-v2)
- [Swap Pre-calculating Result Show](#swap-pre-calculating-result-show)
- [Conversion between liquidity, tickIndex, sqrtPrice, and coinAmount.](#conversion-between-liquidity-tickindex-sqrtprice-and-coinamount)
- [LICENSE](#license)
## SDK configuration parameters
- The contract address available for reference [cetus-developer-docs](https://cetus-1.gitbook.io/cetus-developer-docs/developer/via-sdk/getting-started#latest-sdk-config).
- `simulationAccount` used to simulate trades and obtain tick data.
- *Notes: Please exercise caution when using a mainnet network account with assets as your `simulationAccount`.*
## Introduction
Cetus-CLMM-SUI-SDK is the official software development kit (SDK) specifically designed for seamless integration with Cetus-CLMM. It provides developers with the necessary tools and resources to easily connect and interact with Cetus-CLMM, enabling the development of robust and efficient applications.
## Getting Started
To integrate our SDK into your local project, please follow the example steps provided below.
Please see details in document.
### Prerequisites
* npm
```sh
npm i @cetusprotocol/cetus-sui-clmm-sdk
```
### Setting Up Configuration
1. Initialize testnet (or mainnet) SdkOption
**NOTICE**
1. In this example, the contract address version may backward, please use the latest clmmpool and integrate address.
2. `simulationAccount` should be add an account address with a small amount of assets, it used to do estimated or other query object from.
2. Instantiate one CetusClmmSDK
Now, you can start using Cetus SDK.
### Features Available Right Now
»»» See details in development document.
1. Retrieve data
1.1 Retrieve clmm pools
1.2 Retrieve positions
1.3 Retrieve reward
1.4 Retrieve ticks
2. Pools and postions
2.1 Create clmm pool
2.2 Open position
2.3 Add liquidity
2.4 Remove liquidity
2.5 Close position
2.6 Collect fees
2.7 Collect rewards
3. Swap
3.1 Swap
3.2 Partner swap
3.3 Smart router v1
3.4 Smart router v2
3.5 Price impact
3.6 Minimum received & Maximum sold
3.7 Fee
4. Liquidity correlation calculation
4.1 Liquidity correlation calculation
## LICENSE
CETUS-SUI-SDK released under the Apache license. See the [LICENSE](./LICENSE) file for details.