@aspan/sdk 0.5.0 → 0.5.2

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 */
@@ -461,6 +461,21 @@ declare class AspanReadClient {
         xBNBBalance: bigint;
     }>;
     getUserStabilityPoolPosition(user: Address): Promise<UserStabilityPoolPosition>;
+    /**
+     * Get realtime exchange rate using live xBNB price (not cached xBNBToApUSDRate).
+     * Use this for accurate PnL display — the on-chain exchangeRate() only updates
+     * on deposit/withdraw and doesn't reflect xBNB price changes between operations.
+     *
+     * @returns Exchange rate in 18 decimals (e.g. 1.15e18 means 1 sApUSD = 1.15 apUSD equivalent)
+     */
+    getRealtimeExchangeRate(): Promise<{
+        exchangeRate: bigint;
+        accountedApUSD: bigint;
+        accountedXBNB: bigint;
+        xBNBPriceUSD: bigint;
+        totalValue: bigint;
+        totalSupply: bigint;
+    }>;
     getExchangeRate(): Promise<bigint>;
     getTotalStaked(): Promise<bigint>;
     previewDeposit(assets: bigint): Promise<bigint>;
@@ -770,6 +785,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,25 +2829,28 @@ 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: {
-    readonly diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8";
-    readonly apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4";
-    readonly xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576";
-    readonly sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8";
-    readonly mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18";
-    readonly mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682";
-    readonly mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9";
+    readonly diamond: "0x3d5ceb29BA3b4B837eddCAf53442371828933e5D";
+    readonly apUSD: "0x054f8DB2F700883949d657Da9418c6F6B734BA18";
+    readonly xBNB: "0x1da6F06F7195464732FB9ECa98DE8BC1c520C3a1";
+    readonly sApUSD: "0xf94f0b76942f83Bb4BC010a942c297D18842313b";
+    readonly mockLST: "0xDD890267E72320522E8C61aD357B650ebe4C47c5";
+    readonly mockPriceFeed: "0x4180062949036fCe833027f0ABf7052e7485ddfC";
+    readonly mockExchangeRate: "0xb9aDC2552cF3Fb223236CfEa1c78D277fA8fb8B6";
 };
 /**
  * Format a bigint amount to human-readable string with decimals

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 */
@@ -461,6 +461,21 @@ declare class AspanReadClient {
         xBNBBalance: bigint;
     }>;
     getUserStabilityPoolPosition(user: Address): Promise<UserStabilityPoolPosition>;
+    /**
+     * Get realtime exchange rate using live xBNB price (not cached xBNBToApUSDRate).
+     * Use this for accurate PnL display — the on-chain exchangeRate() only updates
+     * on deposit/withdraw and doesn't reflect xBNB price changes between operations.
+     *
+     * @returns Exchange rate in 18 decimals (e.g. 1.15e18 means 1 sApUSD = 1.15 apUSD equivalent)
+     */
+    getRealtimeExchangeRate(): Promise<{
+        exchangeRate: bigint;
+        accountedApUSD: bigint;
+        accountedXBNB: bigint;
+        xBNBPriceUSD: bigint;
+        totalValue: bigint;
+        totalSupply: bigint;
+    }>;
     getExchangeRate(): Promise<bigint>;
     getTotalStaked(): Promise<bigint>;
     previewDeposit(assets: bigint): Promise<bigint>;
