@cetusprotocol/dlmm-sdk 1.3.1 → 1.3.3

package/dist/index.d.ts

@@ -576,6 +576,12 @@ declare class PositionModule implements IModule<CetusDlmmSDK> {
         coin_a_obj: TransactionObjectArgument;
         coin_b_obj: TransactionObjectArgument;
     };
+    /**
+     * Position principal in token raw units.
+     * Loads each occupied bin and applies floor(bin.amount * share / bin.liquidity).
+     * Returned amounts exclude LP fees.
+     */
+    getPositionAmounts(position: Pick<DlmmPosition, 'lower_bin_id' | 'liquidity_shares'>, pool: Pick<DlmmPool, 'active_id' | 'bin_step' | 'bin_manager'>, requestOptions?: RpcRequestOptions): Promise<BinLiquidityInfo>;
     /**
      * Get the amounts in the active bin if in range
      * @param bin_manager_handle - The bin manager handle
@@ -796,6 +802,12 @@ declare function parseDlmmBasePool(data: SuiEvent): DlmmBasePool;
 declare function parseDlmmPool(data: any): DlmmPool;
 declare function parsePartner(data: any): Partner;
 declare function parseDlmmPosition(data: any): DlmmPosition;
+/**
+ * Position principal from on-chain bin reserves.
+ * Each bin is floor(bin.amount * positionShare / bin.liquidity), then summed.
+ * `stored_bins` must include every bin whose position share is non-zero.
+ * Fees are not included.
+ */
 declare function parseLiquidityShares(liquidity_shares: string[], bin_step: number, lower_bin_id: number, active_bin: BinAmount, stored_bins?: BinAmount[]): BinLiquidityInfo;
 declare function parseBinInfoList(res: any): BinAmount[];
 declare function parseBinInfo(fields: any): BinAmount;
@@ -980,6 +992,15 @@ declare class BinUtils {
      * @param remove_liquidity - The amount of liquidity to be removed
      * @returns The amount of token A and token B to be removed
      */
+    static mulDivFloor(amount: string, share: string, totalShare: string): string;
+    /**
+     * Position principal in one bin, matching the contract:
+     * floor(bin.amount * positionShare / bin.totalLiquidityShare).
+     */
+    static calculatePositionBinAmounts(bin: BinAmount, positionLiquidityShare: string): {
+        amount_a: string;
+        amount_b: string;
+    };
     static calculateOutByShare(bin: BinAmount, remove_liquidity: string): {
         amount_a: string;
         amount_b: string;