@oydual31/more-vaults-sdk 0.1.0 → 0.1.2

package/dist/viem/index.d.cts

@@ -1,4 +1,26 @@
 import { Hash, Address, WalletClient, PublicClient } from 'viem';
+export { PublicClient as SdkPublicClient } from 'viem';
+
+/** EVM Chain IDs for chains supported by MoreVaults */
+declare const CHAIN_IDS: {
+    readonly flowEVMMainnet: 747;
+    readonly flowEVMTestnet: 545;
+    readonly arbitrum: 42161;
+    readonly base: 8453;
+    readonly ethereum: 1;
+};
+/** LayerZero Endpoint IDs (EID) for chains supported by MoreVaults */
+declare const LZ_EIDS: {
+    readonly flowMainnet: 30332;
+    readonly flowTestnet: 30333;
+    readonly arbitrum: 30110;
+    readonly base: 30184;
+    readonly ethereum: 30101;
+};
+/** LayerZero EID → EVM Chain ID */
+declare const EID_TO_CHAIN_ID: Record<number, number>;
+/** EVM Chain ID → LayerZero EID */
+declare const CHAIN_ID_TO_EID: Record<number, number>;
 
 /**
  * ABI fragments for MoreVaults SDK.
@@ -591,6 +613,12 @@ interface VaultAddresses {
     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;
@@ -668,6 +696,9 @@ declare class NotHubVaultError extends MoreVaultsError {
 declare class MissingEscrowAddressError extends MoreVaultsError {
     constructor();
 }
+declare class WrongChainError extends MoreVaultsError {
+    constructor(currentChainId: number, expectedChainId: number);
+}
 
 /**
  * D1 / D3 — Simple deposit (ERC-4626 standard).
@@ -1288,4 +1319,18 @@ type VaultSummary = VaultStatus & VaultMetadata;
  */
 declare function getVaultSummary(publicClient: PublicClient, vault: Address): Promise<VaultSummary>;
 
-export { ActionType, type ActionTypeValue, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, CCManagerNotConfiguredError, CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type DepositBlockReason, type DepositEligibility, type DepositResult, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, METADATA_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, type RedeemResult, type UserBalances, type UserPosition, VAULT_ABI, type VaultAddresses, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };
+/**
+ * Cast a wagmi PublicClient to the SDK's expected type.
+ * Use this in React components to avoid `as any` casts:
+ * ```ts
+ * import { usePublicClient } from 'wagmi'
+ * import { asSdkClient } from '@oydual31/more-vaults-sdk/viem'
+ * const pc = asSdkClient(usePublicClient())
+ * ```
+ * wagmi v2 uses viem as a peer dependency, so the types are structurally
+ * identical — this function validates the client is non-null and applies
+ * a documented cast instead of an opaque `as any`.
+ */
+declare function asSdkClient(client: unknown): PublicClient;
+
+export { ActionType, type ActionTypeValue, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_EIDS, METADATA_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, type RedeemResult, type UserBalances, type UserPosition, VAULT_ABI, type VaultAddresses, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, WrongChainError, asSdkClient, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };

package/dist/viem/index.d.ts

@@ -1,4 +1,26 @@
 import { Hash, Address, WalletClient, PublicClient } from 'viem';
+export { PublicClient as SdkPublicClient } from 'viem';
+
+/** EVM Chain IDs for chains supported by MoreVaults */
+declare const CHAIN_IDS: {
+    readonly flowEVMMainnet: 747;
+    readonly flowEVMTestnet: 545;
+    readonly arbitrum: 42161;
+    readonly base: 8453;
+    readonly ethereum: 1;
+};
+/** LayerZero Endpoint IDs (EID) for chains supported by MoreVaults */
+declare const LZ_EIDS: {
+    readonly flowMainnet: 30332;
+    readonly flowTestnet: 30333;
+    readonly arbitrum: 30110;
+    readonly base: 30184;
+    readonly ethereum: 30101;
+};
+/** LayerZero EID → EVM Chain ID */
+declare const EID_TO_CHAIN_ID: Record<number, number>;
+/** EVM Chain ID → LayerZero EID */
+declare const CHAIN_ID_TO_EID: Record<number, number>;
 
 /**
  * ABI fragments for MoreVaults SDK.
@@ -591,6 +613,12 @@ interface VaultAddresses {
     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;
@@ -668,6 +696,9 @@ declare class NotHubVaultError extends MoreVaultsError {
 declare class MissingEscrowAddressError extends MoreVaultsError {
     constructor();
 }
+declare class WrongChainError extends MoreVaultsError {
+    constructor(currentChainId: number, expectedChainId: number);
+}
 
 /**
  * D1 / D3 — Simple deposit (ERC-4626 standard).
@@ -1288,4 +1319,18 @@ type VaultSummary = VaultStatus & VaultMetadata;
  */
 declare function getVaultSummary(publicClient: PublicClient, vault: Address): Promise<VaultSummary>;
 
