@oydual31/more-vaults-sdk 0.2.8 → 0.3.0

package/dist/viem/index.d.cts

@@ -101,10 +101,12 @@ declare const OFT_ROUTES: {
         };
     };
     /**
-     * PYUSD — PayPal USD OFT (issued by PayPal/Flow).
+     * USDF — USD Flow OFT. Bridges PYUSD (Ethereum) ↔ USDF (Flow EVM).
+     * On Ethereum: underlying is PayPal USD (PYUSD, 0x6c3ea9...).
+     * On Flow: the OFT itself IS the token (USDF, 0x2aabea...).
      * Routes verified: Eth→Flow ✓
      */
-    readonly PYUSD: {
+    readonly USDF: {
         readonly 747: {
             readonly oft: `0x${string}`;
             readonly token: `0x${string}`;
@@ -114,6 +116,23 @@ declare const OFT_ROUTES: {
             readonly token: `0x${string}`;
         };
     };
+    /**
+     * PYUSD — PayPal USD bridged via OFTAdapter (Paxos / LayerZero).
+     * Lock/mint architecture: locks PYUSD on Arbitrum, mints PYUSD0 on Flow EVM.
+     * On Arbitrum: OFTAdapter wraps native PYUSD (0x46850a...).
+     * On Flow: OFTAdapter wraps PYUSD0 (0x99aF3E...), which is the native Paxos token.
+     * Routes verified: Arb↔Flow ✓ (EID 30336). No Eth or Base peers.
+     */
+    readonly PYUSD: {
+        readonly 747: {
+            readonly oft: `0x${string}`;
+            readonly token: `0x${string}`;
+        };
+        readonly 42161: {
+            readonly oft: `0x${string}`;
+            readonly token: `0x${string}`;
+        };
+    };
     /**
      * WFLOW — Wrapped FLOW NativeOFTAdapter (issued by Flow Foundation).
      * Routes verified: Eth→Flow ✓
@@ -354,7 +373,7 @@ declare const OFT_ROUTES: {
 /**
  * oftCmd for Stargate v2 taxi mode (immediate per-message delivery).
  * Pass as `oftCmd` in SendParam when using stgUSDC, USDT, or WETH OFT_ROUTES entries.
- * Non-Stargate OFTs (PYUSD, WFLOW, sUSDe, USDe, weETH, rsETH) use empty bytes — pass `'0x'` instead.
+ * Non-Stargate OFTs (USDF, WFLOW, sUSDe, USDe, weETH, rsETH) use empty bytes — pass `'0x'` instead.
  */
 declare const STARGATE_TAXI_CMD: "0x01";
 /**
@@ -1051,6 +1070,351 @@ declare const OFT_ABI: readonly [{
     }];
     readonly stateMutability: "view";
 }];
+/**
+ * MulticallFacet ABI — curator action submission and execution with timelock.
+ */
+declare const MULTICALL_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "submitActions";
+    readonly inputs: readonly [{
+        readonly name: "actionsData";
+        readonly type: "bytes[]";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "executeActions";
+    readonly inputs: readonly [{
+        readonly name: "actionsNonce";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getPendingActions";
+    readonly inputs: readonly [{
+        readonly name: "actionsNonce";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "actionsData";
+        readonly type: "bytes[]";
+    }, {
+        readonly name: "pendingUntil";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getCurrentNonce";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "vetoActions";
+    readonly inputs: readonly [{
+        readonly name: "actionsNonces";
+        readonly type: "uint256[]";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+/**
+ * GenericDexFacet ABI — single and batch token swaps through any DEX aggregator.
+ */
+declare const DEX_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "executeSwap";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "targetContract";
+            readonly type: "address";
+        }, {
+            readonly name: "tokenIn";
+            readonly type: "address";
+        }, {
+            readonly name: "tokenOut";
+            readonly type: "address";
+        }, {
+            readonly name: "maxAmountIn";
+            readonly type: "uint256";
+        }, {
+            readonly name: "minAmountOut";
+            readonly type: "uint256";
+        }, {
+            readonly name: "swapCallData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "executeBatchSwap";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "swaps";
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly name: "targetContract";
+                readonly type: "address";
+            }, {
+                readonly name: "tokenIn";
+                readonly type: "address";
+            }, {
+                readonly name: "tokenOut";
+                readonly type: "address";
+            }, {
+                readonly name: "maxAmountIn";
+                readonly type: "uint256";
+            }, {
+                readonly name: "minAmountOut";
+                readonly type: "uint256";
+            }, {
+                readonly name: "swapCallData";
+                readonly type: "bytes";
+            }];
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountsOut";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "nonpayable";
+}];
+/**
+ * BridgeFacet ABI — curator bridging and cross-chain request initiation.
+ * (extends the existing BRIDGE_ABI with curator-specific functions)
+ */
+declare const BRIDGE_FACET_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "executeBridging";
+    readonly inputs: readonly [{
+        readonly name: "adapter";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "bridgeSpecificParams";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "initVaultActionRequest";
+    readonly inputs: readonly [{
+        readonly name: "actionType";
+        readonly type: "uint8";
+    }, {
+        readonly name: "actionCallData";
+        readonly type: "bytes";
+    }, {
+        readonly name: "amountLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "extraOptions";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "guid";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "executeRequest";
+    readonly inputs: readonly [{
+        readonly name: "guid";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+/**
+ * ERC7540Facet ABI — async deposit and redeem operations on ERC7540 vaults.
+ */
+declare const ERC7540_FACET_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "erc7540RequestDeposit";
+    readonly inputs: readonly [{
+        readonly name: "vault";
+        readonly type: "address";
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "erc7540RequestRedeem";
+    readonly inputs: readonly [{
+        readonly name: "vault";
+        readonly type: "address";
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "erc7540Deposit";
+    readonly inputs: readonly [{
+        readonly name: "vault";
+        readonly type: "address";
+    }, {
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "erc7540Redeem";
+    readonly inputs: readonly [{
+        readonly name: "vault";
+        readonly type: "address";
+    }, {
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}];
+/**
+ * ConfigurationFacet ABI — extended with curator-relevant read functions.
+ * Augments the existing CONFIG_ABI with additional getters needed by curator dashboard.
+ */
+declare const CURATOR_CONFIG_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "curator";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "timeLockPeriod";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getAvailableAssets";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getMaxSlippagePercent";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getCrossChainAccountingManager";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}];
+/**
+ * LzAdapter ABI — fee quoting for bridge and LZ Read operations.
+ */
+declare const LZ_ADAPTER_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "quoteBridgeFee";
+    readonly inputs: readonly [{
+        readonly name: "bridgeSpecificParams";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "nativeFee";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "quoteReadFee";
+    readonly inputs: readonly [{
+        readonly name: "vaults";
+        readonly type: "address[]";
+    }, {
+        readonly name: "eids";
+        readonly type: "uint32[]";
+    }, {
+        readonly name: "_extraOptions";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "fee";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "nativeFee";
+            readonly type: "uint256";
+        }, {
+            readonly name: "lzTokenFee";
+            readonly type: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}];
 /**
  * Minimal LZ Endpoint V2 ABI for compose queue management.
  * Used by the Stargate 2-TX flow to check compose status and execute pending composes.
@@ -1192,6 +1556,74 @@ interface CrossChainRequestInfo {
     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;
+}
 
 /**
  * Typed error classes for the MoreVaults SDK.
@@ -1827,6 +2259,45 @@ declare function preflightSpokeRedeem(route: {
     hubLiquidBalance: bigint;
 }>;
 
+/**
+ * Curator / vault-manager read helpers for the MoreVaults SDK.
+ *
+ * All functions are read-only (no wallet needed) and use multicall for
+ * batched RPC efficiency.
+ */
+
+/**
+ * Read a comprehensive status snapshot for the curator dashboard.
+ *
+ * Fetches in two batches (multicall) to minimise round trips:
+ *   Batch 1: curator, timeLockPeriod, getMaxSlippagePercent, getCurrentNonce,
+ *            getAvailableAssets, getCrossChainAccountingManager, paused
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             CuratorVaultStatus snapshot
+ */
+declare function getCuratorVaultStatus(publicClient: PublicClient, vault: Address): Promise<CuratorVaultStatus>;
+/**
+ * Fetch pending actions for a specific nonce and resolve whether they are
+ * executable (i.e. the timelock has expired).
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy)
+ * @param nonce         Action nonce to query
+ * @returns             PendingAction with isExecutable flag set
+ */
+declare function getPendingActions(publicClient: PublicClient, vault: Address, nonce: bigint): Promise<PendingAction>;
+/**
+ * Check whether a given address is the curator of the vault.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy)
+ * @param address       Address to check
+ * @returns             true if address is the current curator
+ */
+declare function isCurator(publicClient: PublicClient, vault: Address, address: Address): Promise<boolean>;
+
 /**
  * Cast a wagmi PublicClient to the SDK's expected type.
  * Use this in React components to avoid `as any` casts:
@@ -1841,4 +2312,4 @@ declare function preflightSpokeRedeem(route: {
  */
 declare function asSdkClient(client: unknown): PublicClient;
 
-export { ActionType, type ActionTypeValue, type AsyncRequestResult, BRIDGE_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CapacityFullError, type ComposeData, type CrossChainRequestInfo, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, type RedeemResult, STARGATE_TAXI_CMD, type SpokeDepositResult, type SpokeRedeemRoute, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, type VaultAddresses, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, executeCompose, getWithdrawalRequest, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, waitForCompose, withdrawAssets };
+export { ActionType, type ActionTypeValue, 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, 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, type RedeemResult, STARGATE_TAXI_CMD, type SpokeDepositResult, type SpokeRedeemRoute, type SubmitActionsResult, type SwapParams, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, type VaultAddresses, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, executeCompose, getCuratorVaultStatus, getPendingActions, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, waitForCompose, withdrawAssets };