@oydual31/more-vaults-sdk 0.3.3 → 0.4.1

package/dist/viem/index.d.ts

@@ -1,6 +1,7 @@
-import { Address, Hash, WalletClient, PublicClient } from 'viem';
+import { V as VaultAddresses, A as AsyncRequestResult, D as DepositResult, S as SpokeDepositResult, C as ComposeData, R as RedeemResult, a as CuratorVaultStatus, P as PendingAction, b as VaultAnalysis, c as VaultAssetBreakdown, d as CuratorAction, e as SubmitActionsResult } from '../spokeRoutes-B8Lnk-t4.js';
+export { f as ActionType, g as ActionTypeValue, h as AssetBalance, i as AssetInfo, j as AsyncRequestFinalResult, k as AsyncRequestStatus, l as AsyncRequestStatusInfo, B as BatchSwapParams, m as BridgeParams, n as CrossChainRequestInfo, o as DepositBlockReason, p as DepositEligibility, I as InboundRoute, q as InboundRouteWithBalance, M as MaxWithdrawable, r as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, s as OutboundRoute, t as SpokeBalance, u as SwapParams, U as UserBalances, v as UserPosition, w as VaultDistribution, x as VaultMetadata, y as VaultMode, z as VaultStatus, E as VaultSummary, F as VaultTopology, G as canDeposit, H as detectStargateOft, J as discoverVaultTopology, K as ensureAllowance, L as getAllVaultChainIds, Q as getAsyncRequestStatus, T as getAsyncRequestStatusLabel, W as getFullVaultTopology, X as getInboundRoutes, Y as getMaxWithdrawable, Z as getOutboundRoutes, _ as getUserBalances, $ as getUserBalancesForRoutes, a0 as getUserPosition, a1 as getUserPositionMultiChain, a2 as getVaultDistribution, a3 as getVaultDistributionWithTopology, a4 as getVaultMetadata, a5 as getVaultStatus, a6 as getVaultSummary, a7 as getVaultTopology, a8 as isAsyncMode, a9 as isOnHubChain, aa as previewDeposit, ab as previewRedeem, ac as quoteLzFee, ad as quoteRouteDepositFee, ae as waitForAsyncRequest, af as waitForTx } from '../spokeRoutes-B8Lnk-t4.js';
+import { WalletClient, PublicClient, Address, Hash } from 'viem';
 export { PublicClient as SdkPublicClient } from 'viem';
