@aspan/sdk 0.4.5 → 0.4.7

package/dist/index.mjs

@@ -256,13 +256,6 @@ var DiamondABI = [
     outputs: [{ name: "assets", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
-  {
-    type: "function",
-    name: "withdrawAssets",
-    inputs: [{ name: "_assets", type: "uint256", internalType: "uint256" }],
-    outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
-    stateMutability: "nonpayable"
-  },
   {
     type: "function",
     name: "getShares",
@@ -305,6 +298,16 @@ var DiamondABI = [
     outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "previewRedeemMulti",
+    inputs: [{ name: "_shares", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      { name: "assets", type: "address[]", internalType: "address[]" },
+      { name: "amounts", type: "uint256[]", internalType: "uint256[]" }
+    ],
+    stateMutability: "view"
+  },
   {
     type: "function",
     name: "getPendingYield",
@@ -671,13 +674,13 @@ var SApUSDABI = [
   },
   {
     type: "function",
-    name: "previewRedeemMulti",
+    name: "previewRedeem",
     inputs: [
       { name: "shares", type: "uint256", internalType: "uint256" }
     ],
     outputs: [
-      { name: "assets", type: "address[]", internalType: "address[]" },
-      { name: "amounts", type: "uint256[]", internalType: "uint256[]" }
+      { name: "apUSDOut", type: "uint256", internalType: "uint256" },
+      { name: "xBNBOut", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "view"
   },
@@ -724,56 +727,69 @@ var SApUSDABI = [
   },
   {
     type: "function",
-    name: "previewCleanXBNB",
+    name: "hasRole",
     inputs: [
-      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
-      { name: "_router", type: "address", internalType: "address" },
-      { name: "_path", type: "address[]", internalType: "address[]" }
+      { name: "role", type: "bytes32", internalType: "bytes32" },
+      { name: "account", type: "address", internalType: "address" }
     ],
-    outputs: [{ name: "expectedApUSD", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
     stateMutability: "view"
   },
+  // ============ Write Functions ============
   {
     type: "function",
-    name: "KEEPER_ROLE",
-    inputs: [],
-    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
-    stateMutability: "view"
+    name: "redeem",
+    inputs: [
+      { name: "shares", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" },
+      { name: "owner", type: "address", internalType: "address" }
+    ],
+    outputs: [
+      { name: "apUSDOut", type: "uint256", internalType: "uint256" },
+      { name: "xBNBOut", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "hasRole",
+    name: "deposit",
     inputs: [
-      { name: "role", type: "bytes32", internalType: "bytes32" },
-      { name: "account", type: "address", internalType: "address" }
+      { name: "assets", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" }
     ],
-    outputs: [{ name: "", type: "bool", internalType: "bool" }],
-    stateMutability: "view"
+    outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
   },
-  // ============ Keeper Functions ============
+  // ============ Accounting Functions ============
   {
     type: "function",
-    name: "cleanXBNB",
+    name: "addAccounting",
     inputs: [
-      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
-      { name: "_minApUSDOut", type: "uint256", internalType: "uint256" },
-      { name: "_router", type: "address", internalType: "address" },
-      { name: "_path", type: "address[]", internalType: "address[]" },
-      { name: "_deadline", type: "uint256", internalType: "uint256" }
+      { name: "apUSD", type: "uint256", internalType: "uint256" },
+      { name: "xBNB", type: "uint256", internalType: "uint256" }
     ],
-    outputs: [{ name: "apUSDReceived", type: "uint256", internalType: "uint256" }],
+    outputs: [],
     stateMutability: "nonpayable"
   },
-  // ============ Events ============
   {
-    type: "event",
-    name: "VaultCleaned",
+    type: "function",
+    name: "subAccounting",
     inputs: [
-      { name: "xBNBSold", type: "uint256", indexed: false, internalType: "uint256" },
-      { name: "apUSDReceived", type: "uint256", indexed: false, internalType: "uint256" },
-      { name: "keeper", type: "address", indexed: true, internalType: "address" }
+      { name: "apUSD", type: "uint256", internalType: "uint256" },
+      { name: "xBNB", type: "uint256", internalType: "uint256" }
     ],
-    anonymous: false
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  // ============ Admin Functions ============
+  {
+    type: "function",
+    name: "sweepExcess",
+    inputs: [
+      { name: "recipient", type: "address", internalType: "address" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
   }
 ];
 
@@ -1233,45 +1249,26 @@ var AspanReadClient = class _AspanReadClient {
       throw error;
     }
   }
-  async previewRedeem(shares) {
-    try {
-      return await this.publicClient.readContract({
-        address: this.diamondAddress,
-        abi: DiamondABI,
-        functionName: "previewRedeem",
-        args: [shares]
-      });
-    } catch (error) {
-      if (this.isZeroSupplyError(error)) {
-        return shares;
-      }
-      throw error;
-    }
-  }
   /**
    * Preview withdraw with multi-asset support (apUSD + xBNB)
+   * Replaces previewRedeem — works for both clean and dirty pools.
    * @param shares Amount of sApUSD shares to redeem
    * @returns Object with apUSD and xBNB amounts, plus whether vault has xBNB
    */
   async previewRedeemMulti(shares) {
-    const sApUSDAddress = await this.getSApUSD();
-    const [result, conversion] = await Promise.all([
-      this.publicClient.readContract({
-        address: sApUSDAddress,
-        abi: SApUSDABI,
-        functionName: "previewRedeemMulti",
-        args: [shares]
-      }),
-      this.publicClient.readContract({
-        address: sApUSDAddress,
-        abi: SApUSDABI,
-        functionName: "hasStabilityConversion"
-      })
-    ]);
+    const [assets, amounts] = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "previewRedeemMulti",
+      args: [shares]
+    });
+    const hasXBNB = amounts.length > 1 && amounts[1] > 0n;
     return {
-      apUSD: result[1][0],
-      xBNB: result[1][1],
-      hasXBNB: conversion[0]
+      apUSD: amounts[0] ?? 0n,
+      xBNB: amounts[1] ?? 0n,
+      hasXBNB,
+      assets,
+      amounts
     };
   }
   async getPendingYield() {
@@ -1764,21 +1761,6 @@ var AspanClient = class extends AspanReadClient {
       args: [params.shares]
     });
   }
-  /**
-   * Withdraw from stability pool by asset amount
-   * @param params Withdraw parameters
-   * @returns Transaction hash
-   */
-  async withdrawAssets(params) {
-    return this.walletClient.writeContract({
-      chain: this.chain,
-      account: this.walletClient.account,
-      address: this.diamondAddress,
-      abi: DiamondABI,
-      functionName: "withdrawAssets",
-      args: [params.assets]
-    });
-  }
   /**
    * Harvest yield from LSTs
    * @returns Transaction hash
@@ -2113,6 +2095,20 @@ var RouterABI = [
     outputs: [{ type: "bool" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "lstModes",
+    inputs: [{ name: "lst", type: "address" }],
+    outputs: [{ type: "uint8" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isLSTRoutable",
+    inputs: [{ name: "lst", type: "address" }],
+    outputs: [{ type: "bool" }],
+    stateMutability: "view"
+  },
   // Preview functions - unified
   {
     type: "function",
@@ -2375,6 +2371,29 @@ var AspanRouterReadClient = class {
       args: [lst]
     });
   }
+  /**
+   * Get LST mode (0 = SYNC, 1 = ASYNC_DIRECT_ONLY)
+   */
+  async getLSTMode(lst) {
+    const mode = await this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "lstModes",
+      args: [lst]
+    });
+    return Number(mode);
+  }
+  /**
+   * Check whether an LST supports routed flows (swap/stake/redeemAndSwap)
+   */
+  async isLSTRoutable(lst) {
+    return this.publicClient.readContract({
+      address: this.routerAddress,
+      abi: RouterABI,
+      functionName: "isLSTRoutable",
+      args: [lst]
+    });
+  }
   /**
    * Get the Diamond contract address
    */
@@ -2413,6 +2432,92 @@ var AspanRouterReadClient = class {
       args: [lst, redeemXBNB, amount]
     });
   }
+  /**
+   * SDK-only preview: input token -> estimated LST -> previewMint
+   * Note: oracle-based estimation (does not include live DEX slippage/price impact)
+   */
+  async previewMintByInput(inputToken, inputAmount, targetLST, mintXBNB) {
+    if (inputAmount === 0n) return { lstAmount: 0n, mintedAmount: 0n };
+    const [diamond, wbnb, usdt, usdc] = await Promise.all([
+      this.getDiamond(),
+      this.getWBNB(),
+      this.getUSDT(),
+      this.getUSDC()
+    ]);
+    const [bnbPrice8, lstPrice] = await Promise.all([
+      this.publicClient.readContract({
+        address: diamond,
+        abi: DiamondABI,
+        functionName: "getBNBPriceUSD"
+      }),
+      this.publicClient.readContract({
+        address: diamond,
+        abi: DiamondABI,
+        functionName: "getLSTPriceUSD",
+        args: [targetLST]
+      })
+    ]);
+    const bnbPrice18 = BigInt(bnbPrice8) * 10n ** 10n;
+    const lstPrice18 = BigInt(lstPrice);
+    const one = 10n ** 18n;
+    let lstAmount = 0n;
+    const inNorm = inputToken.toLowerCase();
+    if (inNorm === targetLST.toLowerCase()) {
+      lstAmount = inputAmount;
+    } else if (inNorm === zeroAddress.toLowerCase() || inNorm === wbnb.toLowerCase()) {
+      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;
+    } else {
+      throw new Error("Unsupported input token for SDK preview");
+    }
+    const mintedAmount = await this.previewMint(targetLST, lstAmount, mintXBNB);
+    return { lstAmount, mintedAmount };
+  }
+  /**
+   * SDK-only preview: previewRedeem -> estimated output token
+   * Note: oracle-based estimation (does not include live DEX slippage/price impact)
+   */
+  async previewRedeemToOutput(lst, redeemXBNB, amount, outputToken) {
+    const lstAmount = await this.previewRedeem(lst, redeemXBNB, amount);
+    if (lstAmount === 0n) return { lstAmount: 0n, outputAmount: 0n };
+    const [diamond, wbnb, usdt, usdc] = await Promise.all([
+      this.getDiamond(),
+      this.getWBNB(),
+      this.getUSDT(),
+      this.getUSDC()
+    ]);
+    const [bnbPrice8, lstPrice] = await Promise.all([
+      this.publicClient.readContract({
+        address: diamond,
+        abi: DiamondABI,
+        functionName: "getBNBPriceUSD"
+      }),
+      this.publicClient.readContract({
+        address: diamond,
+        abi: DiamondABI,
+        functionName: "getLSTPriceUSD",
+        args: [lst]
+      })
+    ]);
+    const bnbPrice18 = BigInt(bnbPrice8) * 10n ** 10n;
+    const lstPrice18 = BigInt(lstPrice);
+    const one = 10n ** 18n;
+    const usdValue = lstAmount * lstPrice18 / one;
+    let outputAmount = 0n;
+    const outNorm = outputToken.toLowerCase();
+    if (outNorm === lst.toLowerCase()) {
+      outputAmount = lstAmount;
+    } else if (outNorm === zeroAddress.toLowerCase() || outNorm === wbnb.toLowerCase()) {
+      outputAmount = bnbPrice18 === 0n ? 0n : usdValue * one / bnbPrice18;
+    } else if (outNorm === usdt.toLowerCase() || outNorm === usdc.toLowerCase()) {
+      outputAmount = usdValue;
+    } else {
+      throw new Error("Unsupported output token for SDK preview");
+    }
+    return { lstAmount, outputAmount };
+  }
   /**
    * Get user's withdrawal request indices
    */
@@ -2751,7 +2856,7 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6",
+  router: "0x34a64c4EbDe830773083BA8c9469456616F6723b",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "TypeScript SDK for Aspan Protocol - LST-backed stablecoin on BNB Chain",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -23,6 +23,8 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:fork": "ANVIL_RPC=http://127.0.0.1:8545 vitest run fork.test.ts",
+    "test:risk": "ANVIL_RPC=http://127.0.0.1:8545 vitest run risk.test.ts",
+    "test:risk:live": "vitest run risk.test.ts",
     "test:e2e": "vitest run router.test.ts",
     "test:watch": "vitest",
     "clean": "rm -rf dist",

package/src/__tests__/fork.test.ts

@@ -26,6 +26,7 @@ const ANVIL_RPC = process.env.ANVIL_RPC || "http://127.0.0.1:8545";
 const TOKENS = {
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" as Address,
   USDT: "0x55d398326f99059fF775485246999027B3197955" as Address,
+  USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d" as Address,
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B" as Address,
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as Address,
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as Address,