@aspan/sdk 0.2.0 → 0.2.1

package/README.md

@@ -167,7 +167,7 @@ const hash = await router.stakeAndMintApUSD(
 // Or with full control
 const hash = await router.stakeAndMint({
   targetLST: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B", // slisBNB
-  mintXBNB: false,
+  isXBNB: false,
   minMintOut: parseAmount("99"),
   deadline: BigInt(Math.floor(Date.now() / 1000) + 3600),
   value: parseAmount("1"),  // 1 BNB
@@ -264,10 +264,31 @@ const defaultLST = await router.getDefaultLST();
 const isSupported = await router.isSupportedInputToken(USDT);
 const isLSTSupported = await router.isSupportedLST(slisBNB);
 
-// Preview swap output
-const output = await router.getExpectedOutput(USDT, parseAmount("100"), zeroAddress, false);
-console.log("Expected LST:", output.expectedLST);
-console.log("Expected apUSD:", output.expectedMint);
+// Preview swap + mint output (accurate calculation with fees)
+const mintOutput = await router.getExpectedMintOutput(
+  USDT,                  // inputToken
+  parseAmount("100"),    // inputAmount
+  zeroAddress,           // targetLST (use default)
+  false                  // isXBNB (false = apUSD)
+);
+console.log("Expected LST from swap:", formatAmount(mintOutput.expectedLST));
+console.log("Expected apUSD after mint:", formatAmount(mintOutput.expectedMint));
+
+// Preview redeem + swap output
+const redeemOutput = await router.getExpectedRedeemOutput(
+  false,                 // isXBNB (false = apUSD)
+  parseAmount("100"),    // redeemAmount
+  slisBNB,               // LST to redeem
+  USDT                   // outputToken
+);
+console.log("Expected LST from redeem:", formatAmount(redeemOutput.expectedLST));
+console.log("Expected USDT from swap:", formatAmount(redeemOutput.expectedMint));
+
+// Preview mint/redeem with LST (no swap, accurate with fees)
+const apUSDOut = await router.previewMintApUSD(slisBNB, parseAmount("1"));
+const xBNBOut = await router.previewMintXBNB(slisBNB, parseAmount("1"));
+const lstFromApUSD = await router.previewRedeemApUSD(slisBNB, parseAmount("100"));
+const lstFromXBNB = await router.previewRedeemXBNB(slisBNB, parseAmount("10"));
 
 // Get token addresses
 const wbnb = await router.getWBNB();
@@ -758,7 +779,9 @@ displayDashboard();
 | Category | Methods |
 |----------|---------|
 | **Config** | `getDefaultLST()`, `isSupportedInputToken()`, `isSupportedLST()`, `getDiamond()` |
-| **Preview** | `getExpectedOutput()` |
+| **Preview Swap+Mint** | `getExpectedMintOutput()` (swap → LST → mint) |
+| **Preview Redeem+Swap** | `getExpectedRedeemOutput()` (redeem → LST → swap) |
+| **Preview Direct** | `previewMintApUSD()`, `previewMintXBNB()`, `previewRedeemApUSD()`, `previewRedeemXBNB()` |
 | **Unstake** | `getUserWithdrawalIndices()`, `getWithdrawalStatus()` |
 | **Addresses** | `getWBNB()`, `getUSDT()`, `getUSDC()`, `getSlisBNB()`, `getAsBNB()`, `getWclisBNB()`, `getApUSD()`, `getXBNB()` |
 

package/dist/index.d.mts

@@ -233,7 +233,7 @@ interface StakeAndMintParams {
     /** Target LST (slisBNB, asBNB, wclisBNB) */
     targetLST: Address;
     /** true = mint xBNB, false = mint apUSD */
-    mintXBNB: boolean;
+    isXBNB: boolean;
     /** Minimum output to receive */
     minMintOut: bigint;
     /** Transaction deadline timestamp */
@@ -593,7 +593,27 @@ declare class AspanRouterReadClient {
     /**
      * Get expected output from a swap and mint operation
      */
-    getExpectedOutput(inputToken: Address, inputAmount: bigint, targetLST: Address, mintXBNB: boolean): Promise<ExpectedOutput>;
+    getExpectedMintOutput(inputToken: Address, inputAmount: bigint, targetLST: Address, isXBNB: boolean): Promise<ExpectedOutput>;
+    /**
+     * Get expected output from a redeem and swap operation
+     */
+    getExpectedRedeemOutput(isXBNB: boolean, redeemAmount: bigint, lst: Address, outputToken: Address): Promise<ExpectedOutput>;
+    /**
+     * Preview apUSD mint output for a given LST amount
+     */
+    previewMintApUSD(lst: Address, lstAmount: bigint): Promise<bigint>;
+    /**
+     * Preview xBNB mint output for a given LST amount
+     */
+    previewMintXBNB(lst: Address, lstAmount: bigint): Promise<bigint>;
+    /**
+     * Preview LST output for redeeming apUSD
+     */
+    previewRedeemApUSD(lst: Address, apUSDAmount: bigint): Promise<bigint>;
+    /**
+     * Preview LST output for redeeming xBNB
+     */
+    previewRedeemXBNB(lst: Address, xBNBAmount: bigint): Promise<bigint>;
     /**
      * Get user's withdrawal request indices
      */
@@ -1761,7 +1781,7 @@ declare const RouterABI: readonly [{
         readonly name: "targetLST";
         readonly type: "address";
     }, {
-        readonly name: "mintXBNB";
+        readonly name: "isXBNB";
         readonly type: "bool";
     }, {
         readonly name: "minMintOut";
@@ -2104,7 +2124,7 @@ declare const RouterABI: readonly [{
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "getExpectedOutput";
+    readonly name: "getExpectedMintOutput";
     readonly inputs: readonly [{
         readonly name: "inputToken";
         readonly type: "address";
@@ -2115,7 +2135,7 @@ declare const RouterABI: readonly [{
         readonly name: "targetLST";
         readonly type: "address";
     }, {
-        readonly name: "mintXBNB";
+        readonly name: "isXBNB";
         readonly type: "bool";
     }];
     readonly outputs: readonly [{
@@ -2126,6 +2146,90 @@ declare const RouterABI: readonly [{
         readonly type: "uint256";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getExpectedRedeemOutput";
+    readonly inputs: readonly [{
+        readonly name: "isXBNB";
+        readonly type: "bool";
+    }, {
+        readonly name: "redeemAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "expectedLST";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expectedOutput";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewMintApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewMintXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeemApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeemXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "getUserWithdrawalIndices";

package/dist/index.d.ts

@@ -233,7 +233,7 @@ interface StakeAndMintParams {
     /** Target LST (slisBNB, asBNB, wclisBNB) */
     targetLST: Address;
     /** true = mint xBNB, false = mint apUSD */
-    mintXBNB: boolean;
+    isXBNB: boolean;
     /** Minimum output to receive */
     minMintOut: bigint;
     /** Transaction deadline timestamp */
@@ -593,7 +593,27 @@ declare class AspanRouterReadClient {
     /**
      * Get expected output from a swap and mint operation
      */
-    getExpectedOutput(inputToken: Address, inputAmount: bigint, targetLST: Address, mintXBNB: boolean): Promise<ExpectedOutput>;
+    getExpectedMintOutput(inputToken: Address, inputAmount: bigint, targetLST: Address, isXBNB: boolean): Promise<ExpectedOutput>;
+    /**
+     * Get expected output from a redeem and swap operation
+     */
+    getExpectedRedeemOutput(isXBNB: boolean, redeemAmount: bigint, lst: Address, outputToken: Address): Promise<ExpectedOutput>;
+    /**
+     * Preview apUSD mint output for a given LST amount
+     */
+    previewMintApUSD(lst: Address, lstAmount: bigint): Promise<bigint>;
+    /**
+     * Preview xBNB mint output for a given LST amount
+     */
+    previewMintXBNB(lst: Address, lstAmount: bigint): Promise<bigint>;
+    /**
+     * Preview LST output for redeeming apUSD
+     */
+    previewRedeemApUSD(lst: Address, apUSDAmount: bigint): Promise<bigint>;
+    /**
+     * Preview LST output for redeeming xBNB
+     */
+    previewRedeemXBNB(lst: Address, xBNBAmount: bigint): Promise<bigint>;
     /**
      * Get user's withdrawal request indices
      */
@@ -1761,7 +1781,7 @@ declare const RouterABI: readonly [{
         readonly name: "targetLST";
         readonly type: "address";
     }, {
-        readonly name: "mintXBNB";
+        readonly name: "isXBNB";
         readonly type: "bool";
     }, {
         readonly name: "minMintOut";
@@ -2104,7 +2124,7 @@ declare const RouterABI: readonly [{
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "getExpectedOutput";
+    readonly name: "getExpectedMintOutput";
     readonly inputs: readonly [{
         readonly name: "inputToken";
         readonly type: "address";
@@ -2115,7 +2135,7 @@ declare const RouterABI: readonly [{
         readonly name: "targetLST";
         readonly type: "address";
     }, {
-        readonly name: "mintXBNB";
+        readonly name: "isXBNB";
         readonly type: "bool";
     }];
     readonly outputs: readonly [{
@@ -2126,6 +2146,90 @@ declare const RouterABI: readonly [{
         readonly type: "uint256";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getExpectedRedeemOutput";
+    readonly inputs: readonly [{
+        readonly name: "isXBNB";
+        readonly type: "bool";
+    }, {
+        readonly name: "redeemAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "expectedLST";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expectedOutput";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewMintApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewMintXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeemApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeemXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "getUserWithdrawalIndices";

package/dist/index.js

@@ -1536,7 +1536,7 @@ var RouterABI = [
     name: "stakeAndMint",
     inputs: [
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" },
+      { name: "isXBNB", type: "bool" },
       { name: "minMintOut", type: "uint256" },
       { name: "deadline", type: "uint256" }
     ],
@@ -1761,15 +1761,15 @@ var RouterABI = [
     outputs: [{ name: "", type: "address" }],
     stateMutability: "view"
   },
-  // getExpectedOutput
+  // getExpectedMintOutput
   {
     type: "function",
-    name: "getExpectedOutput",
+    name: "getExpectedMintOutput",
     inputs: [
       { name: "inputToken", type: "address" },
       { name: "inputAmount", type: "uint256" },
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" }
+      { name: "isXBNB", type: "bool" }
     ],
     outputs: [
       { name: "expectedLST", type: "uint256" },
@@ -1777,6 +1777,66 @@ var RouterABI = [
     ],
     stateMutability: "view"
   },
+  // getExpectedRedeemOutput
+  {
+    type: "function",
+    name: "getExpectedRedeemOutput",
+    inputs: [
+      { name: "isXBNB", type: "bool" },
+      { name: "redeemAmount", type: "uint256" },
+      { name: "lst", type: "address" },
+      { name: "outputToken", type: "address" }
+    ],
+    outputs: [
+      { name: "expectedLST", type: "uint256" },
+      { name: "expectedOutput", type: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  // previewMintApUSD
+  {
+    type: "function",
+    name: "previewMintApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "apUSDAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewMintXBNB
+  {
+    type: "function",
+    name: "previewMintXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "xBNBAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewRedeemApUSD
+  {
+    type: "function",
+    name: "previewRedeemApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "apUSDAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewRedeemXBNB
+  {
+    type: "function",
+    name: "previewRedeemXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "xBNBAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
   // getUserWithdrawalIndices
   {
     type: "function",
@@ -2027,18 +2087,77 @@ var AspanRouterReadClient = class {
   /**
    * Get expected output from a swap and mint operation
    */
-  async getExpectedOutput(inputToken, inputAmount, targetLST, mintXBNB) {
+  async getExpectedMintOutput(inputToken, inputAmount, targetLST, isXBNB) {
     const result = await this.publicClient.readContract({
       address: this.routerAddress,
       abi: RouterABI,
-      functionName: "getExpectedOutput",
-      args: [inputToken, inputAmount, targetLST, mintXBNB]
+      functionName: "getExpectedMintOutput",
+      args: [inputToken, inputAmount, targetLST, isXBNB]
     });
     return {
       expectedLST: result[0],
       expectedMint: result[1]
     };
   }
+  /**
+   * Get expected output from a redeem and swap operation
+   */
+  async getExpectedRedeemOutput(isXBNB, redeemAmount, lst, outputToken) {
+    const result = await this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "getExpectedRedeemOutput",
+      args: [isXBNB, redeemAmount, lst, outputToken]
+    });
+    return {
+      expectedLST: result[0],
+      expectedMint: result[1]
+    };
+  }
+  /**
+   * Preview apUSD mint output for a given LST amount
+   */
+  async previewMintApUSD(lst, lstAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintApUSD",
+      args: [lst, lstAmount]
+    });
+  }
+  /**
+   * Preview xBNB mint output for a given LST amount
+   */
+  async previewMintXBNB(lst, lstAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintXBNB",
+      args: [lst, lstAmount]
+    });
+  }
+  /**
+   * Preview LST output for redeeming apUSD
+   */
+  async previewRedeemApUSD(lst, apUSDAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemApUSD",
+      args: [lst, apUSDAmount]
+    });
+  }
+  /**
+   * Preview LST output for redeeming xBNB
+   */
+  async previewRedeemXBNB(lst, xBNBAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemXBNB",
+      args: [lst, xBNBAmount]
+    });
+  }
   /**
    * Get user's withdrawal request indices
    */
@@ -2213,7 +2332,7 @@ var AspanRouterClient = class extends AspanRouterReadClient {
       functionName: "stakeAndMint",
       args: [
         params.targetLST,
-        params.mintXBNB,
+        params.isXBNB,
         params.minMintOut,
         params.deadline
       ],

package/dist/index.mjs

@@ -1497,7 +1497,7 @@ var RouterABI = [
     name: "stakeAndMint",
     inputs: [
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" },
+      { name: "isXBNB", type: "bool" },
       { name: "minMintOut", type: "uint256" },
       { name: "deadline", type: "uint256" }
     ],
@@ -1722,15 +1722,15 @@ var RouterABI = [
     outputs: [{ name: "", type: "address" }],
     stateMutability: "view"
   },
-  // getExpectedOutput
+  // getExpectedMintOutput
   {
     type: "function",
-    name: "getExpectedOutput",
+    name: "getExpectedMintOutput",
     inputs: [
       { name: "inputToken", type: "address" },
       { name: "inputAmount", type: "uint256" },
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" }
+      { name: "isXBNB", type: "bool" }
     ],
     outputs: [
       { name: "expectedLST", type: "uint256" },
@@ -1738,6 +1738,66 @@ var RouterABI = [
     ],
     stateMutability: "view"
   },
+  // getExpectedRedeemOutput
+  {
+    type: "function",
+    name: "getExpectedRedeemOutput",
+    inputs: [
+      { name: "isXBNB", type: "bool" },
+      { name: "redeemAmount", type: "uint256" },
+      { name: "lst", type: "address" },
+      { name: "outputToken", type: "address" }
+    ],
+    outputs: [
+      { name: "expectedLST", type: "uint256" },
+      { name: "expectedOutput", type: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  // previewMintApUSD
+  {
+    type: "function",
+    name: "previewMintApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "apUSDAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewMintXBNB
+  {
+    type: "function",
+    name: "previewMintXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "xBNBAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewRedeemApUSD
+  {
+    type: "function",
+    name: "previewRedeemApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "apUSDAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
+  // previewRedeemXBNB
+  {
+    type: "function",
+    name: "previewRedeemXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "xBNBAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view"
+  },
   // getUserWithdrawalIndices
   {
     type: "function",
@@ -1988,18 +2048,77 @@ var AspanRouterReadClient = class {
   /**
    * Get expected output from a swap and mint operation
    */
-  async getExpectedOutput(inputToken, inputAmount, targetLST, mintXBNB) {
+  async getExpectedMintOutput(inputToken, inputAmount, targetLST, isXBNB) {
     const result = await this.publicClient.readContract({
       address: this.routerAddress,
       abi: RouterABI,
-      functionName: "getExpectedOutput",
-      args: [inputToken, inputAmount, targetLST, mintXBNB]
+      functionName: "getExpectedMintOutput",
+      args: [inputToken, inputAmount, targetLST, isXBNB]
     });
     return {
       expectedLST: result[0],
       expectedMint: result[1]
     };
   }
+  /**
+   * Get expected output from a redeem and swap operation
+   */
+  async getExpectedRedeemOutput(isXBNB, redeemAmount, lst, outputToken) {
+    const result = await this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "getExpectedRedeemOutput",
+      args: [isXBNB, redeemAmount, lst, outputToken]
+    });
+    return {
+      expectedLST: result[0],
+      expectedMint: result[1]
+    };
+  }
+  /**
+   * Preview apUSD mint output for a given LST amount
+   */
+  async previewMintApUSD(lst, lstAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintApUSD",
+      args: [lst, lstAmount]
+    });
+  }
+  /**
+   * Preview xBNB mint output for a given LST amount
+   */
+  async previewMintXBNB(lst, lstAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintXBNB",
+      args: [lst, lstAmount]
+    });
+  }
+  /**
+   * Preview LST output for redeeming apUSD
+   */
+  async previewRedeemApUSD(lst, apUSDAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemApUSD",
+      args: [lst, apUSDAmount]
+    });
+  }
+  /**
+   * Preview LST output for redeeming xBNB
+   */
+  async previewRedeemXBNB(lst, xBNBAmount) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemXBNB",
+      args: [lst, xBNBAmount]
+    });
+  }
   /**
    * Get user's withdrawal request indices
    */
@@ -2174,7 +2293,7 @@ var AspanRouterClient = class extends AspanRouterReadClient {
       functionName: "stakeAndMint",
       args: [
         params.targetLST,
-        params.mintXBNB,
+        params.isXBNB,
         params.minMintOut,
         params.deadline
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "TypeScript SDK for Aspan Protocol - LST-backed stablecoin on BNB Chain",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/abi/router.ts

@@ -82,7 +82,7 @@ export const RouterABI = [
     name: "stakeAndMint",
     inputs: [
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" },
+      { name: "isXBNB", type: "bool" },
       { name: "minMintOut", type: "uint256" },
       { name: "deadline", type: "uint256" },
     ],
@@ -332,15 +332,15 @@ export const RouterABI = [
     stateMutability: "view",
   },
 
-  // getExpectedOutput
+  // getExpectedMintOutput
   {
     type: "function",
-    name: "getExpectedOutput",
+    name: "getExpectedMintOutput",
     inputs: [
       { name: "inputToken", type: "address" },
       { name: "inputAmount", type: "uint256" },
       { name: "targetLST", type: "address" },
-      { name: "mintXBNB", type: "bool" },
+      { name: "isXBNB", type: "bool" },
     ],
     outputs: [
       { name: "expectedLST", type: "uint256" },
@@ -349,6 +349,71 @@ export const RouterABI = [
     stateMutability: "view",
   },
 
+  // getExpectedRedeemOutput
+  {
+    type: "function",
+    name: "getExpectedRedeemOutput",
+    inputs: [
+      { name: "isXBNB", type: "bool" },
+      { name: "redeemAmount", type: "uint256" },
+      { name: "lst", type: "address" },
+      { name: "outputToken", type: "address" },
+    ],
+    outputs: [
+      { name: "expectedLST", type: "uint256" },
+      { name: "expectedOutput", type: "uint256" },
+    ],
+    stateMutability: "view",
+  },
+
+  // previewMintApUSD
+  {
+    type: "function",
+    name: "previewMintApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" },
+    ],
+    outputs: [{ name: "apUSDAmount", type: "uint256" }],
+    stateMutability: "view",
+  },
+
+  // previewMintXBNB
+  {
+    type: "function",
+    name: "previewMintXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "lstAmount", type: "uint256" },
+    ],
+    outputs: [{ name: "xBNBAmount", type: "uint256" }],
+    stateMutability: "view",
+  },
+
+  // previewRedeemApUSD
+  {
+    type: "function",
+    name: "previewRedeemApUSD",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "apUSDAmount", type: "uint256" },
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view",
+  },
+
+  // previewRedeemXBNB
+  {
+    type: "function",
+    name: "previewRedeemXBNB",
+    inputs: [
+      { name: "lst", type: "address" },
+      { name: "xBNBAmount", type: "uint256" },
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256" }],
+    stateMutability: "view",
+  },
+
   // getUserWithdrawalIndices
   {
     type: "function",

package/src/router.ts

@@ -121,17 +121,17 @@ export class AspanRouterReadClient {
   /**
    * Get expected output from a swap and mint operation
    */
-  async getExpectedOutput(
+  async getExpectedMintOutput(
     inputToken: Address,
     inputAmount: bigint,
     targetLST: Address,
-    mintXBNB: boolean
+    isXBNB: boolean
   ): Promise<ExpectedOutput> {
     const result = await this.publicClient.readContract({
       address: this.routerAddress,
       abi: RouterABI,
-      functionName: "getExpectedOutput",
-      args: [inputToken, inputAmount, targetLST, mintXBNB],
+      functionName: "getExpectedMintOutput",
+      args: [inputToken, inputAmount, targetLST, isXBNB],
     });
 
     return {
@@ -140,6 +140,76 @@ export class AspanRouterReadClient {
     };
   }
 
+  /**
+   * Get expected output from a redeem and swap operation
+   */
+  async getExpectedRedeemOutput(
+    isXBNB: boolean,
+    redeemAmount: bigint,
+    lst: Address,
+    outputToken: Address
+  ): Promise<ExpectedOutput> {
+    const result = await this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "getExpectedRedeemOutput",
+      args: [isXBNB, redeemAmount, lst, outputToken],
+    });
+
+    return {
+      expectedLST: result[0],
+      expectedMint: result[1],
+    };
+  }
+
+  /**
+   * Preview apUSD mint output for a given LST amount
+   */
+  async previewMintApUSD(lst: Address, lstAmount: bigint): Promise<bigint> {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintApUSD",
+      args: [lst, lstAmount],
+    });
+  }
+
+  /**
+   * Preview xBNB mint output for a given LST amount
+   */
+  async previewMintXBNB(lst: Address, lstAmount: bigint): Promise<bigint> {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewMintXBNB",
+      args: [lst, lstAmount],
+    });
+  }
+
+  /**
+   * Preview LST output for redeeming apUSD
+   */
+  async previewRedeemApUSD(lst: Address, apUSDAmount: bigint): Promise<bigint> {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemApUSD",
+      args: [lst, apUSDAmount],
+    });
+  }
+
+  /**
+   * Preview LST output for redeeming xBNB
+   */
+  async previewRedeemXBNB(lst: Address, xBNBAmount: bigint): Promise<bigint> {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "previewRedeemXBNB",
+      args: [lst, xBNBAmount],
+    });
+  }
+
   /**
    * Get user's withdrawal request indices
    */
@@ -347,7 +417,7 @@ export class AspanRouterClient extends AspanRouterReadClient {
       functionName: "stakeAndMint",
       args: [
         params.targetLST,
-        params.mintXBNB,
+        params.isXBNB,
         params.minMintOut,
         params.deadline,
       ],

package/src/types.ts

@@ -285,7 +285,7 @@ export interface StakeAndMintParams {
   /** Target LST (slisBNB, asBNB, wclisBNB) */
   targetLST: Address;
   /** true = mint xBNB, false = mint apUSD */
-  mintXBNB: boolean;
+  isXBNB: boolean;
   /** Minimum output to receive */
   minMintOut: bigint;
   /** Transaction deadline timestamp */