@dynamic-labs-sdk/evm 0.9.0 → 0.12.0

package/dist/index.esm.js

@@ -1,10 +1,13 @@
-import { n as version, t as name } from "./package-CgwWn5CG.esm.js";
+import { n as version, t as name } from "./package-BH3Pr-Kr.esm.js";
 import { n as RpcError } from "./registerEvmNetworkProviderBuilder-Cn6YtnaH.esm.js";
-import "./createWalletProviderFromEIP1193Provider-BlpJn4oS.esm.js";
-import { t as addEIP6963Extension } from "./addEIP6963Extension-Fgvl12k3.esm.js";
+import "./createWalletProviderFromEIP1193Provider-t5Nmo-Jr.esm.js";
+import { t as addEIP6963Extension } from "./addEIP6963Extension-C3QBJ5eF.esm.js";
 import { t as addWaasEvmExtension } from "./addWaasEvmExtension-CL5LSmDe.esm.js";
+import { t as createPublicClientFromNetworkData } from "./createPublicClientFromNetworkData-FtTILn2t.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { getDefaultClient } from "@dynamic-labs-sdk/client/core";
+import { createApiClient, getCore, getDefaultClient } from "@dynamic-labs-sdk/client/core";
+import { FeeEstimationFailedError, InvalidParamError, SimulationFailedError, getDefaultClient as getDefaultClient$1, getNetworksData } from "@dynamic-labs-sdk/client";
+import { formatEther } from "viem";
 
 //#region src/addEvmExtension/addEvmExtension.ts
 /**
@@ -31,6 +34,62 @@ const addEvmExtension = (client = getDefaultClient()) => {
 */
 const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM";
 
+//#endregion
+//#region src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts
+/**
+* Calculates the estimated fee for an EVM transaction.
+*
+* This function estimates gas usage and calculates the total transaction fee
+* using either legacy gas pricing or EIP-1559 pricing. The fee is returned
+* in both native units (wei) and human-readable format (ETH).
+*
+* @param params.transaction - The transaction to estimate fees for.
+* @param params.networkData - Network configuration for RPC connection.
+* @param params.nativeTokenPriceUsd - Optional USD price of the native token for fee conversion.
+* @returns Fee data including gas estimates and human-readable amounts.
+* @throws {FeeEstimationFailedError} If gas estimation or fee retrieval fails.
+*/
+const calculateEvmTransactionFee = async ({ transaction, networkData, nativeTokenPriceUsd }) => {
+	try {
+		const publicClient = createPublicClientFromNetworkData({ networkData });
+		const gasEstimate = await publicClient.estimateGas({
+			account: transaction.from,
+			data: transaction.data,
+			to: transaction.to,
+			value: transaction.value
+		});
+		let maxFeePerGas;
+		let maxPriorityFeePerGas;
+		let gasPrice;
+		let nativeAmount;
+		try {
+			const feeData = await publicClient.estimateFeesPerGas();
+			maxFeePerGas = feeData.maxFeePerGas;
+			maxPriorityFeePerGas = feeData.maxPriorityFeePerGas;
+			nativeAmount = gasEstimate * maxFeePerGas;
+		} catch {
+			gasPrice = await publicClient.getGasPrice();
+			nativeAmount = gasEstimate * gasPrice;
+		}
+		const humanReadableAmount = formatEther(nativeAmount);
+		const usdAmount = nativeTokenPriceUsd ? (Number(humanReadableAmount) * nativeTokenPriceUsd).toFixed(2) : void 0;
+		return {
+			gasEstimate,
+			gasPrice,
+			humanReadableAmount,
+			maxFeePerGas,
+			maxPriorityFeePerGas,
+			nativeAmount,
+			usdAmount
+		};
+	} catch (error) {
+		throw new FeeEstimationFailedError({
+			cause: error instanceof Error ? error : void 0,
+			message: "Failed to estimate EVM transaction fee"
+		});
+	}
+};
+
 //#endregion
 //#region src/utils/isEvmWalletAccount/isEvmWalletAccount.ts
 /**
@@ -41,10 +100,75 @@ const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM
 */
 const isEvmWalletAccount = (walletAccount) => walletAccount.chain === "EVM";
 
