@aspan/sdk 0.4.1 → 0.4.2

package/dist/index.d.mts

@@ -385,6 +385,20 @@ interface UnstakeClaimedEvent {
     bnbAmount: bigint;
 }
 
+/** Pharos Atlantic Testnet chain definition */
+declare const pharosTestnet: Chain;
+/** Supported chain IDs */
+declare const CHAIN_IDS: {
+    readonly BSC: 56;
+    readonly BSC_TESTNET: 97;
+    readonly PHAROS: 688689;
+};
+/**
+ * Get the viem Chain object for a given chainId.
+ * @throws if the chainId is not supported
+ */
+declare function getChainById(chainId: number): Chain;
+
 interface AspanClientConfig {
     /** Diamond contract address */
     diamondAddress: Address;
@@ -404,7 +418,7 @@ interface AspanWriteClientConfig extends AspanClientConfig {
  */
 declare class AspanReadClient {
     protected readonly publicClient: PublicClient;
-    protected readonly diamondAddress: Address;
+    readonly diamondAddress: Address;
     protected readonly chain: Chain;
     private static readonly ZERO_SUPPLY_ERROR_SIGNATURES;
     constructor(config: AspanClientConfig);
@@ -591,6 +605,33 @@ declare function createAspanTestnetReadClient(diamondAddress: Address, rpcUrl?:
  * Create a full client for BSC testnet
  */
 declare function createAspanTestnetClient(diamondAddress: Address, account: Account, rpcUrl?: string): AspanClient;
+/**
+ * Create a read-only client for Pharos Atlantic Testnet
+ */
+declare function createAspanPharosReadClient(diamondAddress: Address, rpcUrl?: string): AspanReadClient;
+/**
+ * Create a full client for Pharos Atlantic Testnet
+ */
+declare function createAspanPharosClient(diamondAddress: Address, account: Account, rpcUrl?: string): AspanClient;
+/**
+ * Create a read-only Aspan client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+declare function createAspanReadClientForChain(diamondAddress: Address, chainId?: number, rpcUrl?: string): AspanReadClient;
+/**
+ * Create a write Aspan client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient   External WalletClient from wagmi / viem.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+declare function createAspanWriteClientForChain(diamondAddress: Address, chainId: number | undefined, walletClient: WalletClient<Transport, Chain, Account>, rpcUrl?: string): AspanClient;
 
 interface AspanRouterClientConfig {
     /** Router contract address */
@@ -730,6 +771,33 @@ declare function createRouterTestnetReadClient(routerAddress: Address, rpcUrl?:
  * Create a full router client for BSC testnet
  */
 declare function createRouterTestnetClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+/**
+ * Create a read-only router client for Pharos Atlantic Testnet
+ */
+declare function createRouterPharosReadClient(routerAddress: Address, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a full router client for Pharos Atlantic Testnet
+ */
+declare function createRouterPharosClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+/**
+ * Create a read-only AspanRouter client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+declare function createRouterReadClientForChain(routerAddress: Address, chainId?: number, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a write AspanRouter client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient  External WalletClient from wagmi / viem.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+declare function createRouterWriteClientForChain(routerAddress: Address, chainId: number | undefined, walletClient: WalletClient<Transport, Chain, Account>, rpcUrl?: string): AspanRouterClient;
 
 /**
  * Combined Diamond ABI - includes all facet functions
@@ -2574,7 +2642,7 @@ declare const BPS_PRECISION = 10000n;
 declare const PRICE_PRECISION: bigint;
 declare const BSC_ADDRESSES: {
     readonly diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78";
-    readonly router: "0x813d3D1A3154950E2f1d8718305426a335A974A9";
+    readonly router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6";
     readonly apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287";
     readonly xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43";
     readonly sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF";
@@ -2585,6 +2653,15 @@ declare const BSC_ADDRESSES: {
     readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
     readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 };
+declare const PHAROS_ADDRESSES: {
+    readonly diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8";
+    readonly apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4";
+    readonly xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576";
+    readonly sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8";
+    readonly mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18";
+    readonly mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682";
+    readonly mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9";
+};
 /**
  * Format a bigint amount to human-readable string with decimals
  * @param amount Amount in wei (18 decimals)
@@ -2625,4 +2702,4 @@ declare function formatPriceUSD(price: bigint): string;
  */
 declare function calculateAPY(previousRate: bigint, currentRate: bigint, periodDays: number): number;
 
-export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanReadClient, createAspanTestnetClient, createAspanTestnetReadClient, createRouterClient, createRouterReadClient, createRouterTestnetClient, createRouterTestnetReadClient, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, parseAmount };
+export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };

package/dist/index.d.ts

@@ -385,6 +385,20 @@ interface UnstakeClaimedEvent {
     bnbAmount: bigint;
 }
 
+/** Pharos Atlantic Testnet chain definition */
+declare const pharosTestnet: Chain;
+/** Supported chain IDs */
+declare const CHAIN_IDS: {
+    readonly BSC: 56;
+    readonly BSC_TESTNET: 97;
+    readonly PHAROS: 688689;
+};
+/**
+ * Get the viem Chain object for a given chainId.
+ * @throws if the chainId is not supported
+ */
+declare function getChainById(chainId: number): Chain;
+
 interface AspanClientConfig {
     /** Diamond contract address */
     diamondAddress: Address;
@@ -404,7 +418,7 @@ interface AspanWriteClientConfig extends AspanClientConfig {
  */
 declare class AspanReadClient {
     protected readonly publicClient: PublicClient;
-    protected readonly diamondAddress: Address;
+    readonly diamondAddress: Address;
     protected readonly chain: Chain;
     private static readonly ZERO_SUPPLY_ERROR_SIGNATURES;
     constructor(config: AspanClientConfig);
@@ -591,6 +605,33 @@ declare function createAspanTestnetReadClient(diamondAddress: Address, rpcUrl?:
  * Create a full client for BSC testnet
  */
 declare function createAspanTestnetClient(diamondAddress: Address, account: Account, rpcUrl?: string): AspanClient;
+/**
+ * Create a read-only client for Pharos Atlantic Testnet
+ */
+declare function createAspanPharosReadClient(diamondAddress: Address, rpcUrl?: string): AspanReadClient;
+/**
+ * Create a full client for Pharos Atlantic Testnet
+ */
+declare function createAspanPharosClient(diamondAddress: Address, account: Account, rpcUrl?: string): AspanClient;
+/**
+ * Create a read-only Aspan client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+declare function createAspanReadClientForChain(diamondAddress: Address, chainId?: number, rpcUrl?: string): AspanReadClient;
+/**
+ * Create a write Aspan client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient   External WalletClient from wagmi / viem.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+declare function createAspanWriteClientForChain(diamondAddress: Address, chainId: number | undefined, walletClient: WalletClient<Transport, Chain, Account>, rpcUrl?: string): AspanClient;
 
 interface AspanRouterClientConfig {
     /** Router contract address */
@@ -730,6 +771,33 @@ declare function createRouterTestnetReadClient(routerAddress: Address, rpcUrl?:
  * Create a full router client for BSC testnet
  */
 declare function createRouterTestnetClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+/**
+ * Create a read-only router client for Pharos Atlantic Testnet
+ */
+declare function createRouterPharosReadClient(routerAddress: Address, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a full router client for Pharos Atlantic Testnet
+ */
+declare function createRouterPharosClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+/**
+ * Create a read-only AspanRouter client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+declare function createRouterReadClientForChain(routerAddress: Address, chainId?: number, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a write AspanRouter client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient  External WalletClient from wagmi / viem.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+declare function createRouterWriteClientForChain(routerAddress: Address, chainId: number | undefined, walletClient: WalletClient<Transport, Chain, Account>, rpcUrl?: string): AspanRouterClient;
 
 /**
  * Combined Diamond ABI - includes all facet functions
@@ -2574,7 +2642,7 @@ declare const BPS_PRECISION = 10000n;
 declare const PRICE_PRECISION: bigint;
 declare const BSC_ADDRESSES: {
     readonly diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78";
-    readonly router: "0x813d3D1A3154950E2f1d8718305426a335A974A9";
+    readonly router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6";
     readonly apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287";
     readonly xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43";
     readonly sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF";
@@ -2585,6 +2653,15 @@ declare const BSC_ADDRESSES: {
     readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
     readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 };
+declare const PHAROS_ADDRESSES: {
+    readonly diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8";
+    readonly apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4";
+    readonly xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576";
+    readonly sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8";
+    readonly mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18";
+    readonly mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682";
+    readonly mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9";
+};
 /**
  * Format a bigint amount to human-readable string with decimals
  * @param amount Amount in wei (18 decimals)
@@ -2625,4 +2702,4 @@ declare function formatPriceUSD(price: bigint): string;
  */
 declare function calculateAPY(previousRate: bigint, currentRate: bigint, periodDays: number): number;
 
-export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanReadClient, createAspanTestnetClient, createAspanTestnetReadClient, createRouterClient, createRouterReadClient, createRouterTestnetClient, createRouterTestnetReadClient, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, parseAmount };
+export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, BSC_ADDRESSES, type BigIntString, CHAIN_IDS, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PHAROS_ADDRESSES, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintEvent, type RouterMintParams, type RouterMintParams2, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemEvent, type RouterRedeemParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanPharosClient, createAspanPharosReadClient, createAspanReadClient, createAspanReadClientForChain, createAspanTestnetClient, createAspanTestnetReadClient, createAspanWriteClientForChain, createRouterClient, createRouterPharosClient, createRouterPharosReadClient, createRouterReadClient, createRouterReadClientForChain, createRouterTestnetClient, createRouterTestnetReadClient, createRouterWriteClientForChain, encodeV3Path, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, getChainById, parseAmount, pharosTestnet };

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);
 
@@ -650,6 +662,32 @@ var DiamondABI = [
 ];
 
 // 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;
@@ -1621,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");
@@ -2387,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) {
@@ -2407,7 +2491,7 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x813d3D1A3154950E2f1d8718305426a335A974A9",
+  router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF",
@@ -2420,6 +2504,15 @@ var BSC_ADDRESSES = {
   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;
@@ -2459,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
 });

package/dist/index.mjs

@@ -604,6 +604,32 @@ var DiamondABI = [
 ];
 
 // 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;
@@ -1575,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 {
@@ -2346,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) {
@@ -2366,7 +2438,7 @@ var BPS_PRECISION = 10000n;
 var PRICE_PRECISION = 10n ** 8n;
 var BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78",
-  router: "0x813d3D1A3154950E2f1d8718305426a335A974A9",
+  router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6",
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287",
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43",
   sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF",
@@ -2379,6 +2451,15 @@ var BSC_ADDRESSES = {
   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;
@@ -2417,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.1",
+  "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/bot/services/risk-keeper.ts

@@ -405,53 +405,51 @@ export class RiskKeeperService {
   }
 
   private async executeVaultClean(xBNBAmount: bigint): Promise<Hash> {
-    console.log(`[RiskKeeper] Cleaning ${xBNBAmount} xBNB from vault`);
-
-    // Build swap path: xBNB -> WBNB -> apUSD
-    // Note: In production, might need xBNB -> WBNB -> USDT -> apUSD
-    const path = [
-      await this.getXBNBAddress(),
-      this.keeperConfig.wbnbAddress,
-      await this.getApUSDAddress(),
-    ];
+    console.log(`[RiskKeeper] Cleaning ${xBNBAmount} xBNB from vault via Diamond internal conversion`);
 
     // Preview output
-    const expectedOut = await this.previewClean(xBNBAmount, path);
+    const expectedOut = await this.previewClean(xBNBAmount);
 
     // Calculate min out with slippage
     const minOut = (expectedOut * BigInt(10000 - this.MAX_SLIPPAGE_BPS)) / 10000n;
 
-    // Deadline: 5 minutes from now
-    const deadline = BigInt(Math.floor(Date.now() / 1000) + 300);
+    console.log(`[RiskKeeper] Expected apUSD out: ${Number(expectedOut) / 1e18}, min: ${Number(minOut) / 1e18}`);
 
+    // Call Diamond's cleanVaultXBNB (internal burn xBNB + mint apUSD)
     return this.walletClient.writeContract({
       chain: bsc,
-      account: this.account,      address: this.keeperConfig.sApUSDAddress,
-      abi: SApUSDABI,
-      functionName: "cleanXBNB",
-      args: [xBNBAmount, minOut, this.keeperConfig.routerAddress, path, deadline],
+      account: this.account,
+      address: this.client.diamondAddress,
+      abi: [{
+        type: "function",
+        name: "cleanVaultXBNB",
+        inputs: [
+          { name: "_xBNBAmount", type: "uint256" },
+          { name: "_minApUSDOut", type: "uint256" },
+        ],
+        outputs: [{ name: "apUSDMinted", type: "uint256" }],
+        stateMutability: "nonpayable",
+      }],
+      functionName: "cleanVaultXBNB",
+      args: [xBNBAmount, minOut],
     });
   }
 
-  private async previewClean(xBNBAmount: bigint, path: Address[]): Promise<bigint> {
+  private async previewClean(xBNBAmount: bigint): Promise<bigint> {
     return this.publicClient.readContract({
-      address: this.keeperConfig.sApUSDAddress,
-      abi: SApUSDABI,
-      functionName: "previewCleanXBNB",
-      args: [xBNBAmount, this.keeperConfig.routerAddress, path],
+      address: this.client.diamondAddress,
+      abi: [{
+        type: "function",
+        name: "previewCleanVaultXBNB",
+        inputs: [{ name: "_xBNBAmount", type: "uint256" }],
+        outputs: [{ name: "apUSDOut", type: "uint256" }],
+        stateMutability: "view",
+      }],
+      functionName: "previewCleanVaultXBNB",
+      args: [xBNBAmount],
     });
   }
 
-  private async getXBNBAddress(): Promise<Address> {
-    const tokens = await this.client.getTokens();
-    return tokens.xBNB;
-  }
-
-  private async getApUSDAddress(): Promise<Address> {
-    const tokens = await this.client.getTokens();
-    return tokens.apUSD;
-  }
-
   // ============ Notifications ============
 
   private async notifySM2Success(cr: bigint, amount: bigint, txHash: Hash): Promise<void> {

package/src/client.ts

@@ -16,6 +16,43 @@ import {
   type Hash,
 } from "viem";
 import { bsc, bscTestnet } from "viem/chains";
+
+/** Pharos Atlantic Testnet chain definition */
+export const pharosTestnet: Chain = {
+  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" },
+  },
+} as const satisfies Chain;
+
+/** Supported chain IDs */
+export const CHAIN_IDS = {
+  BSC: 56,
+  BSC_TESTNET: 97,
+  PHAROS: 688689,
+} as const;
+
+/** Internal: map chainId to viem Chain object */
+const CHAIN_MAP: Record<number, Chain> = {
+  [CHAIN_IDS.BSC]: bsc,
+  [CHAIN_IDS.BSC_TESTNET]: bscTestnet,
+  [CHAIN_IDS.PHAROS]: pharosTestnet,
+};
+
+/**
+ * Get the viem Chain object for a given chainId.
+ * @throws if the chainId is not supported
+ */
+export function getChainById(chainId: number): Chain {
+  const chain = CHAIN_MAP[chainId];
+  if (!chain) throw new Error(`[Aspan SDK] Unsupported chainId: ${chainId}`);
+  return chain;
+}
 import { DiamondABI } from "./abi/diamond";
 import type {
   LSTInfo,
@@ -65,7 +102,7 @@ export interface AspanWriteClientConfig extends AspanClientConfig {
  */
 export class AspanReadClient {
   protected readonly publicClient: PublicClient;
-  protected readonly diamondAddress: Address;
+  public readonly diamondAddress: Address;
   protected readonly chain: Chain;
 
   // Known error signatures for zero supply states
@@ -1213,3 +1250,71 @@ export function createAspanTestnetClient(
     rpcUrl,
   });
 }
+
+/**
+ * Create a read-only client for Pharos Atlantic Testnet
+ */
+export function createAspanPharosReadClient(
+  diamondAddress: Address,
+  rpcUrl?: string
+): AspanReadClient {
+  return new AspanReadClient({
+    diamondAddress,
+    chain: pharosTestnet,
+    rpcUrl,
+  });
+}
+
+/**
+ * Create a full client for Pharos Atlantic Testnet
+ */
+export function createAspanPharosClient(
+  diamondAddress: Address,
+  account: Account,
+  rpcUrl?: string
+): AspanClient {
+  return new AspanClient({
+    diamondAddress,
+    account,
+    chain: pharosTestnet,
+    rpcUrl,
+  });
+}
+
+// ============ Chain-ID-based Factory Functions ============
+
+/**
+ * Create a read-only Aspan client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+export function createAspanReadClientForChain(
+  diamondAddress: Address,
+  chainId: number = CHAIN_IDS.BSC,
+  rpcUrl?: string
+): AspanReadClient {
+  const chain = getChainById(chainId);
+  return new AspanReadClient({ diamondAddress, chain, rpcUrl });
+}
+
+/**
+ * Create a write Aspan client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param diamondAddress Diamond contract address for the target chain.
+ * @param chainId        Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient   External WalletClient from wagmi / viem.
+ * @param rpcUrl         Optional custom RPC endpoint.
+ */
+export function createAspanWriteClientForChain(
+  diamondAddress: Address,
+  chainId: number = CHAIN_IDS.BSC,
+  walletClient: WalletClient<Transport, Chain, Account>,
+  rpcUrl?: string
+): AspanClient {
+  const chain = getChainById(chainId);
+  return new AspanClient({ diamondAddress, chain, walletClient, rpcUrl });
+}

package/src/index.ts

@@ -13,6 +13,15 @@ export {
   createAspanClient,
   createAspanTestnetReadClient,
   createAspanTestnetClient,
+  createAspanPharosReadClient,
+  createAspanPharosClient,
+  // Chain-ID-based factory functions
+  createAspanReadClientForChain,
+  createAspanWriteClientForChain,
+  // Chain helpers
+  pharosTestnet,
+  CHAIN_IDS,
+  getChainById,
   type AspanClientConfig,
   type AspanWriteClientConfig,
 } from "./client";
@@ -25,6 +34,11 @@ export {
   createRouterClient,
   createRouterTestnetReadClient,
   createRouterTestnetClient,
+  createRouterPharosReadClient,
+  createRouterPharosClient,
+  // Chain-ID-based factory functions
+  createRouterReadClientForChain,
+  createRouterWriteClientForChain,
   type AspanRouterClientConfig,
   type AspanRouterWriteClientConfig,
 } from "./router";
@@ -103,7 +117,7 @@ export const PRICE_PRECISION = 10n ** 8n; // Chainlink price precision
 // ============ Contract Addresses (BSC Mainnet) ============
 export const BSC_ADDRESSES = {
   diamond: "0x6a11B30d3a70727d5477D6d8090e144443fA1c78" as const,
-  router: "0x813d3D1A3154950E2f1d8718305426a335A974A9" as const,
+  router: "0x29dd49b2e98674ee7531f17e4d40a7725918c3f6" as const,
   apUSD: "0x4570047eeB5aDb4081c5d470494EB5134e34A287" as const,
   xBNB: "0x0A0c9CD826e747D99F90D63e780B3727Da4D0d43" as const,
   sApUSD: "0x73407A291c007a47CC926EcD5CaC256A1E2d00cF" as const,
@@ -117,6 +131,16 @@ export const BSC_ADDRESSES = {
   WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c" as const,
 } as const;
 
+export const PHAROS_ADDRESSES = {
+  diamond: "0x67011Ce4B5E534FA78dD9922559B7005197DBcc8" as const,
+  apUSD: "0x82ac96db027772cE8a770e099370b5D7941B3ae4" as const,
+  xBNB: "0xFF43b2f50b2c6c588d14Ea4565Ee5Eb93e438576" as const,
+  sApUSD: "0xFA4B826CfD5faaAfA48E4963d8a7d6Cf9889A9A8" as const,
+  mockLST: "0xc7BB55759e8e04AfAA620De96E9E133B1FAd3e18" as const,
+  mockPriceFeed: "0xa2B41DDE7a7BB0A897DE476Ea441fB27A6978682" as const,
+  mockExchangeRate: "0xffA1938e072Ea3b144EA7e61662dd8B0818D82B9" as const,
+} as const;
+
 // ============ Utility Functions ============
 
 /**

package/src/router.ts

@@ -18,6 +18,7 @@ import {
   type Hash,
 } from "viem";
 import { bsc, bscTestnet } from "viem/chains";
+import { pharosTestnet, CHAIN_IDS, getChainById } from "./client";
 import { RouterABI } from "./abi/router";
 import type {
   SwapAndMintParams,
@@ -514,3 +515,71 @@ export function createRouterTestnetClient(
     rpcUrl,
   });
 }
+
+/**
+ * Create a read-only router client for Pharos Atlantic Testnet
+ */
+export function createRouterPharosReadClient(
+  routerAddress: Address,
+  rpcUrl?: string
+): AspanRouterReadClient {
+  return new AspanRouterReadClient({
+    routerAddress,
+    chain: pharosTestnet,
+    rpcUrl,
+  });
+}
+
+/**
+ * Create a full router client for Pharos Atlantic Testnet
+ */
+export function createRouterPharosClient(
+  routerAddress: Address,
+  account: Account,
+  rpcUrl?: string
+): AspanRouterClient {
+  return new AspanRouterClient({
+    routerAddress,
+    account,
+    chain: pharosTestnet,
+    rpcUrl,
+  });
+}
+
+// ============ Chain-ID-based Factory Functions ============
+
+/**
+ * Create a read-only AspanRouter client by chainId.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+export function createRouterReadClientForChain(
+  routerAddress: Address,
+  chainId: number = CHAIN_IDS.BSC,
+  rpcUrl?: string
+): AspanRouterReadClient {
+  const chain = getChainById(chainId);
+  return new AspanRouterReadClient({ routerAddress, chain, rpcUrl });
+}
+
+/**
+ * Create a write AspanRouter client by chainId using an external wagmi WalletClient.
+ * Defaults to BSC mainnet (chainId = 56) if chainId is not provided.
+ *
+ * @param routerAddress Router contract address for the target chain.
+ * @param chainId       Target chain ID (56 = BSC, 688689 = Pharos). Defaults to 56.
+ * @param walletClient  External WalletClient from wagmi / viem.
+ * @param rpcUrl        Optional custom RPC endpoint.
+ */
+export function createRouterWriteClientForChain(
+  routerAddress: Address,
+  chainId: number = CHAIN_IDS.BSC,
+  walletClient: WalletClient<Transport, Chain, Account>,
+  rpcUrl?: string
+): AspanRouterClient {
+  const chain = getChainById(chainId);
+  return new AspanRouterClient({ routerAddress, chain, walletClient, rpcUrl });
+}