@aspan/sdk 0.1.7 → 0.1.8

package/README.md

@@ -124,8 +124,12 @@ function MintComponent() {
     // Step 3: Approve LST (use wagmi's useWriteContract or viem)
     // ...
 
-    // Step 4: Mint apUSD
-    const hash = await client.mintApUSD({ lstToken: SLISBNB, lstAmount });
+    // Step 4: Calculate minOut for slippage protection (e.g., 0.5% slippage)
+    const expectedApUSD = lstAmount; // Simplified, use actual calculation
+    const minOut = expectedApUSD * 995n / 1000n; // 0.5% slippage
+
+    // Step 5: Mint apUSD
+    const hash = await client.mintApUSD({ lstToken: SLISBNB, lstAmount, minOut });
     const receipt = await client.waitForTransaction(hash);
     console.log("Minted apUSD:", receipt.status);
   };
@@ -161,8 +165,9 @@ if (fees.apUSDMintDisabled) throw new Error("Minting disabled in current CR");
 //   args: [DIAMOND, lstAmount],
 // });
 
-// Step 4: Mint apUSD
-const hash = await client.mintApUSD({ lstToken: SLISBNB, lstAmount });
+// Step 4: Mint apUSD with slippage protection
+const minOut = lstAmount * 995n / 1000n; // 0.5% slippage tolerance
+const hash = await client.mintApUSD({ lstToken: SLISBNB, lstAmount, minOut });
 const receipt = await client.waitForTransaction(hash);
 console.log("Minted apUSD:", receipt.status);
 ```
@@ -181,8 +186,13 @@ const maxRedeemable = (collateral * lstPrice) / parseAmount("1");
 console.log("Max redeemable:", formatAmount(maxRedeemable), "USD");
 
 // Step 2: Approve apUSD spending (use viem directly)
-// Step 3: Redeem
-const hash = await client.redeemApUSD({ lstToken: SLISBNB, apUSDAmount });
+
+// Step 3: Calculate expected LST output and set minOut
+const expectedLST = (apUSDAmount * parseAmount("1")) / lstPrice;
+const minOut = expectedLST * 995n / 1000n; // 0.5% slippage
+
+// Step 4: Redeem with slippage protection
+const hash = await client.redeemApUSD({ lstToken: SLISBNB, apUSDAmount, minOut });
 await client.waitForTransaction(hash);
 ```
 
@@ -202,12 +212,46 @@ if (xBNBPrice === 0n) {
   throw new Error("xBNB underwater - cannot mint");
 }
 
-// Step 3: Approve LST, then mint xBNB
-const hash = await client.mintXBNB({ lstToken: SLISBNB, lstAmount });
+// Step 3: Approve LST, then mint xBNB with slippage protection
+const minOut = 0n; // Set appropriate minOut based on expected xBNB output
+const hash = await client.mintXBNB({ lstToken: SLISBNB, lstAmount, minOut });
+await client.waitForTransaction(hash);
+```
+
+### Flow 4: Redeem xBNB for LST
+
+User burns xBNB to get back LST.
+
+```typescript
+const xBNBAmount = parseAmount("100"); // 100 xBNB
+
+// Step 1: Check xBNB price (ensure not underwater)
+const xBNBPrice = await client.getXBNBPriceBNB();
+if (xBNBPrice === 0n) {
+  throw new Error("xBNB is underwater - redemption may result in 0 LST");
+}
+
+// Step 2: Check current fees
+const fees = await client.getCurrentFees();
+console.log("xBNB Redeem fee:", fees.xBNBRedeemFee / 100, "%");
+
+// Step 3: Check available LST liquidity
+const collateral = await client.getLSTCollateral(SLISBNB);
+console.log("Available collateral:", formatAmount(collateral));
+
+// Step 4: Approve xBNB spending (use viem directly)
+// ...
+
+// Step 5: Calculate expected LST and set minOut for slippage protection
+const expectedLST = (xBNBAmount * xBNBPrice) / parseAmount("1");
+const minOut = expectedLST * 995n / 1000n; // 0.5% slippage
+
+// Step 6: Redeem xBNB
+const hash = await client.redeemXBNB({ lstToken: SLISBNB, xBNBAmount, minOut });
 await client.waitForTransaction(hash);
 ```
 
-### Flow 4: Stake apUSD to Earn Yield (sApUSD)
+### Flow 5: Stake apUSD to Earn Yield (sApUSD)
 
 User deposits apUSD to stability pool to earn LST yield.
 
@@ -232,7 +276,7 @@ console.log("Shares:", formatAmount(position.shares));
 console.log("Balance (incl. yield):", formatAmount(position.balance));
 ```
 
