@aspan/sdk 0.1.7 → 0.2.0

package/src/client.ts

@@ -102,25 +102,28 @@ export class AspanReadClient {
    * Get comprehensive protocol statistics
    */
   async getProtocolStats(): Promise<ProtocolStats> {
-    const [
-      tvlInBNB,
-      tvlInUSD,
-      collateralRatio,
-      apUSDSupply,
-      xBNBSupply,
-      xBNBPriceBNB,
-      xBNBPriceUSD,
-      effectiveLeverage,
-    ] = await Promise.all([
-      this.getTVLInBNB(),
-      this.getTVLInUSD(),
-      this.getCollateralRatio(),
-      this.getApUSDSupply(),
-      this.getXBNBSupply(),
-      this.getXBNBPriceBNB(),
-      this.getXBNBPriceUSD(),
-      this.getEffectiveLeverage(),
-    ]);
+    // First get supplies to determine if xBNB exists
+    const [tvlInBNB, tvlInUSD, collateralRatio, apUSDSupply, xBNBSupply] =
+      await Promise.all([
+        this.getTVLInBNB(),
+        this.getTVLInUSD(),
+        this.getCollateralRatio(),
+        this.getApUSDSupply(),
+        this.getXBNBSupply(),
+      ]);
+
+    // Only fetch xBNB price and leverage if xBNB supply exists
+    let xBNBPriceBNB = 0n;
+    let xBNBPriceUSD = 0n;
+    let effectiveLeverage = 0n;
+
+    if (xBNBSupply > 0n) {
+      [xBNBPriceBNB, xBNBPriceUSD, effectiveLeverage] = await Promise.all([
+        this.getXBNBPriceBNB(),
+        this.getXBNBPriceUSD(),
+        this.getEffectiveLeverage(),
+      ]);
+    }
 
     return {
       tvlInBNB,
@@ -218,8 +221,8 @@ export class AspanReadClient {
         functionName: "getCollateralRatio",
       });
       // Contract returns max uint256 when supply is zero (infinite CR)
-      // Treat anything above 1000000% (10000 * 1e18) as zero/undefined
-      if (cr > 10000n * 10n ** 18n) {
+      // CR is in BPS format (10000 = 100%), anything above 100000000 BPS is invalid
+      if (cr > 100000000n) {
         return 0n;
       }
       return cr;
@@ -234,11 +237,17 @@ export class AspanReadClient {
 
   async getXBNBPriceBNB(): Promise<bigint> {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceBNB",
       });
+      // Contract returns extreme values when xBNB supply is zero
+      // Normal xBNB price should be < 1000 BNB (1000 * 1e18)
+      if (price > 1000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       // Price undefined when no xBNB exists
       if (this.isZeroSupplyError(error)) {
@@ -250,11 +259,17 @@ export class AspanReadClient {
 
   async getXBNBPriceUSD(): Promise<bigint> {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceUSD",
       });
+      // Contract returns extreme values when xBNB supply is zero
+      // xBNBPriceUSD is in 18 decimals, normal price should be < $1,000,000 (1e6 * 1e18)
+      if (price > 1000000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       // Price undefined when no xBNB exists
       if (this.isZeroSupplyError(error)) {
@@ -266,11 +281,17 @@ export class AspanReadClient {
 
   async getEffectiveLeverage(): Promise<bigint> {
     try {
-      return await this.publicClient.readContract({
+      const leverage = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getEffectiveLeverage",
       });
+      // Contract returns extreme values when xBNB supply is zero
+      // Normal leverage should be < 100x (100 * 1e18)
+      if (leverage > 100n * 10n ** 18n) {
+        return 0n;
+      }
+      return leverage;
     } catch (error) {
       // Leverage undefined when no xBNB exists
       if (this.isZeroSupplyError(error)) {
@@ -336,8 +357,15 @@ export class AspanReadClient {
         functionName: "getCurrentFees",
       });
 
+      let currentCR = result[0];
+      // Contract returns max uint256 when supply is zero (infinite CR)
+      // CR is in BPS format (10000 = 100%)
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
+
       return {
-        currentCR: result[0],
+        currentCR,
         tierMinCR: result[1],
         apUSDMintFee: result[2],
         apUSDRedeemFee: result[3],
@@ -713,6 +741,13 @@ export class AspanReadClient {
         functionName: "getCurrentFeeTier",
       });
 
+      let currentCR = result[6];
+      // Contract returns max uint256 when supply is zero (infinite CR)
+      // CR is in BPS format (10000 = 100%)
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
+
       return {
         minCR: result[0],
         apUSDMintFee: result[1],
@@ -720,7 +755,7 @@ export class AspanReadClient {
         xBNBMintFee: result[3],
         xBNBRedeemFee: result[4],
         apUSDMintDisabled: result[5],
-        currentCR: result[6],
+        currentCR,
       };
     } catch (error) {
       // Return default fee tier when protocol is empty
@@ -773,9 +808,16 @@ export class AspanReadClient {
         functionName: "getStabilityMode",
       });
 
+      let currentCR = result[1];
+      // Contract returns max uint256 when supply is zero (infinite CR)
+      // CR is in BPS format (10000 = 100%)
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
+
       return {
         mode: result[0],
-        currentCR: result[1],
+        currentCR,
       };
     } catch (error) {
       // Return normal mode when protocol is empty
@@ -797,9 +839,16 @@ export class AspanReadClient {
         functionName: "canTriggerStabilityMode2",
       });
 
+      let currentCR = result[1];
+      // Contract returns max uint256 when supply is zero (infinite CR)
+      // CR is in BPS format (10000 = 100%)
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
+
       return {
         canTrigger: result[0],
-        currentCR: result[1],
+        currentCR,
         potentialConversion: result[2],
       };
     } catch (error) {
@@ -866,7 +915,7 @@ export class AspanClient extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintApUSD",
-      args: [params.lstToken, params.lstAmount],
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n],
     });
   }
 
@@ -882,7 +931,7 @@ export class AspanClient extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemApUSD",
-      args: [params.lstToken, params.apUSDAmount],
+      args: [params.lstToken, params.apUSDAmount, params.minOut ?? 0n],
     });
   }
 
@@ -898,7 +947,7 @@ export class AspanClient extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintXBNB",
-      args: [params.lstToken, params.lstAmount],
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n],
     });
   }
 