+//#endregion
+//#region src/simulateEvmTransaction/simulateEvmTransaction.ts
+/**
+* Simulates an EVM transaction to preview its effects before execution.
+*
+* This function uses the Blockaid API to analyze the transaction and returns
+* information about asset transfers, security validation, and optionally fee estimates.
+* The simulation shows what will happen when the transaction is executed without
+* actually sending it to the blockchain.
+*
+* @param params.walletAccount - The EVM wallet account that will sign the transaction.
+* @param params.transaction - The transaction to simulate, including network ID.
+* @param params.includeFees - Whether to calculate transaction fees (default: false).
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns Simulation result with asset diffs, security validation, and optional fee data.
+* @throws {InvalidParamError} If wallet account is not an EVM account or network ID is not configured.
+* @throws {SimulationFailedError} If the simulation API call fails.
+* @throws {FeeEstimationFailedError} If includeFees is true and fee calculation fails.
+*/
+const simulateEvmTransaction = async ({ walletAccount, transaction, includeFees = false }, client = getDefaultClient$1()) => {
+	if (!isEvmWalletAccount(walletAccount)) throw new InvalidParamError("Wallet account must be an EVM wallet account");
+	const networkData = getNetworksData(client).find((data) => data.networkId === transaction.networkId && data.chain === "EVM");
+	if (!networkData) throw new InvalidParamError(`Network with ID ${transaction.networkId} is not configured in project settings`);
+	try {
+		const core = getCore(client);
+		const apiClient = createApiClient({}, client);
+		const simulateEVMTransactionRequest = {
+			chainId: transaction.networkId,
+			data: transaction.data || "0x",
+			from: transaction.from,
+			to: transaction.to
+		};
+		if (transaction.value !== void 0) simulateEVMTransactionRequest.value = transaction.value.toString();
+		const response = await apiClient.simulateEVMTransaction({
+			environmentId: core.environmentId,
+			simulateEVMTransactionRequest
+		});
+		let feeData;
+		if (includeFees) feeData = await calculateEvmTransactionFee({
+			nativeTokenPriceUsd: response.priceData?.nativeTokenUsdPrice,
+			networkData,
+			transaction
+		});
+		return {
+			counterparties: response.counterparties,
+			feeData,
+			inAssets: response.inAssets || [],
+			outAssets: response.outAssets || [],
+			priceData: response.priceData,
+			showTotalFiat: response.showTotalFiat,
+			validation: response.validation ? {
+				description: response.validation.description,
+				reason: response.validation.reason,
+				result: response.validation.result
+			} : void 0
+		};
+	} catch (error) {
+		if (error instanceof FeeEstimationFailedError) throw error;
+		throw new SimulationFailedError({
+			cause: error instanceof Error ? error : void 0,
+			message: "Failed to simulate EVM transaction"
+		});
+	}
+};
+
 //#endregion
 //#region src/exports/index.ts
 assertPackageVersion(name, version);
 
 //#endregion