-### Flow 5: Withdraw from Stability Pool
+### Flow 6: Withdraw from Stability Pool
 
 User withdraws their staked apUSD plus accumulated yield.
 
@@ -255,7 +299,7 @@ await client.waitForTransaction(hash);
 // const hash = await client.withdrawAssets({ assets: parseAmount("500") });
 ```
 
-### Flow 6: Manual Yield Harvest
+### Flow 7: Manual Yield Harvest
 
 Anyone can trigger yield harvest to distribute pending LST yield.
 

package/dist/index.d.mts

@@ -71,21 +71,29 @@ interface StabilityMode2Info {
 interface MintApUSDParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum apUSD output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming apUSD */
 interface RedeemApUSDParams {
     lstToken: Address;
     apUSDAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for minting xBNB */
 interface MintXBNBParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum xBNB output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming xBNB */
 interface RedeemXBNBParams {
     lstToken: Address;
     xBNBAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for depositing to stability pool */
 interface DepositParams {
@@ -365,6 +373,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "apUSDAmount";
@@ -383,6 +395,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_apUSDAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -401,6 +417,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "xBNBAmount";
@@ -419,6 +439,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_xBNBAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -1304,8 +1328,8 @@ declare function parseAmount(amount: string): bigint;
 declare 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%")
  */
 declare function formatCR(cr: bigint): string;
 /**

package/dist/index.d.ts

@@ -71,21 +71,29 @@ interface StabilityMode2Info {
 interface MintApUSDParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum apUSD output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming apUSD */
 interface RedeemApUSDParams {
     lstToken: Address;
     apUSDAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for minting xBNB */
 interface MintXBNBParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum xBNB output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming xBNB */
 interface RedeemXBNBParams {
     lstToken: Address;
     xBNBAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for depositing to stability pool */
 interface DepositParams {
@@ -365,6 +373,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "apUSDAmount";
@@ -383,6 +395,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_apUSDAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -401,6 +417,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "xBNBAmount";
@@ -419,6 +439,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_xBNBAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -1304,8 +1328,8 @@ declare function parseAmount(amount: string): bigint;
 declare 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%")
  */
 declare function formatCR(cr: bigint): string;
 /**

package/dist/index.js

@@ -51,7 +51,8 @@ var DiamondABI = [
     name: "mintApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "apUSDAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -61,7 +62,8 @@ var DiamondABI = [
     name: "redeemApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" }
+      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -71,7 +73,8 @@ var DiamondABI = [
     name: "mintXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "xBNBAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -81,7 +84,8 @@ var DiamondABI = [
     name: "redeemXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" }
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -598,25 +602,23 @@ var AspanReadClient = class _AspanReadClient {
    * Get comprehensive protocol statistics
    */
   async getProtocolStats() {
-    const [
-      tvlInBNB,
-      tvlInUSD,
-      collateralRatio,
-      apUSDSupply,
-      xBNBSupply,
-      xBNBPriceBNB,
-      xBNBPriceUSD,
-      effectiveLeverage
-    ] = await Promise.all([
+    const [tvlInBNB, tvlInUSD, collateralRatio, apUSDSupply, xBNBSupply] = await Promise.all([
       this.getTVLInBNB(),
       this.getTVLInUSD(),
       this.getCollateralRatio(),
       this.getApUSDSupply(),
-      this.getXBNBSupply(),
-      this.getXBNBPriceBNB(),
-      this.getXBNBPriceUSD(),
-      this.getEffectiveLeverage()
+      this.getXBNBSupply()
     ]);
+    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,
       tvlInUSD,
@@ -704,7 +706,7 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCollateralRatio"
       });
-      if (cr > 10000n * 10n ** 18n) {
+      if (cr > 100000000n) {
         return 0n;
       }
       return cr;
@@ -717,11 +719,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getXBNBPriceBNB() {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceBNB"
       });
+      if (price > 1000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -731,11 +737,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getXBNBPriceUSD() {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceUSD"
       });
+      if (price > 1000000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -745,11 +755,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getEffectiveLeverage() {
     try {
-      return await this.publicClient.readContract({
+      const leverage = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getEffectiveLeverage"
       });
+      if (leverage > 100n * 10n ** 18n) {
+        return 0n;
+      }
+      return leverage;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -807,8 +821,12 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCurrentFees"
       });
+      let currentCR = result[0];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
-        currentCR: result[0],
+        currentCR,
         tierMinCR: result[1],
         apUSDMintFee: result[2],
         apUSDRedeemFee: result[3],
@@ -1141,6 +1159,10 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCurrentFeeTier"
       });
+      let currentCR = result[6];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         minCR: result[0],
         apUSDMintFee: result[1],
@@ -1148,7 +1170,7 @@ var AspanReadClient = class _AspanReadClient {
         xBNBMintFee: result[3],
         xBNBRedeemFee: result[4],
         apUSDMintDisabled: result[5],
-        currentCR: result[6]
+        currentCR
       };
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
@@ -1194,9 +1216,13 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getStabilityMode"
       });
+      let currentCR = result[1];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         mode: result[0],
-        currentCR: result[1]
+        currentCR
       };
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
@@ -1216,9 +1242,13 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "canTriggerStabilityMode2"
       });
+      let currentCR = result[1];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         canTrigger: result[0],
-        currentCR: result[1],
+        currentCR,
         potentialConversion: result[2]
       };
     } catch (error) {
@@ -1270,7 +1300,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintApUSD",
-      args: [params.lstToken, params.lstAmount]
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1285,7 +1315,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemApUSD",
-      args: [params.lstToken, params.apUSDAmount]
+      args: [params.lstToken, params.apUSDAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1300,7 +1330,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintXBNB",
-      args: [params.lstToken, params.lstAmount]
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1315,7 +1345,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemXBNB",
-      args: [params.lstToken, params.xBNBAmount]
+      args: [params.lstToken, params.xBNBAmount, params.minOut ?? 0n]
     });
   }
   // ============ Stability Pool Write Functions ============
@@ -1438,8 +1468,8 @@ function formatFeeBPS(bps) {
   return `${(bps / 100).toFixed(2)}%`;
 }
 function formatCR(cr) {
-  const percentage = cr * 100n / PRECISION;
-  return `${percentage}%`;
+  const percentage = Number(cr) / 100;
+  return `${percentage.toFixed(2)}%`;
 }
 function formatPriceUSD(price) {
   const dollars = price / PRICE_PRECISION;

package/dist/index.mjs

@@ -14,7 +14,8 @@ var DiamondABI = [
     name: "mintApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "apUSDAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -24,7 +25,8 @@ var DiamondABI = [
     name: "redeemApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" }
+      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -34,7 +36,8 @@ var DiamondABI = [
     name: "mintXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "xBNBAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -44,7 +47,8 @@ var DiamondABI = [
     name: "redeemXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" }
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -561,25 +565,23 @@ var AspanReadClient = class _AspanReadClient {
    * Get comprehensive protocol statistics
    */
   async getProtocolStats() {
-    const [
-      tvlInBNB,
-      tvlInUSD,
-      collateralRatio,
-      apUSDSupply,
-      xBNBSupply,
-      xBNBPriceBNB,
-      xBNBPriceUSD,
-      effectiveLeverage
-    ] = await Promise.all([
+    const [tvlInBNB, tvlInUSD, collateralRatio, apUSDSupply, xBNBSupply] = await Promise.all([
       this.getTVLInBNB(),
       this.getTVLInUSD(),
       this.getCollateralRatio(),
       this.getApUSDSupply(),
-      this.getXBNBSupply(),
-      this.getXBNBPriceBNB(),
-      this.getXBNBPriceUSD(),
-      this.getEffectiveLeverage()
+      this.getXBNBSupply()
     ]);
+    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,
       tvlInUSD,
@@ -667,7 +669,7 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCollateralRatio"
       });
-      if (cr > 10000n * 10n ** 18n) {
+      if (cr > 100000000n) {
         return 0n;
       }
       return cr;
@@ -680,11 +682,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getXBNBPriceBNB() {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceBNB"
       });
+      if (price > 1000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -694,11 +700,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getXBNBPriceUSD() {
     try {
-      return await this.publicClient.readContract({
+      const price = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getXBNBPriceUSD"
       });
+      if (price > 1000000n * 10n ** 18n) {
+        return 0n;
+      }
+      return price;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -708,11 +718,15 @@ var AspanReadClient = class _AspanReadClient {
   }
   async getEffectiveLeverage() {
     try {
-      return await this.publicClient.readContract({
+      const leverage = await this.publicClient.readContract({
         address: this.diamondAddress,
         abi: DiamondABI,
         functionName: "getEffectiveLeverage"
       });
+      if (leverage > 100n * 10n ** 18n) {
+        return 0n;
+      }
+      return leverage;
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
         return 0n;
@@ -770,8 +784,12 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCurrentFees"
       });
+      let currentCR = result[0];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
-        currentCR: result[0],
+        currentCR,
         tierMinCR: result[1],
         apUSDMintFee: result[2],
         apUSDRedeemFee: result[3],
@@ -1104,6 +1122,10 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getCurrentFeeTier"
       });
+      let currentCR = result[6];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         minCR: result[0],
         apUSDMintFee: result[1],
@@ -1111,7 +1133,7 @@ var AspanReadClient = class _AspanReadClient {
         xBNBMintFee: result[3],
         xBNBRedeemFee: result[4],
         apUSDMintDisabled: result[5],
-        currentCR: result[6]
+        currentCR
       };
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
@@ -1157,9 +1179,13 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "getStabilityMode"
       });
+      let currentCR = result[1];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         mode: result[0],
-        currentCR: result[1]
+        currentCR
       };
     } catch (error) {
       if (this.isZeroSupplyError(error)) {
@@ -1179,9 +1205,13 @@ var AspanReadClient = class _AspanReadClient {
         abi: DiamondABI,
         functionName: "canTriggerStabilityMode2"
       });
+      let currentCR = result[1];
+      if (currentCR > 100000000n) {
+        currentCR = 0n;
+      }
       return {
         canTrigger: result[0],
-        currentCR: result[1],
+        currentCR,
         potentialConversion: result[2]
       };
     } catch (error) {
@@ -1233,7 +1263,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintApUSD",
-      args: [params.lstToken, params.lstAmount]
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1248,7 +1278,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemApUSD",
-      args: [params.lstToken, params.apUSDAmount]
+      args: [params.lstToken, params.apUSDAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1263,7 +1293,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "mintXBNB",
-      args: [params.lstToken, params.lstAmount]
+      args: [params.lstToken, params.lstAmount, params.minOut ?? 0n]
     });
   }
   /**
@@ -1278,7 +1308,7 @@ var AspanClient = class extends AspanReadClient {
       address: this.diamondAddress,
       abi: DiamondABI,
       functionName: "redeemXBNB",
-      args: [params.lstToken, params.xBNBAmount]
+      args: [params.lstToken, params.xBNBAmount, params.minOut ?? 0n]
     });
   }
   // ============ Stability Pool Write Functions ============
@@ -1401,8 +1431,8 @@ function formatFeeBPS(bps) {
   return `${(bps / 100).toFixed(2)}%`;
 }
 function formatCR(cr) {
-  const percentage = cr * 100n / PRECISION;
-  return `${percentage}%`;
+  const percentage = Number(cr) / 100;
+  return `${percentage.toFixed(2)}%`;
 }
 function formatPriceUSD(price) {
   const dollars = price / PRICE_PRECISION;

package/package.json

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

package/src/abi/diamond.ts

@@ -9,7 +9,8 @@ export const DiamondABI = [
     name: "mintApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "apUSDAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -19,7 +20,8 @@ export const DiamondABI = [
     name: "redeemApUSD",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" }
+      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -29,7 +31,8 @@ export const DiamondABI = [
     name: "mintXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "xBNBAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"
@@ -39,7 +42,8 @@ export const DiamondABI = [
     name: "redeemXBNB",
     inputs: [
       { name: "_lstToken", type: "address", internalType: "address" },
-      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" }
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minOut", type: "uint256", internalType: "uint256" }
     ],
     outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
     stateMutability: "nonpayable"

package/src/bot/config.ts

@@ -17,7 +17,7 @@ export interface BotConfig {
   statsReportInterval: number;
   crCheckInterval: number;
 
-  // CR Thresholds (18 decimals: 1.5e18 = 150%)
+  // CR Thresholds (BPS: 15000 = 150%, matches contract format)
   crThresholdMode1: bigint;
   crThresholdMode2: bigint;
 
@@ -59,13 +59,13 @@ export function loadConfig(): BotConfig {
     ), // 5 min
     crCheckInterval: parseInt(process.env.CR_CHECK_INTERVAL_MS ?? "30000", 10), // 30 sec
 
-    // CR Thresholds
+    // CR Thresholds (BPS format to match contract)
     crThresholdMode1: BigInt(
-      process.env.CR_THRESHOLD_MODE1 ?? "1500000000000000000"
-    ), // 150%
+      process.env.CR_THRESHOLD_MODE1 ?? "15000"
+    ), // 150% in BPS
     crThresholdMode2: BigInt(
-      process.env.CR_THRESHOLD_MODE2 ?? "1300000000000000000"
-    ), // 130%
+      process.env.CR_THRESHOLD_MODE2 ?? "13000"
+    ), // 130% in BPS
 
     // TVL
     tvlImpactThresholdPercent: parseFloat(

package/src/bot/monitors/cr-monitor.ts

@@ -79,6 +79,14 @@ export class CRMonitor {
       const currentCR = stabilityMode.currentCR;
       const now = Date.now();
 
+      // Skip alerts when protocol is effectively empty
+      // CR < 100 BPS (1%) indicates negligible TVL/supply, not a real crisis
+      const MIN_MEANINGFUL_CR = 100n; // 1% in BPS
+      if (currentCR < MIN_MEANINGFUL_CR) {
+        console.log(`[CRMonitor] Protocol effectively empty (CR = ${formatCR(currentCR)}), skipping alerts`);
+        return;
+      }
+
       // Check Mode 2 threshold (< 130%)
       if (currentCR < this.config.crThresholdMode2) {
         if (!this.state.mode2Triggered || this.shouldRepeatAlert(now)) {

package/src/bot/monitors/stats-monitor.ts

@@ -143,7 +143,7 @@ export class StatsMonitor {
               },
               {
                 title: "xBNB Supply",
-                value: formatAmount(stats.xBNBSupply, 4),
+                value: formatAmount(stats.xBNBSupply, 18),
                 short: true,
               },
               {

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

@@ -102,12 +102,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)}%`;
 }
 
 /**

package/src/types.ts

@@ -90,24 +90,32 @@ export interface StabilityMode2Result {
 export interface MintApUSDParams {
   lstToken: Address;
   lstAmount: bigint;
+  /** Minimum apUSD output for slippage protection (default: 0n) */
+  minOut?: bigint;
 }
 
 /** Parameters for redeeming apUSD */
 export interface RedeemApUSDParams {
   lstToken: Address;
   apUSDAmount: bigint;
+  /** Minimum LST output for slippage protection (default: 0n) */
+  minOut?: bigint;
 }
 
 /** Parameters for minting xBNB */
 export interface MintXBNBParams {
   lstToken: Address;
   lstAmount: bigint;
+  /** Minimum xBNB output for slippage protection (default: 0n) */
+  minOut?: bigint;
 }
 
 /** Parameters for redeeming xBNB */
 export interface RedeemXBNBParams {
   lstToken: Address;
   xBNBAmount: bigint;
+  /** Minimum LST output for slippage protection (default: 0n) */
+  minOut?: bigint;
 }
 
 /** Parameters for depositing to stability pool */