@aspan/sdk 0.1.4

package/dist/index.mjs

@@ -0,0 +1,1413 @@
+// src/client.ts
+import {
+  createPublicClient,
+  createWalletClient,
+  http
+} from "viem";
+import { bsc, bscTestnet } from "viem/chains";
+
+// src/abi/diamond.ts
+var DiamondABI = [
+  // ============ PoolFacet ============
+  {
+    type: "function",
+    name: "mintApUSD",
+    inputs: [
+      { name: "_lstToken", type: "address", internalType: "address" },
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "apUSDAmount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "redeemApUSD",
+    inputs: [
+      { name: "_lstToken", type: "address", internalType: "address" },
+      { name: "_apUSDAmount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "mintXBNB",
+    inputs: [
+      { name: "_lstToken", type: "address", internalType: "address" },
+      { name: "_lstAmount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "xBNBAmount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "redeemXBNB",
+    inputs: [
+      { name: "_lstToken", type: "address", internalType: "address" },
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "lstAmount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "getXBNBPriceBNB",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getXBNBPriceUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getTVLInBNB",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getTVLInUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getCollateralRatio",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getCurrentFees",
+    inputs: [],
+    outputs: [
+      { name: "currentCR", type: "uint256", internalType: "uint256" },
+      { name: "tierMinCR", type: "uint256", internalType: "uint256" },
+      { name: "apUSDMintFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBMintFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDMintDisabled", type: "bool", internalType: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getEffectiveLeverage",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getApUSDSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getXBNBSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getLSTCollateral",
+    inputs: [{ name: "_lstToken", type: "address", internalType: "address" }],
+    outputs: [{ name: "amount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  // ============ PoolFacet Events ============
+  {
+    type: "event",
+    name: "ApUSDMinted",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "lstToken", type: "address", indexed: true, internalType: "address" },
+      { name: "lstAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "apUSDAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "feeBPS", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "ApUSDRedeemed",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "lstToken", type: "address", indexed: true, internalType: "address" },
+      { name: "apUSDAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "lstAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "feeBPS", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "XBNBMinted",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "lstToken", type: "address", indexed: true, internalType: "address" },
+      { name: "lstAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "xBNBAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "feeBPS", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "XBNBRedeemed",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "lstToken", type: "address", indexed: true, internalType: "address" },
+      { name: "xBNBAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "lstAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "feeBPS", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  // ============ OracleFacet ============
+  {
+    type: "function",
+    name: "getBNBPriceUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getLSTPriceUSD",
+    inputs: [{ name: "_lstToken", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getLSTInfo",
+    inputs: [{ name: "_lstToken", type: "address", internalType: "address" }],
+    outputs: [
+      { name: "isAccepted", type: "bool", internalType: "bool" },
+      { name: "priceFeed", type: "address", internalType: "address" },
+      { name: "manualPriceUSD", type: "uint256", internalType: "uint256" },
+      { name: "collateralAmount", type: "uint256", internalType: "uint256" },
+      { name: "decimals", type: "uint8", internalType: "uint8" },
+      { name: "exchangeRateProvider", type: "address", internalType: "address" },
+      { name: "useIntrinsicValue", type: "bool", internalType: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getSupportedLSTs",
+    inputs: [],
+    outputs: [{ name: "", type: "address[]", internalType: "address[]" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isLSTSupported",
+    inputs: [{ name: "_lstToken", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "bnbPriceFeed",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getOracleBounds",
+    inputs: [{ name: "_priceFeed", type: "address", internalType: "address" }],
+    outputs: [
+      { name: "minPrice", type: "uint256", internalType: "uint256" },
+      { name: "maxPrice", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  // ============ StabilityPoolFacet ============
+  {
+    type: "function",
+    name: "deposit",
+    inputs: [{ name: "_apUSDAmount", type: "uint256", internalType: "uint256" }],
+    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" }],
+    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",
+    inputs: [{ name: "_user", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getBalance",
+    inputs: [{ name: "_user", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getExchangeRate",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getTotalStaked",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "previewDeposit",
+    inputs: [{ name: "_assets", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "previewRedeem",
+    inputs: [{ name: "_shares", type: "uint256", internalType: "uint256" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getPendingYield",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "harvestYield",
+    inputs: [],
+    outputs: [{ name: "yieldAmount", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+  // ============ StabilityPoolFacet Events ============
+  {
+    type: "event",
+    name: "Deposited",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "apUSDAmount", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "sharesReceived", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "Withdrawn",
+    inputs: [
+      { name: "user", type: "address", indexed: true, internalType: "address" },
+      { name: "sharesRedeemed", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "apUSDReceived", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  {
+    type: "event",
+    name: "YieldHarvested",
+    inputs: [
+      { name: "yieldUSD", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  // ============ YieldFacet ============
+  {
+    type: "function",
+    name: "getTotalYieldGenerated",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getLSTYieldInfo",
+    inputs: [{ name: "_lstToken", type: "address", internalType: "address" }],
+    outputs: [
+      { name: "lastExchangeRate", type: "uint256", internalType: "uint256" },
+      { name: "lastUpdateTimestamp", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getMinHarvestInterval",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getLastHarvestTimestamp",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "previewHarvest",
+    inputs: [],
+    outputs: [{ name: "totalYieldUSD", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  // ============ ConfigFacet ============
+  {
+    type: "function",
+    name: "getTokens",
+    inputs: [],
+    outputs: [
+      { name: "apUSD", type: "address", internalType: "address" },
+      { name: "xBNB", type: "address", internalType: "address" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getSApUSD",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getStabilityPool",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getTreasury",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getFeeTierCount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getFeeTier",
+    inputs: [{ name: "_index", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      { name: "minCR", type: "uint256", internalType: "uint256" },
+      { name: "apUSDMintFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBMintFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDMintDisabled", type: "bool", internalType: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getCurrentFeeTier",
+    inputs: [],
+    outputs: [
+      { name: "minCR", type: "uint256", internalType: "uint256" },
+      { name: "apUSDMintFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBMintFee", type: "uint16", internalType: "uint16" },
+      { name: "xBNBRedeemFee", type: "uint16", internalType: "uint16" },
+      { name: "apUSDMintDisabled", type: "bool", internalType: "bool" },
+      { name: "currentCR", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getMaxPriceAge",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getMinDepositPeriod",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "isPaused",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  // ============ StabilityModeFacet ============
+  {
+    type: "function",
+    name: "getStabilityMode",
+    inputs: [],
+    outputs: [
+      { name: "mode", type: "uint8", internalType: "uint8" },
+      { name: "currentCR", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "canTriggerStabilityMode2",
+    inputs: [],
+    outputs: [
+      { name: "canTrigger", type: "bool", internalType: "bool" },
+      { name: "currentCR", type: "uint256", internalType: "uint256" },
+      { name: "potentialConversion", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "triggerStabilityMode2",
+    inputs: [{ name: "_targetCR", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      { name: "apUSDBurned", type: "uint256", internalType: "uint256" },
+      { name: "xBNBMinted", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "nonpayable"
+  },
+  // ============ StabilityModeFacet Events ============
+  {
+    type: "event",
+    name: "StabilityMode2Triggered",
+    inputs: [
+      { name: "currentCR", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "targetCR", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "apUSDBurned", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "xBNBMinted", type: "uint256", indexed: false, internalType: "uint256" }
+    ],
+    anonymous: false
+  },
+  // ============ OwnershipFacet ============
+  {
+    type: "function",
+    name: "owner",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  }
+];
+
+// src/client.ts
+var AspanReadClient = class _AspanReadClient {
+  publicClient;
+  diamondAddress;
+  chain;
+  // Known error signatures for zero supply states
+  static ZERO_SUPPLY_ERROR_SIGNATURES = [
+    "0x403e7fa6"
+    // Custom error when xBNB supply is zero
+  ];
+  constructor(config) {
+    this.diamondAddress = config.diamondAddress;
+    this.chain = config.chain ?? bsc;
+    this.publicClient = createPublicClient({
+      chain: this.chain,
+      transport: http(config.rpcUrl)
+    });
+  }
+  /**
+   * Check if error is a known zero supply error from the contract
+   */
+  isZeroSupplyError(error) {
+    if (error && typeof error === "object" && "message" in error) {
+      const message = error.message;
+      return _AspanReadClient.ZERO_SUPPLY_ERROR_SIGNATURES.some(
+        (sig) => message.includes(sig)
+      );
+    }
+    return false;
+  }
+  // ============ Protocol Stats ============
+  /**
+   * Get comprehensive protocol statistics
+   */
+  async getProtocolStats() {
+    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()
+    ]);
+    return {
+      tvlInBNB,
+      tvlInUSD,
+      collateralRatio,
+      apUSDSupply,
+      xBNBSupply,
+      xBNBPriceBNB,
+      xBNBPriceUSD,
+      effectiveLeverage
+    };
+  }
+  /**
+   * Get stability pool statistics
+   */
+  async getStabilityPoolStats() {
+    const [totalStaked, exchangeRate, pendingYield] = await Promise.all([
+      this.getTotalStaked(),
+      this.getExchangeRate(),
+      this.getPendingYield()
+    ]);
+    return {
+      totalStaked,
+      exchangeRate,
+      pendingYield
+    };
+  }
+  /**
+   * Get yield statistics
+   */
+  async getYieldStats() {
+    const [
+      totalYieldGenerated,
+      pendingYield,
+      lastHarvestTimestamp,
+      minHarvestInterval,
+      previewedHarvest
+    ] = await Promise.all([
+      this.getTotalYieldGenerated(),
+      this.getPendingYield(),
+      this.getLastHarvestTimestamp(),
+      this.getMinHarvestInterval(),
+      this.previewHarvest()
+    ]);
+    return {
+      totalYieldGenerated,
+      pendingYield,
+      lastHarvestTimestamp,
+      minHarvestInterval,
+      previewedHarvest
+    };
+  }
+  // ============ Pool View Functions ============
+  async getTVLInBNB() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getTVLInBNB"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getTVLInUSD() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getTVLInUSD"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getCollateralRatio() {
+    try {
+      const cr = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getCollateralRatio"
+      });
+      if (cr > 10000n * 10n ** 18n) {
+        return 0n;
+      }
+      return cr;
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getXBNBPriceBNB() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getXBNBPriceBNB"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getXBNBPriceUSD() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getXBNBPriceUSD"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getEffectiveLeverage() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getEffectiveLeverage"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getApUSDSupply() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getApUSDSupply"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getXBNBSupply() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getXBNBSupply"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getLSTCollateral(lstToken) {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getLSTCollateral",
+        args: [lstToken]
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getCurrentFees() {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getCurrentFees"
+      });
+      return {
+        currentCR: result[0],
+        tierMinCR: result[1],
+        apUSDMintFee: result[2],
+        apUSDRedeemFee: result[3],
+        xBNBMintFee: result[4],
+        xBNBRedeemFee: result[5],
+        apUSDMintDisabled: result[6]
+      };
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return {
+          currentCR: 0n,
+          tierMinCR: 0n,
+          apUSDMintFee: 0,
+          apUSDRedeemFee: 0,
+          xBNBMintFee: 0,
+          xBNBRedeemFee: 0,
+          apUSDMintDisabled: false
+        };
+      }
+      throw error;
+    }
+  }
+  // ============ Oracle View Functions ============
+  async getBNBPriceUSD() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getBNBPriceUSD"
+    });
+  }
+  async getLSTPriceUSD(lstToken) {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getLSTPriceUSD",
+      args: [lstToken]
+    });
+  }
+  async getLSTInfo(lstToken) {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getLSTInfo",
+      args: [lstToken]
+    });
+    return {
+      isAccepted: result[0],
+      priceFeed: result[1],
+      manualPriceUSD: result[2],
+      collateralAmount: result[3],
+      decimals: result[4],
+      exchangeRateProvider: result[5],
+      useIntrinsicValue: result[6]
+    };
+  }
+  async getSupportedLSTs() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getSupportedLSTs"
+    });
+  }
+  async isLSTSupported(lstToken) {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "isLSTSupported",
+      args: [lstToken]
+    });
+  }
+  async getBNBPriceFeed() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "bnbPriceFeed"
+    });
+  }
+  async getOracleBounds(priceFeed) {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getOracleBounds",
+      args: [priceFeed]
+    });
+    return {
+      minPrice: result[0],
+      maxPrice: result[1]
+    };
+  }
+  // ============ Stability Pool View Functions ============
+  async getShares(user) {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getShares",
+      args: [user]
+    });
+  }
+  async getBalance(user) {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getBalance",
+      args: [user]
+    });
+  }
+  async getUserStabilityPoolPosition(user) {
+    const [shares, balance] = await Promise.all([
+      this.getShares(user),
+      this.getBalance(user)
+    ]);
+    return { shares, balance };
+  }
+  async getExchangeRate() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getExchangeRate"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 10n ** 18n;
+      }
+      throw error;
+    }
+  }
+  async getTotalStaked() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getTotalStaked"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async previewDeposit(assets) {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "previewDeposit",
+        args: [assets]
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return assets;
+      }
+      throw error;
+    }
+  }
+  async previewRedeem(shares) {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "previewRedeem",
+        args: [shares]
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return shares;
+      }
+      throw error;
+    }
+  }
+  async getPendingYield() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getPendingYield"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  // ============ Yield View Functions ============
+  async getTotalYieldGenerated() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getTotalYieldGenerated"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getLSTYieldInfo(lstToken) {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getLSTYieldInfo",
+        args: [lstToken]
+      });
+      return {
+        lastExchangeRate: result[0],
+        lastUpdateTimestamp: result[1]
+      };
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return {
+          lastExchangeRate: 0n,
+          lastUpdateTimestamp: 0n
+        };
+      }
+      throw error;
+    }
+  }
+  async getMinHarvestInterval() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getMinHarvestInterval"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async getLastHarvestTimestamp() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getLastHarvestTimestamp"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  async previewHarvest() {
+    try {
+      return await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "previewHarvest"
+      });
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return 0n;
+      }
+      throw error;
+    }
+  }
+  // ============ Config View Functions ============
+  async getTokens() {
+    const [tokens, sApUSD] = await Promise.all([
+      this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getTokens"
+      }),
+      this.getSApUSD()
+    ]);
+    return {
+      apUSD: tokens[0],
+      xBNB: tokens[1],
+      sApUSD
+    };
+  }
+  async getSApUSD() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getSApUSD"
+    });
+  }
+  async getStabilityPool() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getStabilityPool"
+    });
+  }
+  async getTreasury() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getTreasury"
+    });
+  }
+  async getFeeTierCount() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getFeeTierCount"
+    });
+  }
+  async getFeeTier(index) {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getFeeTier",
+      args: [index]
+    });
+    return {
+      minCR: result[0],
+      apUSDMintFee: result[1],
+      apUSDRedeemFee: result[2],
+      xBNBMintFee: result[3],
+      xBNBRedeemFee: result[4],
+      apUSDMintDisabled: result[5]
+    };
+  }
+  async getCurrentFeeTier() {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getCurrentFeeTier"
+      });
+      return {
+        minCR: result[0],
+        apUSDMintFee: result[1],
+        apUSDRedeemFee: result[2],
+        xBNBMintFee: result[3],
+        xBNBRedeemFee: result[4],
+        apUSDMintDisabled: result[5],
+        currentCR: result[6]
+      };
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return {
+          minCR: 0n,
+          apUSDMintFee: 0,
+          apUSDRedeemFee: 0,
+          xBNBMintFee: 0,
+          xBNBRedeemFee: 0,
+          apUSDMintDisabled: false,
+          currentCR: 0n
+        };
+      }
+      throw error;
+    }
+  }
+  async getMaxPriceAge() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getMaxPriceAge"
+    });
+  }
+  async getMinDepositPeriod() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getMinDepositPeriod"
+    });
+  }
+  async isPaused() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "isPaused"
+    });
+  }
+  // ============ Stability Mode View Functions ============
+  async getStabilityMode() {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "getStabilityMode"
+      });
+      return {
+        mode: result[0],
+        currentCR: result[1]
+      };
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return {
+          mode: 0,
+          // Normal mode
+          currentCR: 0n
+        };
+      }
+      throw error;
+    }
+  }
+  async canTriggerStabilityMode2() {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.diamondAddress,
+        abi: DiamondABI,
+        functionName: "canTriggerStabilityMode2"
+      });
+      return {
+        canTrigger: result[0],
+        currentCR: result[1],
+        potentialConversion: result[2]
+      };
+    } catch (error) {
+      if (this.isZeroSupplyError(error)) {
+        return {
+          canTrigger: false,
+          currentCR: 0n,
+          potentialConversion: 0n
+        };
+      }
+      throw error;
+    }
+  }
+  // ============ Ownership View Functions ============
+  async getOwner() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "owner"
+    });
+  }
+};
+var AspanClient = class extends AspanReadClient {
+  walletClient;
+  constructor(config) {
+    super(config);
+    this.walletClient = createWalletClient({
+      account: config.account,
+      chain: this.chain,
+      transport: http(config.rpcUrl)
+    });
+  }
+  // ============ Pool Write Functions ============
+  /**
+   * Mint apUSD by depositing LST
+   * @param params Mint parameters
+   * @returns Transaction hash
+   */
+  async mintApUSD(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "mintApUSD",
+      args: [params.lstToken, params.lstAmount]
+    });
+  }
+  /**
+   * Redeem apUSD for LST
+   * @param params Redeem parameters
+   * @returns Transaction hash
+   */
+  async redeemApUSD(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "redeemApUSD",
+      args: [params.lstToken, params.apUSDAmount]
+    });
+  }
+  /**
+   * Mint xBNB by depositing LST
+   * @param params Mint parameters
+   * @returns Transaction hash
+   */
+  async mintXBNB(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "mintXBNB",
+      args: [params.lstToken, params.lstAmount]
+    });
+  }
+  /**
+   * Redeem xBNB for LST
+   * @param params Redeem parameters
+   * @returns Transaction hash
+   */
+  async redeemXBNB(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "redeemXBNB",
+      args: [params.lstToken, params.xBNBAmount]
+    });
+  }
+  // ============ Stability Pool Write Functions ============
+  /**
+   * Deposit apUSD to stability pool to earn yield
+   * @param params Deposit parameters
+   * @returns Transaction hash
+   */
+  async deposit(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "deposit",
+      args: [params.apUSDAmount]
+    });
+  }
+  /**
+   * Withdraw from stability pool by shares
+   * @param params Withdraw parameters
+   * @returns Transaction hash
+   */
+  async withdraw(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "withdraw",
+      args: [params.shares]
+    });
+  }
+  /**
+   * Withdraw from stability pool by asset amount
+   * @param params Withdraw parameters
+   * @returns Transaction hash
+   */
+  async withdrawAssets(params) {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "withdrawAssets",
+      args: [params.assets]
+    });
+  }
+  /**
+   * Harvest yield from LSTs
+   * @returns Transaction hash
+   */
+  async harvestYield() {
+    return this.walletClient.writeContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "harvestYield"
+    });
+  }
+  // ============ Transaction Helpers ============
+  /**
+   * Wait for transaction confirmation
+   * @param hash Transaction hash
+   * @returns Transaction receipt
+   */
+  async waitForTransaction(hash) {
+    return this.publicClient.waitForTransactionReceipt({ hash });
+  }
+};
+function createAspanReadClient(diamondAddress, rpcUrl) {
+  return new AspanReadClient({
+    diamondAddress,
+    chain: bsc,
+    rpcUrl
+  });
+}
+function createAspanClient(diamondAddress, account, rpcUrl) {
+  return new AspanClient({
+    diamondAddress,
+    account,
+    chain: bsc,
+    rpcUrl
+  });
+}
+function createAspanTestnetReadClient(diamondAddress, rpcUrl) {
+  return new AspanReadClient({
+    diamondAddress,
+    chain: bscTestnet,
+    rpcUrl
+  });
+}
+function createAspanTestnetClient(diamondAddress, account, rpcUrl) {
+  return new AspanClient({
+    diamondAddress,
+    account,
+    chain: bscTestnet,
+    rpcUrl
+  });
+}
+
+// src/index.ts
+var PRECISION = 10n ** 18n;
+var BPS_PRECISION = 10000n;
+var PRICE_PRECISION = 10n ** 8n;
+function formatAmount(amount, decimals = 4) {
+  const divisor = 10n ** BigInt(18 - decimals);
+  const scaled = amount / divisor;
+  const intPart = scaled / 10n ** BigInt(decimals);
+  const fracPart = scaled % 10n ** BigInt(decimals);
+  return `${intPart}.${fracPart.toString().padStart(decimals, "0")}`;
+}
+function parseAmount(amount) {
+  const [intPart, fracPart = ""] = amount.split(".");
+  const paddedFrac = fracPart.padEnd(18, "0").slice(0, 18);
+  return BigInt(intPart) * PRECISION + BigInt(paddedFrac);
+}
+function formatFeeBPS(bps) {
+  return `${(bps / 100).toFixed(2)}%`;
+}
+function formatCR(cr) {
+  const percentage = cr * 100n / PRECISION;
+  return `${percentage}%`;
+}
+function formatPriceUSD(price) {
+  const dollars = price / PRICE_PRECISION;
+  const cents = price % PRICE_PRECISION / 10n ** 6n;
+  return `$${dollars}.${cents.toString().padStart(2, "0")}`;
+}
+function calculateAPY(previousRate, currentRate, periodDays) {
+  if (previousRate === 0n || periodDays === 0) return 0;
+  const rateChange = Number((currentRate - previousRate) * 10000n) / Number(previousRate);
+  const dailyRate = rateChange / periodDays;
+  const annualizedRate = dailyRate * 365;
+  return annualizedRate / 100;
+}
+export {
+  AspanClient,
+  AspanReadClient,
+  BPS_PRECISION,
+  DiamondABI,
+  PRECISION,
+  PRICE_PRECISION,
+  calculateAPY,
+  createAspanClient,
+  createAspanReadClient,
+  createAspanTestnetClient,
+  createAspanTestnetReadClient,
+  formatAmount,
+  formatCR,
+  formatFeeBPS,
+  formatPriceUSD,
+  parseAmount
+};