@aspan/sdk 0.4.7 → 0.4.9

package/dist/index.mjs

@@ -245,15 +245,25 @@ var DiamondABI = [
   {
     type: "function",
     name: "deposit",
-    inputs: [{ name: "_apUSDAmount", type: "uint256", internalType: "uint256" }],
+    inputs: [
+      { name: "assets", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" }
+    ],
     outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "withdraw",
-    inputs: [{ name: "_shares", type: "uint256", internalType: "uint256" }],
-    outputs: [{ name: "assets", type: "uint256", internalType: "uint256" }],
+    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"
   },
   {
@@ -834,7 +844,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 }
     });
   }
   /**
@@ -1743,22 +1754,22 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "deposit",
-      args: [params.apUSDAmount]
+      args: [params.assets, params.receiver]
     });
   }
   /**
-   * Withdraw from stability pool by shares
-   * @param params Withdraw parameters
+   * Redeem from stability pool by shares
+   * @param params Redeem parameters
    * @returns Transaction hash
    */
-  async withdraw(params) {
+  async redeem(params) {
     return this.walletClient.writeContract({
       chain: this.chain,
       account: this.walletClient.account,
       address: this.diamondAddress,
       abi: DiamondABI,
-      functionName: "withdraw",
-      args: [params.shares]
+      functionName: "redeem",
+      args: [params.shares, params.receiver, params.owner]
     });
   }
   /**
@@ -2330,14 +2341,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
@@ -2398,11 +2418,14 @@ var AspanRouterReadClient = class {
    * Get the Diamond contract address
    */
   async getDiamond() {
-    return this.publicClient.readContract({
-      address: this.routerAddress,
-      abi: RouterABI,
-      functionName: "diamond"
-    });
+    return this._getCachedAddress(
+      "diamond",
+      async () => this.publicClient.readContract({
+        address: this.routerAddress,
+        abi: RouterABI,
+        functionName: "diamond"
+      })
+    );
   }
   /**
    * Preview mint output for a given LST amount
@@ -2438,39 +2461,41 @@ var AspanRouterReadClient = class {
    */
   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 [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 };
@@ -2482,39 +2507,41 @@ var AspanRouterReadClient = class {
   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");
+      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 };
   }
@@ -2547,60 +2574,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 {
@@ -2856,7 +2907,7 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x34a64c4EbDe830773083BA8c9469456616F6723b",
+  router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "TypeScript SDK for Aspan Protocol - LST-backed stablecoin on BNB Chain",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

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 = "0x34a64c4EbDe830773083BA8c9469456616F6723b" as Address;
+const ROUTER = "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3" as Address;
 
 const TOKENS = {
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" 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({ apUSDAmount: depositedApUSD }));
+        await waitTx(await diamondWrite.deposit({ assets: depositedApUSD, receiver: account.address }));
       } 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.withdraw({ shares: currentShares }));
+        await waitTx(await diamondWrite.redeem({ shares: currentShares, receiver: account.address, owner: account.address }));
       } catch (err: any) {
         console.log(`  ⚠️ Withdraw failed: ${err.shortMessage || err.message?.slice(0, 100)}`);
         return;

package/src/abi/diamond.ts

@@ -243,15 +243,25 @@ export const DiamondABI = [
   {
     type: "function",
     name: "deposit",
-    inputs: [{ name: "_apUSDAmount", type: "uint256", internalType: "uint256" }],
+    inputs: [
+      { name: "assets", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" }
+    ],
     outputs: [{ name: "shares", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
-    name: "withdraw",
-    inputs: [{ name: "_shares", type: "uint256", internalType: "uint256" }],
-    outputs: [{ name: "assets", type: "uint256", internalType: "uint256" }],
+    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"
   },
   {

package/src/client.ts

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

package/src/index.ts

@@ -67,7 +67,7 @@ export type {
   MintXBNBParams,
   RedeemXBNBParams,
   DepositParams,
-  WithdrawParams,
+  RedeemParams,
   // Events
   ApUSDMintedEvent,
   ApUSDRedeemedEvent,
@@ -116,7 +116,7 @@ export const PRICE_PRECISION = 10n ** 8n; // Chainlink price precision
 // ============ Contract Addresses (BSC Mainnet) ============
 export const BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78" as const,
-  router: "0x34a64c4EbDe830773083BA8c9469456616F6723b" as const,
+  router: "0x1Ca976d2043dfb785c7F3A17535B3A38c50113f3" as const,
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as const,
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as const,
   sApUSD: "0x896770Dba7c0481539E25aaB56bE285ECF6D65eB" as const,