@aspan/sdk 0.4.7 → 0.4.9

package/src/router.ts

@@ -59,6 +59,7 @@ export class AspanRouterReadClient {
   protected readonly publicClient: PublicClient;
   protected readonly routerAddress: Address;
   protected readonly chain: Chain;
+  private readonly _addressCache = new Map<string, Address>();
 
   constructor(config: AspanRouterClientConfig) {
     this.routerAddress = config.routerAddress;
@@ -67,9 +68,18 @@ export class AspanRouterReadClient {
     this.publicClient = createPublicClient({
       chain: this.chain,
       transport: http(config.rpcUrl),
+      batch: { multicall: true },
     });
   }
 
+  protected async _getCachedAddress(key: string, fetcher: () => Promise<Address>): Promise<Address> {
+    const cached = this._addressCache.get(key);
+    if (cached) return cached;
+    const addr = await fetcher();
+    this._addressCache.set(key, addr);
+    return addr;
+  }
+
   // ============ View Functions ============
 
   /**
@@ -136,11 +146,13 @@ export class AspanRouterReadClient {
    * Get the Diamond contract address
    */
   async getDiamond(): Promise<Address> {
-    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",
+      })
+    );
   }
 
   /**
@@ -185,44 +197,47 @@ export class AspanRouterReadClient {
   ): Promise<{ lstAmount: bigint; mintedAmount: bigint }> {
     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()) {
-      // BNB/WBNB -> USD -> LST
-      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;
     } 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()) {
+        // BNB/WBNB -> USD -> LST
+        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;
+      } else {
+        throw new Error("Unsupported input token for SDK preview");
+      }
     }
 
     const mintedAmount = await this.previewMint(targetLST, lstAmount, mintXBNB);
@@ -242,42 +257,45 @@ export class AspanRouterReadClient {
     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 };
@@ -318,67 +336,83 @@ export class AspanRouterReadClient {
   // ============ Token Address Getters ============
 
   async getWBNB(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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(): Promise<Address> {
-    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",
+      })
+    );
   }
 }
 

package/src/types.ts

@@ -120,12 +120,15 @@ export interface RedeemXBNBParams {
 
 /** Parameters for depositing to stability pool */
 export interface DepositParams {
-  apUSDAmount: bigint;
+  assets: bigint;
+  receiver: Address;
 }
 
-/** Parameters for withdrawing from stability pool */
-export interface WithdrawParams {
+/** Parameters for redeeming from stability pool */
+export interface RedeemParams {
   shares: bigint;
+  receiver: Address;
+  owner: Address;
 }
 
 // ============ Protocol Stats ============