@aspan/sdk 0.4.0 → 0.4.2

package/dist/index.js

@@ -26,25 +26,37 @@ __export(index_exports, {
   AspanRouterReadClient: () => AspanRouterReadClient,
   BPS_PRECISION: () => BPS_PRECISION,
   BSC_ADDRESSES: () => BSC_ADDRESSES,
+  CHAIN_IDS: () => CHAIN_IDS,
   DiamondABI: () => DiamondABI,
+  PHAROS_ADDRESSES: () => PHAROS_ADDRESSES,
   PRECISION: () => PRECISION,
   PRICE_PRECISION: () => PRICE_PRECISION,
   RouterABI: () => RouterABI,
   calculateAPY: () => calculateAPY,
   createAspanClient: () => createAspanClient,
+  createAspanPharosClient: () => createAspanPharosClient,
+  createAspanPharosReadClient: () => createAspanPharosReadClient,
   createAspanReadClient: () => createAspanReadClient,
+  createAspanReadClientForChain: () => createAspanReadClientForChain,
   createAspanTestnetClient: () => createAspanTestnetClient,
   createAspanTestnetReadClient: () => createAspanTestnetReadClient,
+  createAspanWriteClientForChain: () => createAspanWriteClientForChain,
   createRouterClient: () => createRouterClient,
+  createRouterPharosClient: () => createRouterPharosClient,
+  createRouterPharosReadClient: () => createRouterPharosReadClient,
   createRouterReadClient: () => createRouterReadClient,
+  createRouterReadClientForChain: () => createRouterReadClientForChain,
   createRouterTestnetClient: () => createRouterTestnetClient,
   createRouterTestnetReadClient: () => createRouterTestnetReadClient,
+  createRouterWriteClientForChain: () => createRouterWriteClientForChain,
   encodeV3Path: () => encodeV3Path,
   formatAmount: () => formatAmount,
   formatCR: () => formatCR,
   formatFeeBPS: () => formatFeeBPS,
   formatPriceUSD: () => formatPriceUSD,
-  parseAmount: () => parseAmount
+  getChainById: () => getChainById,
+  parseAmount: () => parseAmount,
+  pharosTestnet: () => pharosTestnet
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -522,6 +534,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 +590,13 @@ var DiamondABI = [
     ],
     stateMutability: "nonpayable"
   },
+  {
+    type: "function",
+    name: "cleanXbnb",
+    inputs: [{ name: "_xBNBAmount", type: "uint256", internalType: "uint256" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
   // ============ StabilityModeFacet Events ============
   {
     type: "event",
@@ -573,10 +616,78 @@ 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
   }
 ];
 
 // src/client.ts
+var pharosTestnet = {
+  id: 688689,
+  name: "Pharos Atlantic Testnet",
+  nativeCurrency: { name: "PHRS", symbol: "PHRS", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://atlantic.dplabs-internal.com"] }
+  },
+  blockExplorers: {
+    default: { name: "Pharos Explorer", url: "https://atlantic.pharosscan.xyz" }
+  }
+};
+var CHAIN_IDS = {
+  BSC: 56,
+  BSC_TESTNET: 97,
+  PHAROS: 688689
+};
+var CHAIN_MAP = {
+  [CHAIN_IDS.BSC]: import_chains.bsc,
+  [CHAIN_IDS.BSC_TESTNET]: import_chains.bscTestnet,
+  [CHAIN_IDS.PHAROS]: pharosTestnet
+};
+function getChainById(chainId) {
+  const chain = CHAIN_MAP[chainId];
+  if (!chain) throw new Error(`[Aspan SDK] Unsupported chainId: ${chainId}`);
+  return chain;
+}
 var AspanReadClient = class _AspanReadClient {
   publicClient;
   diamondAddress;
@@ -1217,6 +1328,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 +1550,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
@@ -1456,6 +1659,29 @@ function createAspanTestnetClient(diamondAddress, account, rpcUrl) {
     rpcUrl
   });
 }
+function createAspanPharosReadClient(diamondAddress, rpcUrl) {
+  return new AspanReadClient({
+    diamondAddress,
+    chain: pharosTestnet,
+    rpcUrl
+  });
+}
+function createAspanPharosClient(diamondAddress, account, rpcUrl) {
+  return new AspanClient({
+    diamondAddress,
+    account,
+    chain: pharosTestnet,
+    rpcUrl
+  });
+}
+function createAspanReadClientForChain(diamondAddress, chainId = CHAIN_IDS.BSC, rpcUrl) {
+  const chain = getChainById(chainId);
+  return new AspanReadClient({ diamondAddress, chain, rpcUrl });
+}
+function createAspanWriteClientForChain(diamondAddress, chainId = CHAIN_IDS.BSC, walletClient, rpcUrl) {
+  const chain = getChainById(chainId);
+  return new AspanClient({ diamondAddress, chain, walletClient, rpcUrl });
+}
 
 // src/router.ts
 var import_viem2 = require("viem");
@@ -2222,6 +2448,29 @@ function createRouterTestnetClient(routerAddress, account, rpcUrl) {
     rpcUrl
   });
 }