-export { ActionType, type ActionTypeValue, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, CCManagerNotConfiguredError, CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type DepositBlockReason, type DepositEligibility, type DepositResult, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, METADATA_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, type RedeemResult, type UserBalances, type UserPosition, VAULT_ABI, type VaultAddresses, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };
+/**
+ * Cast a wagmi PublicClient to the SDK's expected type.
+ * Use this in React components to avoid `as any` casts:
+ * ```ts
+ * import { usePublicClient } from 'wagmi'
+ * import { asSdkClient } from '@oydual31/more-vaults-sdk/viem'
+ * const pc = asSdkClient(usePublicClient())
+ * ```
+ * wagmi v2 uses viem as a peer dependency, so the types are structurally
+ * identical — this function validates the client is non-null and applies
+ * a documented cast instead of an opaque `as any`.
+ */
+declare function asSdkClient(client: unknown): PublicClient;
+
+export { ActionType, type ActionTypeValue, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_EIDS, METADATA_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, type RedeemResult, type UserBalances, type UserPosition, VAULT_ABI, type VaultAddresses, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, WrongChainError, asSdkClient, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };

package/dist/viem/index.js

@@ -1,5 +1,35 @@
 import { getAddress, zeroAddress, encodeAbiParameters, pad } from 'viem';
 
