@aspan/sdk 0.4.0 → 0.4.1

package/dist/index.js

@@ -522,6 +522,30 @@ var DiamondABI = [
     outputs: [{ name: "", type: "bool", internalType: "bool" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "bootstrap",
+    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: "isBootstrapped",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getBootstrapXBNBAmount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   // ============ StabilityModeFacet ============
   {
     type: "function",
@@ -554,6 +578,13 @@ var DiamondABI = [
     ],
     stateMutability: "nonpayable"
   },
+  {
+    type: "function",
+    name: "cleanXbnb",
+    inputs: [{ name: "_xBNBAmount", type: "uint256", internalType: "uint256" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
   // ============ StabilityModeFacet Events ============
   {
     type: "event",
@@ -573,6 +604,48 @@ var DiamondABI = [
     inputs: [],
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
+  },
+  // ============ Fee Manager ============
+  {
+    type: "function",
+    name: "setFeeManager",
+    inputs: [{ name: "_feeManager", type: "address", internalType: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "getFeeManager",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "setFeeTiers",
+    inputs: [{
+      name: "_tiers",
+      type: "tuple[]",
+      internalType: "struct LibAppStorage.FeeTier[]",
+      components: [
+        { 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" }
+      ]
+    }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "FeeManagerSet",
+    inputs: [
+      { name: "feeManager", type: "address", indexed: true, internalType: "address" }
+    ],
+    anonymous: false
   }
 ];
 
@@ -1217,6 +1290,29 @@ var AspanReadClient = class _AspanReadClient {
       functionName: "isPaused"
     });
   }
+  // ============ Bootstrap View Functions ============
+  /**
+   * Check if xBNB liquidity has been bootstrapped
+   * @returns true if bootstrap has been called
+   */
+  async isBootstrapped() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "isBootstrapped"
+    });
+  }
+  /**
+   * Get the amount of xBNB locked in bootstrap (burned to dead address)
+   * @returns xBNB amount in wei
+   */
+  async getBootstrapXBNBAmount() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getBootstrapXBNBAmount"
+    });
+  }
   // ============ Stability Mode View Functions ============
   async getStabilityMode() {
     try {
@@ -1416,6 +1512,75 @@ var AspanClient = class extends AspanReadClient {
       functionName: "harvestYield"
     });
   }
+  // ============ Risk Management Functions ============
+  /**
+   * Trigger Stability Mode 2 forced conversion
+   * @description Anyone can call when CR < 130%. Burns apUSD from stability pool
+   * and mints xBNB to compensate stakers.
+   * @param targetCR Target CR to restore to (in BPS, e.g., 14000 = 140%)
+   * @returns Transaction hash
+   */
+  async triggerStabilityMode2(targetCR = 14000n) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "triggerStabilityMode2",
+      args: [targetCR]
+    });
+  }
+  /**
+   * Clean underwater xBNB (burn without getting LST back)
+   * @description Only works when xBNB is underwater (price = 0)
+   * @param xBNBAmount Amount of xBNB to clean (burn)
+   * @returns Transaction hash
+   */
+  async cleanXbnb(xBNBAmount) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "cleanXbnb",
+      args: [xBNBAmount]
+    });
+  }
+  // ============ Fee Management Functions ============
+  /**
+   * Set fee tiers (requires feeManager or owner role)
+   * @param tiers Array of fee tier configurations
+   * @returns Transaction hash
+   */
+  async setFeeTiers(tiers) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "setFeeTiers",
+      args: [tiers]
+    });
+  }
+  // ============ Admin Functions ============
+  /**
+   * Bootstrap xBNB liquidity (owner only)
+   * @description Initializes xBNB supply by minting to dead address, preventing extreme initial prices.
+   * Similar to Uniswap V2's MINIMUM_LIQUIDITY. Can only be called once.
+   * @param lstToken LST token address to deposit
+   * @param lstAmount Amount of LST to deposit for bootstrap
+   * @returns Transaction hash
+   */
+  async bootstrap(lstToken, lstAmount) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "bootstrap",
+      args: [lstToken, lstAmount]
+    });
+  }
   // ============ Transaction Helpers ============
   /**
    * Wait for transaction confirmation
@@ -2241,15 +2406,15 @@ var PRECISION = 10n ** 18n;
 var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
-  diamond: "0x10d25Ae0690533e0BA9E64EC7ae77dbD4fE8A46f",
+  diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
   router: "0x813d3D1A3154950E2f1d8718305426a335A974A9",
-  apUSD: "0x1977097E2E5697A6DD91b6732F368a14F50f6B3d",
-  xBNB: "0xB78eB4d5928bAb158Eb23c3154544084cD2661d5",
-  sApUSD: "0xE2BE739C4aA4126ee72D612d9548C38B1B0e5A1b",
+  apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
+  xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
+  sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF",
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B",
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6",
-  wclisBNB: "0x439faaC2229559121C4Ad4fd8B3FE13Dff038046",
+  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108",
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955",
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",

package/dist/index.mjs

@@ -476,6 +476,30 @@ var DiamondABI = [
     outputs: [{ name: "", type: "bool", internalType: "bool" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "bootstrap",
+    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: "isBootstrapped",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getBootstrapXBNBAmount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
   // ============ StabilityModeFacet ============
   {
     type: "function",
@@ -508,6 +532,13 @@ var DiamondABI = [
     ],
     stateMutability: "nonpayable"
   },
+  {
+    type: "function",
+    name: "cleanXbnb",
+    inputs: [{ name: "_xBNBAmount", type: "uint256", internalType: "uint256" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
   // ============ StabilityModeFacet Events ============
   {
     type: "event",
@@ -527,6 +558,48 @@ var DiamondABI = [
     inputs: [],
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
+  },
+  // ============ Fee Manager ============
+  {
+    type: "function",
+    name: "setFeeManager",
+    inputs: [{ name: "_feeManager", type: "address", internalType: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "getFeeManager",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "setFeeTiers",
+    inputs: [{
+      name: "_tiers",
+      type: "tuple[]",
+      internalType: "struct LibAppStorage.FeeTier[]",
+      components: [
+        { 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" }
+      ]
+    }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "FeeManagerSet",
+    inputs: [
+      { name: "feeManager", type: "address", indexed: true, internalType: "address" }
+    ],
+    anonymous: false
   }
 ];
 
@@ -1171,6 +1244,29 @@ var AspanReadClient = class _AspanReadClient {
       functionName: "isPaused"
     });
   }
+  // ============ Bootstrap View Functions ============
+  /**
+   * Check if xBNB liquidity has been bootstrapped
+   * @returns true if bootstrap has been called
+   */
+  async isBootstrapped() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "isBootstrapped"
+    });
+  }
+  /**
+   * Get the amount of xBNB locked in bootstrap (burned to dead address)
+   * @returns xBNB amount in wei
+   */
+  async getBootstrapXBNBAmount() {
+    return this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "getBootstrapXBNBAmount"
+    });
+  }
   // ============ Stability Mode View Functions ============
   async getStabilityMode() {
     try {
@@ -1370,6 +1466,75 @@ var AspanClient = class extends AspanReadClient {
       functionName: "harvestYield"
     });
   }