@@ -914,7 +963,7 @@ export class AspanClient extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemXBNB",
-      args: [params.lstToken, params.xBNBAmount],
+      args: [params.lstToken, params.xBNBAmount, params.minOut ?? 0n],
     });
   }
 

package/src/index.ts

@@ -17,6 +17,18 @@ export {
   type AspanWriteClientConfig,
 } from "./client";
 
+// ============ Router Client Classes ============
+export {
+  AspanRouterReadClient,
+  AspanRouterClient,
+  createRouterReadClient,
+  createRouterClient,
+  createRouterTestnetReadClient,
+  createRouterTestnetClient,
+  type AspanRouterClientConfig,
+  type AspanRouterWriteClientConfig,
+} from "./router";
+
 // ============ Types ============
 export type {
   // Core types
@@ -54,10 +66,33 @@ export type {
   // Transaction result
   TransactionResult,
   TransactionReceipt,
+  // Router types
+  RouterSwapParams,
+  RouterMintParams,
+  SwapAndMintParams,
+  StakeAndMintParams,
+  SwapAndMintDefaultParams,
+  RouterMintApUSDParams,
+  RouterMintXBNBParams,
+  RouterRedeemApUSDParams,
+  RouterRedeemXBNBParams,
+  RouterRedeemAndSwapParams,
+  RouterRedeemAndUnstakeParams,
+  WithdrawalRequestInfo,
+  ExpectedOutput,
+  // Router events
+  SwapAndMintEvent,
+  StakeAndMintEvent,
+  RouterMintEvent,
+  RouterRedeemEvent,
+  RedeemAndSwapEvent,
+  UnstakeRequestedEvent,
+  UnstakeClaimedEvent,
 } from "./types";
 
 // ============ ABI ============
 export { DiamondABI } from "./abi/diamond";
+export { RouterABI } from "./abi/router";
 
 // ============ Constants ============
 export const PRECISION = 10n ** 18n;
@@ -102,12 +137,13 @@ export function formatFeeBPS(bps: number): string {
 
 /**
  * Format collateral ratio to percentage string
- * @param cr Collateral ratio (18 decimals, 1e18 = 100%)
- * @returns Percentage string (e.g., "150%")
+ * @param cr Collateral ratio in BPS (10000 = 100%, contract format)
+ * @returns Percentage string (e.g., "150.00%")
  */
 export function formatCR(cr: bigint): string {
-  const percentage = (cr * 100n) / PRECISION;
-  return `${percentage}%`;
+  // CR is in BPS: 15000 = 150%
+  const percentage = Number(cr) / 100;
+  return `${percentage.toFixed(2)}%`;
 }
 
 /**