+// src/viem/chains.ts
+var CHAIN_IDS = {
+  flowEVMMainnet: 747,
+  flowEVMTestnet: 545,
+  arbitrum: 42161,
+  base: 8453,
+  ethereum: 1
+};
+var LZ_EIDS = {
+  flowMainnet: 30332,
+  flowTestnet: 30333,
+  arbitrum: 30110,
+  base: 30184,
+  ethereum: 30101
+};
+var EID_TO_CHAIN_ID = {
+  [LZ_EIDS.flowMainnet]: CHAIN_IDS.flowEVMMainnet,
+  [LZ_EIDS.flowTestnet]: CHAIN_IDS.flowEVMTestnet,
+  [LZ_EIDS.arbitrum]: CHAIN_IDS.arbitrum,
+  [LZ_EIDS.base]: CHAIN_IDS.base,
+  [LZ_EIDS.ethereum]: CHAIN_IDS.ethereum
+};
+var CHAIN_ID_TO_EID = {
+  [CHAIN_IDS.flowEVMMainnet]: LZ_EIDS.flowMainnet,
+  [CHAIN_IDS.flowEVMTestnet]: LZ_EIDS.flowTestnet,
+  [CHAIN_IDS.arbitrum]: LZ_EIDS.arbitrum,
+  [CHAIN_IDS.base]: LZ_EIDS.base,
+  [CHAIN_IDS.ethereum]: LZ_EIDS.ethereum
+};
+
 // src/viem/abis.ts
 var VAULT_ABI = [
   {
@@ -451,6 +481,14 @@ var MissingEscrowAddressError = class extends MoreVaultsError {
     this.name = "MissingEscrowAddressError";
   }
 };
+var WrongChainError = class extends MoreVaultsError {
+  constructor(currentChainId, expectedChainId) {
+    super(
+      `Wrong network: wallet is on chain ${currentChainId}, but the vault hub requires chain ${expectedChainId}. Switch networks before proceeding.`
+    );
+    this.name = "WrongChainError";
+  }
+};
 async function getVaultStatus(publicClient, vault) {
   const v = getAddress(vault);
   const b1 = await publicClient.multicall({
@@ -758,10 +796,20 @@ async function preflightSync(publicClient, vault) {
   }
 }
 
+// src/viem/chainValidation.ts
+function validateWalletChain(walletClient, hubChainId) {
+  if (!hubChainId) return;
+  const current = walletClient.chain?.id;
+  if (current !== void 0 && current !== hubChainId) {
+    throw new WrongChainError(current, hubChainId);
+  }
+}
+
 // src/viem/depositFlows.ts
 async function depositSimple(walletClient, publicClient, addresses, assets, receiver) {
   const account = walletClient.account;
   const vault = getAddress(addresses.vault);
+  validateWalletChain(walletClient, addresses.hubChainId);
   await preflightSync(publicClient, vault);
   const underlying = await publicClient.readContract({
     address: vault,
@@ -789,6 +837,7 @@ async function depositSimple(walletClient, publicClient, addresses, assets, rece
 async function depositMultiAsset(walletClient, publicClient, addresses, tokens, amounts, receiver, minShares) {
   const account = walletClient.account;
   const vault = getAddress(addresses.vault);
+  validateWalletChain(walletClient, addresses.hubChainId);
   for (let i = 0; i < tokens.length; i++) {
     await ensureAllowance(walletClient, publicClient, tokens[i], vault, amounts[i]);
   }
@@ -814,6 +863,7 @@ async function depositAsync(walletClient, publicClient, addresses, assets, recei
   const vault = getAddress(addresses.vault);
   if (!addresses.escrow) throw new MissingEscrowAddressError();
   const escrow = getAddress(addresses.escrow);
+  validateWalletChain(walletClient, addresses.hubChainId);
   await preflightAsync(publicClient, vault);
   const underlying = await publicClient.readContract({
     address: vault,
@@ -849,6 +899,7 @@ async function mintAsync(walletClient, publicClient, addresses, shares, maxAsset
   const vault = getAddress(addresses.vault);
   if (!addresses.escrow) throw new MissingEscrowAddressError();
   const escrow = getAddress(addresses.escrow);
+  validateWalletChain(walletClient, addresses.hubChainId);
   await preflightAsync(publicClient, vault);
   const underlying = await publicClient.readContract({
     address: vault,
@@ -1002,6 +1053,7 @@ async function quoteDepositFromSpokeFee(publicClient, spokeOFT, hubEid, spokeEid
 async function redeemShares(walletClient, publicClient, addresses, shares, receiver, owner) {
   const account = walletClient.account;
   const vault = getAddress(addresses.vault);
+  validateWalletChain(walletClient, addresses.hubChainId);
   const { result: assets } = await publicClient.simulateContract({
     address: vault,
     abi: VAULT_ABI,
@@ -1022,6 +1074,7 @@ async function redeemShares(walletClient, publicClient, addresses, shares, recei
 async function withdrawAssets(walletClient, publicClient, addresses, assets, receiver, owner) {
   const account = walletClient.account;
   const vault = getAddress(addresses.vault);
+  validateWalletChain(walletClient, addresses.hubChainId);
   const { result: sharesBurned } = await publicClient.simulateContract({
     address: vault,
     abi: VAULT_ABI,
@@ -1042,6 +1095,7 @@ async function withdrawAssets(walletClient, publicClient, addresses, assets, rec
 async function requestRedeem(walletClient, publicClient, addresses, shares, owner) {
   const account = walletClient.account;
   const vault = getAddress(addresses.vault);
+  validateWalletChain(walletClient, addresses.hubChainId);
   await publicClient.simulateContract({
     address: vault,
     abi: VAULT_ABI,
@@ -1074,6 +1128,7 @@ async function redeemAsync(walletClient, publicClient, addresses, shares, receiv
   const vault = getAddress(addresses.vault);
   if (!addresses.escrow) throw new MissingEscrowAddressError();
   const escrow = getAddress(addresses.escrow);
+  validateWalletChain(walletClient, addresses.hubChainId);
   await preflightAsync(publicClient, vault);
   await preflightRedeemLiquidity(publicClient, vault, shares);
   await ensureAllowance(walletClient, publicClient, vault, escrow, shares);
@@ -1372,6 +1427,12 @@ async function getVaultSummary(publicClient, vault) {
   return { ...status, ...metadata };
 }
 
-export { ActionType, BRIDGE_ABI, CCManagerNotConfiguredError, CONFIG_ABI, CapacityFullError, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, METADATA_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, VAULT_ABI, VaultPausedError, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };
+// src/viem/wagmiCompat.ts
+function asSdkClient(client) {
+  if (!client) throw new Error("[MoreVaults] No public client available. Make sure wagmi is configured correctly.");
+  return client;
+}
+
+export { ActionType, BRIDGE_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CapacityFullError, EID_TO_CHAIN_ID, ERC20_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_EIDS, METADATA_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, VAULT_ABI, VaultPausedError, WrongChainError, asSdkClient, bridgeSharesToHub, canDeposit, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, ensureAllowance, getAsyncRequestStatus, getAsyncRequestStatusLabel, getMaxWithdrawable, getUserBalances, getUserPosition, getVaultMetadata, getVaultStatus, getVaultSummary, getWithdrawalRequest, isAsyncMode, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSync, previewDeposit, previewRedeem, quoteDepositFromSpokeFee, quoteLzFee, redeemAsync, redeemShares, requestRedeem, smartDeposit, withdrawAssets };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map