@@ -770,6 +785,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,25 +2829,28 @@ 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: {
-    readonly diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8";
-    readonly apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4";
-    readonly xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576";
-    readonly sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8";
-    readonly mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18";
-    readonly mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682";
-    readonly mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9";
+    readonly diamond: "0x3d5ceb29BA3b4B837eddCAf53442371828933e5D";
+    readonly apUSD: "0x054f8DB2F700883949d657Da9418c6F6B734BA18";
+    readonly xBNB: "0x1da6F06F7195464732FB9ECa98DE8BC1c520C3a1";
+    readonly sApUSD: "0xf94f0b76942f83Bb4BC010a942c297D18842313b";
+    readonly mockLST: "0xDD890267E72320522E8C61aD357B650ebe4C47c5";
+    readonly mockPriceFeed: "0x4180062949036fCe833027f0ABf7052e7485ddfC";
+    readonly mockExchangeRate: "0xb9aDC2552cF3Fb223236CfEa1c78D277fA8fb8B6";
 };
 /**
  * Format a bigint amount to human-readable string with decimals

package/dist/index.js

@@ -773,6 +773,20 @@ var SApUSDABI = [
     ],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "accountedApUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "accountedXBNB",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "xBNBToApUSDRate",
@@ -1269,6 +1283,48 @@ var AspanReadClient = class _AspanReadClient {
     ]);
     return { shares, balance };
   }
+  /**
+   * Get realtime exchange rate using live xBNB price (not cached xBNBToApUSDRate).
+   * Use this for accurate PnL display — the on-chain exchangeRate() only updates
+   * on deposit/withdraw and doesn't reflect xBNB price changes between operations.
+   *
+   * @returns Exchange rate in 18 decimals (e.g. 1.15e18 means 1 sApUSD = 1.15 apUSD equivalent)
+   */
+  async getRealtimeExchangeRate() {
+    const sApUSDAddress = await this.getSApUSD();
+    const PRECISION2 = 10n ** 18n;
+    const VIRTUAL_ASSETS = 10n ** 6n;
+    const VIRTUAL_SHARES = 10n ** 6n;
+    const [accountedApUSD, accountedXBNB, totalSupply, xBNBPriceUSD] = await Promise.all([
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedApUSD"
+      }),
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedXBNB"
+      }),
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "totalSupply"
+      }),
+      this.getXBNBPriceUSD()
+    ]);
+    const totalValue = accountedXBNB === 0n || xBNBPriceUSD === 0n ? accountedApUSD : accountedApUSD + accountedXBNB * xBNBPriceUSD / PRECISION2;
+    const supply = totalSupply + VIRTUAL_SHARES;
+    const exchangeRate = supply === 0n ? PRECISION2 : (totalValue + VIRTUAL_ASSETS) * PRECISION2 / supply;
+    return {
+      exchangeRate,
+      accountedApUSD,
+      accountedXBNB,
+      xBNBPriceUSD,
+      totalValue,
+      totalSupply
+    };
+  }
   async getExchangeRate() {
     try {
       return await this.publicClient.readContract({
@@ -2384,6 +2440,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 +2610,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 +2658,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 +2724,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,27 +3054,30 @@ 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 = {
-  diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8",
-  apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4",
-  xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576",
-  sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8",
-  mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18",
-  mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682",
-  mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9"
+  diamond: "0x3d5ceb29BA3b4B837eddCAf53442371828933e5D",
+  apUSD: "0x054f8DB2F700883949d657Da9418c6F6B734BA18",
+  xBNB: "0x1da6F06F7195464732FB9ECa98DE8BC1c520C3a1",
+  sApUSD: "0xf94f0b76942f83Bb4BC010a942c297D18842313b",
+  mockLST: "0xDD890267E72320522E8C61aD357B650ebe4C47c5",
+  mockPriceFeed: "0x4180062949036fCe833027f0ABf7052e7485ddfC",
+  mockExchangeRate: "0xb9aDC2552cF3Fb223236CfEa1c78D277fA8fb8B6"
 };
 function formatAmount(amount, decimals = 4) {
   const divisor = 10n ** BigInt(18 - decimals);

package/dist/index.mjs

@@ -715,6 +715,20 @@ var SApUSDABI = [
     ],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "accountedApUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "accountedXBNB",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "xBNBToApUSDRate",
@@ -1211,6 +1225,48 @@ var AspanReadClient = class _AspanReadClient {
     ]);
     return { shares, balance };
   }
+  /**
+   * Get realtime exchange rate using live xBNB price (not cached xBNBToApUSDRate).
+   * Use this for accurate PnL display — the on-chain exchangeRate() only updates
+   * on deposit/withdraw and doesn't reflect xBNB price changes between operations.
+   *
+   * @returns Exchange rate in 18 decimals (e.g. 1.15e18 means 1 sApUSD = 1.15 apUSD equivalent)
+   */
+  async getRealtimeExchangeRate() {
+    const sApUSDAddress = await this.getSApUSD();
+    const PRECISION2 = 10n ** 18n;
+    const VIRTUAL_ASSETS = 10n ** 6n;
+    const VIRTUAL_SHARES = 10n ** 6n;
+    const [accountedApUSD, accountedXBNB, totalSupply, xBNBPriceUSD] = await Promise.all([
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedApUSD"
+      }),
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedXBNB"
+      }),
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "totalSupply"
+      }),
+      this.getXBNBPriceUSD()
+    ]);
+    const totalValue = accountedXBNB === 0n || xBNBPriceUSD === 0n ? accountedApUSD : accountedApUSD + accountedXBNB * xBNBPriceUSD / PRECISION2;
+    const supply = totalSupply + VIRTUAL_SHARES;
+    const exchangeRate = supply === 0n ? PRECISION2 : (totalValue + VIRTUAL_ASSETS) * PRECISION2 / supply;
+    return {
+      exchangeRate,
+      accountedApUSD,
+      accountedXBNB,
+      xBNBPriceUSD,
+      totalValue,
+      totalSupply
+    };
+  }
   async getExchangeRate() {
     try {
       return await this.publicClient.readContract({
@@ -2331,6 +2387,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 +2557,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 +2605,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 +2671,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,27 +3001,30 @@ 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 = {
-  diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8",
-  apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4",
-  xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576",
-  sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8",
-  mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18",
-  mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682",
-  mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9"
+  diamond: "0x3d5ceb29BA3b4B837eddCAf53442371828933e5D",
+  apUSD: "0x054f8DB2F700883949d657Da9418c6F6B734BA18",
+  xBNB: "0x1da6F06F7195464732FB9ECa98DE8BC1c520C3a1",
+  sApUSD: "0xf94f0b76942f83Bb4BC010a942c297D18842313b",
+  mockLST: "0xDD890267E72320522E8C61aD357B650ebe4C47c5",
+  mockPriceFeed: "0x4180062949036fCe833027f0ABf7052e7485ddfC",
+  mockExchangeRate: "0xb9aDC2552cF3Fb223236CfEa1c78D277fA8fb8B6"
 };
 function formatAmount(amount, decimals = 4) {
   const divisor = 10n ** BigInt(18 - decimals);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "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/abi/sApUSD.ts

@@ -64,6 +64,20 @@ export const SApUSDABI = [
     ],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "accountedApUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "accountedXBNB",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "xBNBToApUSDRate",

package/src/bot/services/risk-keeper.ts

@@ -318,11 +318,25 @@ export class RiskKeeperService {
 
       this.state.isProcessing = true;
 
-      // Calculate amount to clean (X% of total)
-      const cleanAmount = (vaultState.xBNBAmount * BigInt(this.TWAP_PERCENTAGE)) / 100n;
+      // Contract allows full clean when vault xBNB <= 10 xBNB (dust exemption)
+      // Otherwise capped at 10% per call (MAX_CLEAN_PERCENT_BPS = 1000)
+      const DUST_THRESHOLD = 10n * 10n ** 18n; // 10 xBNB — must match contract DUST_CLEAN_THRESHOLD
+      const FULL_CLEAN_THRESHOLD = 1n * 10n ** 18n; // 1 xBNB — below this, clean everything
+      let cleanAmount: bigint;
+
+      if (vaultState.xBNBAmount <= FULL_CLEAN_THRESHOLD) {
+        // Less than 1 xBNB remaining — clean all to avoid infinite tiny trades
+        cleanAmount = vaultState.xBNBAmount;
+        console.log(`[RiskKeeper] Below 1 xBNB (${Number(vaultState.xBNBAmount) / 1e18}), cleaning all in one shot`);
+      } else if (vaultState.xBNBAmount <= DUST_THRESHOLD) {
+        cleanAmount = vaultState.xBNBAmount;
+        console.log(`[RiskKeeper] Dust amount (${Number(vaultState.xBNBAmount) / 1e18} xBNB <= 10), cleaning all in one shot`);
+      } else {
+        cleanAmount = (vaultState.xBNBAmount * BigInt(this.TWAP_PERCENTAGE)) / 100n;
+      }
 
       if (cleanAmount === 0n) {
-        console.log("[RiskKeeper] Clean amount too small, skipping");
+        console.log("[RiskKeeper] Clean amount rounds to 0, skipping");
         return;
       }
 

package/src/client.ts

@@ -551,6 +551,66 @@ export class AspanReadClient {
     return { shares, balance };
   }
 
+  /**
+   * Get realtime exchange rate using live xBNB price (not cached xBNBToApUSDRate).
+   * Use this for accurate PnL display — the on-chain exchangeRate() only updates
+   * on deposit/withdraw and doesn't reflect xBNB price changes between operations.
+   *
+   * @returns Exchange rate in 18 decimals (e.g. 1.15e18 means 1 sApUSD = 1.15 apUSD equivalent)
+   */
+  async getRealtimeExchangeRate(): Promise<{
+    exchangeRate: bigint;
+    accountedApUSD: bigint;
+    accountedXBNB: bigint;
+    xBNBPriceUSD: bigint;
+    totalValue: bigint;
+    totalSupply: bigint;
+  }> {
+    const sApUSDAddress = await this.getSApUSD();
+    const PRECISION = 10n ** 18n;
+    const VIRTUAL_ASSETS = 10n ** 6n;
+    const VIRTUAL_SHARES = 10n ** 6n;
+
+    const [accountedApUSD, accountedXBNB, totalSupply, xBNBPriceUSD] = await Promise.all([
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedApUSD",
+      }) as Promise<bigint>,
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "accountedXBNB",
+      }) as Promise<bigint>,
+      this.publicClient.readContract({
+        address: sApUSDAddress,
+        abi: SApUSDABI,
+        functionName: "totalSupply",
+      }) as Promise<bigint>,
+      this.getXBNBPriceUSD(),
+    ]);
+
+    // _totalValue = accountedApUSD + (accountedXBNB * xBNBPrice) / 1e18
+    const totalValue = accountedXBNB === 0n || xBNBPriceUSD === 0n
+      ? accountedApUSD
+      : accountedApUSD + (accountedXBNB * xBNBPriceUSD) / PRECISION;
+
+    // exchangeRate = (totalValue + VIRTUAL_ASSETS) * 1e18 / (totalSupply + VIRTUAL_SHARES)
+    const supply = totalSupply + VIRTUAL_SHARES;
+    const exchangeRate = supply === 0n
+      ? PRECISION
+      : ((totalValue + VIRTUAL_ASSETS) * PRECISION) / supply;
+
+    return {
+      exchangeRate,
+      accountedApUSD,
+      accountedXBNB,
+      xBNBPriceUSD,
+      totalValue,
+      totalSupply,
+    };
+  }
+
   async getExchangeRate(): Promise<bigint> {
     try {
       return await this.publicClient.readContract({

package/src/index.ts

@@ -116,28 +116,31 @@ 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;
 
 export const PHAROS_ADDRESSES = {
-  diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8" as const,
-  apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4" as const,
-  xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576" as const,
-  sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8" as const,
-  mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18" as const,
-  mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682" as const,
-  mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9" as const,
+  diamond: "0x3d5ceb29BA3b4B837eddCAf53442371828933e5D" as const,
+  apUSD: "0x054f8DB2F700883949d657Da9418c6F6B734BA18" as const,
+  xBNB: "0x1da6F06F7195464732FB9ECa98DE8BC1c520C3a1" as const,
+  sApUSD: "0xf94f0b76942f83Bb4BC010a942c297D18842313b" as const,
+  mockLST: "0xDD890267E72320522E8C61aD357B650ebe4C47c5" as const,
+  mockPriceFeed: "0x4180062949036fCe833027f0ABf7052e7485ddfC" as const,
+  mockExchangeRate: "0xb9aDC2552cF3Fb223236CfEa1c78D277fA8fb8B6" as const,
 } as const;
 
 // ============ Utility Functions ============

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;
 }