+  // ============ Risk Management Functions ============
+  /**
+   * Trigger Stability Mode 2 forced conversion
+   * @description Anyone can call when CR < 130%. Burns apUSD from stability pool
+   * and mints xBNB to compensate stakers.
+   * @param targetCR Target CR to restore to (in BPS, e.g., 14000 = 140%)
+   * @returns Transaction hash
+   */
+  async triggerStabilityMode2(targetCR = 14000n) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "triggerStabilityMode2",
+      args: [targetCR]
+    });
+  }
+  /**
+   * Clean underwater xBNB (burn without getting LST back)
+   * @description Only works when xBNB is underwater (price = 0)
+   * @param xBNBAmount Amount of xBNB to clean (burn)
+   * @returns Transaction hash
+   */
+  async cleanXbnb(xBNBAmount) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "cleanXbnb",
+      args: [xBNBAmount]
+    });
+  }
+  // ============ Fee Management Functions ============
+  /**
+   * Set fee tiers (requires feeManager or owner role)
+   * @param tiers Array of fee tier configurations
+   * @returns Transaction hash
+   */
+  async setFeeTiers(tiers) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "setFeeTiers",
+      args: [tiers]
+    });
+  }
+  // ============ Admin Functions ============
+  /**
+   * Bootstrap xBNB liquidity (owner only)
+   * @description Initializes xBNB supply by minting to dead address, preventing extreme initial prices.
+   * Similar to Uniswap V2's MINIMUM_LIQUIDITY. Can only be called once.
+   * @param lstToken LST token address to deposit
+   * @param lstAmount Amount of LST to deposit for bootstrap
+   * @returns Transaction hash
+   */
+  async bootstrap(lstToken, lstAmount) {
+    return this.walletClient.writeContract({
+      chain: this.chain,
+      account: this.walletClient.account,
+      address: this.diamondAddress,
+      abi: DiamondABI,
+      functionName: "bootstrap",
+      args: [lstToken, lstAmount]
+    });
+  }
   // ============ Transaction Helpers ============
   /**
    * Wait for transaction confirmation
@@ -2200,15 +2365,15 @@ var PRECISION = 10n ** 18n;
 var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
-  diamond: "0x10d25Ae0690533e0BA9E64EC7ae77dbD4fE8A46f",
+  diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
   router: "0x813d3D1A3154950E2f1d8718305426a335A974A9",
-  apUSD: "0x1977097E2E5697A6DD91b6732F368a14F50f6B3d",
-  xBNB: "0xB78eB4d5928bAb158Eb23c3154544084cD2661d5",
-  sApUSD: "0xE2BE739C4aA4126ee72D612d9548C38B1B0e5A1b",
+  apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
+  xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
+  sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF",
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B",
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6",
-  wclisBNB: "0x439faaC2229559121C4Ad4fd8B3FE13Dff038046",
+  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108",
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955",
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",

package/package.json

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

package/src/__tests__/fork.test.ts

@@ -27,8 +27,8 @@ const TOKENS = {
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" as Address,
   USDT: "0x55d398326f99059fF775485246999027B3197955" as Address,
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B" as Address,
-  apUSD: "0x1977097E2E5697A6DD91b6732F368a14F50f6B3d" as Address,
-  xBNB: "0xB78eB4d5928bAb158Eb23c3154544084cD2661d5" as Address,
+  apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as Address,
+  xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as Address,
 };
 
 const ERC20_ABI = [

package/src/abi/diamond.ts

@@ -477,6 +477,30 @@ export const DiamondABI = [
     outputs: [{ name: "", type: "bool", internalType: "bool" }],
     stateMutability: "view"
   },
+  {
+    type: "function",
+    name: "bootstrap",
+    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: "isBootstrapped",
+    inputs: [],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getBootstrapXBNBAmount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
 
   // ============ StabilityModeFacet ============
   {
@@ -510,6 +534,13 @@ export const DiamondABI = [
     ],
     stateMutability: "nonpayable"
   },
+  {
+    type: "function",
+    name: "cleanXbnb",
+    inputs: [{ name: "_xBNBAmount", type: "uint256", internalType: "uint256" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
 
   // ============ StabilityModeFacet Events ============
   {
@@ -531,5 +562,48 @@ export const DiamondABI = [
     inputs: [],
     outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
+  },
+
+  // ============ Fee Manager ============
+  {
+    type: "function",
+    name: "setFeeManager",
+    inputs: [{ name: "_feeManager", type: "address", internalType: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "getFeeManager",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "setFeeTiers",
+    inputs: [{
+      name: "_tiers",
+      type: "tuple[]",
+      internalType: "struct LibAppStorage.FeeTier[]",
+      components: [
+        { 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" }
+      ]
+    }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "FeeManagerSet",
+    inputs: [
+      { name: "feeManager", type: "address", indexed: true, internalType: "address" }
+    ],
+    anonymous: false
   }
 ] as const;

package/src/abi/sApUSD.ts

@@ -0,0 +1,100 @@
+/**
+ * SApUSD (Staked ApUSD) Vault ABI
+ * Multi-asset vault for staking apUSD and absorbing xBNB during stability events
+ */
+export const SApUSDABI = [
+  // ============ View Functions ============
+  {
+    type: "function",
+    name: "totalAssets",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "totalSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "account", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "hasStabilityConversion",
+    inputs: [],
+    outputs: [
+      { name: "hasXBNB", type: "bool", internalType: "bool" },
+      { name: "xBNBAmount", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "exchangeRate",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "previewCleanXBNB",
+    inputs: [
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
+      { name: "_router", type: "address", internalType: "address" },
+      { name: "_path", type: "address[]", internalType: "address[]" }
+    ],
+    outputs: [{ name: "expectedApUSD", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "KEEPER_ROLE",
+    inputs: [],
+    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "hasRole",
+    inputs: [
+      { name: "role", type: "bytes32", internalType: "bytes32" },
+      { name: "account", type: "address", internalType: "address" }
+    ],
+    outputs: [{ name: "", type: "bool", internalType: "bool" }],
+    stateMutability: "view"
+  },
+
+  // ============ Keeper Functions ============
+  {
+    type: "function",
+    name: "cleanXBNB",
+    inputs: [
+      { name: "_xBNBAmount", type: "uint256", internalType: "uint256" },
+      { name: "_minApUSDOut", type: "uint256", internalType: "uint256" },
+      { name: "_router", type: "address", internalType: "address" },
+      { name: "_path", type: "address[]", internalType: "address[]" },
+      { name: "_deadline", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "apUSDReceived", type: "uint256", internalType: "uint256" }],
+    stateMutability: "nonpayable"
+  },
+
+  // ============ Events ============
+  {
+    type: "event",
+    name: "VaultCleaned",
+    inputs: [
+      { name: "xBNBSold", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "apUSDReceived", type: "uint256", indexed: false, internalType: "uint256" },
+      { name: "keeper", type: "address", indexed: true, internalType: "address" }
+    ],
+    anonymous: false
+  }
+] as const;