@aspan/sdk 0.4.6 → 0.4.8

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",
@@ -681,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"
   },
@@ -734,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"
   }
 ];
 
@@ -828,7 +834,8 @@ var AspanReadClient = class _AspanReadClient {
     this.chain = config.chain ?? bsc;
     this.publicClient = createPublicClient({
       chain: this.chain,
-      transport: http(config.rpcUrl)
+      transport: http(config.rpcUrl),
+      batch: { multicall: true }
     });
   }
   /**
@@ -1755,21 +1762,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
@@ -2104,6 +2096,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",
@@ -2325,14 +2331,23 @@ var AspanRouterReadClient = class {
   publicClient;
   routerAddress;
   chain;
+  _addressCache = /* @__PURE__ */ new Map();
   constructor(config) {
     this.routerAddress = config.routerAddress;
     this.chain = config.chain ?? bsc2;
     this.publicClient = createPublicClient2({
       chain: this.chain,
-      transport: http2(config.rpcUrl)
+      transport: http2(config.rpcUrl),
+      batch: { multicall: true }
     });
   }
+  async _getCachedAddress(key, fetcher) {
+    const cached = this._addressCache.get(key);
+    if (cached) return cached;
+    const addr = await fetcher();
+    this._addressCache.set(key, addr);
+    return addr;
+  }
   // ============ View Functions ============
   /**
    * Get the default LST address
@@ -2367,15 +2382,41 @@ var AspanRouterReadClient = class {
     });
   }
   /**
-   * Get the Diamond contract address
+   * Get LST mode (0 = SYNC, 1 = ASYNC_DIRECT_ONLY)
    */
-  async getDiamond() {
+  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: "diamond"
+      functionName: "isLSTRoutable",
+      args: [lst]
     });
   }
+  /**
+   * Get the Diamond contract address
+   */
+  async getDiamond() {
+    return this._getCachedAddress(
+      "diamond",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "diamond"
+      })
+    );
+  }
   /**
    * Preview mint output for a given LST amount
    * @param lst LST token address
@@ -2404,6 +2445,96 @@ 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 };
+    let lstAmount = 0n;
+    const inNorm = inputToken.toLowerCase();
+    if (inNorm === targetLST.toLowerCase()) {
+      lstAmount = inputAmount;
+    } else {
+      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;
+      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 };
+    let outputAmount = 0n;
+    const outNorm = outputToken.toLowerCase();
+    if (outNorm === lst.toLowerCase()) {
+      outputAmount = lstAmount;
+    } else {
+      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;
+      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
    */
@@ -2433,60 +2564,84 @@ var AspanRouterReadClient = class {
   }
   // ============ Token Address Getters ============
   async getWBNB() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "wbnb"
-    });
+    return this._getCachedAddress(
+      "wbnb",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "wbnb"
+      })
+    );
   }
   async getUSDT() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "usdt"
-    });
+    return this._getCachedAddress(
+      "usdt",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "usdt"
+      })
+    );
   }
   async getUSDC() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "usdc"
-    });
+    return this._getCachedAddress(
+      "usdc",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "usdc"
+      })
+    );
   }
   async getSlisBNB() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "slisBNB"
-    });
+    return this._getCachedAddress(
+      "slisBNB",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "slisBNB"
+      })
+    );
   }
   async getAsBNB() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "asBNB"
-    });
+    return this._getCachedAddress(
+      "asBNB",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "asBNB"
+      })
+    );
   }
   async getWclisBNB() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "wclisBNB"
-    });
+    return this._getCachedAddress(
+      "wclisBNB",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "wclisBNB"
+      })
+    );
   }
   async getApUSD() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "apUSD"
-    });
+    return this._getCachedAddress(
+      "apUSD",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "apUSD"
+      })
+    );
   }
   async getXBNB() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "xBNB"
-    });
+    return this._getCachedAddress(
+      "xBNB",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "xBNB"
+      })
+    );
   }
 };
 var AspanRouterClient = class extends AspanRouterReadClient {
@@ -2742,7 +2897,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.6",
+  "version": "0.4.8",
   "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,