-export { A as AsyncRequestFinalResult, a as AsyncRequestStatus, b as AsyncRequestStatusInfo, D as DepositBlockReason, c as DepositEligibility, I as InboundRoute, d as InboundRouteWithBalance, M as MaxWithdrawable, e as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, f as OutboundRoute, S as SpokeBalance, U as UserBalances, g as UserPosition, V as VaultDistribution, h as VaultMetadata, i as VaultMode, j as VaultStatus, k as VaultSummary, l as VaultTopology, m as canDeposit, n as detectStargateOft, o as discoverVaultTopology, p as ensureAllowance, q as getAllVaultChainIds, r as getAsyncRequestStatus, s as getAsyncRequestStatusLabel, t as getFullVaultTopology, u as getInboundRoutes, v as getMaxWithdrawable, w as getOutboundRoutes, x as getUserBalances, y as getUserBalancesForRoutes, z as getUserPosition, B as getUserPositionMultiChain, C as getVaultDistribution, E as getVaultDistributionWithTopology, F as getVaultMetadata, G as getVaultStatus, H as getVaultSummary, J as getVaultTopology, K as isAsyncMode, L as isOnHubChain, P as previewDeposit, Q as previewRedeem, R as quoteLzFee, T as quoteRouteDepositFee, W as waitForAsyncRequest, X as waitForTx } from '../spokeRoutes-BIafSbQ3.js';
 
 /** EVM Chain IDs for chains supported by MoreVaults */
 declare const CHAIN_IDS: {
@@ -1613,195 +1614,6 @@ declare const LZ_ENDPOINT_ABI: readonly [{
     readonly stateMutability: "payable";
 }];
 
-interface VaultAddresses {
-    /** Hub vault address (diamond proxy) */
-    vault: Address;
-    /** MoreVaultsEscrow — holds locked tokens during async cross-chain flows */
-    escrow?: Address;
-    /** OFTAdapter for vault shares (cross-chain redeem only) */
-    shareOFT?: Address;
-    /** OFT for USDC bridging (cross-chain deposits from spoke) */
-    usdcOFT?: Address;
-    /**
-     * Expected EVM chain ID of the hub. When provided, SDK functions will
-     * throw a clear WrongChainError if the walletClient is on a different chain.
-     * Prevents silent failures when MetaMask is connected to the wrong network.
-     */
-    hubChainId?: number;
-}
-interface DepositResult {
-    txHash: Hash;
-    shares: bigint;
-}
-interface RedeemResult {
-    txHash: Hash;
-    assets: bigint;
-}
-interface AsyncRequestResult {
-    txHash: Hash;
-    /** Cross-chain request GUID to track via getRequestInfo / getFinalizationResult */
-    guid: `0x${string}`;
-}
-/**
- * ActionType enum values matching MoreVaultsLib.ActionType on-chain.
- * DEPOSIT=0, MINT=1, WITHDRAW=2, REDEEM=3, MULTI_ASSETS_DEPOSIT=4, ACCRUE_FEES=5
- */
-declare const ActionType: {
-    readonly DEPOSIT: 0;
-    readonly MINT: 1;
-    readonly WITHDRAW: 2;
-    readonly REDEEM: 3;
-    readonly MULTI_ASSETS_DEPOSIT: 4;
-    readonly ACCRUE_FEES: 5;
-};
-type ActionTypeValue = (typeof ActionType)[keyof typeof ActionType];
-/**
- * Data needed to execute a pending LZ compose on the hub chain.
- * Returned by `depositFromSpoke` when the OFT is a Stargate V2 pool,
- * because Stargate cannot forward ETH to the compose executor.
- * The SDK user must call `executeCompose()` with this data as a second TX on the hub.
- */
-interface ComposeData {
-    /** LZ Endpoint address on the hub chain */
-    endpoint: Address;
-    /** The OFT/pool address that sent the compose (Stargate pool on hub) */
-    from: Address;
-    /** MoreVaultsComposer address on the hub */
-    to: Address;
-    /** LayerZero GUID from the original OFT.send() */
-    guid: `0x${string}`;
-    /** Compose index (always 0 for single-compose messages) */
-    index: number;
-    /** The full compose message bytes (reconstructed from composeMsg + OFT header) */
-    message: `0x${string}`;
-    /** Whether this is a Stargate OFT that requires a 2-TX flow */
-    isStargate: boolean;
-    /** Hub chain ID for creating the hub wallet/public client */
-    hubChainId: number;
-    /** Hub block number just before TX1 was sent — used as search start for ComposeSent events */
-    hubBlockStart: bigint;
-}
-/**
- * Result from `depositFromSpoke`.
- * When `composeData` is present, the user must call `executeCompose()` on the hub chain.
- */
-interface SpokeDepositResult {
-    txHash: Hash;
-    guid: `0x${string}`;
-    /** Present when OFT is Stargate V2 — user must execute compose on hub as TX2 */
-    composeData?: ComposeData;
-}
-interface CrossChainRequestInfo {
-    initiator: Address;
-    timestamp: bigint;
-    actionType: number;
-    actionCallData: `0x${string}`;
-    fulfilled: boolean;
-    finalized: boolean;
-    refunded: boolean;
-    totalAssets: bigint;
-    finalizationResult: bigint;
-    amountLimit: bigint;
-}
-interface SwapParams {
-    targetContract: Address;
-    tokenIn: Address;
-    tokenOut: Address;
-    maxAmountIn: bigint;
-    minAmountOut: bigint;
-    swapCallData: `0x${string}`;
-}
-interface BatchSwapParams {
-    swaps: SwapParams[];
-}
-interface BridgeParams {
-    oftToken: Address;
-    dstEid: number;
-    amount: bigint;
-    dstVault: Address;
-    refundAddress: Address;
-}
-interface PendingAction {
-    nonce: bigint;
-    actionsData: `0x${string}`[];
-    pendingUntil: bigint;
-    isExecutable: boolean;
-}
-interface SubmitActionsResult {
-    txHash: `0x${string}`;
-    nonce: bigint;
-}
-type CuratorAction = {
-    type: 'swap';
-    params: SwapParams;
-} | {
-    type: 'batchSwap';
-    params: BatchSwapParams;
-} | {
-    type: 'erc4626Deposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc4626Redeem';
-    vault: Address;
-    shares: bigint;
-} | {
-    type: 'erc7540RequestDeposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc7540Deposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc7540RequestRedeem';
-    vault: Address;
-    shares: bigint;
-} | {
-    type: 'erc7540Redeem';
-    vault: Address;
-    shares: bigint;
-};
-interface CuratorVaultStatus {
-    curator: Address;
-    timeLockPeriod: bigint;
-    maxSlippagePercent: bigint;
-    currentNonce: bigint;
-    availableAssets: Address[];
-    lzAdapter: Address;
-    paused: boolean;
-}
-interface AssetInfo {
-    address: Address;
-    symbol: string;
-    name: string;
-    decimals: number;
-}
-interface VaultAnalysis {
-    /** All tokens the vault can hold/swap (curator-managed) */
-    availableAssets: AssetInfo[];
-    /** Tokens users can deposit */
-    depositableAssets: AssetInfo[];
-    /** Whether deposit whitelist is enabled (restricts who can deposit) */
-    depositWhitelistEnabled: boolean;
-    /** Registry address for global protocol whitelist checks */
-    registryAddress: Address | null;
-}
-interface AssetBalance extends AssetInfo {
-    /** Raw balance held by the vault */
-    balance: bigint;
-}
-interface VaultAssetBreakdown {
-    /** Per-asset balances held by the vault on the hub chain */
-    assets: AssetBalance[];
-    /** totalAssets() as reported by the vault (all positions converted to underlying) */
-    totalAssets: bigint;
-    /** totalSupply() of vault shares */
-    totalSupply: bigint;
-    /** Vault underlying token decimals */
-    underlyingDecimals: number;
-}
-
 /**
  * Typed error classes for the MoreVaults SDK.
  *
@@ -2705,4 +2517,4 @@ declare function buildUniswapV3Swap(params: {
  */
 declare function asSdkClient(client: unknown): PublicClient;
 
-export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type ComposeData, type CrossChainRequestInfo, type CuratorAction, type CuratorVaultStatus, DEX_ABI, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, type PendingAction, REGISTRY_ABI, type RedeemResult, STARGATE_TAXI_CMD, type SpokeDepositResult, type SpokeRedeemRoute, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getPendingActions, getVaultAnalysis, getVaultAssetBreakdown, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };
+export { AsyncRequestResult, BRIDGE_ABI, BRIDGE_FACET_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, ComposeData, CuratorAction, CuratorVaultStatus, DEX_ABI, DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, PendingAction, REGISTRY_ABI, RedeemResult, STARGATE_TAXI_CMD, SpokeDepositResult, type SpokeRedeemRoute, SubmitActionsResult, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, VaultAddresses, VaultAnalysis, VaultAssetBreakdown, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getPendingActions, getVaultAnalysis, getVaultAssetBreakdown, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oydual31/more-vaults-sdk",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "TypeScript SDK for MoreVaults protocol — viem/wagmi and ethers.js",
   "type": "module",
   "exports": {

package/src/ethers/abis.ts

@@ -85,3 +85,95 @@ export const LZ_ENDPOINT_ABI = [
   "function composeQueue(address from, address to, bytes32 guid, uint16 index) view returns (bytes32 messageHash)",
   "function lzCompose(address _from, address _to, bytes32 _guid, uint16 _index, bytes _message, bytes _extraData) payable",
 ] as const;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Curator Operations ABIs
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * MulticallFacet ABI — curator action submission and execution with timelock.
+ */
+export const MULTICALL_ABI = [
+  "function submitActions(bytes[] actionsData) returns (uint256 nonce)",
+  "function executeActions(uint256 actionsNonce)",
+  "function getPendingActions(uint256 actionsNonce) view returns (bytes[] actionsData, uint256 pendingUntil)",
+  "function getCurrentNonce() view returns (uint256)",
+  "function vetoActions(uint256[] actionsNonces)",
+] as const;
+
+/**
+ * GenericDexFacet ABI — single and batch token swaps through any DEX aggregator.
+ */
+export const DEX_ABI = [
+  "function executeSwap(tuple(address targetContract, address tokenIn, address tokenOut, uint256 maxAmountIn, uint256 minAmountOut, bytes swapCallData) params) returns (uint256 amountOut)",
+  "function executeBatchSwap(tuple(tuple(address targetContract, address tokenIn, address tokenOut, uint256 maxAmountIn, uint256 minAmountOut, bytes swapCallData)[] swaps) params) returns (uint256[] amountsOut)",
+] as const;
+
+/**
+ * BridgeFacet ABI — curator bridging and cross-chain request initiation.
+ */
+export const BRIDGE_FACET_ABI = [
+  "function executeBridging(address adapter, address token, uint256 amount, bytes bridgeSpecificParams) payable",
+  "function initVaultActionRequest(uint8 actionType, bytes actionCallData, uint256 amountLimit, bytes extraOptions) payable returns (bytes32 guid)",
+  "function executeRequest(bytes32 guid)",
+] as const;
+
+/**
+ * ERC7540Facet ABI — async deposit and redeem operations on ERC7540 vaults.
+ */
+export const ERC7540_FACET_ABI = [
+  "function erc7540RequestDeposit(address vault, uint256 assets) returns (uint256 requestId)",
+  "function erc7540RequestRedeem(address vault, uint256 shares) returns (uint256 requestId)",
+  "function erc7540Deposit(address vault, uint256 assets) returns (uint256 shares)",
+  "function erc7540Redeem(address vault, uint256 shares) returns (uint256 assets)",
+] as const;
+
+/**
+ * ERC4626Facet ABI — synchronous deposit and redeem into whitelisted ERC-4626 vaults.
+ */
+export const ERC4626_FACET_ABI = [
+  "function erc4626Deposit(address vault, uint256 assets) returns (uint256 shares)",
+  "function erc4626Redeem(address vault, uint256 shares) returns (uint256 assets)",
+] as const;
+
+/**
+ * ConfigurationFacet ABI — extended with curator-relevant read functions.
+ */
+export const CURATOR_CONFIG_ABI = [
+  "function curator() view returns (address)",
+  "function timeLockPeriod() view returns (uint256)",
+  "function getAvailableAssets() view returns (address[])",
+  "function getMaxSlippagePercent() view returns (uint256)",
+  "function getCrossChainAccountingManager() view returns (address)",
+  "function paused() view returns (bool)",
+] as const;
+
+/**
+ * LzAdapter ABI — fee quoting for bridge and LZ Read operations.
+ */
+export const LZ_ADAPTER_ABI = [
+  "function quoteBridgeFee(bytes bridgeSpecificParams) view returns (uint256 nativeFee)",
+  "function quoteReadFee(address[] vaults, uint32[] eids, bytes _extraOptions) view returns (tuple(uint256 nativeFee, uint256 lzTokenFee) fee)",
+] as const;
+
+/**
+ * Vault analysis ABIs — per-vault whitelist and registry reads.
+ */
+export const VAULT_ANALYSIS_ABI = [
+  "function getAvailableAssets() view returns (address[])",
+  "function getDepositableAssets() view returns (address[])",
+  "function isAssetAvailable(address asset) view returns (bool)",
+  "function isAssetDepositable(address asset) view returns (bool)",
+  "function isDepositWhitelistEnabled() view returns (bool)",
+  "function getAvailableToDeposit(address depositor) view returns (uint256)",
+  "function moreVaultsRegistry() view returns (address)",
+] as const;
+
+/**
+ * MoreVaultsRegistry ABI — global protocol and bridge whitelist checks.
+ */
+export const REGISTRY_ABI = [
+  "function isWhitelisted(address protocol) view returns (bool)",
+  "function isBridgeAllowed(address bridge) view returns (bool)",
+  "function getAllowedFacets() view returns (address[])",
+] as const;

package/src/ethers/chains.ts

@@ -1,3 +1,6 @@
+import { JsonRpcProvider } from "ethers";
+import type { Provider } from "ethers";
+
 /** EVM Chain IDs for chains supported by MoreVaults */
 export const CHAIN_IDS = {
   flowEVMMainnet: 747,
@@ -5,6 +8,9 @@ export const CHAIN_IDS = {
   arbitrum: 42161,
   base: 8453,
   ethereum: 1,
+  optimism: 10,
+  sonic: 146,
+  bsc: 56,
 } as const;
 
 /**
@@ -18,6 +24,9 @@ export const LZ_EIDS = {
   arbitrum: 30110,
   base: 30184,
   ethereum: 30101,
+  optimism: 30111,
+  sonic: 30332,
+  bsc: 30102,
 } as const;
 
 /** LayerZero EID → EVM Chain ID */
@@ -27,6 +36,9 @@ export const EID_TO_CHAIN_ID: Record<number, number> = {
   [LZ_EIDS.arbitrum]: CHAIN_IDS.arbitrum,
   [LZ_EIDS.base]: CHAIN_IDS.base,
   [LZ_EIDS.ethereum]: CHAIN_IDS.ethereum,
+  [LZ_EIDS.optimism]: CHAIN_IDS.optimism,
+  [LZ_EIDS.sonic]: CHAIN_IDS.sonic,
+  [LZ_EIDS.bsc]: CHAIN_IDS.bsc,
 };
 
 /** EVM Chain ID → LayerZero EID */
@@ -36,8 +48,187 @@ export const CHAIN_ID_TO_EID: Record<number, number> = {
   [CHAIN_IDS.arbitrum]: LZ_EIDS.arbitrum,
   [CHAIN_IDS.base]: LZ_EIDS.base,
   [CHAIN_IDS.ethereum]: LZ_EIDS.ethereum,
+  [CHAIN_IDS.optimism]: LZ_EIDS.optimism,
+  [CHAIN_IDS.sonic]: LZ_EIDS.sonic,
+  [CHAIN_IDS.bsc]: LZ_EIDS.bsc,
+};
+
+/**
+ * LayerZero v2 OFT route config per asset symbol.
+ *
+ * Each entry maps chainId → { oft, token } where:
+ *   - `oft`   = OFT contract to call send() on (pass as `spokeOFT` to depositFromSpoke)
+ *   - `token` = underlying ERC-20 the user approves before bridging
+ *               (zero address = native ETH, no approval needed)
+ *
+ * All routes verified on-chain via quoteSend() or peers(). Issuers vary per asset.
+ */
+export const OFT_ROUTES = {
+  /**
+   * stgUSDC — USDC bridged via Stargate v2.
+   * Underlying on Eth/Arb/Base/Op: native USDC. On Flow: stgUSDC (Stargate's wrapped USDC).
+   */
+  stgUSDC: {
+    [747   /* flowEVMMainnet */]: { oft: '0xAF54BE5B6eEc24d6BFACf1cce4eaF680A8239398', token: '0xF1815bd50389c46847f0Bda824eC8da914045D14' },
+    [1     /* ethereum       */]: { oft: '0xc026395860Db2d07ee33e05fE50ed7bD583189C7', token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' },
+    [42161 /* arbitrum       */]: { oft: '0xe8CDF27AcD73a434D661C84887215F7598e7d0d3', token: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831' },
+    [8453  /* base           */]: { oft: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26', token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' },
+    [10    /* optimism       */]: { oft: '0xcE8CcA271Ebc0533920C83d39F417ED6A0abB7D0', token: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85' },
+    [146   /* sonic          */]: { oft: '0xA272fFe20cFfe769CdFc4b63088DCD2C82a2D8F9', token: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894' },
+  },
+  /**
+   * USDT — USDT bridged via Stargate v2.
+   */
+  USDT: {
+    [747   /* flowEVMMainnet */]: { oft: '0xAf5191B0De278C7286d6C7CC6ab6BB8A73bA2Cd6', token: '0x674843C06FF83502ddb4D37c2E09C01cdA38cbc8' },
+    [1     /* ethereum       */]: { oft: '0x933597a323Eb81cAe705C5bC29985172fd5A3973', token: '0xdAC17F958D2ee523a2206206994597C13D831ec7' },
+    [42161 /* arbitrum       */]: { oft: '0xcE8CcA271Ebc0533920C83d39F417ED6A0abB7D0', token: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9' },
+    [10    /* optimism       */]: { oft: '0x19cFCE47eD54a88614648DC3f19A5980097007dD', token: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58' },
+  },
+  /**
+   * USDF — USD Flow OFT. Bridges PYUSD (Ethereum) ↔ USDF (Flow EVM).
+   */
+  USDF: {
+    [747   /* flowEVMMainnet */]: { oft: '0x2aabea2058b5ac2d339b163c6ab6f2b6d53aabed', token: '0x2aabea2058b5ac2d339b163c6ab6f2b6d53aabed' },
+    [1     /* ethereum       */]: { oft: '0xfa0e06b54986ad96de87a8c56fea76fbd8d493f8', token: '0x6c3ea9036406852006290770BEdFcAbA0e23A0e8' },
+  },
+  /**
+   * PYUSD — PayPal USD bridged via OFTAdapter (Paxos / LayerZero).
+   */
+  PYUSD: {
+    [747   /* flowEVMMainnet */]: { oft: '0x26d27d5AF2F6f1c14F40013C8619d97aaf015509', token: '0x99aF3EeA856556646C98c8B9b2548Fe815240750' },
+    [42161 /* arbitrum       */]: { oft: '0x3CD2b89C49D130C08f1d683225b2e5DeB63ff876', token: '0x46850aD61C2B7d64d08c9C754F45254596696984' },
+  },
+  /**
+   * WFLOW — Wrapped FLOW NativeOFTAdapter (issued by Flow Foundation).
+   */
+  WFLOW: {
+    [747   /* flowEVMMainnet */]: { oft: '0xd296588850bee2770136464ffdddd78c32f2a07c', token: '0xd296588850bee2770136464ffdddd78c32f2a07c' },
+    [1     /* ethereum       */]: { oft: '0xc1b45896b5fc9422a8f779653808297bb4f546f9', token: '0x5c147e74D63B1D31AA3Fd78Eb229B65161983B2b' },
+  },
+  /**
+   * WETH — ETH OFT via Stargate v2. underlying = native ETH (no approval needed).
+   */
+  WETH: {
+    [747   /* flowEVMMainnet */]: { oft: '0x45f1A95A4D3f3836523F5c83673c797f4d4d263B', token: '0x2F6F07CDcf3588944Bf4C42aC74ff24bF56e7590' },
+    [1     /* ethereum       */]: { oft: '0x77b2043768d28E9C9aB44E1aBfC95944bcE57931', token: '0x0000000000000000000000000000000000000000' },
+    [42161 /* arbitrum       */]: { oft: '0xA45B5130f36CDcA45667738e2a258AB09f4A5f7F', token: '0x0000000000000000000000000000000000000000' },
+    [8453  /* base           */]: { oft: '0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7', token: '0x0000000000000000000000000000000000000000' },
+  },
+  /**
+   * sUSDe — Ethena staked USDe (yield-bearing stablecoin).
+   */
+  sUSDe: {
+    [1     /* ethereum       */]: { oft: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2', token: '0x9D39A5DE30e57443BfF2A8307A4256c8797A3497' },
+    [42161 /* arbitrum       */]: { oft: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2', token: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2' },
+    [8453  /* base           */]: { oft: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2', token: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2' },
+    [10    /* optimism       */]: { oft: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2', token: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2' },
+    [56    /* bsc            */]: { oft: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2', token: '0x211cc4dd073734da055fbf44a2b4667d5e5fe5d2' },
+  },
+  /**
+   * USDe — Ethena USD stablecoin.
+   */
+  USDe: {
+    [1     /* ethereum       */]: { oft: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34', token: '0x4c9EDD5852cd905f086C759E8383e09bff1E68B3' },
+    [42161 /* arbitrum       */]: { oft: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34', token: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34' },
+    [8453  /* base           */]: { oft: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34', token: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34' },
+    [10    /* optimism       */]: { oft: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34', token: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34' },
+    [56    /* bsc            */]: { oft: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34', token: '0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34' },
+  },
+  /**
+   * weETH — Ether.Fi liquid restaking token.
+   */
+  weETH: {
+    [1     /* ethereum       */]: { oft: '0xcd2eb13d6831d4602d80e5db9230a57596cdca63', token: '0xCd5fE23C85820F7B72D0926FC9b05b43E359b7ee' },
+    [8453  /* base           */]: { oft: '0x04c0599ae5a44757c0af6f9ec3b93da8976c150a', token: '0x04c0599ae5a44757c0af6f9ec3b93da8976c150a' },
+    [10    /* optimism       */]: { oft: '0x5a7facb970d094b6c7ff1df0ea68d99e6e73cbff', token: '0x5a7facb970d094b6c7ff1df0ea68d99e6e73cbff' },
+    [56    /* bsc            */]: { oft: '0x04c0599ae5a44757c0af6f9ec3b93da8976c150a', token: '0x04c0599ae5a44757c0af6f9ec3b93da8976c150a' },
+    [146   /* sonic          */]: { oft: '0xa3d68b74bf0528fdd07263c60d6488749044914b', token: '0xa3d68b74bf0528fdd07263c60d6488749044914b' },
+  },
+  /**
+   * rsETH — Kelp DAO liquid restaking token.
+   */
+  rsETH: {
+    [1     /* ethereum       */]: { oft: '0x85d456b2dff1fd8245387c0bfb64dfb700e98ef3', token: '0xA1290d69c65A6Fe4DF752f95823fae25cB99e5A7' },
+    [42161 /* arbitrum       */]: { oft: '0x4186bfc76e2e237523cbc30fd220fe055156b41f', token: '0x4186bfc76e2e237523cbc30fd220fe055156b41f' },
+    [8453  /* base           */]: { oft: '0x1bc71130a0e39942a7658878169764bbd8a45993', token: '0x1bc71130a0e39942a7658878169764bbd8a45993' },
+    [10    /* optimism       */]: { oft: '0x4186bfc76e2e237523cbc30fd220fe055156b41f', token: '0x4186bfc76e2e237523cbc30fd220fe055156b41f' },
+    [146   /* sonic          */]: { oft: '0xd75787ba9aba324420d522bda84c08c87e5099b1', token: '0xd75787ba9aba324420d522bda84c08c87e5099b1' },
+  },
+  /**
+   * rswETH — Swell Network liquid restaking token.
+   */
+  rswETH: {
+    [1     /* ethereum       */]: { oft: '0x1486d39646cdee84619bd05997319545a8575079', token: '0xFAe103DC9cf190eD75350761e95403b7b8aFa6c0' },
+    [42161 /* arbitrum       */]: { oft: '0xb1fe27b32ffb5ce54e272c096547f1e86c19e72f', token: '0xb1fe27b32ffb5ce54e272c096547f1e86c19e72f' },
+    [8453  /* base           */]: { oft: '0x850cdf416668210ed0c36bfff5d21921c7ada3b8', token: '0x850cdf416668210ed0c36bfff5d21921c7ada3b8' },
+  },
+  /**
+   * USR — Resolv Labs USD stablecoin.
+   */
+  USR: {
+    [1     /* ethereum       */]: { oft: '0xd2ee2776f34ef4e7325745b06e6d464b08d4be0e', token: '0x66a1E37c9b0eAddca17d3662D6c05F4DECf3e110' },
+    [42161 /* arbitrum       */]: { oft: '0x2492d0006411af6c8bbb1c8afc1b0197350a79e9', token: '0x2492d0006411af6c8bbb1c8afc1b0197350a79e9' },
+    [8453  /* base           */]: { oft: '0x35e5db674d8e93a03d814fa0ada70731efe8a4b9', token: '0x35e5db674d8e93a03d814fa0ada70731efe8a4b9' },
+    [56    /* bsc            */]: { oft: '0x2492d0006411af6c8bbb1c8afc1b0197350a79e9', token: '0x2492d0006411af6c8bbb1c8afc1b0197350a79e9' },
+  },
+  /**
+   * wstUSR — Resolv Labs wrapped staked USR (yield-bearing).
+   */
+  wstUSR: {
+    [1     /* ethereum       */]: { oft: '0xab17c1fe647c37ceb9b96d1c27dd189bf8451978', token: '0x1202F5C7b4B9E47a1A484E8B270be34dbbC75055' },
+    [42161 /* arbitrum       */]: { oft: '0x66cfbd79257dc5217903a36293120282548e2254', token: '0x66cfbd79257dc5217903a36293120282548e2254' },
+    [8453  /* base           */]: { oft: '0xb67675158b412d53fe6b68946483ba920b135ba1', token: '0xb67675158b412d53fe6b68946483ba920b135ba1' },
+    [56    /* bsc            */]: { oft: '0x4254813524695def4163a169e901f3d7a1a55429', token: '0x4254813524695def4163a169e901f3d7a1a55429' },
+  },
+  /**
+   * USDtb — Ethena treasury-backed stablecoin.
+   */
+  USDtb: {
+    [1     /* ethereum       */]: { oft: '0xc708b6887db46005da033501f8aebee72d191a5d', token: '0xC139190F447e929f090Edeb554D95AbB8b18aC1C' },
+    [42161 /* arbitrum       */]: { oft: '0xc708b6887db46005da033501f8aebee72d191a5d', token: '0xc708b6887db46005da033501f8aebee72d191a5d' },
+    [8453  /* base           */]: { oft: '0xc708b6887db46005da033501f8aebee72d191a5d', token: '0xc708b6887db46005da033501f8aebee72d191a5d' },
+  },
+} as const;
+
+/**
+ * Uniswap V3 SwapRouter addresses per chain.
+ * Used by curator swap helpers to build calldata for on-chain swaps.
+ *
+ * Note on struct differences:
+ *   - SwapRouter (Eth/Arb/Op, 0xE592...): exactInputSingle struct includes `deadline`
+ *   - SwapRouter02 (Base, 0x2626...): exactInputSingle struct does NOT include `deadline`
+ *   - FlowSwap V3 (Flow EVM, 0xeEDC...): derived from original UniV3, includes `deadline`
+ */
+export const UNISWAP_V3_ROUTERS: Record<number, string> = {
+  [8453]:  '0x2626664c2603336E57B271c5C0b26F421741e481', // Base — SwapRouter02 (no deadline)
+  [1]:     '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Ethereum — SwapRouter
+  [42161]: '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Arbitrum — SwapRouter
+  [10]:    '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Optimism — SwapRouter
+  [747]:   '0xeEDC6Ff75e1b10B903D9013c358e446a73d35341',  // Flow EVM — FlowSwap V3 SwapRouter
+};
+
+/** Public RPC endpoints per chain for cross-chain reads */
+const PUBLIC_RPCS: Record<number, string[]> = {
+  1:     ['https://ethereum-rpc.publicnode.com', 'https://eth.drpc.org', 'https://eth.llamarpc.com'],
+  10:    ['https://mainnet.optimism.io', 'https://optimism-rpc.publicnode.com'],
+  42161: ['https://arbitrum-one-rpc.publicnode.com', 'https://arbitrum.publicnode.com'],
+  8453:  ['https://base-rpc.publicnode.com', 'https://base.llamarpc.com', 'https://mainnet.base.org'],
+  747:   ['https://mainnet.evm.nodes.onflow.org'],
+  146:   ['https://rpc.soniclabs.com'],
+  56:    ['https://bsc-dataseed1.binance.org', 'https://bsc-dataseed2.binance.org'],
 };
 
+/**
+ * Create a read-only ethers Provider for a given chain ID using public RPCs.
+ * Returns null if no public RPC is configured for that chain.
+ */
+export function createChainProvider(chainId: number): Provider | null {
+  const rpcs = PUBLIC_RPCS[chainId];
+  if (!rpcs?.length) return null;
+  return new JsonRpcProvider(rpcs[0], chainId, { staticNetwork: true });
+}
+
 /**
  * Recommended timeouts for cross-chain operations (milliseconds).
  * UIs should show a progress indicator and NOT timeout before these values.