@gala-chain/gswap-sdk 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -492,6 +492,46 @@ declare class Positions {
         tickLower: number;
         tickUpper: number;
     }): Promise<GetPositionResult>;
+    /**
+     * Estimates the token amounts that would be received from removing liquidity from a position.
+     * @param args - Parameters for estimating liquidity removal.
+     * @param args.ownerAddress - The wallet address that owns the position.
+     * @param args.positionId - The position identifier.
+     * @param args.token0 - The first token in the pair.
+     * @param args.token1 - The second token in the pair.
+     * @param args.fee - The pool fee tier.
+     * @param args.tickLower - The lower tick of the position range.
+     * @param args.tickUpper - The upper tick of the position range.
+     * @param args.amount - The amount of liquidity to remove.
+     * @returns Estimated token amounts that would be received.
+     * @example
+     * ```typescript
+     * const estimation = await gSwap.positions.estimateRemoveLiquidity({
+     *   ownerAddress: 'client|635f048ab243d7eb7f5ba044',
+     *   positionId: '210f8e4dd1bbe1b4af4b977330ee7e4b68bc716f66e39c87a60fff0976ded3ea',
+     *   token0: 'GALA|Unit|none|none',
+     *   token1: 'GUSDT|Unit|none|none',
+     *   fee: 3000,
+     *   tickLower: -41100,
+     *   tickUpper: -40080,
+     *   amount: '1491.973332758921980256'
+     * });
+     * console.log('Estimated tokens:', estimation);
+     * ```
+     */
+    estimateRemoveLiquidity(args: {
+        ownerAddress: string;
+        positionId: string;
+        token0: GalaChainTokenClassKey | string;
+        token1: GalaChainTokenClassKey | string;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+        amount: NumericAmount;
+    }): Promise<{
+        amount0: BigNumber;
+        amount1: BigNumber;
+    }>;
     /**
      * Gets detailed information about a liquidity position by its ID.
      * @param ownerAddress - The wallet address that owns the position.

package/dist/index.d.ts

@@ -492,6 +492,46 @@ declare class Positions {
         tickLower: number;
         tickUpper: number;
     }): Promise<GetPositionResult>;
+    /**
+     * Estimates the token amounts that would be received from removing liquidity from a position.
+     * @param args - Parameters for estimating liquidity removal.
+     * @param args.ownerAddress - The wallet address that owns the position.
+     * @param args.positionId - The position identifier.
+     * @param args.token0 - The first token in the pair.
+     * @param args.token1 - The second token in the pair.
+     * @param args.fee - The pool fee tier.
+     * @param args.tickLower - The lower tick of the position range.
+     * @param args.tickUpper - The upper tick of the position range.
+     * @param args.amount - The amount of liquidity to remove.
+     * @returns Estimated token amounts that would be received.
+     * @example
+     * ```typescript
+     * const estimation = await gSwap.positions.estimateRemoveLiquidity({
+     *   ownerAddress: 'client|635f048ab243d7eb7f5ba044',
+     *   positionId: '210f8e4dd1bbe1b4af4b977330ee7e4b68bc716f66e39c87a60fff0976ded3ea',
+     *   token0: 'GALA|Unit|none|none',
+     *   token1: 'GUSDT|Unit|none|none',
+     *   fee: 3000,
+     *   tickLower: -41100,
+     *   tickUpper: -40080,
+     *   amount: '1491.973332758921980256'
+     * });
+     * console.log('Estimated tokens:', estimation);
+     * ```
+     */
+    estimateRemoveLiquidity(args: {
+        ownerAddress: string;
+        positionId: string;
+        token0: GalaChainTokenClassKey | string;
+        token1: GalaChainTokenClassKey | string;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+        amount: NumericAmount;
+    }): Promise<{
+        amount0: BigNumber;
+        amount1: BigNumber;
+    }>;
     /**
      * Gets detailed information about a liquidity position by its ID.
      * @param ownerAddress - The wallet address that owns the position.

package/dist/index.mjs

@@ -858,6 +858,56 @@ var Positions = class {
     });
     return result;
   }
+  /**
+   * Estimates the token amounts that would be received from removing liquidity from a position.
+   * @param args - Parameters for estimating liquidity removal.
+   * @param args.ownerAddress - The wallet address that owns the position.
+   * @param args.positionId - The position identifier.
+   * @param args.token0 - The first token in the pair.
+   * @param args.token1 - The second token in the pair.
+   * @param args.fee - The pool fee tier.
+   * @param args.tickLower - The lower tick of the position range.
+   * @param args.tickUpper - The upper tick of the position range.
+   * @param args.amount - The amount of liquidity to remove.
+   * @returns Estimated token amounts that would be received.
+   * @example
+   * ```typescript
+   * const estimation = await gSwap.positions.estimateRemoveLiquidity({
+   *   ownerAddress: 'client|635f048ab243d7eb7f5ba044',
+   *   positionId: '210f8e4dd1bbe1b4af4b977330ee7e4b68bc716f66e39c87a60fff0976ded3ea',
+   *   token0: 'GALA|Unit|none|none',
+   *   token1: 'GUSDT|Unit|none|none',
+   *   fee: 3000,
+   *   tickLower: -41100,
+   *   tickUpper: -40080,
+   *   amount: '1491.973332758921980256'
+   * });
+   * console.log('Estimated tokens:', estimation);
+   * ```
+   */
+  async estimateRemoveLiquidity(args) {
+    validateWalletAddress(args.ownerAddress);
+    validateFee(args.fee);
+    validateTickRange(args.tickLower, args.tickUpper);
+    validateNumericAmount(args.amount, "amount");
+    const token0TokenClassKey = parseTokenClassKey(args.token0);
+    const token1TokenClassKey = parseTokenClassKey(args.token1);
+    const ordering = getTokenOrdering(token0TokenClassKey, token1TokenClassKey, false);
+    const responseBody = await this.httpClient.sendPostRequest(this.gatewayBaseUrl, this.dexContractBasePath, "/GetRemoveLiquidityEstimation", {
+      tickLower: args.tickLower,
+      tickUpper: args.tickUpper,
+      amount: BigNumber3(args.amount).toFixed(),
+      token0: ordering.token0,
+      token1: ordering.token1,
+      fee: args.fee,
+      owner: args.ownerAddress,
+      positionId: args.positionId
+    });
+    return {
+      amount0: BigNumber3(responseBody.Data.amount0),
+      amount1: BigNumber3(responseBody.Data.amount1)
+    };
+  }
   /**
    * Gets detailed information about a liquidity position by its ID.
    * @param ownerAddress - The wallet address that owns the position.
@@ -921,8 +971,8 @@ var Positions = class {
     validateWalletAddress(walletAddress);
     validateFee(args.fee);
     validateTickRange(args.tickLower, args.tickUpper);
-    validateNumericAmount(args.amount0Desired, "amount0Desired");
-    validateNumericAmount(args.amount1Desired, "amount1Desired");
+    validateNumericAmount(args.amount0Desired, "amount0Desired", true);
+    validateNumericAmount(args.amount1Desired, "amount1Desired", true);
     validateNumericAmount(args.amount0Min, "amount0Min", true);
     validateNumericAmount(args.amount1Min, "amount1Min", true);
     const token0TokenClassKey = parseTokenClassKey(args.token0);
@@ -1008,8 +1058,8 @@ var Positions = class {
     validateTickSpacing(args.tickSpacing);
     validateNumericAmount(args.minPrice, "minPrice", true);
     validateNumericAmount(args.maxPrice, "maxPrice");
-    validateNumericAmount(args.amount0Desired, "amount0Desired");
-    validateNumericAmount(args.amount1Desired, "amount1Desired");
+    validateNumericAmount(args.amount0Desired, "amount0Desired", true);
+    validateNumericAmount(args.amount1Desired, "amount1Desired", true);
     validateNumericAmount(args.amount0Min, "amount0Min", true);
     validateNumericAmount(args.amount1Min, "amount1Min", true);
     if (BigNumber3(args.minPrice).isGreaterThan(BigNumber3(args.maxPrice))) {