@dynamic-labs-sdk/evm 1.17.1 → 1.19.0

package/dist/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.d.ts

@@ -7,10 +7,18 @@ type WaitForSponsoredTransactionParams = {
  * Polls `getEVMSponsoredTransactionStatus` until the relay reports the
  * transaction has been included on-chain, then returns the transaction hash.
  *
+ * @example
+ * ```ts
+ * const { requestId } = await relaySponsoredTransaction({ signedTransaction });
+ * const { transactionHash } = await waitForSponsoredTransaction({ requestId });
+ * ```
+ *
  * @param params.requestId - The request ID returned when the transaction was relayed.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns An object containing the on-chain transaction hash.
  * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+ * @see relaySponsoredTransaction
+ * @see getEVMSponsoredTransactionStatus
  * @notInstrumented
  */
 export declare const waitForSponsoredTransaction: ({ requestId }: WaitForSponsoredTransactionParams, client?: import("@dynamic-labs-sdk/client").DynamicClient) => Promise<{

package/dist/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"waitForSponsoredTransaction.d.ts","sourceRoot":"","sources":["../../../src/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAchC,KAAK,iCAAiC,GAAG;IACvC,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,kBACvB,iCAAiC,gEAE/C,OAAO,CAAC;IAAE,eAAe,EAAE,GAAG,CAAA;CAAE,CA0BlC,CAAC"}
+{"version":3,"file":"waitForSponsoredTransaction.d.ts","sourceRoot":"","sources":["../../../src/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAchC,KAAK,iCAAiC,GAAG;IACvC,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,2BAA2B,kBACvB,iCAAiC,gEAE/C,OAAO,CAAC;IAAE,eAAe,EAAE,GAAG,CAAA;CAAE,CA0BlC,CAAC"}

package/dist/index.cjs

@@ -1,9 +1,9 @@
-const require_mapNetworkDataToViemChain = require('./mapNetworkDataToViemChain-DHni6ErD.cjs');
-const require_evmTransferAmount = require('./evmTransferAmount-C1msMTNe.cjs');
-const require_createWalletClientForWalletAccount = require('./createWalletClientForWalletAccount-Cb2uMZxJ.cjs');
-require('./createWalletProviderFromEIP1193Provider-DIplPkf4.cjs');
-const require_addEIP6963Extension = require('./addEIP6963Extension-5tjpOHPi.cjs');
-const require_addWaasEvmExtension = require('./addWaasEvmExtension-CexieTAz.cjs');
+const require_mapNetworkDataToViemChain = require('./mapNetworkDataToViemChain-y9sq6Oak.cjs');
+const require_evmTransferAmount = require('./evmTransferAmount-bPkkINFr.cjs');
+const require_createWalletClientForWalletAccount = require('./createWalletClientForWalletAccount-DZ1SUxot.cjs');
+require('./createWalletProviderFromEIP1193Provider-BfIxWk-1.cjs');
+const require_addEIP6963Extension = require('./addEIP6963Extension-ButCTeIE.cjs');
+const require_addWaasEvmExtension = require('./addWaasEvmExtension-CIBwjebr.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
@@ -18,11 +18,20 @@ let viem = require("viem");
 * subsequent sponsored transactions no longer need to include the
 * authorization.
 *
+* @example
+* ```ts
+* const { transactionHash } = await activate7702Delegation({
+*   walletAccount: evmAccount,
+* });
+* ```
+*
 * @param params.walletAccount - The EVM wallet account to activate delegation for.
 * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the on-chain transaction hash.
 * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+* @see is7702DelegationActive
+* @see sign7702Authorization
 * @notInstrumented
 */
 const activate7702Delegation = async ({ walletAccount, authorization }, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => require_evmTransferAmount.sendSponsoredTransaction({
@@ -40,7 +49,16 @@ const activate7702Delegation = async ({ walletAccount, authorization }, client =
 * and the Dynamic WaaS EVM extension, enabling support for all EVM wallet types
 * including standard wallets and embedded wallets managed by Dynamic's infrastructure.
 *
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: 'env-123' });
+* addEvmExtension(client);
+* ```
+*
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see isEvmWalletAccount
+* @see isEvmNetworkProvider
 * @notInstrumented
 */
 const addEvmExtension = (client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -67,8 +85,17 @@ var EvmGasSponsorshipNotEnabledError = class extends _dynamic_labs_sdk_client.Ba
 /**
 * Type guard function to check if a network provider is an EVM network provider.
 *
+* @example
+* ```ts
+* if (isEvmNetworkProvider(networkProvider)) {
+*   const publicClient = networkProvider.getPublicClient();
+* }
+* ```
+*
 * @param networkProvider - The network provider to check.
 * @returns True if the network provider is an EVM network provider, false otherwise.
+* @see isEvmWalletAccount
+* @see addEvmExtension
 * @notInstrumented
 */
 const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM";
@@ -82,11 +109,22 @@ const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM
 * using either legacy gas pricing or EIP-1559 pricing. The fee is returned
 * in both native units (wei) and human-readable format (ETH).
 *
+* @example
+* ```ts
+* const feeData = await calculateEvmTransactionFee({
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   networkData,
+*   nativeTokenPriceUsd: 3500,
+* });
+* ```
+*
 * @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.
+* @see simulateEvmTransaction
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const calculateEvmTransactionFee = async ({ transaction, networkData, nativeTokenPriceUsd }) => {
@@ -140,6 +178,15 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * The simulation shows what will happen when the transaction is executed without
 * actually sending it to the blockchain.
 *
+* @example
+* ```ts
+* const result = await simulateEvmTransaction({
+*   walletAccount: evmAccount,
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   includeFees: true,
+* });
+* ```
+*
 * @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).
@@ -148,6 +195,8 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * @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.
+* @see calculateEvmTransactionFee
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const simulateEvmTransaction = async ({ walletAccount, transaction, includeFees = false }, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["sendSponsoredTransaction","BaseError","createPublicClientFromNetworkData","maxFeePerGas: bigint | undefined","maxPriorityFeePerGas: bigint | undefined","gasPrice: bigint | undefined","nativeAmount: bigint","FeeEstimationFailedError","isEvmWalletAccount","InvalidParamError","feeData: EvmSimulationResult['feeData']","FeeEstimationFailedError","SimulationFailedError","packageName","packageVersion"],"sources":["../src/gasless/activate7702Delegation/activate7702Delegation.ts","../src/addEvmExtension/addEvmExtension.ts","../src/errors/EvmGasSponsorshipNotEnabledError/EvmGasSponsorshipNotEnabledError.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts","../src/simulateEvmTransaction/simulateEvmTransaction.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { sendSponsoredTransaction } from '../sendSponsoredTransaction';\n\ntype Activate7702DelegationParams = {\n  /** Pre-signed EIP-7702 authorization. If not provided, one will be signed automatically. */\n  authorization?: SignAuthorizationReturnType;\n  /** The EVM wallet account to activate delegation for. */\n  walletAccount: EvmWalletAccount;\n};\n\n/**\n * Activates EIP-7702 delegation for a wallet by sending a sponsored\n * transaction that only contains the 7702 authorization.\n *\n * After activation, the wallet's delegation is persisted on-chain and\n * subsequent sponsored transactions no longer need to include the\n * authorization.\n *\n * @param params.walletAccount - The EVM wallet account to activate delegation for.\n * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @notInstrumented\n */\nexport const activate7702Delegation = async (\n  { walletAccount, authorization }: Activate7702DelegationParams,\n  client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> =>\n  sendSponsoredTransaction(\n    { authorization, calls: [], walletAccount },\n    client\n  );\n","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  * @notInstrumented\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class EvmGasSponsorshipNotEnabledError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'evm_gas_sponsorship_not_enabled_error',\n      docsUrl: null,\n      name: 'EvmGasSponsorshipNotEnabledError',\n      shortMessage: 'EVM gas sponsorship is not enabled for this project',\n    });\n  }\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  * @notInstrumented\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  * @notInstrumented\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 {\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  * @notInstrumented\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 { activate7702Delegation } from '../gasless/activate7702Delegation';\nexport { addEvmExtension } from '../addEvmExtension';\nexport { EvmGasSponsorshipNotEnabledError } from '../errors/EvmGasSponsorshipNotEnabledError';\nexport { RpcError } from '../errors/RpcError';\nexport { SponsorTransactionError } from '../errors/SponsorTransactionError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport type {\n  SerializedAuthorization,\n  SignedSponsoredTransaction,\n  SponsoredTransactionCall,\n  SponsoredTransactionStatus,\n  SponsoredTransactionStatusResult,\n} from '../gasless/gasless.types';\nexport { getEVMSponsoredTransactionStatus } from '../gasless/getEVMSponsoredTransactionStatus';\nexport { is7702DelegationActive } from '../gasless/is7702DelegationActive';\nexport { isEvmGasSponsorshipEnabled } from '../gasless/isEvmGasSponsorshipEnabled';\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';\nexport { relaySponsoredTransaction } from '../gasless/relaySponsoredTransaction';\nexport { sendSponsoredTransaction } from '../gasless/sendSponsoredTransaction';\nexport { sign7702Authorization } from '../gasless/sign7702Authorization';\nexport { signSponsoredTransaction } from '../gasless/signSponsoredTransaction';\nexport { waitForSponsoredTransaction } from '../gasless/waitForSponsoredTransaction';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,yBAAyB,OACpC,EAAE,eAAe,iBACjB,yDAA2B,KAE3BA,mDACE;CAAE;CAAe,OAAO,EAAE;CAAE;CAAe,EAC3C,OACD;;;;;;;;;;;;;;ACrBH,MAAa,mBAAmB,8DAA2B,KAAW;AACpE,iDAAoB,OAAO;AAC3B,iDAAoB,OAAO;;;;;ACf7B,IAAa,mCAAb,cAAsDC,mCAAU;CAC9D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;;;;;;;;;;;;;ACCN,MAAa,wBACX,oBAC0C,gBAAgB,UAAU;;;;;;;;;;;;;;;;;;ACiBtE,MAAa,6BAA6B,OAAO,EAC/C,aACA,aACA,0BACsE;AACtE,KAAI;EACF,MAAM,eAAeC,6EAAkC,EAAE,aAAa,CAAC;EAGvE,MAAM,cAAc,MAAM,aAAa,YAAY;GACjD,SAAS,YAAY;GACrB,MAAM,YAAY;GAClB,IAAI,YAAY;GAChB,OAAO,YAAY;GACpB,CAAC;EAGF,IAAIC;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,4CAAkC,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,IAAIC,kDAAyB;GACjC,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AC5CN,MAAa,yBAAyB,OACpC,EACE,eACA,aACA,cAAc,SAEhB,yDAA2B,KACM;AAEjC,KAAI,CAACC,6CAAmB,cAAc,CACpC,OAAM,IAAIC,2CAAkB,+CAA+C;CAK7E,MAAM,4DAD+B,OAAO,CACX,MAC9B,SAAS,KAAK,cAAc,YAAY,aAAa,KAAK,UAAU,MACtE;AAED,KAAI,CAAC,YACH,OAAM,IAAIA,2CACR,mBAAmB,YAAY,UAAU,wCAC1C;AAGH,KAAI;EAEF,MAAM,kDAAe,OAAO;EAC5B,MAAM,+DAA4B,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,iBAAiBC,kDACnB,OAAM;AAGR,QAAM,IAAIC,+CAAsB;GAC9B,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;mECzHeC,wCAAaC,0CAAe"}
+{"version":3,"file":"index.cjs","names":["sendSponsoredTransaction","BaseError","createPublicClientFromNetworkData","maxFeePerGas: bigint | undefined","maxPriorityFeePerGas: bigint | undefined","gasPrice: bigint | undefined","nativeAmount: bigint","FeeEstimationFailedError","isEvmWalletAccount","InvalidParamError","feeData: EvmSimulationResult['feeData']","FeeEstimationFailedError","SimulationFailedError","packageName","packageVersion"],"sources":["../src/gasless/activate7702Delegation/activate7702Delegation.ts","../src/addEvmExtension/addEvmExtension.ts","../src/errors/EvmGasSponsorshipNotEnabledError/EvmGasSponsorshipNotEnabledError.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts","../src/simulateEvmTransaction/simulateEvmTransaction.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { sendSponsoredTransaction } from '../sendSponsoredTransaction';\n\ntype Activate7702DelegationParams = {\n  /** Pre-signed EIP-7702 authorization. If not provided, one will be signed automatically. */\n  authorization?: SignAuthorizationReturnType;\n  /** The EVM wallet account to activate delegation for. */\n  walletAccount: EvmWalletAccount;\n};\n\n/**\n * Activates EIP-7702 delegation for a wallet by sending a sponsored\n * transaction that only contains the 7702 authorization.\n *\n * After activation, the wallet's delegation is persisted on-chain and\n * subsequent sponsored transactions no longer need to include the\n * authorization.\n *\n * @example\n * ```ts\n * const { transactionHash } = await activate7702Delegation({\n *   walletAccount: evmAccount,\n * });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to activate delegation for.\n * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see is7702DelegationActive\n * @see sign7702Authorization\n * @notInstrumented\n */\nexport const activate7702Delegation = async (\n  { walletAccount, authorization }: Activate7702DelegationParams,\n  client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> =>\n  sendSponsoredTransaction(\n    { authorization, calls: [], walletAccount },\n    client\n  );\n","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 * @example\n * ```ts\n * const client = createDynamicClient({ environmentId: 'env-123' });\n * addEvmExtension(client);\n * ```\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns void\n * @see isEvmWalletAccount\n * @see isEvmNetworkProvider\n * @notInstrumented\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class EvmGasSponsorshipNotEnabledError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'evm_gas_sponsorship_not_enabled_error',\n      docsUrl: null,\n      name: 'EvmGasSponsorshipNotEnabledError',\n      shortMessage: 'EVM gas sponsorship is not enabled for this project',\n    });\n  }\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 * @example\n * ```ts\n * if (isEvmNetworkProvider(networkProvider)) {\n *   const publicClient = networkProvider.getPublicClient();\n * }\n * ```\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an EVM network provider, false otherwise.\n * @see isEvmWalletAccount\n * @see addEvmExtension\n * @notInstrumented\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 * @example\n * ```ts\n * const feeData = await calculateEvmTransactionFee({\n *   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },\n *   networkData,\n *   nativeTokenPriceUsd: 3500,\n * });\n * ```\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 * @see simulateEvmTransaction\n * @see isEvmWalletAccount\n * @notInstrumented\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 {\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 * @example\n * ```ts\n * const result = await simulateEvmTransaction({\n *   walletAccount: evmAccount,\n *   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },\n *   includeFees: true,\n * });\n * ```\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 * @see calculateEvmTransactionFee\n * @see isEvmWalletAccount\n * @notInstrumented\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 { activate7702Delegation } from '../gasless/activate7702Delegation';\nexport { addEvmExtension } from '../addEvmExtension';\nexport { EvmGasSponsorshipNotEnabledError } from '../errors/EvmGasSponsorshipNotEnabledError';\nexport { RpcError } from '../errors/RpcError';\nexport { SponsorTransactionError } from '../errors/SponsorTransactionError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport type {\n  SerializedAuthorization,\n  SignedSponsoredTransaction,\n  SponsoredTransactionCall,\n  SponsoredTransactionStatus,\n  SponsoredTransactionStatusResult,\n} from '../gasless/gasless.types';\nexport { getEVMSponsoredTransactionStatus } from '../gasless/getEVMSponsoredTransactionStatus';\nexport { is7702DelegationActive } from '../gasless/is7702DelegationActive';\nexport { isEvmGasSponsorshipEnabled } from '../gasless/isEvmGasSponsorshipEnabled';\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';\nexport { relaySponsoredTransaction } from '../gasless/relaySponsoredTransaction';\nexport { sendSponsoredTransaction } from '../gasless/sendSponsoredTransaction';\nexport { sign7702Authorization } from '../gasless/sign7702Authorization';\nexport { signSponsoredTransaction } from '../gasless/signSponsoredTransaction';\nexport { waitForSponsoredTransaction } from '../gasless/waitForSponsoredTransaction';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,yBAAyB,OACpC,EAAE,eAAe,iBACjB,yDAA2B,KAE3BA,mDACE;CAAE;CAAe,OAAO,EAAE;CAAE;CAAe,EAC3C,OACD;;;;;;;;;;;;;;;;;;;;;;;ACrBH,MAAa,mBAAmB,8DAA2B,KAAW;AACpE,iDAAoB,OAAO;AAC3B,iDAAoB,OAAO;;;;;ACxB7B,IAAa,mCAAb,cAAsDC,mCAAU;CAC9D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;;;;;;;;;;;;;;;;;;;;;;ACUN,MAAa,wBACX,oBAC0C,gBAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACmBtE,MAAa,6BAA6B,OAAO,EAC/C,aACA,aACA,0BACsE;AACtE,KAAI;EACF,MAAM,eAAeC,6EAAkC,EAAE,aAAa,CAAC;EAGvE,MAAM,cAAc,MAAM,aAAa,YAAY;GACjD,SAAS,YAAY;GACrB,MAAM,YAAY;GAClB,IAAI,YAAY;GAChB,OAAO,YAAY;GACpB,CAAC;EAGF,IAAIC;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,4CAAkC,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,IAAIC,kDAAyB;GACjC,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC5CN,MAAa,yBAAyB,OACpC,EACE,eACA,aACA,cAAc,SAEhB,yDAA2B,KACM;AAEjC,KAAI,CAACC,6CAAmB,cAAc,CACpC,OAAM,IAAIC,2CAAkB,+CAA+C;CAK7E,MAAM,4DAD+B,OAAO,CACX,MAC9B,SAAS,KAAK,cAAc,YAAY,aAAa,KAAK,UAAU,MACtE;AAED,KAAI,CAAC,YACH,OAAM,IAAIA,2CACR,mBAAmB,YAAY,UAAU,wCAC1C;AAGH,KAAI;EAEF,MAAM,kDAAe,OAAO;EAC5B,MAAM,+DAA4B,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,iBAAiBC,kDACnB,OAAM;AAGR,QAAM,IAAIC,+CAAsB;GAC9B,OAAO,iBAAiB,QAAQ,QAAQ;GACxC,SAAS;GACV,CAAC;;;;;;mECpIeC,wCAAaC,0CAAe"}

package/dist/index.esm.js

@@ -1,9 +1,9 @@
-import { n as name, r as version } from "./mapNetworkDataToViemChain-6r3qQgSG.esm.js";
-import { a as isEvmWalletAccount, c as sendSponsoredTransaction, d as relaySponsoredTransaction, f as signSponsoredTransaction, h as SponsorTransactionError, l as waitForSponsoredTransaction, m as is7702DelegationActive, p as sign7702Authorization, r as isEvmGasSponsorshipEnabled, s as RpcError, u as getEVMSponsoredTransactionStatus } from "./evmTransferAmount-ebnRuHex.esm.js";
-import { r as createPublicClientFromNetworkData } from "./createWalletClientForWalletAccount-CRcI7k6-.esm.js";
-import "./createWalletProviderFromEIP1193Provider-BQ0d8crZ.esm.js";
-import { t as addEIP6963Extension } from "./addEIP6963Extension-Nz8vTj11.esm.js";
-import { t as addWaasEvmExtension } from "./addWaasEvmExtension-JRgUEac2.esm.js";
+import { n as name, r as version } from "./mapNetworkDataToViemChain-DXy4yka7.esm.js";
+import { a as isEvmWalletAccount, c as sendSponsoredTransaction, d as relaySponsoredTransaction, f as signSponsoredTransaction, h as SponsorTransactionError, l as waitForSponsoredTransaction, m as is7702DelegationActive, p as sign7702Authorization, r as isEvmGasSponsorshipEnabled, s as RpcError, u as getEVMSponsoredTransactionStatus } from "./evmTransferAmount-zNYlT8-b.esm.js";
+import { r as createPublicClientFromNetworkData } from "./createWalletClientForWalletAccount-CSV76RdP.esm.js";
+import "./createWalletProviderFromEIP1193Provider-Dhruqg0P.esm.js";
+import { t as addEIP6963Extension } from "./addEIP6963Extension-BjucaEgu.esm.js";
+import { t as addWaasEvmExtension } from "./addWaasEvmExtension-D47UG4zQ.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { BaseError, FeeEstimationFailedError, InvalidParamError, SimulationFailedError, getDefaultClient, getNetworksData } from "@dynamic-labs-sdk/client";
 import { createApiClient, getCore, getDefaultClient as getDefaultClient$1 } from "@dynamic-labs-sdk/client/core";
@@ -18,11 +18,20 @@ import { formatEther } from "viem";
 * subsequent sponsored transactions no longer need to include the
 * authorization.
 *
+* @example
+* ```ts
+* const { transactionHash } = await activate7702Delegation({
+*   walletAccount: evmAccount,
+* });
+* ```
+*
 * @param params.walletAccount - The EVM wallet account to activate delegation for.
 * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the on-chain transaction hash.
 * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+* @see is7702DelegationActive
+* @see sign7702Authorization
 * @notInstrumented
 */
 const activate7702Delegation = async ({ walletAccount, authorization }, client = getDefaultClient()) => sendSponsoredTransaction({
@@ -40,7 +49,16 @@ const activate7702Delegation = async ({ walletAccount, authorization }, client =
 * and the Dynamic WaaS EVM extension, enabling support for all EVM wallet types
 * including standard wallets and embedded wallets managed by Dynamic's infrastructure.
 *
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: 'env-123' });
+* addEvmExtension(client);
+* ```
+*
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see isEvmWalletAccount
+* @see isEvmNetworkProvider
 * @notInstrumented
 */
 const addEvmExtension = (client = getDefaultClient$1()) => {
@@ -67,8 +85,17 @@ var EvmGasSponsorshipNotEnabledError = class extends BaseError {
 /**
 * Type guard function to check if a network provider is an EVM network provider.
 *
+* @example
+* ```ts
+* if (isEvmNetworkProvider(networkProvider)) {
+*   const publicClient = networkProvider.getPublicClient();
+* }
+* ```
+*
 * @param networkProvider - The network provider to check.
 * @returns True if the network provider is an EVM network provider, false otherwise.
+* @see isEvmWalletAccount
+* @see addEvmExtension
 * @notInstrumented
 */
 const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM";
@@ -82,11 +109,22 @@ const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM
 * using either legacy gas pricing or EIP-1559 pricing. The fee is returned
 * in both native units (wei) and human-readable format (ETH).
 *
+* @example
+* ```ts
+* const feeData = await calculateEvmTransactionFee({
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   networkData,
+*   nativeTokenPriceUsd: 3500,
+* });
+* ```
+*
 * @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.
+* @see simulateEvmTransaction
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const calculateEvmTransactionFee = async ({ transaction, networkData, nativeTokenPriceUsd }) => {
@@ -140,6 +178,15 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * The simulation shows what will happen when the transaction is executed without
 * actually sending it to the blockchain.
 *
+* @example
+* ```ts
+* const result = await simulateEvmTransaction({
+*   walletAccount: evmAccount,
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   includeFees: true,
+* });
+* ```
+*
 * @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).
@@ -148,6 +195,8 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * @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.
+* @see calculateEvmTransactionFee
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const simulateEvmTransaction = async ({ walletAccount, transaction, includeFees = false }, client = getDefaultClient()) => {

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":["getDefaultClient","maxFeePerGas: bigint | undefined","maxPriorityFeePerGas: bigint | undefined","gasPrice: bigint | undefined","nativeAmount: bigint","feeData: EvmSimulationResult['feeData']","packageName","packageVersion"],"sources":["../src/gasless/activate7702Delegation/activate7702Delegation.ts","../src/addEvmExtension/addEvmExtension.ts","../src/errors/EvmGasSponsorshipNotEnabledError/EvmGasSponsorshipNotEnabledError.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts","../src/simulateEvmTransaction/simulateEvmTransaction.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { sendSponsoredTransaction } from '../sendSponsoredTransaction';\n\ntype Activate7702DelegationParams = {\n  /** Pre-signed EIP-7702 authorization. If not provided, one will be signed automatically. */\n  authorization?: SignAuthorizationReturnType;\n  /** The EVM wallet account to activate delegation for. */\n  walletAccount: EvmWalletAccount;\n};\n\n/**\n * Activates EIP-7702 delegation for a wallet by sending a sponsored\n * transaction that only contains the 7702 authorization.\n *\n * After activation, the wallet's delegation is persisted on-chain and\n * subsequent sponsored transactions no longer need to include the\n * authorization.\n *\n * @param params.walletAccount - The EVM wallet account to activate delegation for.\n * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @notInstrumented\n */\nexport const activate7702Delegation = async (\n  { walletAccount, authorization }: Activate7702DelegationParams,\n  client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> =>\n  sendSponsoredTransaction(\n    { authorization, calls: [], walletAccount },\n    client\n  );\n","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  * @notInstrumented\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class EvmGasSponsorshipNotEnabledError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'evm_gas_sponsorship_not_enabled_error',\n      docsUrl: null,\n      name: 'EvmGasSponsorshipNotEnabledError',\n      shortMessage: 'EVM gas sponsorship is not enabled for this project',\n    });\n  }\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  * @notInstrumented\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  * @notInstrumented\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 {\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  * @notInstrumented\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 { activate7702Delegation } from '../gasless/activate7702Delegation';\nexport { addEvmExtension } from '../addEvmExtension';\nexport { EvmGasSponsorshipNotEnabledError } from '../errors/EvmGasSponsorshipNotEnabledError';\nexport { RpcError } from '../errors/RpcError';\nexport { SponsorTransactionError } from '../errors/SponsorTransactionError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport type {\n  SerializedAuthorization,\n  SignedSponsoredTransaction,\n  SponsoredTransactionCall,\n  SponsoredTransactionStatus,\n  SponsoredTransactionStatusResult,\n} from '../gasless/gasless.types';\nexport { getEVMSponsoredTransactionStatus } from '../gasless/getEVMSponsoredTransactionStatus';\nexport { is7702DelegationActive } from '../gasless/is7702DelegationActive';\nexport { isEvmGasSponsorshipEnabled } from '../gasless/isEvmGasSponsorshipEnabled';\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';\nexport { relaySponsoredTransaction } from '../gasless/relaySponsoredTransaction';\nexport { sendSponsoredTransaction } from '../gasless/sendSponsoredTransaction';\nexport { sign7702Authorization } from '../gasless/sign7702Authorization';\nexport { signSponsoredTransaction } from '../gasless/signSponsoredTransaction';\nexport { waitForSponsoredTransaction } from '../gasless/waitForSponsoredTransaction';\n"],"mappings":"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"}
+{"version":3,"file":"index.esm.js","names":["getDefaultClient","maxFeePerGas: bigint | undefined","maxPriorityFeePerGas: bigint | undefined","gasPrice: bigint | undefined","nativeAmount: bigint","feeData: EvmSimulationResult['feeData']","packageName","packageVersion"],"sources":["../src/gasless/activate7702Delegation/activate7702Delegation.ts","../src/addEvmExtension/addEvmExtension.ts","../src/errors/EvmGasSponsorshipNotEnabledError/EvmGasSponsorshipNotEnabledError.ts","../src/isEvmNetworkProvider/isEvmNetworkProvider.ts","../src/utils/calculateEvmTransactionFee/calculateEvmTransactionFee.ts","../src/simulateEvmTransaction/simulateEvmTransaction.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { sendSponsoredTransaction } from '../sendSponsoredTransaction';\n\ntype Activate7702DelegationParams = {\n  /** Pre-signed EIP-7702 authorization. If not provided, one will be signed automatically. */\n  authorization?: SignAuthorizationReturnType;\n  /** The EVM wallet account to activate delegation for. */\n  walletAccount: EvmWalletAccount;\n};\n\n/**\n * Activates EIP-7702 delegation for a wallet by sending a sponsored\n * transaction that only contains the 7702 authorization.\n *\n * After activation, the wallet's delegation is persisted on-chain and\n * subsequent sponsored transactions no longer need to include the\n * authorization.\n *\n * @example\n * ```ts\n * const { transactionHash } = await activate7702Delegation({\n *   walletAccount: evmAccount,\n * });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to activate delegation for.\n * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see is7702DelegationActive\n * @see sign7702Authorization\n * @notInstrumented\n */\nexport const activate7702Delegation = async (\n  { walletAccount, authorization }: Activate7702DelegationParams,\n  client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> =>\n  sendSponsoredTransaction(\n    { authorization, calls: [], walletAccount },\n    client\n  );\n","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 * @example\n * ```ts\n * const client = createDynamicClient({ environmentId: 'env-123' });\n * addEvmExtension(client);\n * ```\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns void\n * @see isEvmWalletAccount\n * @see isEvmNetworkProvider\n * @notInstrumented\n */\nexport const addEvmExtension = (client = getDefaultClient()): void => {\n  addEIP6963Extension(client);\n  addWaasEvmExtension(client);\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class EvmGasSponsorshipNotEnabledError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'evm_gas_sponsorship_not_enabled_error',\n      docsUrl: null,\n      name: 'EvmGasSponsorshipNotEnabledError',\n      shortMessage: 'EVM gas sponsorship is not enabled for this project',\n    });\n  }\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 * @example\n * ```ts\n * if (isEvmNetworkProvider(networkProvider)) {\n *   const publicClient = networkProvider.getPublicClient();\n * }\n * ```\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an EVM network provider, false otherwise.\n * @see isEvmWalletAccount\n * @see addEvmExtension\n * @notInstrumented\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 * @example\n * ```ts\n * const feeData = await calculateEvmTransactionFee({\n *   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },\n *   networkData,\n *   nativeTokenPriceUsd: 3500,\n * });\n * ```\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 * @see simulateEvmTransaction\n * @see isEvmWalletAccount\n * @notInstrumented\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 {\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 * @example\n * ```ts\n * const result = await simulateEvmTransaction({\n *   walletAccount: evmAccount,\n *   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },\n *   includeFees: true,\n * });\n * ```\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 * @see calculateEvmTransactionFee\n * @see isEvmWalletAccount\n * @notInstrumented\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 { activate7702Delegation } from '../gasless/activate7702Delegation';\nexport { addEvmExtension } from '../addEvmExtension';\nexport { EvmGasSponsorshipNotEnabledError } from '../errors/EvmGasSponsorshipNotEnabledError';\nexport { RpcError } from '../errors/RpcError';\nexport { SponsorTransactionError } from '../errors/SponsorTransactionError';\nexport type { EvmNetworkProvider } from '../EvmNetworkProvider';\nexport type { EvmWalletAccount } from '../EvmWalletAccount.types';\nexport type { EvmWalletProvider } from '../EvmWalletProvider.types';\nexport type {\n  SerializedAuthorization,\n  SignedSponsoredTransaction,\n  SponsoredTransactionCall,\n  SponsoredTransactionStatus,\n  SponsoredTransactionStatusResult,\n} from '../gasless/gasless.types';\nexport { getEVMSponsoredTransactionStatus } from '../gasless/getEVMSponsoredTransactionStatus';\nexport { is7702DelegationActive } from '../gasless/is7702DelegationActive';\nexport { isEvmGasSponsorshipEnabled } from '../gasless/isEvmGasSponsorshipEnabled';\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';\nexport { relaySponsoredTransaction } from '../gasless/relaySponsoredTransaction';\nexport { sendSponsoredTransaction } from '../gasless/sendSponsoredTransaction';\nexport { sign7702Authorization } from '../gasless/sign7702Authorization';\nexport { signSponsoredTransaction } from '../gasless/signSponsoredTransaction';\nexport { waitForSponsoredTransaction } from '../gasless/waitForSponsoredTransaction';\n"],"mappings":"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"}

package/dist/index.native.esm.js

@@ -1,8 +1,8 @@
-import { n as version, t as name } from "./package-Dt8Q4Vtr.native.esm.js";
-import { a as isEvmWalletAccount, c as sendSponsoredTransaction, d as relaySponsoredTransaction, f as signSponsoredTransaction, h as SponsorTransactionError, l as waitForSponsoredTransaction, m as is7702DelegationActive, p as sign7702Authorization, r as isEvmGasSponsorshipEnabled, s as RpcError, u as getEVMSponsoredTransactionStatus } from "./evmTransferAmount-B2lXHyW3.native.esm.js";
+import { n as version, t as name } from "./package-YT_Fw3US.native.esm.js";
+import { a as isEvmWalletAccount, c as sendSponsoredTransaction, d as relaySponsoredTransaction, f as signSponsoredTransaction, h as SponsorTransactionError, l as waitForSponsoredTransaction, m as is7702DelegationActive, p as sign7702Authorization, r as isEvmGasSponsorshipEnabled, s as RpcError, u as getEVMSponsoredTransactionStatus } from "./evmTransferAmount-D9Sygfbl.native.esm.js";
 import { r as createPublicClientFromNetworkData } from "./createWalletClientForWalletAccount-CsfxMvvD.native.esm.js";
 import { t as addEIP6963Extension } from "./addEIP6963Extension-h10IapXB.native.esm.js";
-import { t as addWaasEvmExtension } from "./addWaasEvmExtension-CJD8D1Sf.native.esm.js";
+import { t as addWaasEvmExtension } from "./addWaasEvmExtension-V3vwSfx0.native.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { BaseError, FeeEstimationFailedError, InvalidParamError, SimulationFailedError, getDefaultClient, getNetworksData } from "@dynamic-labs-sdk/client";
 import { createApiClient, getCore, getDefaultClient as getDefaultClient$1 } from "@dynamic-labs-sdk/client/core";
@@ -17,11 +17,20 @@ import { formatEther } from "viem";
 * subsequent sponsored transactions no longer need to include the
 * authorization.
 *
+* @example
+* ```ts
+* const { transactionHash } = await activate7702Delegation({
+*   walletAccount: evmAccount,
+* });
+* ```
+*
 * @param params.walletAccount - The EVM wallet account to activate delegation for.
 * @param [params.authorization] - Pre-signed authorization. If omitted, signs one automatically.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the on-chain transaction hash.
 * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+* @see is7702DelegationActive
+* @see sign7702Authorization
 * @notInstrumented
 */
 const activate7702Delegation = async ({ walletAccount, authorization }, client = getDefaultClient()) => sendSponsoredTransaction({
@@ -39,7 +48,16 @@ const activate7702Delegation = async ({ walletAccount, authorization }, client =
 * and the Dynamic WaaS EVM extension, enabling support for all EVM wallet types
 * including standard wallets and embedded wallets managed by Dynamic's infrastructure.
 *
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: 'env-123' });
+* addEvmExtension(client);
+* ```
+*
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see isEvmWalletAccount
+* @see isEvmNetworkProvider
 * @notInstrumented
 */
 const addEvmExtension = (client = getDefaultClient$1()) => {
@@ -66,8 +84,17 @@ var EvmGasSponsorshipNotEnabledError = class extends BaseError {
 /**
 * Type guard function to check if a network provider is an EVM network provider.
 *
+* @example
+* ```ts
+* if (isEvmNetworkProvider(networkProvider)) {
+*   const publicClient = networkProvider.getPublicClient();
+* }
+* ```
+*
 * @param networkProvider - The network provider to check.
 * @returns True if the network provider is an EVM network provider, false otherwise.
+* @see isEvmWalletAccount
+* @see addEvmExtension
 * @notInstrumented
 */
 const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM";
@@ -81,11 +108,22 @@ const isEvmNetworkProvider = (networkProvider) => networkProvider.chain === "EVM
 * using either legacy gas pricing or EIP-1559 pricing. The fee is returned
 * in both native units (wei) and human-readable format (ETH).
 *
+* @example
+* ```ts
+* const feeData = await calculateEvmTransactionFee({
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   networkData,
+*   nativeTokenPriceUsd: 3500,
+* });
+* ```
+*
 * @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.
+* @see simulateEvmTransaction
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const calculateEvmTransactionFee = async ({ transaction, networkData, nativeTokenPriceUsd }) => {
@@ -139,6 +177,15 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * The simulation shows what will happen when the transaction is executed without
 * actually sending it to the blockchain.
 *
+* @example
+* ```ts
+* const result = await simulateEvmTransaction({
+*   walletAccount: evmAccount,
+*   transaction: { from: '0x...', to: '0x...', value: 1000000000000000000n, networkId: '1' },
+*   includeFees: true,
+* });
+* ```
+*
 * @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).
@@ -147,6 +194,8 @@ const calculateEvmTransactionFee = async ({ transaction, networkData, nativeToke
 * @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.
+* @see calculateEvmTransactionFee
+* @see isEvmWalletAccount
 * @notInstrumented
 */
 const simulateEvmTransaction = async ({ walletAccount, transaction, includeFees = false }, client = getDefaultClient()) => {