@aspan/sdk 0.5.0 → 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

@@ -203,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 */
@@ -770,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>;
@@ -2809,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: {

package/dist/index.d.ts

@@ -203,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 */
@@ -770,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>;
@@ -2809,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: {

package/dist/index.js

@@ -2384,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;
@@ -2539,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");
       }
@@ -2585,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");
       }
@@ -2650,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",
@@ -2954,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

@@ -2331,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;
@@ -2486,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");
       }
@@ -2532,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");
       }
@@ -2597,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",
@@ -2901,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.5.0",
+  "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,

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/index.ts

@@ -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

@@ -251,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;
 }