@aspan/sdk 0.4.9 → 0.5.1

package/README.md

@@ -22,11 +22,11 @@ import { BSC_ADDRESSES } from "@aspan/sdk";
 | Contract | Address |
 |----------|---------|
 | **Diamond (Main Entry)** | `0x6a11B30d3a70727d5477D6d8090e144443fA1c78` |
-| **Router** | `0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3` |
+| **Router** | `0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E` |
 | **ApUSD** | `0x4570047eeB5aDb4081c5d470494EB5134e34A287` |
 | **XBNB** | `0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43` |
 | **SApUSD** | `0xE2BE739C4aA4126ee72D612d9548C38B1B0e5A1b` |
-| **wclisBNB** | `0x448f7c2fa4e5135a4a5B50879602cf3CD428e108` |
+| **wclisBNB** | `0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07` |
 
 ## Quick Start
 

package/dist/index.d.mts

@@ -97,14 +97,11 @@ interface RedeemXBNBParams {
 }
 /** Parameters for depositing to stability pool */
 interface DepositParams {
-    assets: bigint;
-    receiver: Address;
+    apUSDAmount: bigint;
 }
-/** Parameters for redeeming from stability pool */
-interface RedeemParams {
+/** Parameters for withdrawing from stability pool */
+interface WithdrawParams {
     shares: bigint;
-    receiver: Address;
-    owner: Address;
 }
 /** Overall protocol statistics */
 interface ProtocolStats {
@@ -206,7 +203,7 @@ interface RouterSwapParams {
     targetLST: Address;
     /** Minimum LST to receive from swap (slippage protection) */
     minLSTOut: bigint;
-    /** PancakeSwap V3 pool fee tier (500, 2500, 10000) */
+    /** PancakeSwap V3 pool fee tier (100, 500, 2500, 10000) */
     poolFee: number;
 }
 /** Router mint parameters */
@@ -580,11 +577,11 @@ declare class AspanClient extends AspanReadClient {
      */
     deposit(params: DepositParams): Promise<Hash>;
     /**
-     * Redeem from stability pool by shares
-     * @param params Redeem parameters
+     * Withdraw from stability pool by shares
+     * @param params Withdraw parameters
      * @returns Transaction hash
      */
-    redeem(params: RedeemParams): Promise<Hash>;
+    withdraw(params: WithdrawParams): Promise<Hash>;
     /**
      * Harvest yield from LSTs
      * @returns Transaction hash
@@ -773,6 +770,11 @@ declare class AspanRouterReadClient {
     getWBNB(): Promise<Address>;
     getUSDT(): Promise<Address>;
     getUSDC(): Promise<Address>;
+    /**
+     * Get stablecoin price in USD (18 decimals) from Chainlink.
+     * Returns 1e18 if feed unavailable (graceful fallback).
+     */
+    getStablecoinPrice(token: Address): Promise<bigint>;
     getSlisBNB(): Promise<Address>;
     getAsBNB(): Promise<Address>;
     getWclisBNB(): Promise<Address>;
@@ -1334,13 +1336,9 @@ declare const DiamondABI: readonly [{
     readonly type: "function";
     readonly name: "deposit";
     readonly inputs: readonly [{
-        readonly name: "assets";
+        readonly name: "_amount";
         readonly type: "uint256";
         readonly internalType: "uint256";
-    }, {
-        readonly name: "receiver";
-        readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "shares";
@@ -1350,26 +1348,14 @@ declare const DiamondABI: readonly [{
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "redeem";
+    readonly name: "withdraw";
     readonly inputs: readonly [{
-        readonly name: "shares";
+        readonly name: "_shares";
         readonly type: "uint256";
         readonly internalType: "uint256";
-    }, {
-        readonly name: "receiver";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "owner";
-        readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
-        readonly name: "apUSDOut";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "xBNBOut";
+        readonly name: "assets";
         readonly type: "uint256";
         readonly internalType: "uint256";
     }];
@@ -2828,15 +2814,18 @@ declare const BPS_PRECISION = 10000n;
 declare const PRICE_PRECISION: bigint;
 declare const BSC_ADDRESSES: {
     readonly diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78";
-    readonly router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3";
+    readonly router: "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E";
     readonly apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287";
     readonly xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43";
     readonly sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB";
     readonly slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B";
     readonly asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6";
-    readonly wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108";
+    readonly wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07";
     readonly USDT: "0x55d398326f99059fF775485246999027B3197955";
     readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+    /** Chainlink price feeds (BSC Mainnet) */
+    readonly USDT_USD_FEED: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320";
+    readonly USDC_USD_FEED: "0x51597f405303C4377E36123cBc172b13269EA163";
     readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 };
 declare const PHAROS_ADDRESSES: {
@@ -2888,4 +2877,4 @@ declare function formatPriceUSD(price: bigint): string;
  */
 declare function calculateAPY(previousRate: bigint, currentRate: bigint, periodDays: number): number;
 
-export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };
+export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };

package/dist/index.d.ts

@@ -97,14 +97,11 @@ interface RedeemXBNBParams {
 }
 /** Parameters for depositing to stability pool */
 interface DepositParams {
-    assets: bigint;
-    receiver: Address;
+    apUSDAmount: bigint;
 }
-/** Parameters for redeeming from stability pool */
-interface RedeemParams {
+/** Parameters for withdrawing from stability pool */
+interface WithdrawParams {
     shares: bigint;
-    receiver: Address;
-    owner: Address;
 }
 /** Overall protocol statistics */
 interface ProtocolStats {
@@ -206,7 +203,7 @@ interface RouterSwapParams {
     targetLST: Address;
     /** Minimum LST to receive from swap (slippage protection) */
     minLSTOut: bigint;
-    /** PancakeSwap V3 pool fee tier (500, 2500, 10000) */
+    /** PancakeSwap V3 pool fee tier (100, 500, 2500, 10000) */
     poolFee: number;
 }
 /** Router mint parameters */
@@ -580,11 +577,11 @@ declare class AspanClient extends AspanReadClient {
      */
     deposit(params: DepositParams): Promise<Hash>;
     /**
-     * Redeem from stability pool by shares
-     * @param params Redeem parameters
+     * Withdraw from stability pool by shares
+     * @param params Withdraw parameters
      * @returns Transaction hash
      */
-    redeem(params: RedeemParams): Promise<Hash>;
+    withdraw(params: WithdrawParams): Promise<Hash>;
     /**
      * Harvest yield from LSTs
      * @returns Transaction hash
@@ -773,6 +770,11 @@ declare class AspanRouterReadClient {
     getWBNB(): Promise<Address>;
     getUSDT(): Promise<Address>;
     getUSDC(): Promise<Address>;
+    /**
+     * Get stablecoin price in USD (18 decimals) from Chainlink.
+     * Returns 1e18 if feed unavailable (graceful fallback).
+     */
+    getStablecoinPrice(token: Address): Promise<bigint>;
     getSlisBNB(): Promise<Address>;
     getAsBNB(): Promise<Address>;
     getWclisBNB(): Promise<Address>;
@@ -1334,13 +1336,9 @@ declare const DiamondABI: readonly [{
     readonly type: "function";
     readonly name: "deposit";
     readonly inputs: readonly [{
-        readonly name: "assets";
+        readonly name: "_amount";
         readonly type: "uint256";
         readonly internalType: "uint256";
-    }, {
-        readonly name: "receiver";
-        readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "shares";
@@ -1350,26 +1348,14 @@ declare const DiamondABI: readonly [{
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "redeem";
+    readonly name: "withdraw";
     readonly inputs: readonly [{
-        readonly name: "shares";
+        readonly name: "_shares";
         readonly type: "uint256";
         readonly internalType: "uint256";
-    }, {
-        readonly name: "receiver";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "owner";
-        readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
-        readonly name: "apUSDOut";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "xBNBOut";
+        readonly name: "assets";
         readonly type: "uint256";
         readonly internalType: "uint256";
     }];
@@ -2828,15 +2814,18 @@ declare const BPS_PRECISION = 10000n;
 declare const PRICE_PRECISION: bigint;
 declare const BSC_ADDRESSES: {
     readonly diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78";
-    readonly router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3";
+    readonly router: "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E";
     readonly apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287";
     readonly xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43";
     readonly sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB";
     readonly slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B";
     readonly asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6";
-    readonly wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108";
+    readonly wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07";
     readonly USDT: "0x55d398326f99059fF775485246999027B3197955";
     readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+    /** Chainlink price feeds (BSC Mainnet) */
+    readonly USDT_USD_FEED: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320";
+    readonly USDC_USD_FEED: "0x51597f405303C4377E36123cBc172b13269EA163";
     readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 };
 declare const PHAROS_ADDRESSES: {
@@ -2888,4 +2877,4 @@ declare function formatPriceUSD(price: bigint): string;
  */
 declare function calculateAPY(previousRate: bigint, currentRate: bigint, periodDays: number): number;
 
-export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };
+export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };

package/dist/index.js

@@ -303,24 +303,18 @@ var DiamondABI = [
   {
     type: "function",
     name: "deposit",
-    inputs: [
-      { name: "assets", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" }
-    ],
+    inputs: [{ name: "_amount", type: "uint256", internalType: "uint256" }],
     outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "redeem",
+    name: "withdraw",
     inputs: [
-      { name: "shares", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" },
-      { name: "owner", type: "address", internalType: "address" }
+      { name: "_shares", type: "uint256", internalType: "uint256" }
     ],
     outputs: [
-      { name: "apUSDOut", type: "uint256", internalType: "uint256" },
-      { name: "xBNBOut", type: "uint256", internalType: "uint256" }
+      { name: "assets", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "nonpayable"
   },
@@ -1812,22 +1806,22 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "deposit",
-      args: [params.assets, params.receiver]
+      args: [params.apUSDAmount]
     });
   }
   /**
-   * Redeem from stability pool by shares
-   * @param params Redeem parameters
+   * Withdraw from stability pool by shares
+   * @param params Withdraw parameters
    * @returns Transaction hash
    */
-  async redeem(params) {
+  async withdraw(params) {
     return this.walletClient.writeContract({
       chain: this.chain,
       account: this.walletClient.account,
       address: this.diamondAddress,
       abi: DiamondABI,
-      functionName: "redeem",
-      args: [params.shares, params.receiver, params.owner]
+      functionName: "withdraw",
+      args: [params.shares]
     });
   }
   /**
@@ -2390,6 +2384,21 @@ var RouterABI = [
 ];
 
 // src/router.ts
+var ChainlinkABI = [
+  {
+    type: "function",
+    name: "latestRoundData",
+    inputs: [],
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" }
+    ],
+    stateMutability: "view"
+  }
+];
 var AspanRouterReadClient = class {
   publicClient;
   routerAddress;
@@ -2545,7 +2554,9 @@ var AspanRouterReadClient = class {
         const usdValue = inputAmount * bnbPrice18 / one;
         lstAmount = lstPrice18 === 0n ? 0n : usdValue * one / lstPrice18;
       } else if (inNorm === usdt.toLowerCase() || inNorm === usdc.toLowerCase()) {
-        lstAmount = lstPrice18 === 0n ? 0n : inputAmount * one / lstPrice18;
+        const stablePrice18 = await this.getStablecoinPrice(inputToken);
+        const usdValue = inputAmount * stablePrice18 / one;
+        lstAmount = lstPrice18 === 0n ? 0n : usdValue * one / lstPrice18;
       } else {
         throw new Error("Unsupported input token for SDK preview");
       }
@@ -2591,7 +2602,8 @@ var AspanRouterReadClient = class {
       if (outNorm === import_viem2.zeroAddress.toLowerCase() || outNorm === wbnb.toLowerCase()) {
         outputAmount = bnbPrice18 === 0n ? 0n : usdValue * one / bnbPrice18;
       } else if (outNorm === usdt.toLowerCase() || outNorm === usdc.toLowerCase()) {
-        outputAmount = usdValue;
+        const stablePrice18 = await this.getStablecoinPrice(outputToken);
+        outputAmount = stablePrice18 === 0n ? 0n : usdValue * one / stablePrice18;
       } else {
         throw new Error("Unsupported output token for SDK preview");
       }
@@ -2656,6 +2668,32 @@ var AspanRouterReadClient = class {
       })
     );
   }
+  /**
+   * Get stablecoin price in USD (18 decimals) from Chainlink.
+   * Returns 1e18 if feed unavailable (graceful fallback).
+   */
+  async getStablecoinPrice(token) {
+    const usdt = await this.getUSDT();
+    const usdc = await this.getUSDC();
+    const norm = token.toLowerCase();
+    let feed = null;
+    if (norm === usdt.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDT_USD_FEED;
+    } else if (norm === usdc.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDC_USD_FEED;
+    }
+    if (!feed) return 10n ** 18n;
+    try {
+      const [, answer] = await this.publicClient.readContract({
+        address: feed,
+        abi: ChainlinkABI,
+        functionName: "latestRoundData"
+      });
+      return BigInt(answer) * 10n ** 10n;
+    } catch {
+      return 10n ** 18n;
+    }
+  }
   async getSlisBNB() {
     return this._getCachedAddress(
       "slisBNB",
@@ -2960,17 +2998,20 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3",
+  router: "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB",
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B",
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6",
-  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108",
+  wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07",
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955",
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+  /** Chainlink price feeds (BSC Mainnet) */
+  USDT_USD_FEED: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320",
+  USDC_USD_FEED: "0x51597f405303C4377E36123cBc172b13269EA163",
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
 };
 var PHAROS_ADDRESSES = {

package/dist/index.mjs

@@ -245,24 +245,18 @@ var DiamondABI = [
   {
     type: "function",
     name: "deposit",
-    inputs: [
-      { name: "assets", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" }
-    ],
+    inputs: [{ name: "_amount", type: "uint256", internalType: "uint256" }],
     outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "redeem",
+    name: "withdraw",
     inputs: [
-      { name: "shares", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" },
-      { name: "owner", type: "address", internalType: "address" }
+      { name: "_shares", type: "uint256", internalType: "uint256" }
     ],
     outputs: [
-      { name: "apUSDOut", type: "uint256", internalType: "uint256" },
-      { name: "xBNBOut", type: "uint256", internalType: "uint256" }
+      { name: "assets", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "nonpayable"
   },
@@ -1754,22 +1748,22 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "deposit",
-      args: [params.assets, params.receiver]
+      args: [params.apUSDAmount]
     });
   }
   /**
-   * Redeem from stability pool by shares
-   * @param params Redeem parameters
+   * Withdraw from stability pool by shares
+   * @param params Withdraw parameters
    * @returns Transaction hash
    */
-  async redeem(params) {
+  async withdraw(params) {
     return this.walletClient.writeContract({
       chain: this.chain,
       account: this.walletClient.account,
       address: this.diamondAddress,
       abi: DiamondABI,
-      functionName: "redeem",
-      args: [params.shares, params.receiver, params.owner]
+      functionName: "withdraw",
+      args: [params.shares]
     });
   }
   /**
@@ -2337,6 +2331,21 @@ var RouterABI = [
 ];
 
 // src/router.ts
+var ChainlinkABI = [
+  {
+    type: "function",
+    name: "latestRoundData",
+    inputs: [],
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" }
+    ],
+    stateMutability: "view"
+  }
+];
 var AspanRouterReadClient = class {
   publicClient;
   routerAddress;
@@ -2492,7 +2501,9 @@ var AspanRouterReadClient = class {
         const usdValue = inputAmount * bnbPrice18 / one;
         lstAmount = lstPrice18 === 0n ? 0n : usdValue * one / lstPrice18;
       } else if (inNorm === usdt.toLowerCase() || inNorm === usdc.toLowerCase()) {
-        lstAmount = lstPrice18 === 0n ? 0n : inputAmount * one / lstPrice18;
+        const stablePrice18 = await this.getStablecoinPrice(inputToken);
+        const usdValue = inputAmount * stablePrice18 / one;
+        lstAmount = lstPrice18 === 0n ? 0n : usdValue * one / lstPrice18;
       } else {
         throw new Error("Unsupported input token for SDK preview");
       }
@@ -2538,7 +2549,8 @@ var AspanRouterReadClient = class {
       if (outNorm === zeroAddress.toLowerCase() || outNorm === wbnb.toLowerCase()) {
         outputAmount = bnbPrice18 === 0n ? 0n : usdValue * one / bnbPrice18;
       } else if (outNorm === usdt.toLowerCase() || outNorm === usdc.toLowerCase()) {
-        outputAmount = usdValue;
+        const stablePrice18 = await this.getStablecoinPrice(outputToken);
+        outputAmount = stablePrice18 === 0n ? 0n : usdValue * one / stablePrice18;
       } else {
         throw new Error("Unsupported output token for SDK preview");
       }
@@ -2603,6 +2615,32 @@ var AspanRouterReadClient = class {
       })
     );
   }
+  /**
+   * Get stablecoin price in USD (18 decimals) from Chainlink.
+   * Returns 1e18 if feed unavailable (graceful fallback).
+   */
+  async getStablecoinPrice(token) {
+    const usdt = await this.getUSDT();
+    const usdc = await this.getUSDC();
+    const norm = token.toLowerCase();
+    let feed = null;
+    if (norm === usdt.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDT_USD_FEED;
+    } else if (norm === usdc.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDC_USD_FEED;
+    }
+    if (!feed) return 10n ** 18n;
+    try {
+      const [, answer] = await this.publicClient.readContract({
+        address: feed,
+        abi: ChainlinkABI,
+        functionName: "latestRoundData"
+      });
+      return BigInt(answer) * 10n ** 10n;
+    } catch {
+      return 10n ** 18n;
+    }
+  }
   async getSlisBNB() {
     return this._getCachedAddress(
       "slisBNB",
@@ -2907,17 +2945,20 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3",
+  router: "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB",
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B",
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6",
-  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108",
+  wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07",
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955",
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+  /** Chainlink price feeds (BSC Mainnet) */
+  USDT_USD_FEED: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320",
+  USDC_USD_FEED: "0x51597f405303C4377E36123cBc172b13269EA163",
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
 };
 var PHAROS_ADDRESSES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "description": "TypeScript SDK for Aspan Protocol - LST-backed stablecoin on BNB Chain",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -45,18 +45,18 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "viem": "^2.21.0"
+    "viem": ">=2.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "tsup": "^8.0.1",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0",
-    "eslint": "^8.55.0",
     "@typescript-eslint/eslint-plugin": "^6.13.0",
     "@typescript-eslint/parser": "^6.13.0",
+    "dotenv": "^16.3.1",
+    "eslint": "^8.55.0",
+    "tsup": "^8.0.1",
     "tsx": "^4.7.0",
-    "dotenv": "^16.3.1"
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.1"
   },
   "peerDependencies": {
     "viem": ">=2.0.0"

package/src/__tests__/risk.test.ts

@@ -61,7 +61,7 @@ const BSC_RPC_URL = process.env.BSC_RPC_URL || "https://bsc-dataseed.binance.org
 const ANVIL_DEFAULT_KEY = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
 
 const DIAMOND = "0x6a11B30d3a70727d5477D6d8090e144443fA1c78" as Address;
-const ROUTER = "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3" as Address;
+const ROUTER = "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E" as Address;
 
 const TOKENS = {
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" as Address,
@@ -69,7 +69,7 @@ const TOKENS = {
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d" as Address,
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B" as Address,
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6" as Address,
-  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108" as Address,
+  wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07" as Address,
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as Address,
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as Address,
   sApUSD: "0xE2BE739C4aA4126ee72D612d9548C38B1B0e5A1b" as Address,
@@ -1224,7 +1224,7 @@ describe.skipIf(!IS_FORK && !IS_LIVE)("Risk Control Tests", () => {
 
       await approve(TOKENS.apUSD, DIAMOND, depositedApUSD);
       try {
-        await waitTx(await diamondWrite.deposit({ assets: depositedApUSD, receiver: account.address }));
+        await waitTx(await diamondWrite.deposit({ apUSDAmount: depositedApUSD }));
       } catch (err: any) {
         console.log(`  ⚠️ Deposit failed (AccessControl or not configured): ${err.shortMessage || err.message?.slice(0, 100)}`);
         console.log(`  Skipping remaining FC-02 tests`);
@@ -1351,7 +1351,7 @@ describe.skipIf(!IS_FORK && !IS_LIVE)("Risk Control Tests", () => {
 
       console.log(`  Withdrawing ${formatAmount(currentShares)} shares...`);
       try {
-        await waitTx(await diamondWrite.redeem({ shares: currentShares, receiver: account.address, owner: account.address }));
+        await waitTx(await diamondWrite.withdraw({ shares: currentShares }));
       } catch (err: any) {
         console.log(`  ⚠️ Withdraw failed: ${err.shortMessage || err.message?.slice(0, 100)}`);
         return;

package/src/__tests__/router.test.ts

@@ -43,9 +43,9 @@ const TOKENS = {
 };
 
 // Minimal amounts — just enough to verify path connectivity
-const BNB_AMOUNT = parseEther("0.001");
+const BNB_AMOUNT = parseEther("0.002");
 const USDT_AMOUNT = parseAmount("1");
-const WBNB_AMOUNT = parseEther("0.001");
+const WBNB_AMOUNT = parseEther("0.002");
 const USDC_AMOUNT = parseAmount("1");
 
 const ERC20_ABI = [
@@ -589,17 +589,26 @@ describe("AspanRouter SDK", () => {
       
       const indicesBefore = await readClient.getUserWithdrawalIndices(account.address);
       
-      const unstakeHash = await writeClient.redeemAndRequestUnstake({
-        redeemXBNB: true,
-        amount: freshMinted,
-      });
-      const unstakeReceipt = await publicClient.waitForTransactionReceipt({ hash: unstakeHash });
-      await sleep(2000);
-      expect(unstakeReceipt.status).toBe("success");
-      
-      const indicesAfter = await readClient.getUserWithdrawalIndices(account.address);
-      expect(indicesAfter.length).toBeGreaterThan(indicesBefore.length);
-      console.log(`  Unstake requested ✓ (new indices: ${indicesAfter.length - indicesBefore.length})`);
+      try {
+        const unstakeHash = await writeClient.redeemAndRequestUnstake({
+          redeemXBNB: true,
+          amount: freshMinted,
+        });
+        const unstakeReceipt = await publicClient.waitForTransactionReceipt({ hash: unstakeHash });
+        await sleep(2000);
+        expect(unstakeReceipt.status).toBe("success");
+        
+        const indicesAfter = await readClient.getUserWithdrawalIndices(account.address);
+        expect(indicesAfter.length).toBeGreaterThan(indicesBefore.length);
+        console.log(`  Unstake requested ✓ (new indices: ${indicesAfter.length - indicesBefore.length})`);
+      } catch (err: any) {
+        const msg = err.shortMessage || err.message || "";
+        if (msg.includes("too small")) {
+          console.log(`  ⚠️ Amount too small for Lista unstake (min ~0.001 BNB equivalent), skipped`);
+        } else {
+          throw err;
+        }
+      }
     }, 180000);
 
     // Test 9: stakeAndMint xBNB
@@ -854,7 +863,8 @@ describe("AspanRouter SDK", () => {
         return;
       }
 
-      const unstakeAmount = apUSDBalance > parseAmount("0.5") ? parseAmount("0.5") : apUSDBalance;
+      // Lista requires minimum ~0.001 BNB equivalent; at ~$670/BNB, that's ~$0.67 apUSD min
+      const unstakeAmount = apUSDBalance > parseAmount("1.0") ? parseAmount("1.0") : apUSDBalance;
       console.log(`  Requesting unstake for ${formatAmount(unstakeAmount)} apUSD (of ${formatAmount(apUSDBalance)} total)...`);
       await approve(TOKENS.apUSD, unstakeAmount);
       

package/src/abi/diamond.ts

@@ -243,24 +243,18 @@ export const DiamondABI = [
   {
     type: "function",
     name: "deposit",
-    inputs: [
-      { name: "assets", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" }
-    ],
+    inputs: [{ name: "_amount", type: "uint256", internalType: "uint256" }],
     outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "redeem",
+    name: "withdraw",
     inputs: [
-      { name: "shares", type: "uint256", internalType: "uint256" },
-      { name: "receiver", type: "address", internalType: "address" },
-      { name: "owner", type: "address", internalType: "address" }
+      { name: "_shares", type: "uint256", internalType: "uint256" }
     ],
     outputs: [
-      { name: "apUSDOut", type: "uint256", internalType: "uint256" },
-      { name: "xBNBOut", type: "uint256", internalType: "uint256" }
+      { name: "assets", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "nonpayable"
   },

package/src/client.ts

@@ -74,7 +74,7 @@ import type {
   MintXBNBParams,
   RedeemXBNBParams,
   DepositParams,
-  RedeemParams,
+  WithdrawParams,
 } from "./types";
 
 // ============ Configuration ============
@@ -1190,23 +1190,23 @@ export class AspanClient extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "deposit",
-      args: [params.assets, params.receiver],
+      args: [params.apUSDAmount],
     });
   }
 
   /**
-   * Redeem from stability pool by shares
-   * @param params Redeem parameters
+   * Withdraw from stability pool by shares
+   * @param params Withdraw parameters
    * @returns Transaction hash
    */
-  async redeem(params: RedeemParams): Promise<Hash> {
+  async withdraw(params: WithdrawParams): Promise<Hash> {
     return this.walletClient.writeContract({
       chain: this.chain,
       account: this.walletClient.account!,
       address: this.diamondAddress,
       abi: DiamondABI,
-      functionName: "redeem",
-      args: [params.shares, params.receiver, params.owner],
+      functionName: "withdraw",
+      args: [params.shares],
     });
   }
 

package/src/index.ts

@@ -67,7 +67,7 @@ export type {
   MintXBNBParams,
   RedeemXBNBParams,
   DepositParams,
-  RedeemParams,
+  WithdrawParams,
   // Events
   ApUSDMintedEvent,
   ApUSDRedeemedEvent,
@@ -116,17 +116,20 @@ export const PRICE_PRECISION = 10n ** 8n; // Chainlink price precision
 // ============ Contract Addresses (BSC Mainnet) ============
 export const BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78" as const,
-  router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3" as const,
+  router: "0xb8a90CD2811d6DDbB4B7969d30B036574842cb6E" as const,
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as const,
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as const,
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB" as const,
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B" as const,
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6" as const,
-  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108" as const,
+  wclisBNB: "0xb2A0631bF0aC326fEefc201E7337E13C63Bbed07" as const,
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955" as const,
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d" as const,
+  /** Chainlink price feeds (BSC Mainnet) */
+  USDT_USD_FEED: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320" as const,
+  USDC_USD_FEED: "0x51597f405303C4377E36123cBc172b13269EA163" as const,
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" as const,
 } as const;
 

package/src/router.ts

@@ -19,8 +19,26 @@ import {
 } from "viem";
 import { bsc, bscTestnet } from "viem/chains";
 import { pharosTestnet, CHAIN_IDS, getChainById } from "./client";
+import { BSC_ADDRESSES } from "./index";
 import { RouterABI } from "./abi/router";
 import { DiamondABI } from "./abi/diamond";
+
+/** Chainlink AggregatorV3 — only latestRoundData needed */
+const ChainlinkABI = [
+  {
+    type: "function",
+    name: "latestRoundData",
+    inputs: [],
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" },
+    ],
+    stateMutability: "view",
+  },
+] as const;
 import type {
   SwapAndMintParams,
   StakeAndMintParams,
@@ -233,8 +251,10 @@ export class AspanRouterReadClient {
         const usdValue = (inputAmount * bnbPrice18) / one;
         lstAmount = lstPrice18 === 0n ? 0n : (usdValue * one) / lstPrice18;
       } else if (inNorm === usdt.toLowerCase() || inNorm === usdc.toLowerCase()) {
-        // stablecoin (18-decimal normalized in this SDK path) -> LST
-        lstAmount = lstPrice18 === 0n ? 0n : (inputAmount * one) / lstPrice18;
+        // stablecoin -> USD (via Chainlink) -> LST
+        const stablePrice18 = await this.getStablecoinPrice(inputToken);
+        const usdValue = (inputAmount * stablePrice18) / one;
+        lstAmount = lstPrice18 === 0n ? 0n : (usdValue * one) / lstPrice18;
       } else {
         throw new Error("Unsupported input token for SDK preview");
       }
@@ -292,7 +312,9 @@ export class AspanRouterReadClient {
       if (outNorm === zeroAddress.toLowerCase() || outNorm === wbnb.toLowerCase()) {
         outputAmount = bnbPrice18 === 0n ? 0n : (usdValue * one) / bnbPrice18;
       } else if (outNorm === usdt.toLowerCase() || outNorm === usdc.toLowerCase()) {
-        outputAmount = usdValue;
+        // USD value -> stablecoin amount (via Chainlink price)
+        const stablePrice18 = await this.getStablecoinPrice(outputToken);
+        outputAmount = stablePrice18 === 0n ? 0n : (usdValue * one) / stablePrice18;
       } else {
         throw new Error("Unsupported output token for SDK preview");
       }
@@ -365,6 +387,34 @@ export class AspanRouterReadClient {
     );
   }
 
+  /**
+   * Get stablecoin price in USD (18 decimals) from Chainlink.
+   * Returns 1e18 if feed unavailable (graceful fallback).
+   */
+  async getStablecoinPrice(token: Address): Promise<bigint> {
+    const usdt = await this.getUSDT();
+    const usdc = await this.getUSDC();
+    const norm = token.toLowerCase();
+    let feed: Address | null = null;
+    if (norm === usdt.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDT_USD_FEED as Address;
+    } else if (norm === usdc.toLowerCase()) {
+      feed = BSC_ADDRESSES.USDC_USD_FEED as Address;
+    }
+    if (!feed) return 10n ** 18n; // not a stablecoin, assume 1:1
+    try {
+      const [, answer] = await this.publicClient.readContract({
+        address: feed,
+        abi: ChainlinkABI,
+        functionName: "latestRoundData",
+      });
+      // Chainlink returns 8 decimals, normalize to 18
+      return BigInt(answer) * 10n ** 10n;
+    } catch {
+      return 10n ** 18n; // fallback: 1 USD
+    }
+  }
+
   async getSlisBNB(): Promise<Address> {
     return this._getCachedAddress("slisBNB", async () =>
       this.publicClient.readContract({

package/src/types.ts

@@ -120,15 +120,12 @@ export interface RedeemXBNBParams {
 
 /** Parameters for depositing to stability pool */
 export interface DepositParams {
-  assets: bigint;
-  receiver: Address;
+  apUSDAmount: bigint;
 }
 
-/** Parameters for redeeming from stability pool */
-export interface RedeemParams {
+/** Parameters for withdrawing from stability pool */
+export interface WithdrawParams {
   shares: bigint;
-  receiver: Address;
-  owner: Address;
 }
 
 // ============ Protocol Stats ============
@@ -254,7 +251,7 @@ export interface RouterSwapParams {
   targetLST: Address;
   /** Minimum LST to receive from swap (slippage protection) */
   minLSTOut: bigint;
-  /** PancakeSwap V3 pool fee tier (500, 2500, 10000) */
+  /** PancakeSwap V3 pool fee tier (100, 500, 2500, 10000) */
   poolFee: number;
 }