ddd utils sdk
npm install ddd-utils-sdk2
Integrating Cetus-CLMM-SUI-SDK: A Comprehensive Guide, Please see details in document.
Explore the document »
View Demo
·
Report Bug
·
Request Feature
- SDK configuration parameters
- Introduction
- Getting Started
- Prerequisites
- Setting Up Configuration
- Features Available Right Now
- Query data
- Pool and Position (Liquidity)
- Swap with Partner
- Smart Router for Swap
- Smart Router V1
- Smart Router V2
- Swap Pre-calculating Result Show
- Conversion between liquidity, tickIndex, sqrtPrice, and coinAmount.
- LICENSE
- The contract address available for reference config.ts.
- simulationAccount Used to simulate trades and obtain tick data.
- Notes: Please exercise caution when using a mainnet network account with assets as your simulationAccount.
``bash
export const testnet = {
fullRpcUrl: 'https://fullnode.testnet.sui.io',
simulationAccount: {
address: ''
},
cetus_config: {
package_id: '0xf5ff7d5ba73b581bca6b4b9fa0049cd320360abd154b809f8700a8fd3cfaf7ca',
published_at: '0xf5ff7d5ba73b581bca6b4b9fa0049cd320360abd154b809f8700a8fd3cfaf7ca',
config: {
coin_list_id: '0x257eb2ba592a5480bba0a97d05338fab17cc3283f8df6998a0e12e4ab9b84478',
launchpad_pools_id: '0xdc3a7bd66a6dcff73c77c866e87d73826e446e9171f34e1c1b656377314f94da',
clmm_pools_id: '0x26c85500f5dd2983bf35123918a144de24e18936d0b234ef2b49fbb2d3d6307d',
admin_cap_id: '0x1a496f6c67668eb2c27c99e07e1d61754715c1acf86dac45020c886ac601edb8',
global_config_id: '0xe1f3db327e75f7ec30585fa52241edf66f7e359ef550b533f89aa1528dd1be52',
coin_list_handle: '0x3204350fc603609c91675e07b8f9ac0999b9607d83845086321fca7f469de235',
launchpad_pools_handle: '0xae67ff87c34aceea4d28107f9c6c62e297a111e9f8e70b9abbc2f4c9f5ec20fd',
clmm_pools_handle: '0xd28736923703342b4752f5ed8c2f2a5c0cb2336c30e1fed42b387234ce8408ec'
}
},
clmm_pool: {
package_id: '0x0868b71c0cba55bf0faf6c40df8c179c67a4d0ba0e79965b68b3d72d7dfbf666',
published_at: '0x1c29d658882c40eeb39a8bb8fe58f71a216a918acb3e3eb3b47d24efd07257f2',
config: {
pools_id: '0xc090b101978bd6370def2666b7a31d7d07704f84e833e108a969eda86150e8cf',
global_config_id: '0x6f4149091a5aea0e818e7243a13adcfb403842d670b9a2089de058512620687a',
global_vault_id: '0xf3114a74d54cbe56b3e68f9306661c043ede8c6615f0351b0c3a93ce895e1699',
admin_cap_id: '0xa456f86a53fc31e1243f065738ff1fc93f5a62cc080ff894a0fb3747556a799b',
partners_id: '0xb1cefb6de411213a1cfe94d24213af2518eff3d51267fb95e35d11aa77fc9b5f'
}
},
integrate: {
package_id: '0x8627c5cdcd8b63bc3daa09a6ab7ed81a829a90cafce6003ae13372d611fbb1a9',
published_at: '0xc831ec758f8ddcb23781a4288a9f2ccaf3e17cf7443e8888cf74fd7c80e1f52d'
},
deepbook: {
package_id: '0x000000000000000000000000000000000000000000000000000000000000dee9',
published_at: '0x000000000000000000000000000000000000000000000000000000000000dee9'
},
deepbook_endpoint_v2: {
package_id: '0xa34ffca2c6540e1ca9e53963ab43e7b1eed7b82e37696c743bb7c6179c15dfa6',
published_at: '0xa34ffca2c6540e1ca9e53963ab43e7b1eed7b82e37696c743bb7c6179c15dfa6'
},
aggregatorUrl: 'https://api-sui.devcetus.com/router'
}
export const mainnet = {
fullRpcUrl: 'https://sui-mainnet-rpc.allthatnode.com',
simulationAccount: {
address: ''
},
cetus_config: {
package_id: '0x95b8d278b876cae22206131fb9724f701c9444515813042f54f0a426c9a3bc2f',
published_at: '0x95b8d278b876cae22206131fb9724f701c9444515813042f54f0a426c9a3bc2f',
config: {
coin_list_id: '0x8cbc11d9e10140db3d230f50b4d30e9b721201c0083615441707ffec1ef77b23',
launchpad_pools_id: '0x1098fac992eab3a0ab7acf15bb654fc1cf29b5a6142c4ef1058e6c408dd15115',
clmm_pools_id: '0x15b6a27dd9ae03eb455aba03b39e29aad74abd3757b8e18c0755651b2ae5b71e',
admin_cap_id: '0x39d78781750e193ce35c45ff32c6c0c3f2941fa3ddaf8595c90c555589ddb113',
global_config_id: '0x0408fa4e4a4c03cc0de8f23d0c2bbfe8913d178713c9a271ed4080973fe42d8f',
coin_list_handle: '0x49136005e90e28c4695419ed4194cc240603f1ea8eb84e62275eaff088a71063',
launchpad_pools_handle: '0x5e194a8efcf653830daf85a85b52e3ae8f65dc39481d54b2382acda25068375c',
clmm_pools_handle: '0x37f60eb2d9d227949b95da8fea810db3c32d1e1fa8ed87434fc51664f87d83cb'
}
},
clmm_pool: {
package_id: '0x1eabed72c53feb3805120a081dc15963c204dc8d091542592abaf7a35689b2fb',
published_at: '0xc33c3e937e5aa2009cc0c3fdb3f345a0c3193d4ee663ffc601fe8b894fbc4ba6',
config: {
pools_id: '0xf699e7f2276f5c9a75944b37a0c5b5d9ddfd2471bf6242483b03ab2887d198d0',
global_config_id: '0xdaa46292632c3c4d8f31f23ea0f9b36a28ff3677e9684980e4438403a67a3d8f',
global_vault_id: '0xce7bceef26d3ad1f6d9b6f13a953f053e6ed3ca77907516481ce99ae8e588f2b',
admin_cap_id: '0x89c1a321291d15ddae5a086c9abc533dff697fde3d89e0ca836c41af73e36a75',
partners_id: '0xac30897fa61ab442f6bff518c5923faa1123c94b36bd4558910e9c783adfa204'
}
},
integrate: {
package_id: '0x996c4d9480708fb8b92aa7acf819fb0497b5ec8e65ba06601cae2fb6db3312c3',
published_at: '0x12fc0b1791df55bf2c91921f12152659c4a897fa6867144b5b3939a3ea004c46'
},
deepbook: {
package_id: '0x000000000000000000000000000000000000000000000000000000000000dee9',
published_at: '0x000000000000000000000000000000000000000000000000000000000000dee9'
},
deepbook_endpoint_v2: {
package_id: '0x92aee86c01c79146d23938a00c7fff725ee0688c389be36d1bcbe03761b466c6',
published_at: '0x92aee86c01c79146d23938a00c7fff725ee0688c389be36d1bcbe03761b466c6'
},
aggregatorUrl: 'https://api-sui.cetus.zone/router'
}
`
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.
sh
npm i @cetusprotocol/cetus-sui-clmm-sdk
`$3
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.
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