+function createRouterPharosReadClient(routerAddress, rpcUrl) {
+  return new AspanRouterReadClient({
+    routerAddress,
+    chain: pharosTestnet,
+    rpcUrl
+  });
+}
+function createRouterPharosClient(routerAddress, account, rpcUrl) {
+  return new AspanRouterClient({
+    routerAddress,
+    account,
+    chain: pharosTestnet,
+    rpcUrl
+  });
+}
+function createRouterReadClientForChain(routerAddress, chainId = CHAIN_IDS.BSC, rpcUrl) {
+  const chain = getChainById(chainId);
+  return new AspanRouterReadClient({ routerAddress, chain, rpcUrl });
+}
+function createRouterWriteClientForChain(routerAddress, chainId = CHAIN_IDS.BSC, walletClient, rpcUrl) {
+  const chain = getChainById(chainId);
+  return new AspanRouterClient({ routerAddress, chain, walletClient, rpcUrl });
+}
 
 // src/types.ts
 function encodeV3Path(tokens, fees) {
@@ -2241,20 +2490,29 @@ var PRECISION = 10n ** 18n;
 var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
-  diamond: "0x10d25Ae0690533e0BA9E64EC7ae77dbD4fE8A46f",
-  router: "0x813d3D1A3154950E2f1d8718305426a335A974A9",
-  apUSD: "0x1977097E2E5697A6DD91b6732F368a14F50f6B3d",
-  xBNB: "0xB78eB4d5928bAb158Eb23c3154544084cD2661d5",
-  sApUSD: "0xE2BE739C4aA4126ee72D612d9548C38B1B0e5A1b",
+  diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
+  router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6",
+  apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
+  xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
+  sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF",
   // LSTs
   slisBNB: "0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B",
   asBNB: "0x77734e70b6E88b4d82fE632a168EDf6e700912b6",
-  wclisBNB: "0x439faaC2229559121C4Ad4fd8B3FE13Dff038046",
+  wclisBNB: "0x448f7c2fa4e5135a4a5B50879602cf3CD428e108",
   // Stablecoins
   USDT: "0x55d398326f99059fF775485246999027B3197955",
   USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
 };
+var PHAROS_ADDRESSES = {
+  diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8",
+  apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4",
+  xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576",
+  sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8",
+  mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18",
+  mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682",
+  mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9"
+};
 function formatAmount(amount, decimals = 4) {
   const divisor = 10n ** BigInt(18 - decimals);
   const scaled = amount / divisor;
@@ -2294,23 +2552,35 @@ function calculateAPY(previousRate, currentRate, periodDays) {
   AspanRouterReadClient,
   BPS_PRECISION,
   BSC_ADDRESSES,
+  CHAIN_IDS,
   DiamondABI,
+  PHAROS_ADDRESSES,
   PRECISION,
   PRICE_PRECISION,
   RouterABI,
   calculateAPY,
   createAspanClient,
+  createAspanPharosClient,
+  createAspanPharosReadClient,
   createAspanReadClient,
+  createAspanReadClientForChain,
   createAspanTestnetClient,
   createAspanTestnetReadClient,
+  createAspanWriteClientForChain,
   createRouterClient,
+  createRouterPharosClient,
+  createRouterPharosReadClient,
   createRouterReadClient,
+  createRouterReadClientForChain,
   createRouterTestnetClient,
   createRouterTestnetReadClient,
+  createRouterWriteClientForChain,
   encodeV3Path,
   formatAmount,
   formatCR,
   formatFeeBPS,
   formatPriceUSD,
-  parseAmount
+  getChainById,
+  parseAmount,
+  pharosTestnet
 });