@cetusprotocol/deepbook-utils 1.0.6 → 1.1.1

package/dist/index.d.ts

@@ -1,11 +1,16 @@
+import { SuiTransactionBlockResponse, SuiClient, SuiEventFilter, SuiObjectResponseQuery, SuiObjectDataOptions, CoinBalance, SuiObjectResponse, SuiObjectData, SuiObjectRef, OwnedObjectRef, SuiMoveObject, ObjectOwner, DisplayFieldsResponse, SuiParsedData } from '@mysten/sui/client';
+import { SuiGraphQLClient } from '@mysten/sui/graphql';
 import * as _mysten_sui_transactions from '@mysten/sui/transactions';
-import { TransactionArgument, Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
-import { SuiClient, SuiEventFilter, SuiObjectResponseQuery, SuiObjectDataOptions, SuiTransactionBlockResponse, SuiObjectResponse, SuiObjectData, SuiObjectRef, OwnedObjectRef, SuiMoveObject, ObjectOwner, DisplayFieldsResponse, SuiParsedData } from '@mysten/sui/client';
+import { TransactionArgument, Transaction, TransactionResult, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { SuiPriceServiceConnection, SuiPythClient } from '@pythnetwork/pyth-sui-js';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { Secp256k1Keypair } from '@mysten/sui/keypairs/secp256k1';
-import { CoinBalance } from '@mysten/sui/dist/cjs/client';
 import Decimal from 'decimal.js';
 
+interface IModule {
+    readonly sdk: DeepbookUtilsSDK;
+}
+
 /**
  * Represents a SUI address, which is a string.
  */
@@ -237,6 +242,11 @@ declare enum OrderType {
     FILL_OR_KILL = 2,
     POST_ONLY = 3
 }
+declare enum SelfMatchingOption {
+    SELF_MATCHING_ALLOWED = 0,
+    CANCEL_TAKER = 1,
+    CANCEL_MAKER = 2
+}
 type Token = {
     coinType: string;
     decimals: number;
@@ -248,62 +258,20 @@ type PoolInfo = {
     [key: string]: any;
 };
 
-type BigNumber = Decimal.Value | number | string;
-
-/**
- * Represents a module for making RPC (Remote Procedure Call) requests.
- */
-declare class RpcModule extends SuiClient {
-    /**
-     * Get events for a given query criteria
-     * @param query
-     * @param paginationArgs
-     * @returns
-     */
-    queryEventsByPage(query: SuiEventFilter, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
-    /**
-     * Get all objects owned by an address
-     * @param owner
-     * @param query
-     * @param paginationArgs
-     * @returns
-     */
-    getOwnedObjectsByPage(owner: string, query: SuiObjectResponseQuery, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
-    /**
-     * Return the list of dynamic field objects owned by an object
-     * @param parentId
-     * @param paginationArgs
-     * @returns
-     */
-    getDynamicFieldsByPage(parentId: SuiObjectIdType, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
-    /**
-     * Batch get details about a list of objects. If any of the object ids are duplicates the call will fail
-     * @param ids
-     * @param options
-     * @param limit
-     * @returns
-     */
-    batchGetObjects(ids: SuiObjectIdType[], options?: SuiObjectDataOptions, limit?: number): Promise<any[]>;
-    /**
-     * Calculates the gas cost of a transaction block.
-     * @param {Transaction} tx - The transaction block to calculate gas for.
-     * @returns {Promise<number>} - The estimated gas cost of the transaction block.
-     * @throws {Error} - Throws an error if the sender is empty.
-     */
-    calculationTxGas(tx: Transaction): Promise<number>;
-    /**
-     * Sends a transaction block after signing it with the provided keypair.
-     *
-     * @param {Ed25519Keypair | Secp256k1Keypair} keypair - The keypair used for signing the transaction.
-     * @param {Transaction} tx - The transaction block to send.
-     * @returns {Promise<SuiTransactionBlockResponse | undefined>} - The response of the sent transaction block.
-     */
-    sendTransaction(keypair: Ed25519Keypair | Secp256k1Keypair, tx: Transaction): Promise<SuiTransactionBlockResponse | undefined>;
-}
+type MarginCoinInfo = {
+    coinType: string;
+    feed?: string;
+    decimals?: number;
+    scalar?: number;
+    priceInfoObjectId?: string;
+};
+type MarginPoolInfo = {
+    id: string;
+    baseCoin: MarginCoinInfo;
+    quoteCoin: MarginCoinInfo;
+};
 
-interface IModule {
-    readonly sdk: DeepbookUtilsSDK;
-}
+type BigNumber = Decimal.Value | number | string;
 
 declare const DEEP_SCALAR = 1000000;
 declare const FLOAT_SCALAR = 1000000000;
@@ -316,7 +284,7 @@ type DeepCoin = {
     decimals: number;
 };
 type StateAccount = {
-    balance_manager_id: string;
+    balance_manager_id: string | TransactionArgument;
     open_orders: string[];
     owed_balances: Balances;
     settled_balances: Balances;
@@ -348,7 +316,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Creates a new balance manager and deposits the specified coin amount into it.
      */
-    createAndDepsit({ account, coin, amountToDeposit }: {
+    createAndDepsit({ account, coin, amountToDeposit, }: {
         account: string;
         coin: CoinItem;
         amountToDeposit: string;
@@ -379,7 +347,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Withdraws free balances from multiple managers into the owner account.
      */
-    withdrawManagersFreeBalance({ account, balanceManagers, tx }: {
+    withdrawManagersFreeBalance({ account, balanceManagers, tx, }: {
         account: string;
         balanceManagers: Record<string, {
             coinType: string;
@@ -392,7 +360,7 @@ declare class DeepbookUtilsModule implements IModule {
      * result when it is still valid.
      */
     getBalanceManager(account: string, forceRefresh?: boolean): Promise<any>;
-    withdrawSettledAmounts({ poolInfo, balanceManager }: {
+    withdrawSettledAmounts({ poolInfo, balanceManager, }: {
         poolInfo: any;
         balanceManager: string;
     }, tx?: Transaction): Transaction;
@@ -400,7 +368,7 @@ declare class DeepbookUtilsModule implements IModule {
      * Retrieves balances for the provided coins tracked by a specific balance
      * manager.
      */
-    getManagerBalance({ account, balanceManager, coins }: {
+    getManagerBalance({ account, balanceManager, coins, }: {
         account: string;
         balanceManager: string;
         coins: CoinItem[];
@@ -408,7 +376,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Retrieves balances for all balance managers owned by the account.
      */
-    getAccountAllManagerBalance({ account, coins }: {
+    getAccountAllManagerBalance({ account, coins, }: {
         account: string;
         coins: CoinItem[];
     }): Promise<any>;
@@ -520,7 +488,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Creates a transaction that deposits required assets and then places a limit order.
      */
-    createDepositThenPlaceLimitOrder({ poolInfo, priceInput, quantity, orderType, isBid, maxFee, account, payWithDeep, expirationTimestamp }: {
+    createDepositThenPlaceLimitOrder({ poolInfo, priceInput, quantity, orderType, isBid, maxFee, account, payWithDeep, expirationTimestamp, }: {
         poolInfo: PoolInfo;
         priceInput: string;
         quantity: string;
@@ -535,7 +503,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Creates a transaction that deposits necessary assets and places a market order.
      */
-    createDepositThenPlaceMarketOrder({ poolInfo, quantity, isBid, maxFee, account, payWithDeep, slippage }: {
+    createDepositThenPlaceMarketOrder({ poolInfo, quantity, isBid, maxFee, account, payWithDeep, slippage, }: {
         poolInfo: any;
         quantity: string;
         isBid: boolean;
@@ -547,7 +515,7 @@ declare class DeepbookUtilsModule implements IModule {
     /**
      * Builds a transaction to place a limit order and handles required deposits.
      */
-    placeLimitOrder({ balanceManager, poolInfo, priceInput, quantity, isBid, orderType, maxFee, account, payWithDeep, expirationTimestamp }: {
+    placeLimitOrder({ balanceManager, poolInfo, priceInput, quantity, isBid, orderType, maxFee, account, payWithDeep, expirationTimestamp, }: {
         balanceManager: string;
         poolInfo: any;
         priceInput: string;
@@ -598,9 +566,9 @@ declare class DeepbookUtilsModule implements IModule {
         price: bigint;
         orderId: bigint;
     };
-    getOpenOrder(poolInfo: any, account: string, balanceManager: string, orders?: string[]): Promise<any>;
+    getOpenOrder(poolInfo: any, account: string, balanceManager: string | TransactionArgument, orders?: string[], isMargin?: boolean, tx?: Transaction): Promise<any>;
     getAllMarketsOpenOrders(account: string, balanceManager: string): Promise<any>;
-    cancelOrders(orderList: any, balanceManager: string): Transaction;
+    cancelOrders(orderList: any, balanceManager: string, tx?: Transaction): Transaction;
     getDeepbookOrderBook(poolKey: string, priceLow: number, priceHigh: number, isBid: boolean, account: string, balanceManager: string): Promise<void>;
     /**
      * Processes raw level 2 order book data returned from dev-inspect into
@@ -636,7 +604,7 @@ declare class DeepbookUtilsModule implements IModule {
     getWalletBalance(account: string): Promise<{
         [k: string]: any;
     }>;
-    getAccount(balanceManager: string, poolList: any): Promise<StateAccount[] | null>;
+    getAccount(balanceManager: string | TransactionArgument, poolList: any, txb?: Transaction): Promise<StateAccount[] | null>;
     /**
      * Gets the SUI transaction response for a given transaction digest.
      * @param digest - The digest of the transaction for which the SUI transaction response is requested.
@@ -675,7 +643,7 @@ declare class DeepbookUtilsModule implements IModule {
      * @returns The cache entry for the given key, or undefined if the cache entry does not exist or is expired.
      */
     getCache<T>(key: string, forceRefresh?: boolean): T | undefined;
-    createPermissionlessPool({ tickSize, lotSize, minSize, baseCoinType, quoteCoinType }: {
+    createPermissionlessPool({ tickSize, lotSize, minSize, baseCoinType, quoteCoinType, }: {
         tickSize: string;
         lotSize: string;
         minSize: string;
@@ -684,6 +652,749 @@ declare class DeepbookUtilsModule implements IModule {
     }): Promise<Transaction>;
 }
 
+type Price = {
+    coin_type: string;
+    price: string;
+    oracle_price: bigint;
+    last_update_time: number;
+};
+declare class PythPriceModule implements IModule {
+    protected _sdk: DeepbookUtilsSDK;
+    protected connection: SuiPriceServiceConnection;
+    protected suiPythClient: SuiPythClient;
+    protected hasChangeConnection: boolean;
+    private readonly _cache;
+    constructor(sdk: DeepbookUtilsSDK);
+    get sdk(): DeepbookUtilsSDK;
+    updatePythPriceIDs(priceIDs: string[], txb: Transaction): Promise<Map<string, string>>;
+    /**
+     * Checks if the price has been updated within the last 60 seconds.
+     *
+     * @param price - The price object to check.
+     * @returns The price object if it has been updated within the last 60 seconds, otherwise undefined.
+     */
+    priceCheck(price: Price, age?: number): Price | undefined;
+    /**
+     * Fetches the latest prices for a list of coin types.
+     * Optionally uses cached prices if available.
+     *
+     * @param coinTypeList - The list of coin types for which prices are required.
+     * @param useCache - A flag to indicate whether to use cached prices (default: false).
+     * @returns A promise that resolves to a record mapping coin types to their respective price information.
+     */
+    getLatestPrice(coinList: {
+        feed: string;
+        coinType: string;
+    }[], useCache?: boolean): Promise<Record<string, Price>>;
+}
+
+/**
+ * MarginUtilsModule provides utilities for managing margin trading operations
+ * including deposits, withdrawals, borrowing, repaying, and order management.
+ *
+ * @class MarginUtilsModule
+ * @implements {IModule}
+ */
+declare class MarginUtilsModule implements IModule {
+    #private;
+    protected _sdk: DeepbookUtilsSDK;
+    protected pythPrice: PythPriceModule;
+    protected _deep: DeepCoin;
+    private readonly _cache;
+    /**
+     * Creates an instance of MarginUtilsModule.
+     *
+     * @param {DeepbookUtilsSDK} sdk - The SDK instance
+     */
+    constructor(sdk: DeepbookUtilsSDK);
+    /**
+     * Gets the SDK instance.
+     *
+     * @returns {DeepbookUtilsSDK} The SDK instance
+     */
+    get sdk(): DeepbookUtilsSDK;
+    get deepCoin(): DeepCoin;
+    /**
+     * Creates a margin manager and shares it with the caller account.
+     * This is the first step to enable margin trading for a specific pool.
+     *
+     * @param {MarginPoolInfo} poolInfo - The pool information containing base and quote coin details
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with margin manager creation and sharing operations
+     * @throws {Error} If poolInfo is invalid or missing required fields
+     */
+    createAndShareMarginManager(poolInfo: MarginPoolInfo, tx?: Transaction): {
+        tx: Transaction;
+        margin_manager: {
+            $kind: "NestedResult";
+            NestedResult: [number, number];
+        };
+        initializer: {
+            $kind: "NestedResult";
+            NestedResult: [number, number];
+        };
+    };
+    createMarginManager(poolInfo: MarginPoolInfo, tx?: Transaction): {
+        tx: Transaction;
+        margin_manager: {
+            $kind: "NestedResult";
+            NestedResult: [number, number];
+        };
+        initializer: {
+            $kind: "NestedResult";
+            NestedResult: [number, number];
+        };
+    };
+    shareMarginManager({ marginManager, initializer, baseCoin, quoteCoin, }: {
+        marginManager: TransactionArgument;
+        initializer: TransactionArgument;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+    }, tx?: Transaction): Transaction;
+    /**
+     * Gets all balance managers for an account using GraphQL query.
+     * NOTE: This method has known issues and should not be used in production.
+     *
+     * @deprecated This method has issues and should not be used
+     * @param {string} account - The account address to query
+     * @returns {Promise<any[]>} Array of balance manager event data
+     * @throws {Error} If account is invalid or query fails
+     */
+    getBalanceManagerByMarginManager(account: string): Promise<any>;
+    /**
+     * Gets all margin managers created by a specific account.
+     *
+     * @param {string} account - The account address to query
+     * @returns {Promise<any[]>} Array of margin manager information
+     * @throws {Error} If account is invalid or query fails
+     */
+    getMarginManagerByAccount(account: string): Promise<any[]>;
+    /**
+     * Gets the base coin balance for a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @returns {Promise<string>} The base balance as a string
+     * @throws {Error} If parameters are invalid or transaction fails
+     */
+    getBaseBalance({ account, marginManager, baseCoinType, quoteCoinType, }: {
+        account: string;
+        marginManager: string;
+        baseCoinType: string;
+        quoteCoinType: string;
+    }): Promise<string>;
+    /**
+     * Gets the quote coin balance for a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @returns {Promise<string>} The quote balance as a string
+     * @throws {Error} If parameters are invalid or transaction fails
+     */
+    getQuoteBalance({ account, marginManager, baseCoinType, quoteCoinType, }: {
+        account: string;
+        marginManager: string;
+        baseCoinType: string;
+        quoteCoinType: string;
+    }): Promise<string>;
+    /**
+     * Gets the deep coin balance for a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @returns {Promise<string>} The base balance as a string
+     * @throws {Error} If parameters are invalid or transaction fails
+     */
+    getDeepBalance({ account, marginManager, baseCoinType, quoteCoinType, }: {
+        account: string;
+        marginManager: string;
+        baseCoinType: string;
+        quoteCoinType: string;
+    }): Promise<string>;
+    /**
+     * Gets the borrowed shares (debt) for both base and quote coins.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @returns {Promise<{baseBorrowedShare: bigint, quoteBorrowedShare: bigint}>} Object containing borrowed shares
+     * @throws {Error} If parameters are invalid or transaction fails
+     */
+    getBorrowedShares({ account, marginManager, baseCoinType, quoteCoinType, }: {
+        account: string;
+        marginManager: string;
+        baseCoinType: string;
+        quoteCoinType: string;
+    }): Promise<{
+        baseBorrowedShare: string;
+        quoteBorrowedShare: string;
+    }>;
+    /**
+     * Creates a transaction builder function for getting margin manager state.
+     * NOTE: This is currently not used in production.
+     *
+     * @deprecated This method is not currently used
+     * @param {Object} params - Parameters object
+     * @returns {Function} A function that takes a Transaction and adds the manager state call
+     */
+    managerState: ({ account, marginManager, baseCoin, quoteCoin, pool, baseMarginPool, quoteMarginPool, decimals, basePriceFeedObjectId, quotePriceFeedObjectId, }: {
+        account: string;
+        marginManager: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        pool: string;
+        baseMarginPool: string;
+        quoteMarginPool: string;
+        decimals?: number;
+        basePriceFeedObjectId: string;
+        quotePriceFeedObjectId: string;
+    }) => (tx: Transaction) => void;
+    /**
+     * Gets the complete state of a margin manager including assets, debts, and risk ratio.
+     * NOTE: This method is currently not used in production.
+     *
+     * @deprecated This method is not currently used
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {string} params.pool - Pool address
+     * @param {string} params.baseMarginPool - Base margin pool address
+     * @param {string} params.quoteMarginPool - Quote margin pool address
+     * @param {number} [params.decimals=6] - Number of decimal places for formatting
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object
+     * @returns {Promise<Object>} Manager state object with all financial metrics
+     * @throws {Error} If parameters are invalid, feeds are missing, or transaction fails
+     */
+    getManagerState(params: {
+        account: string;
+        marginManager: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        pool: string;
+        baseMarginPool: string;
+        quoteMarginPool: string;
+        decimals?: number;
+    }, tx?: Transaction): Promise<{
+        managerId: string;
+        deepbookPoolId: string;
+        riskRatio: number;
+        baseAsset: string;
+        quoteAsset: string;
+        baseDebt: string;
+        quoteDebt: string;
+        basePythPrice: string;
+        basePythDecimals: number;
+        quotePythPrice: string;
+        quotePythDecimals: number;
+        currentPrice: bigint;
+        lowestTriggerAbovePrice: bigint;
+        highestTriggerBelowPrice: bigint;
+    }>;
+    /**
+     * Calculates the current assets (base and quote) for a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.pool - Pool address
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {number} [params.decimals=6] - Number of decimal places (not currently used)
+     * @returns {Promise<{baseAsset: string, quoteAsset: string}>} Object containing asset amounts
+     * @throws {Error} If parameters are invalid, scalars are missing, or transaction fails
+     */
+    calculateAssets({ account, marginManager, pool, baseCoin, quoteCoin, decimals, }: {
+        account: string;
+        marginManager: string;
+        pool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        decimals?: number;
+    }): Promise<{
+        baseAsset: string;
+        quoteAsset: string;
+    }>;
+    /**
+     * Gets the borrowed amount (in tokens, not shares) for a margin manager.
+     * Determines whether base or quote has more debt and returns the corresponding amount.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @param {string} params.baseMarginPool - Base margin pool address
+     * @param {string} params.quoteMarginPool - Quote margin pool address
+     * @returns {Promise<{baseBorrowedAmount: string, quoteBorrowedAmount: string}>} Object containing borrowed amounts
+     * @throws {Error} If parameters are invalid or transaction fails
+     */
+    getBorrowedAmount({ account, marginManager, baseCoinType, quoteCoinType, baseMarginPool, quoteMarginPool, }: {
+        account: string;
+        marginManager: string;
+        baseCoinType: string;
+        quoteCoinType: string;
+        baseMarginPool: string;
+        quoteMarginPool: string;
+    }): Promise<{
+        baseBorrowedAmount: string;
+        quoteBorrowedAmount: string;
+    }>;
+    /**
+     * Deposits tokens (base or quote) into a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {boolean} params.isBase - Whether to deposit base coin (true) or quote coin (false)
+     * @param {string} params.amount - Amount to deposit (as string to avoid precision loss)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with deposit operation
+     * @throws {Error} If parameters are invalid, feeds are missing, or price feed IDs cannot be obtained
+     */
+    deposit({ marginManager, baseCoin, quoteCoin, amount, depositCoinType, }: {
+        marginManager: string | TransactionArgument;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        amount: string;
+        depositCoinType: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Withdraws tokens (base or quote) from a margin manager.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.account - The account address to receive the withdrawn tokens
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseMarginPool - Base margin pool address
+     * @param {string} params.quoteMarginPool - Quote margin pool address
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {string} params.pool - Pool address
+     * @param {boolean} params.isBase - Whether to withdraw base coin (true) or quote coin (false)
+     * @param {string} params.amount - Amount to withdraw (as string to avoid precision loss)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with withdraw operation
+     * @throws {Error} If parameters are invalid, feeds are missing, or price feed IDs cannot be obtained
+     */
+    withdraw({ account, marginManager, baseMarginPool, quoteMarginPool, baseCoin, quoteCoin, pool, amount, withdrawCoinType, }: {
+        account: string;
+        marginManager: string;
+        baseMarginPool: string;
+        quoteMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        pool: string;
+        amount: string;
+        withdrawCoinType: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Borrows base coins from the margin pool.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseMarginPool - Base margin pool address
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {string} params.pool - Pool address
+     * @param {string} params.amount - Amount to borrow (as string to avoid precision loss)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with borrow base operation
+     * @throws {Error} If parameters are invalid, feeds are missing, or price feed IDs cannot be obtained
+     */
+    borrowBase({ marginManager, baseMarginPool, baseCoin, quoteCoin, pool, amount, }: {
+        marginManager: string;
+        baseMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        pool: string;
+        amount: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Borrows quote coins from the margin pool.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.quoteMarginPool - Quote margin pool address
+     * @param {MarginCoinInfo} params.baseCoin - Base coin information
+     * @param {MarginCoinInfo} params.quoteCoin - Quote coin information
+     * @param {string} params.pool - Pool address
+     * @param {string} params.amount - Amount to borrow (as string to avoid precision loss)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with borrow quote operation
+     * @throws {Error} If parameters are invalid, feeds are missing, or price feed IDs cannot be obtained
+     */
+    borrowQuote({ marginManager, quoteMarginPool, baseCoin, quoteCoin, pool, amount, }: {
+        marginManager: string | TransactionArgument;
+        quoteMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        pool: string;
+        amount: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Repays borrowed base coins to the margin pool.
+     * If amount is not specified, repays all debt.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.baseMarginPool - Base margin pool address
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @param {string} [params.amount] - Optional amount to repay (if not provided, repays all)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with repay base operation
+     * @throws {Error} If parameters are invalid
+     */
+    repayBase({ marginManager, baseMarginPool, baseCoin, quoteCoin, amount, }: {
+        marginManager: string;
+        baseMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        amount?: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Repays borrowed quote coins to the margin pool.
+     * If amount is not specified, repays all debt.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {string} params.quoteMarginPool - Quote margin pool address
+     * @param {string} params.baseCoinType - The base coin type
+     * @param {string} params.quoteCoinType - The quote coin type
+     * @param {string} [params.amount] - Optional amount to repay (if not provided, repays all)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with repay quote operation
+     * @throws {Error} If parameters are invalid
+     */
+    repayQuote({ marginManager, quoteMarginPool, baseCoin, quoteCoin, amount, }: {
+        marginManager: string;
+        quoteMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        amount?: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    repay({ marginManager, baseMarginPool, quoteMarginPool, baseCoin, quoteCoin, isBase, amount, }: {
+        marginManager: string;
+        baseMarginPool: string;
+        quoteMarginPool: string;
+        baseCoin: MarginCoinInfo;
+        quoteCoin: MarginCoinInfo;
+        isBase: boolean;
+        amount?: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Places a market order for margin trading.
+     * Market orders are executed immediately at the current market price.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginPoolInfo} params.poolInfo - Pool information
+     * @param {SelfMatchingOption} params.selfMatchingOption - Self-matching behavior option
+     * @param {string} params.quantity - Order quantity
+     * @param {boolean} params.isBid - Whether this is a buy order (true) or sell order (false)
+     * @param {boolean} params.payWithDeep - Whether to pay with DEEP tokens
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with market order operation
+     * @throws {Error} If parameters are invalid or decimals are missing
+     */
+    placeMarginMarketOrder({ marginManager, poolInfo, selfMatchingOption, quantity, amountLimit, isBid, payWithDeep, exactBase }: {
+        marginManager: string | TransactionArgument;
+        poolInfo: MarginPoolInfo;
+        selfMatchingOption: SelfMatchingOption;
+        quantity: string;
+        amountLimit: string;
+        isBid: boolean;
+        payWithDeep: boolean;
+        exactBase?: boolean;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Places a limit order for margin trading.
+     * Limit orders are executed only when the market price reaches the specified limit price.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginPoolInfo} params.poolInfo - Pool information
+     * @param {OrderType} params.orderType - Order type (0=NO_RESTRICTION, 1=IMMEDIATE_OR_CANCEL, 2=FILL_OR_KILL, 3=POST_ONLY)
+     * @param {SelfMatchingOption} params.selfMatchingOption - Self-matching behavior option (0=SELF_MATCHING_ALLOWED, 1=CANCEL_TAKER, 2=CANCEL_MAKER)
+     * @param {string} params.priceInput - Limit price as a string
+     * @param {string} params.quantity - Order quantity
+     * @param {boolean} params.isBid - Whether this is a buy order (true) or sell order (false)
+     * @param {boolean} params.payWithDeep - Whether to pay with DEEP tokens
+     * @param {number} [params.expirationTimestamp] - Optional expiration timestamp (defaults to current time + default expiration)
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Promise<Transaction>} The transaction object with limit order operation
+     * @throws {Error} If parameters are invalid or decimals are missing
+     */
+    placeMarginLimitOrder({ marginManager, poolInfo, orderType, selfMatchingOption, priceInput, quantity, isBid, payWithDeep, expirationTimestamp, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+        orderType: OrderType;
+        selfMatchingOption: SelfMatchingOption;
+        priceInput: string;
+        quantity: string;
+        isBid: boolean;
+        payWithDeep: boolean;
+        expirationTimestamp?: number;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Modifies an existing margin order by updating its quantity.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginPoolInfo} params.poolInfo - Pool information
+     * @param {string} params.orderId - The order ID to modify
+     * @param {string} params.newQuantity - New quantity for the order
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with modify order operation
+     * @throws {Error} If parameters are invalid or base coin decimals are missing
+     */
+    modifyMarginOrder({ marginManager, poolInfo, orderId, newQuantity, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+        orderId: string;
+        newQuantity: string;
+    }, tx?: Transaction): Transaction;
+    /**
+     * Cancels a specific margin order.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginPoolInfo} params.poolInfo - Pool information
+     * @param {string} params.orderId - The order ID to cancel
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with cancel order operation
+     * @throws {Error} If parameters are invalid
+     */
+    cancelMarginOrder({ marginManager, poolInfo, orderId, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+        orderId: string;
+    }, tx?: Transaction): Transaction;
+    /**
+     * Cancels all margin orders for a specific pool.
+     *
+     * @param {Object} params - Parameters object
+     * @param {string} params.marginManager - The margin manager object ID
+     * @param {MarginPoolInfo} params.poolInfo - Pool information
+     * @param {Transaction} [tx=new Transaction()] - Optional transaction object to append to
+     * @returns {Transaction} The transaction object with cancel all orders operation
+     * @throws {Error} If parameters are invalid
+     */
+    cancelAllMarginOrders({ marginManager, poolInfo, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+    }, tx?: Transaction): Transaction;
+    placeReduceOnlyLimitOrder({ marginManager, poolInfo, marginPoolId, orderType, selfMatchingOption, priceInput, quantity, isBid, payWithDeep, expirationTimestamp, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+        marginPoolId: string;
+        orderType: OrderType;
+        selfMatchingOption: SelfMatchingOption;
+        priceInput: string;
+        quantity: string;
+        isBid: boolean;
+        payWithDeep: boolean;
+        expirationTimestamp: number;
+    }, tx?: Transaction): Transaction;
+    placeReduceOnlyMarketOrder({ marginManager, poolInfo, marginPoolId, selfMatchingOption, quantity, isBid, payWithDeep, }: {
+        marginManager: string;
+        poolInfo: MarginPoolInfo;
+        marginPoolId: string;
+        orderType: OrderType;
+        selfMatchingOption: SelfMatchingOption;
+        quantity: string;
+        isBid: boolean;
+        payWithDeep: boolean;
+        expirationTimestamp: number;
+    }, tx?: Transaction): Transaction;
+    getAccountOpenOrders({ poolInfo, marginManager }: {
+        poolInfo: PoolInfo;
+        marginManager: string;
+    }): Promise<any>;
+    getAccountAllMarketsOpenOrders(account: string, pools: any): Promise<any[]>;
+    mintSupplierCap(tx: Transaction | undefined, hasTransfer: boolean): {
+        tx: Transaction;
+        supplierCap: TransactionResult;
+    };
+    querySupplierCap(): Promise<any>;
+    mintSupplierCapAndSupply({ marginPool, supplyCoinType, amount }: {
+        marginPool: string;
+        supplyCoinType: string;
+        amount: string;
+    }): Transaction;
+    supply({ marginPool, supplierCap, supplyCoinType, amount, tx, }: {
+        marginPool: string;
+        supplierCap?: TransactionResult | string;
+        supplyCoinType: string;
+        amount: string;
+        tx?: Transaction;
+    }): Transaction;
+    supplierWithdraw({ marginPool, withdrawCoinType, amount, supplierCapId, hasSwap, withdrawAll, tx, }: {
+        marginPool: string;
+        supplierCapId?: string;
+        withdrawCoinType: string;
+        amount: string;
+        hasSwap: boolean;
+        withdrawAll: boolean;
+        tx?: Transaction;
+    }): Transaction | TransactionResult;
+    withdrawReferralFees({ marginPool }: {
+        marginPool: string;
+    }): Transaction;
+    getUserSupplyAmount({ marginPool, supplyCoin, supplierCapId, }: {
+        marginPool: string;
+        supplyCoin: MarginCoinInfo;
+        supplierCapId: string;
+    }): Promise<string>;
+    getDeepBookMarginRegistry(): Promise<{
+        pool_registry_table_id: any;
+        margin_pool_table_id: any;
+    }>;
+    getDeepBookPool(): Promise<{
+        id: any;
+        name: any;
+        base_margin_pool_id: any;
+        quote_margin_pool_id: any;
+        enabled: any;
+        pool_liquidation_reward: any;
+        user_liquidation_reward: any;
+        liquidation_risk_ratio: any;
+        min_borrow_risk_ratio: any;
+        min_withdraw_risk_ratio: any;
+        target_liquidation_risk_ratio: any;
+    }[]>;
+    getDeepBookMarginPool(): Promise<{
+        deposit_coin_type: any;
+        id: any;
+        supply_cap: any;
+        total_supply: any;
+        total_borrow: any;
+        available_supply: string;
+        max_utilization_rate: any;
+        min_borrow: any;
+        protocol_spread: any;
+        maintainer_fees: any;
+        protocol_fees: any;
+    }[]>;
+    getBaseQuantityOutInput(poolInfo: any, quantity: string, payWithDeep: boolean): Promise<{
+        base_amount: string;
+        quote_amount: string;
+        deep_fee_amount: string;
+    }>;
+    getQuoteQuantityOutInput(poolInfo: any, quantity: string): Promise<{
+        base_amount: string;
+        quote_amount: string;
+        deep_fee_amount: string;
+    }>;
+    getAccount(marginManager: string, poolInfo: any): Promise<StateAccount[] | null>;
+    withdrawSettledAmounts({ poolInfo, marginManager, }: {
+        poolInfo: any;
+        marginManager: string;
+    }, tx?: Transaction): Promise<Transaction>;
+    /**
+     * Gets the margin pool state with all fields needed for interest calculation.
+     * This method fetches the complete pool state including interest config, borrow/supply shares, and timestamps.
+     *
+     * @param {string} marginPoolId - The margin pool object ID
+     * @returns {Promise<Object>} The complete margin pool state for interest calculation
+     */
+    getMarginPoolStateForInterest(marginPoolId: string): Promise<{
+        poolState: {
+            total_supply: bigint;
+            total_borrow: bigint;
+            supply_shares: bigint;
+            borrow_shares: bigint;
+            last_update_timestamp: bigint;
+        };
+        interestConfig: {
+            base_rate: bigint;
+            base_slope: bigint;
+            optimal_utilization: bigint;
+            excess_slope: bigint;
+        };
+        marginPoolConfig: {
+            protocol_spread: bigint;
+            max_utilization_rate: bigint;
+            min_borrow: bigint;
+            supply_cap: bigint;
+        };
+    }>;
+    /**
+     * Gets the current chain timestamp from the Sui network.
+     * Use this timestamp for interest calculations instead of local Date.now().
+     *
+     * This method fetches the latest checkpoint and returns its timestamp,
+     * which represents the most recent confirmed on-chain time.
+     *
+     * @returns {Promise<bigint>} The current chain timestamp in milliseconds
+     */
+    getChainTimestamp(): Promise<bigint>;
+}
+
+/**
+ * Represents a module for making RPC (Remote Procedure Call) requests.
+ */
+declare class RpcModule extends SuiClient {
+    /**
+     * Get events for a given query criteria
+     * @param query
+     * @param paginationArgs
+     * @returns
+     */
+    queryEventsByPage(query: SuiEventFilter, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
+    /**
+     * Get all objects owned by an address
+     * @param owner
+     * @param query
+     * @param paginationArgs
+     * @returns
+     */
+    getOwnedObjectsByPage(owner: string, query: SuiObjectResponseQuery, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
+    /**
+     * Return the list of dynamic field objects owned by an object
+     * @param parentId
+     * @param paginationArgs
+     * @returns
+     */
+    getDynamicFieldsByPage(parentId: SuiObjectIdType, paginationArgs?: PaginationArgs): Promise<DataPage<any>>;
+    /**
+     * Batch get details about a list of objects. If any of the object ids are duplicates the call will fail
+     * @param ids
+     * @param options
+     * @param limit
+     * @returns
+     */
+    batchGetObjects(ids: SuiObjectIdType[], options?: SuiObjectDataOptions, limit?: number): Promise<any[]>;
+    /**
+     * Calculates the gas cost of a transaction block.
+     * @param {Transaction} tx - The transaction block to calculate gas for.
+     * @returns {Promise<number>} - The estimated gas cost of the transaction block.
+     * @throws {Error} - Throws an error if the sender is empty.
+     */
+    calculationTxGas(tx: Transaction): Promise<number>;
+    /**
+     * Sends a transaction block after signing it with the provided keypair.
+     *
+     * @param {Ed25519Keypair | Secp256k1Keypair} keypair - The keypair used for signing the transaction.
+     * @param {Transaction} tx - The transaction block to send.
+     * @returns {Promise<SuiTransactionBlockResponse | undefined>} - The response of the sent transaction block.
+     */
+    sendTransaction(keypair: Ed25519Keypair | Secp256k1Keypair, tx: Transaction): Promise<SuiTransactionBlockResponse | undefined>;
+}
+
 /**
  * Represents options and configurations for an SDK.
  */
@@ -693,6 +1404,8 @@ type SdkOptions = {
      * The full URL for interacting with the RPC (Remote Procedure Call) service.
      */
     fullRpcUrl: string;
+    graphqlUrl: string;
+    pythUrl: string;
     /**
      * Configuration for the simulation account.
      */
@@ -705,6 +1418,8 @@ type SdkOptions = {
     deepbook: {
         package_id: string;
         published_at: string;
+        margin_package_id: string;
+        margin_published_at: string;
         registry_id: string;
     };
     deepbook_utils: {
@@ -714,6 +1429,19 @@ type SdkOptions = {
         cetus_balance_manager_indexer_id: string;
         vault_global_config_id?: string;
     };
+    margin_utils: {
+        package_id: string;
+        published_at: string;
+        registry_id: string;
+        margin_registry_id: string;
+        wormhole_state_id: string;
+        pyth_state_id: string;
+        global_config_id: string;
+        versioned_id: string;
+        admin_cap_id: string;
+        pool_registry_table_id: string;
+        margin_pool_table_id: string;
+    };
     DEEP_COIN: {
         coinType: string;
         decimals: number;
@@ -733,6 +1461,9 @@ declare class DeepbookUtilsSDK {
      */
     protected _rpcModule: RpcModule;
     protected _deepbookUtils: any;
+    protected _marginUtils: any;
+    protected _pythPrice: PythPriceModule;
+    protected _graphqlClient: SuiGraphQLClient;
     /**
      *  Provide sdk options
      */
@@ -753,11 +1484,14 @@ declare class DeepbookUtilsSDK {
      */
     set senderAddress(value: string);
     get DeepbookUtils(): DeepbookUtilsModule;
+    get MarginUtils(): MarginUtilsModule;
+    get PythPrice(): PythPriceModule;
     /**
      * Getter for the fullClient property.
      * @returns {RpcModule} The fullClient property value.
      */
     get fullClient(): RpcModule;
+    get graphqlClient(): SuiGraphQLClient;
     /**
      * Getter for the sdkOptions property.
      * @returns {SdkOptions} The sdkOptions property value.
@@ -966,6 +1700,123 @@ declare function secretKeyToEd25519Keypair(secretKey: string | Uint8Array, ecode
 declare function secretKeyToSecp256k1Keypair(secretKey: string | Uint8Array, ecode?: 'hex' | 'base64'): Secp256k1Keypair;
 declare const sleepTime: (s: number) => Promise<unknown>;
 
+declare const calculateRiskRatio: ({ totalAssetsValue, totalDebtValue }: {
+    totalAssetsValue: string;
+    totalDebtValue: string;
+}) => string;
+declare const wrapDeepBookPoolInfo: (poolInfo: any) => {
+    id: any;
+    name: any;
+    base_margin_pool_id: any;
+    quote_margin_pool_id: any;
+    enabled: any;
+    pool_liquidation_reward: any;
+    user_liquidation_reward: any;
+    liquidation_risk_ratio: any;
+    min_borrow_risk_ratio: any;
+    min_withdraw_risk_ratio: any;
+    target_liquidation_risk_ratio: any;
+};
+declare const wrapDeepBookMarginPoolInfo: (marginPoolInfo: any, baseInfo: any) => {
+    deposit_coin_type: any;
+    id: any;
+    supply_cap: any;
+    total_supply: any;
+    total_borrow: any;
+    available_supply: string;
+    max_utilization_rate: any;
+    min_borrow: any;
+    protocol_spread: any;
+    maintainer_fees: any;
+    protocol_fees: any;
+};
+
+declare const FLOAT_SCALING = 1000000000n;
+declare const YEAR_MS: bigint;
+interface PoolState {
+    total_supply: bigint;
+    total_borrow: bigint;
+    supply_shares: bigint;
+    borrow_shares: bigint;
+    last_update_timestamp: bigint;
+}
+interface InterestConfig {
+    base_rate: bigint;
+    base_slope: bigint;
+    optimal_utilization: bigint;
+    excess_slope: bigint;
+}
+interface MarginPoolConfig {
+    protocol_spread: bigint;
+}
+interface UserBorrowInfo {
+    borrow_shares: bigint;
+}
+interface DebtDetail {
+    confirmedDebt: bigint;
+    estimatedInterest: bigint;
+    totalDebt: bigint;
+    annualInterestRate: bigint;
+}
+/**
+ * 计算资金利用率
+ *
+ * 公式: 利用率 = total_borrow / total_supply
+ */
+declare function calcUtilizationRate(total_borrow: bigint, total_supply: bigint): bigint;
+/**
+ * 计算利率（分段线性模型）
+ *
+ * 利率曲线:
+ * - 当利用率 < optimal_utilization: base_rate + utilization_rate * base_slope / FLOAT_SCALING
+ * - 当利用率 >= optimal_utilization: base_rate + base_portion + excess_portion
+ */
+declare function calcInterestRate(utilization_rate: bigint, config: InterestConfig): bigint;
+/**
+ * 乘法向上取整
+ */
+declare function mulRoundUp(x: bigint, y: bigint): bigint;
+/**
+ * 计算用户债务详情（核心函数）
+ *
+ * 将债务拆分为：已确认债务 + 预估利息
+ *
+ * 公式:
+ * - 已确认债务 = user_borrow_shares × (total_borrow / borrow_shares)
+ * - 全池预估利息 = total_borrow × 利率 × 时间间隔 / 一年毫秒数
+ * - 用户预估利息 = 全池预估利息 × (user_borrow_shares / borrow_shares)
+ * - 总债务 = 已确认债务 + 用户预估利息
+ *
+ * @param user_borrow_shares - 用户的借款份额
+ * @param pool - 池子状态
+ * @param interest_config - 利息配置
+ * @param current_timestamp_ms - 当前时间戳（毫秒）
+ * @returns DebtDetail - 债务详情
+ */
+declare function calcDebtDetail(user_borrow_shares: bigint, pool: PoolState, interest_config: InterestConfig, current_timestamp_ms: bigint): DebtDetail;
+/**
+ * 计算 100% 还款金额
+ *
+ * 通过额外计算一段时间的利息来确保还款充足（覆盖交易确认时间）
+ *
+ * 公式: 100% 还款金额 = calcDebtDetail(链上时间 + extra_time_ms).totalDebt
+ *
+ * 优势（相比旧方案 confirmedDebt + estimatedInterest × 1.2）:
+ * - 基于实际利率计算，而非固定的 1.2 倍系数
+ * - 低利率时不会多收太多，高利率时能提供足够缓冲
+ * - 1 分钟足够覆盖 Sui 网络的交易确认时间
+ *
+ * 注意：必须传入链上时间戳，不要使用 Date.now()，避免用户本地时间与链上时间不同步
+ *
+ * @param user_borrow_shares - 用户的借款份额
+ * @param pool - 池子状态
+ * @param interest_config - 利息配置
+ * @param chain_timestamp_ms - 链上时间戳（毫秒），通过 SDK 的 getChainTimestamp() 获取
+ * @param extra_time_ms - 额外计算的时间（毫秒），默认 1 分钟 (60_000n)
+ * @returns bigint - 100% 还款金额
+ */
+declare function calc100PercentRepay(user_borrow_shares: bigint, pool: PoolState, interest_config: InterestConfig, chain_timestamp_ms: bigint, extra_time_ms?: bigint): bigint;
+
 declare const DEFAULT_GAS_BUDGET_FOR_SPLIT = 1000;
 declare const DEFAULT_GAS_BUDGET_FOR_MERGE = 500;
 declare const DEFAULT_GAS_BUDGET_FOR_TRANSFER = 100;
@@ -1094,4 +1945,4 @@ declare class CoinAssist {
     static buildCoinWithBalance(amount: bigint, coin_type: string, tx: Transaction): TransactionObjectArgument;
 }
 
-export { AdjustResult, Balances, BigNumber, BuildCoinResult, CLOCK_ADDRESS, CachedContent, DeepbookUtilsSDK as CetusClmmSDK, ClmmExpectSwapModule, ClmmFetcherModule, ClmmIntegratePoolModule, ClmmIntegratePoolV2Module, ClmmIntegrateRouterModule, ClmmIntegrateRouterWithPartnerModule, ClmmIntegrateUtilsModule, CoinAsset, CoinAssist, CoinConfig, CoinInfoAddress, CoinStoreAddress, DEEP_SCALAR, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, DataPage, DeepbookClobV2Moudle, DeepbookCustodianV2Moudle, DeepbookEndpointsV2Moudle, DeepbookUtilsModule, FLOAT_SCALAR, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, NFT, NORMALIZED_SUI_COIN_TYPE, OrderDeepPrice, OrderFee, OrderType, Package, PageQuery, PaginationArgs, PoolInfo, RpcModule, SUI_SYSTEM_STATE_OBJECT_ID, SdkOptions, StateAccount, SuiAddressType, SuiBasicTypes, SuiInputTypes, SuiObjectDataWithContent, SuiObjectIdType, SuiResource, SuiStructTag, SuiTxArg, Token, TransactionUtil, addHexPrefix, asIntN, asUintN, bufferToHex, cacheTime1min, cacheTime24h, cacheTime5min, checkAddress, composeType, d, decimalsMultiplier, DeepbookUtilsSDK as default, extractAddressFromType, extractStructTagFromType, fixCoinType, fixDown, fixSuiObjectId, fromDecimalsAmount, getDefaultSuiInputType, getFutureTime, getMoveObject, getMoveObjectType, getMovePackageContent, getObjectDeletedResponse, getObjectDisplay, getObjectFields, getObjectId, getObjectNotExistsResponse, getObjectOwner, getObjectPreviousTransactionDigest, getObjectReference, getObjectType, getObjectVersion, getSuiObjectData, hasPublicTransfer, hexToNumber, hexToString, isSortedSymbols, isSuiObjectResponse, maxDecimal, normalizeCoinType, patchFixSuiObjectId, printTransaction, removeHexPrefix, secretKeyToEd25519Keypair, secretKeyToSecp256k1Keypair, shortAddress, shortString, sleepTime, toBuffer, toDecimalsAmount, utf8to16 };
+export { AdjustResult, Balances, BigNumber, BuildCoinResult, CLOCK_ADDRESS, CachedContent, DeepbookUtilsSDK as CetusClmmSDK, ClmmExpectSwapModule, ClmmFetcherModule, ClmmIntegratePoolModule, ClmmIntegratePoolV2Module, ClmmIntegrateRouterModule, ClmmIntegrateRouterWithPartnerModule, ClmmIntegrateUtilsModule, CoinAsset, CoinAssist, CoinConfig, CoinInfoAddress, CoinStoreAddress, DEEP_SCALAR, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, DataPage, DebtDetail, DeepCoin, DeepbookClobV2Moudle, DeepbookCustodianV2Moudle, DeepbookEndpointsV2Moudle, DeepbookUtilsModule, FLOAT_SCALAR, FLOAT_SCALING, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, InterestConfig, MarginCoinInfo, MarginPoolConfig, MarginPoolInfo, MarginUtilsModule, NFT, NORMALIZED_SUI_COIN_TYPE, OrderDeepPrice, OrderFee, OrderType, Package, PageQuery, PaginationArgs, PoolInfo, PoolState, RpcModule, SUI_SYSTEM_STATE_OBJECT_ID, SdkOptions, SelfMatchingOption, StateAccount, SuiAddressType, SuiBasicTypes, SuiInputTypes, SuiObjectDataWithContent, SuiObjectIdType, SuiResource, SuiStructTag, SuiTxArg, Token, TransactionUtil, UserBorrowInfo, YEAR_MS, addHexPrefix, asIntN, asUintN, bufferToHex, cacheTime1min, cacheTime24h, cacheTime5min, calc100PercentRepay, calcDebtDetail, calcInterestRate, calcUtilizationRate, calculateRiskRatio, checkAddress, composeType, d, decimalsMultiplier, DeepbookUtilsSDK as default, extractAddressFromType, extractStructTagFromType, fixCoinType, fixDown, fixSuiObjectId, fromDecimalsAmount, getDefaultSuiInputType, getFutureTime, getMoveObject, getMoveObjectType, getMovePackageContent, getObjectDeletedResponse, getObjectDisplay, getObjectFields, getObjectId, getObjectNotExistsResponse, getObjectOwner, getObjectPreviousTransactionDigest, getObjectReference, getObjectType, getObjectVersion, getSuiObjectData, hasPublicTransfer, hexToNumber, hexToString, isSortedSymbols, isSuiObjectResponse, maxDecimal, mulRoundUp, normalizeCoinType, patchFixSuiObjectId, printTransaction, removeHexPrefix, secretKeyToEd25519Keypair, secretKeyToSecp256k1Keypair, shortAddress, shortString, sleepTime, toBuffer, toDecimalsAmount, utf8to16, wrapDeepBookMarginPoolInfo, wrapDeepBookPoolInfo };