-export { RpcError, addEvmExtension, isEvmNetworkProvider, isEvmWalletAccount };
+export { RpcError, addEvmExtension, calculateEvmTransactionFee, isEvmNetworkProvider, isEvmWalletAccount, simulateEvmTransaction };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":["packageName","packageVersion"],"sources":["../src/addEvmExtension/addEvmExtension.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/isEvmWalletAccount/isEvmWalletAccount.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client/core';\n\nimport { addEIP6963Extension } from '../eip6963/addEIP6963Extension';\nimport { addWaasEvmExtension } from '../waas/addWaasEvmExtension';\n\n/**\n * Adds the EVM extension to the Dynamic client.\n *\n * This is a convenience function that adds both the EIP-6963 extension\n * and the Dynamic WaaS EVM extension, enabling support for all EVM wallet types\n * including standard wallets and embedded wallets managed by Dynamic's infrastructure.\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import type { NetworkProvider } from '@dynamic-labs-sdk/client';\n\nimport type { EvmNetworkProvider } from '../EvmNetworkProvider';\n\n/**\n * Type guard function to check if a network provider is an EVM network provider.\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an EVM network provider, false otherwise.\n */\nexport const isEvmNetworkProvider = (\n  networkProvider: NetworkProvider\n): networkProvider is EvmNetworkProvider => networkProvider.chain === 'EVM';\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\n\n/**\n * Type guard function to check if a wallet account is an EVM wallet account.\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an EVM wallet account, false otherwise.\n */\nexport const isEvmWalletAccount = (\n  walletAccount: WalletAccount\n): walletAccount is EvmWalletAccount => walletAccount.chain === 'EVM';\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { addEvmExtension } from '../addEvmExtension';\nexport { RpcError } from '../errors/RpcError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport { isEvmNetworkProvider } from '../isEvmNetworkProvider';\nexport { isEvmWalletAccount } from '../utils/isEvmWalletAccount';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAcA,MAAa,mBAAmB,SAAS,kBAAkB,KAAW;AACpE,qBAAoB,OAAO;AAC3B,qBAAoB,OAAO;;;;;;;;;;;ACN7B,MAAa,wBACX,oBAC0C,gBAAgB,UAAU;;;;;;;;;;ACFtE,MAAa,sBACX,kBACsC,cAAc,UAAU;;;;ACNhE,qBAAqBA,MAAaC,QAAe"}
+{"version":3,"file":"index.esm.js","names":["maxFeePerGas: bigint | undefined","maxPriorityFeePerGas: bigint | undefined","gasPrice: bigint | undefined","nativeAmount: bigint","getDefaultClient","feeData: EvmSimulationResult['feeData']","packageName","packageVersion"],"sources":["../src/addEvmExtension/addEvmExtension.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts","../src/utils/isEvmWalletAccount/isEvmWalletAccount.ts","../src/simulateEvmTransaction/simulateEvmTransaction.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client/core';\n\nimport { addEIP6963Extension } from '../eip6963/addEIP6963Extension';\nimport { addWaasEvmExtension } from '../waas/addWaasEvmExtension';\n\n/**\n * Adds the EVM extension to the Dynamic client.\n *\n * This is a convenience function that adds both the EIP-6963 extension\n * and the Dynamic WaaS EVM extension, enabling support for all EVM wallet types\n * including standard wallets and embedded wallets managed by Dynamic's infrastructure.\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import type { NetworkProvider } from '@dynamic-labs-sdk/client';\n\nimport type { EvmNetworkProvider } from '../EvmNetworkProvider';\n\n/**\n * Type guard function to check if a network provider is an EVM network provider.\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an EVM network provider, false otherwise.\n */\nexport const isEvmNetworkProvider = (\n  networkProvider: NetworkProvider\n): networkProvider is EvmNetworkProvider => networkProvider.chain === 'EVM';\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { FeeEstimationFailedError } from '@dynamic-labs-sdk/client';\nimport { formatEther } from 'viem';\n\nimport type {\n  EvmTransactionFeeData,\n  EvmTransactionToSimulate,\n} from '../../transactionSimulation.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\n\ntype CalculateEvmTransactionFeeParams = {\n  nativeTokenPriceUsd?: number;\n  networkData: NetworkData;\n  transaction: EvmTransactionToSimulate;\n};\n\n/**\n * Calculates the estimated fee for an EVM transaction.\n *\n * This function estimates gas usage and calculates the total transaction fee\n * using either legacy gas pricing or EIP-1559 pricing. The fee is returned\n * in both native units (wei) and human-readable format (ETH).\n *\n * @param params.transaction - The transaction to estimate fees for.\n * @param params.networkData - Network configuration for RPC connection.\n * @param params.nativeTokenPriceUsd - Optional USD price of the native token for fee conversion.\n * @returns Fee data including gas estimates and human-readable amounts.\n * @throws {FeeEstimationFailedError} If gas estimation or fee retrieval fails.\n */\nexport const calculateEvmTransactionFee = async ({\n  transaction,\n  networkData,\n  nativeTokenPriceUsd,\n}: CalculateEvmTransactionFeeParams): Promise<EvmTransactionFeeData> => {\n  try {\n    const publicClient = createPublicClientFromNetworkData({ networkData });\n\n    // Estimate gas for the transaction\n    const gasEstimate = await publicClient.estimateGas({\n      account: transaction.from,\n      data: transaction.data,\n      to: transaction.to,\n      value: transaction.value,\n    });\n\n    // Try to get EIP-1559 fees first, fallback to legacy gas price\n    let maxFeePerGas: bigint | undefined;\n    let maxPriorityFeePerGas: bigint | undefined;\n    let gasPrice: bigint | undefined;\n    let nativeAmount: bigint;\n\n    try {\n      const feeData = await publicClient.estimateFeesPerGas();\n      maxFeePerGas = feeData.maxFeePerGas;\n      maxPriorityFeePerGas = feeData.maxPriorityFeePerGas;\n\n      // Calculate fee using EIP-1559 pricing\n      nativeAmount = gasEstimate * maxFeePerGas;\n    } catch {\n      // Fallback to legacy gas pricing\n      gasPrice = await publicClient.getGasPrice();\n      nativeAmount = gasEstimate * gasPrice;\n    }\n\n    // Format to human-readable ETH\n    const humanReadableAmount = formatEther(nativeAmount);\n\n    // Calculate USD amount if price data available\n    const usdAmount = nativeTokenPriceUsd\n      ? (Number(humanReadableAmount) * nativeTokenPriceUsd).toFixed(2)\n      : undefined;\n\n    return {\n      gasEstimate,\n      gasPrice,\n      humanReadableAmount,\n      maxFeePerGas,\n      maxPriorityFeePerGas,\n      nativeAmount,\n      usdAmount,\n    };\n  } catch (error) {\n    throw new FeeEstimationFailedError({\n      cause: error instanceof Error ? error : undefined,\n      message: 'Failed to estimate EVM transaction fee',\n    });\n  }\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\n\n/**\n * Type guard function to check if a wallet account is an EVM wallet account.\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an EVM wallet account, false otherwise.\n */\nexport const isEvmWalletAccount = (\n  walletAccount: WalletAccount\n): walletAccount is EvmWalletAccount => walletAccount.chain === 'EVM';\n","import {\n  FeeEstimationFailedError,\n  InvalidParamError,\n  SimulationFailedError,\n  getDefaultClient,\n  getNetworksData,\n} from '@dynamic-labs-sdk/client';\nimport { createApiClient, getCore } from '@dynamic-labs-sdk/client/core';\nimport type { SimulateEVMTransactionRequest } from '@dynamic-labs/sdk-api-core';\n\nimport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nimport type {\n  EvmSimulationResult,\n  EvmTransactionToSimulate,\n} from '../transactionSimulation.types';\nimport { calculateEvmTransactionFee } from '../utils/calculateEvmTransactionFee';\nimport { isEvmWalletAccount } from '../utils/isEvmWalletAccount';\n\ntype SimulateEvmTransactionParams = {\n  includeFees?: boolean;\n  transaction: EvmTransactionToSimulate;\n  walletAccount: EvmWalletAccount;\n};\n\n/**\n * Simulates an EVM transaction to preview its effects before execution.\n *\n * This function uses the Blockaid API to analyze the transaction and returns\n * information about asset transfers, security validation, and optionally fee estimates.\n * The simulation shows what will happen when the transaction is executed without\n * actually sending it to the blockchain.\n *\n * @param params.walletAccount - The EVM wallet account that will sign the transaction.\n * @param params.transaction - The transaction to simulate, including network ID.\n * @param params.includeFees - Whether to calculate transaction fees (default: false).\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns Simulation result with asset diffs, security validation, and optional fee data.\n * @throws {InvalidParamError} If wallet account is not an EVM account or network ID is not configured.\n * @throws {SimulationFailedError} If the simulation API call fails.\n * @throws {FeeEstimationFailedError} If includeFees is true and fee calculation fails.\n */\nexport const simulateEvmTransaction = async (\n  {\n    walletAccount,\n    transaction,\n    includeFees = false,\n  }: SimulateEvmTransactionParams,\n  client = getDefaultClient()\n): Promise<EvmSimulationResult> => {\n  // Validate wallet account type\n  if (!isEvmWalletAccount(walletAccount)) {\n    throw new InvalidParamError('Wallet account must be an EVM wallet account');\n  }\n\n  // Get network data for the specified network\n  const networksData = getNetworksData(client);\n  const networkData = networksData.find(\n    (data) => data.networkId === transaction.networkId && data.chain === 'EVM'\n  );\n\n  if (!networkData) {\n    throw new InvalidParamError(\n      `Network with ID ${transaction.networkId} is not configured in project settings`\n    );\n  }\n\n  try {\n    // Create API client and call simulation endpoint\n    const core = getCore(client);\n    const apiClient = createApiClient({}, client);\n\n    const simulateEVMTransactionRequest = {\n      chainId: transaction.networkId,\n      data: transaction.data || '0x',\n      from: transaction.from,\n      to: transaction.to,\n    } as SimulateEVMTransactionRequest;\n\n    if (transaction.value !== undefined) {\n      simulateEVMTransactionRequest.value = transaction.value.toString();\n    }\n\n    const response = await apiClient.simulateEVMTransaction({\n      environmentId: core.environmentId,\n      simulateEVMTransactionRequest,\n    });\n\n    // Calculate fees if requested\n    let feeData: EvmSimulationResult['feeData'];\n\n    if (includeFees) {\n      feeData = await calculateEvmTransactionFee({\n        nativeTokenPriceUsd: response.priceData?.nativeTokenUsdPrice,\n        networkData,\n        transaction,\n      });\n    }\n\n    // Map API response to simulation result\n    return {\n      counterparties: response.counterparties,\n      feeData,\n      inAssets: response.inAssets || [],\n      outAssets: response.outAssets || [],\n      priceData: response.priceData,\n      showTotalFiat: response.showTotalFiat,\n      validation: response.validation\n        ? {\n            description: response.validation.description,\n            reason: response.validation.reason,\n            result: response.validation.result as\n              | 'benign'\n              | 'warning'\n              | 'malicious',\n          }\n        : undefined,\n    };\n  } catch (error) {\n    // Re-throw FeeEstimationFailedError as-is\n    if (error instanceof FeeEstimationFailedError) {\n      throw error;\n    }\n\n    throw new SimulationFailedError({\n      cause: error instanceof Error ? error : undefined,\n      message: 'Failed to simulate EVM transaction',\n    });\n  }\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { addEvmExtension } from '../addEvmExtension';\nexport { RpcError } from '../errors/RpcError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport { isEvmNetworkProvider } from '../isEvmNetworkProvider';\nexport { simulateEvmTransaction } from '../simulateEvmTransaction';\nexport type {\n  EvmSimulationResult,\n  EvmTransactionFeeData,\n  EvmTransactionToSimulate,\n} from '../transactionSimulation.types';\nexport { calculateEvmTransactionFee } from '../utils/calculateEvmTransactionFee';\nexport { isEvmWalletAccount } from '../utils/isEvmWalletAccount';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAcA,MAAa,mBAAmB,SAAS,kBAAkB,KAAW;AACpE,qBAAoB,OAAO;AAC3B,qBAAoB,OAAO;;;;;;;;;;;ACN7B,MAAa,wBACX,oBAC0C,gBAAgB,UAAU;;;;;;;;;;;;;;;;;ACiBtE,MAAa,6BAA6B,OAAO,EAC/C,aACA,aACA,0BACsE;AACtE,KAAI;EACF,MAAM,eAAe,kCAAkC,EAAE,aAAa,CAAC;EAGvE,MAAM,cAAc,MAAM,aAAa,YAAY;GACjD,SAAS,YAAY;GACrB,MAAM,YAAY;GAClB,IAAI,YAAY;GAChB,OAAO,YAAY;GACpB,CAAC;EAGF,IAAIA;EACJ,IAAIC;EACJ,IAAIC;EACJ,IAAIC;AAEJ,MAAI;GACF,MAAM,UAAU,MAAM,aAAa,oBAAoB;AACvD,kBAAe,QAAQ;AACvB,0BAAuB,QAAQ;AAG/B,kBAAe,cAAc;UACvB;AAEN,cAAW,MAAM,aAAa,aAAa;AAC3C,kBAAe,cAAc;;EAI/B,MAAM,sBAAsB,YAAY,aAAa;EAGrD,MAAM,YAAY,uBACb,OAAO,oBAAoB,GAAG,qBAAqB,QAAQ,EAAE,GAC9D;AAEJ,SAAO;GACL;GACA;GACA;GACA;GACA;GACA;GACA;GACD;UACM,OAAO;AACd,QAAM,IAAI,yBAAyB;GACjC,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;;;;;;;AC3EN,MAAa,sBACX,kBACsC,cAAc,UAAU;;;;;;;;;;;;;;;;;;;;;AC6BhE,MAAa,yBAAyB,OACpC,EACE,eACA,aACA,cAAc,SAEhB,SAASC,oBAAkB,KACM;AAEjC,KAAI,CAAC,mBAAmB,cAAc,CACpC,OAAM,IAAI,kBAAkB,+CAA+C;CAK7E,MAAM,cADe,gBAAgB,OAAO,CACX,MAC9B,SAAS,KAAK,cAAc,YAAY,aAAa,KAAK,UAAU,MACtE;AAED,KAAI,CAAC,YACH,OAAM,IAAI,kBACR,mBAAmB,YAAY,UAAU,wCAC1C;AAGH,KAAI;EAEF,MAAM,OAAO,QAAQ,OAAO;EAC5B,MAAM,YAAY,gBAAgB,EAAE,EAAE,OAAO;EAE7C,MAAM,gCAAgC;GACpC,SAAS,YAAY;GACrB,MAAM,YAAY,QAAQ;GAC1B,MAAM,YAAY;GAClB,IAAI,YAAY;GACjB;AAED,MAAI,YAAY,UAAU,OACxB,+BAA8B,QAAQ,YAAY,MAAM,UAAU;EAGpE,MAAM,WAAW,MAAM,UAAU,uBAAuB;GACtD,eAAe,KAAK;GACpB;GACD,CAAC;EAGF,IAAIC;AAEJ,MAAI,YACF,WAAU,MAAM,2BAA2B;GACzC,qBAAqB,SAAS,WAAW;GACzC;GACA;GACD,CAAC;AAIJ,SAAO;GACL,gBAAgB,SAAS;GACzB;GACA,UAAU,SAAS,YAAY,EAAE;GACjC,WAAW,SAAS,aAAa,EAAE;GACnC,WAAW,SAAS;GACpB,eAAe,SAAS;GACxB,YAAY,SAAS,aACjB;IACE,aAAa,SAAS,WAAW;IACjC,QAAQ,SAAS,WAAW;IAC5B,QAAQ,SAAS,WAAW;IAI7B,GACD;GACL;UACM,OAAO;AAEd,MAAI,iBAAiB,yBACnB,OAAM;AAGR,QAAM,IAAI,sBAAsB;GAC9B,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;ACxHN,qBAAqBC,MAAaC,QAAe"}

package/dist/{package-CgwWn5CG.esm.js → package-BH3Pr-Kr.esm.js}

@@ -1,7 +1,7 @@
 //#region package.json
 var name = "@dynamic-labs-sdk/evm";
-var version = "0.9.0";
+var version = "0.12.0";
 
 //#endregion
 export { version as n, name as t };
-//# sourceMappingURL=package-CgwWn5CG.esm.js.map
+//# sourceMappingURL=package-BH3Pr-Kr.esm.js.map

package/dist/package-BH3Pr-Kr.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-BH3Pr-Kr.esm.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/{package-D46S1BfS.cjs.js → package-CM0pp-B5.cjs.js}

@@ -1,7 +1,7 @@
 
 //#region package.json
 var name = "@dynamic-labs-sdk/evm";
-var version = "0.9.0";
+var version = "0.12.0";
 
 //#endregion
 Object.defineProperty(exports, 'name', {
@@ -16,4 +16,4 @@ Object.defineProperty(exports, 'version', {
     return version;
   }
 });
-//# sourceMappingURL=package-D46S1BfS.cjs.js.map
+//# sourceMappingURL=package-CM0pp-B5.cjs.js.map

package/dist/package-CM0pp-B5.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-CM0pp-B5.cjs.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/simulateEvmTransaction/index.d.ts

@@ -0,0 +1,2 @@
+export { simulateEvmTransaction } from './simulateEvmTransaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/simulateEvmTransaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/simulateEvmTransaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/simulateEvmTransaction/simulateEvmTransaction.d.ts

@@ -0,0 +1,27 @@
+import type { EvmWalletAccount } from '../EvmWalletAccount.types';
+import type { EvmSimulationResult, EvmTransactionToSimulate } from '../transactionSimulation.types';
+type SimulateEvmTransactionParams = {
+    includeFees?: boolean;
+    transaction: EvmTransactionToSimulate;
+    walletAccount: EvmWalletAccount;
+};
+/**
+ * Simulates an EVM transaction to preview its effects before execution.
+ *
+ * This function uses the Blockaid API to analyze the transaction and returns
+ * information about asset transfers, security validation, and optionally fee estimates.
+ * The simulation shows what will happen when the transaction is executed without
+ * actually sending it to the blockchain.
+ *
+ * @param params.walletAccount - The EVM wallet account that will sign the transaction.
+ * @param params.transaction - The transaction to simulate, including network ID.
+ * @param params.includeFees - Whether to calculate transaction fees (default: false).
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns Simulation result with asset diffs, security validation, and optional fee data.
+ * @throws {InvalidParamError} If wallet account is not an EVM account or network ID is not configured.
+ * @throws {SimulationFailedError} If the simulation API call fails.
+ * @throws {FeeEstimationFailedError} If includeFees is true and fee calculation fails.
+ */
+export declare const simulateEvmTransaction: ({ walletAccount, transaction, includeFees, }: SimulateEvmTransactionParams, client?: import("@dynamic-labs-sdk/client").DynamicClient) => Promise<EvmSimulationResult>;
+export {};
+//# sourceMappingURL=simulateEvmTransaction.d.ts.map

package/dist/simulateEvmTransaction/simulateEvmTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulateEvmTransaction.d.ts","sourceRoot":"","sources":["../../src/simulateEvmTransaction/simulateEvmTransaction.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AAIxC,KAAK,4BAA4B,GAAG;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,wBAAwB,CAAC;IACtC,aAAa,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,iDAK9B,4BAA4B,gEAE9B,OAAO,CAAC,mBAAmB,CAgF7B,CAAC"}

package/dist/transactionSimulation.types.d.ts

@@ -0,0 +1,57 @@
+import type { SimulationResult, TransactionFeeData } from '@dynamic-labs-sdk/client';
+import type { Hex } from 'viem';
+/**
+ * EVM transaction data required for simulation.
+ *
+ * This represents a transaction to be simulated before execution.
+ */
+export type EvmTransactionToSimulate = {
+    /**
+     * Encoded function call data for contract interactions
+     */
+    data?: Hex;
+    /**
+     * Address sending the transaction
+     */
+    from: Hex;
+    /**
+     * Network identifier matching NetworkData.networkId (e.g., '1' for Ethereum, '137' for Polygon)
+     */
+    networkId: string;
+    /**
+     * Address receiving the transaction
+     */
+    to: Hex;
+    /**
+     * Amount of native token to send (in wei)
+     */
+    value?: bigint;
+};
+/**
+ * EVM-specific transaction fee data extending the base fee data with gas details.
+ *
+ * Includes both legacy and EIP-1559 gas pricing fields.
+ */
+export type EvmTransactionFeeData = TransactionFeeData & {
+    /**
+     * Estimated gas units required for the transaction
+     */
+    gasEstimate: bigint;
+    /**
+     * Legacy gas price in wei per gas unit
+     */
+    gasPrice?: bigint;
+    /**
+     * EIP-1559 maximum fee per gas unit in wei
+     */
+    maxFeePerGas?: bigint;
+    /**
+     * EIP-1559 maximum priority fee (tip) per gas unit in wei
+     */
+    maxPriorityFeePerGas?: bigint;
+};
+/**
+ * EVM transaction simulation result with typed fee data.
+ */
+export type EvmSimulationResult = SimulationResult<EvmTransactionFeeData>;
+//# sourceMappingURL=transactionSimulation.types.d.ts.map

package/dist/transactionSimulation.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionSimulation.types.d.ts","sourceRoot":"","sources":["../src/transactionSimulation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,GAAG,CAAC;IACV;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,EAAE,EAAE,GAAG,CAAC;IACR;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG;IACvD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC"}