@aspan/sdk 0.4.0 → 0.4.2

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,10 +558,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]: bsc,
+  [CHAIN_IDS.BSC_TESTNET]: 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;
@@ -1171,6 +1270,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 +1492,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
@@ -1410,6 +1601,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
 import {
@@ -2181,6 +2395,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) {
@@ -2200,20 +2437,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;
@@ -2252,23 +2498,35 @@ export {
   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
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspan/sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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;

package/src/bot/config.ts

@@ -32,6 +32,29 @@ export interface BotConfig {
   maxRetries: number;
   retryDelayMs: number;
   retryBackoffMultiplier: number;
+
+  // Risk Keeper Configuration (optional)
+  riskKeeper?: {
+    enabled: boolean;
+    sApUSDAddress: Address;
+    routerAddress: Address;
+    wbnbAddress: Address;
+    privateKey: `0x${string}`;
+    sm2CooldownMs: number;
+    sm2MaxPoolPercent: number;
+    twapIntervalMs: number;
+    twapPercentage: number;
+    maxSlippageBps: number;
+    twapStartCR: bigint;
+    maxVolatilityPercent: number;
+  };
+
+  // Fee Manager Configuration (optional)
+  feeManager?: {
+    enabled: boolean;
+    privateKey: `0x${string}`;
+    checkIntervalMs: number;
+  };
 }
 
 export function loadConfig(): BotConfig {
@@ -50,7 +73,7 @@ export function loadConfig(): BotConfig {
 
     // Contract
     diamondAddress: (process.env.DIAMOND_ADDRESS ??
-      "0x10d25Ae0690533e0BA9E64EC7ae77dbD4fE8A46f") as Address,
+      "0x6a11B30d3a70727d5477D6d8090e144443fA1c78") as Address,
 
     // Intervals
     statsReportInterval: parseInt(
@@ -80,5 +103,32 @@ export function loadConfig(): BotConfig {
     maxRetries: parseInt(process.env.MAX_RETRIES ?? "3", 10),
     retryDelayMs: parseInt(process.env.RETRY_DELAY_MS ?? "1000", 10),
     retryBackoffMultiplier: parseFloat(process.env.RETRY_BACKOFF ?? "2"),
+
+    // Risk Keeper (optional - only enabled if private key is provided)
+    riskKeeper: process.env.KEEPER_PRIVATE_KEY
+      ? {
+          enabled: process.env.RISK_KEEPER_ENABLED === "true",
+          sApUSDAddress: (process.env.SAPUSD_ADDRESS ?? "") as Address,
+          routerAddress: (process.env.ROUTER_ADDRESS ?? "0x10ED43C718714eb63d5aA57B78B54704E256024E") as Address, // PancakeSwap V2
+          wbnbAddress: (process.env.WBNB_ADDRESS ?? "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c") as Address,
+          privateKey: process.env.KEEPER_PRIVATE_KEY as `0x${string}`,
+          sm2CooldownMs: parseInt(process.env.SM2_COOLDOWN_MS ?? "1800000", 10), // 30 min
+          sm2MaxPoolPercent: parseInt(process.env.SM2_MAX_POOL_PERCENT ?? "40", 10), // 40%
+          twapIntervalMs: parseInt(process.env.TWAP_INTERVAL_MS ?? "600000", 10), // 10 min
+          twapPercentage: parseInt(process.env.TWAP_PERCENTAGE ?? "5", 10), // 5%
+          maxSlippageBps: parseInt(process.env.MAX_SLIPPAGE_BPS ?? "50", 10), // 0.5%
+          twapStartCR: BigInt(process.env.TWAP_START_CR ?? "13500"), // 135%
+          maxVolatilityPercent: parseInt(process.env.MAX_VOLATILITY_PERCENT ?? "5", 10), // 5%
+        }
+      : undefined,
+
+    // Fee Manager (optional - uses same or different private key)
+    feeManager: process.env.FEE_MANAGER_ENABLED === "true" && process.env.FEE_MANAGER_PRIVATE_KEY
+      ? {
+          enabled: true,
+          privateKey: process.env.FEE_MANAGER_PRIVATE_KEY as `0x${string}`,
+          checkIntervalMs: parseInt(process.env.FEE_CHECK_INTERVAL_MS ?? "60000", 10), // 1 min
+        }
+      : undefined,
   };
 }