npm - @dynamic-labs-sdk/zerodev - Versions diffs - 1.18.0 → 1.19.0 - Mend

@dynamic-labs-sdk/zerodev 1.18.0 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (34) hide show

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.cjs","names":["WalletProviderEnum","ZERODEV_METADATA","networkData: NetworkData \| undefined","getZerodevRpc","createKernelAccount","getPaymasterConfig","shouldUseEIP7702","InvalidParamError","ERC20_TRANSFER_ABI","chain: Chain","WalletProviderEnum","ZERODEV_METADATA","signMessage","InvalidParamError","signMessageUtils","getZerodevChainProviderForNetworkId","UnrecognizedNetworkError","WalletProviderPriority","getSignerForSmartWalletAccount","networkData: NetworkData \| undefined","constants","ZERODEV_METADATA","FeeEstimationFailedError","InvalidParamError","feeData: EvmSimulationResult['feeData']","FeeEstimationFailedError","SimulationFailedError","name","version"],"sources":["../src/utils/getAllUserZerodevAddresses/getAllUserZerodevAddresses.ts","../src/createKernelClientForWalletAccount/createKernelClientForWalletAccount.ts","../src/utils/shouldSignWithEoa/shouldSignWithEoa.ts","../src/utils/signMessage/signMessage.ts","../src/isGasSponsorshipError/isGasSponsorshipError.ts","../src/utils/zerodevTransferAmount/zerodevTransferAmount.ts","../src/utils/createZerodevWalletProvider/createZerodevWalletProvider.ts","../src/addZerodevExtension/addZerodevExtension.ts","../src/utils/prepareUserOperationFromCalls/prepareUserOperationFromCalls.ts","../src/canSponsorUserOperation/canSponsorUserOperation.ts","../src/utils/calculateGasForUserOperation/calculateGasForUserOperation.ts","../src/estimateUserOperationGas/estimateUserOperationGas.ts","../src/sendUserOperation/sendUserOperation.ts","../src/signEip7702Authorization/signEip7702Authorization.ts","../src/isZerodevWalletAccount/isZerodevWalletAccount.ts","../src/utils/calculateFeeForUserOperation/calculateFeeForUserOperation.ts","../src/utils/hasRequiredGasFields/hasRequiredGasFields.ts","../src/simulateZerodevUserOperation/simulateZerodevUserOperation.ts","../src/exports/index.ts"],"sourcesContent":["import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getChainFromVerifiedCredentialChain } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport { ZERODEV_METADATA } from '../../constants';\n\n/** @notInstrumented /\nexport const getAllUserZerodevAddresses = (client: DynamicClient): string[] => {\n const zerodevWalletCredentials =\n client.user?.verifiedCredentials.filter(\n (credential) =>\n credential.walletProvider === WalletProviderEnum.SmartContractWallet &&\n credential.walletName\n ?.toLowerCase()\n .startsWith(ZERODEV_METADATA.normalizedWalletName) &&\n credential.address &&\n credential.chain &&\n getChainFromVerifiedCredentialChain(credential.chain) === 'EVM'\n ) ?? [];\n\n const zerodevAddresses: string[] = zerodevWalletCredentials.map(\n // casting because we're already filtering out credentials without an address\n (credential) => credential.address as string\n );\n\n return zerodevAddresses;\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n getNetworkDataForNetworkId,\n} from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport { mapNetworkDataToViemChain } from '@dynamic-labs-sdk/evm/viem';\nimport type { ZerodevBundlerProvider } from '@dynamic-labs/sdk-api-core';\nimport {\n createKernelAccountClient,\n getUserOperationGasPrice,\n} from '@zerodev/sdk';\nimport type { Hex } from 'viem';\nimport { createPublicClient, http } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { KernelClient } from '../KernelClient.types';\nimport { createKernelAccount } from '../utils/createKernelAccount';\nimport { getPaymasterConfig } from '../utils/getPaymasterConfig';\nimport { getZerodevRpc } from '../utils/getZerodevRpc';\n\nexport type Eip7702Authorization = SignAuthorizationReturnType;\n\ntype CreateKernelClientForWalletAccountParams = {\n bundlerProvider?: ZerodevBundlerProvider;\n bundlerRpc?: string;\n eip7702Auth?: SignAuthorizationReturnType;\n gasTokenAddress?: Hex;\n networkId?: string;\n paymasterRpc?: string;\n smartWalletAccount: EvmWalletAccount;\n withSponsorship?: boolean;\n};\n\n/\n Creates a KernelClient instance for a given smart wallet account.\n \n @param params.smartWalletAccount - The smart wallet account to create the KernelClient for.\n * @param [params.bundlerProvider] - A custom bundler provider to use\n * @param [params.bundlerRpc] - A custom bundler RPC to use\n * @param [params.networkId] - The network ID to use for the KernelClient.\n * If not provided, the network ID will be fetched from the active network data.\n * @param [params.paymasterRpc] - A custom paymaster RPC to use\n * @param [params.gasTokenAddress] - The address of a custom ERC20 token to use as a gas token\n * @param [params.withSponsorship] - Whether to use sponsorship for the KernelClient or not (default is true).\n * @param [params.eip7702Auth] - A pre-signed EIP-7702 authorization. When provided, the kernel client uses \n * this authorization instead of signing a new one internally. Useful for singleUse MFA flows where you need\n * to separate the authorization signing step from the transaction step.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A promise that resolves to a KernelClient instance.\n * @notInstrumented\n /\nexport const createKernelClientForWalletAccount = async (\n {\n smartWalletAccount,\n withSponsorship = true,\n bundlerProvider,\n networkId,\n bundlerRpc: bundlerRpcOverride,\n paymasterRpc: paymasterRpcOverride,\n gasTokenAddress,\n eip7702Auth,\n }: CreateKernelClientForWalletAccountParams,\n client = getDefaultClient()\n): Promise<KernelClient> => {\n let networkData: NetworkData \| undefined;\n\n if (networkId) {\n networkData = getNetworkDataForNetworkId(\n { chain: 'EVM', networkId },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for specified network ID: ${networkId}. Make sure the network is enabled for your project.`\n );\n } else {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount: smartWalletAccount },\n client\n );\n\n networkData = activeNetworkData.networkData;\n\n assertDefined(\n networkData,\n `No active network data found for this wallet account.`\n );\n }\n\n const viemChain = mapNetworkDataToViemChain(networkData);\n\n const bundlerRpc =\n bundlerRpcOverride ??\n getZerodevRpc(\n {\n bundlerProvider,\n networkId: networkData.networkId,\n rpcType: 'bundler',\n },\n client\n );\n\n const bundlerTransport = http(bundlerRpc);\n\n const publicClient = createPublicClient({\n chain: viemChain,\n transport: bundlerTransport,\n });\n\n const account = await createKernelAccount(\n {\n eip7702Auth,\n publicClient,\n smartWalletAccount,\n },\n client\n );\n\n const paymasterRpc =\n paymasterRpcOverride ??\n getZerodevRpc(\n {\n bundlerProvider,\n networkId: networkData.networkId,\n rpcType: 'paymaster',\n },\n client\n );\n\n const paymasterConfig = withSponsorship\n ? getPaymasterConfig({\n chain: viemChain,\n gasTokenAddress,\n paymasterRpc,\n })\n : {};\n\n return createKernelAccountClient({\n account,\n bundlerTransport,\n chain: viemChain,\n client: publicClient,\n userOperation: {\n estimateFeesPerGas: async ({ bundlerClient }) =>\n getUserOperationGasPrice(bundlerClient),\n },\n ...paymasterConfig,\n });\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { KernelClient } from '../../KernelClient.types';\nimport { shouldUseEIP7702 } from '../shouldUseEIP7702';\n\ntype ShouldSignWithEoaParams = {\n kernelClient: KernelClient;\n smartWalletAccount: EvmWalletAccount;\n};\n\n/* @notInstrumented /\nexport const shouldSignWithEoa = async (\n { kernelClient, smartWalletAccount }: ShouldSignWithEoaParams,\n client: DynamicClient\n) => {\n const useEIP7702 = shouldUseEIP7702({ smartWalletAccount }, client);\n\n if (!useEIP7702) {\n return false;\n }\n\n const isDeployed = await kernelClient.account.isDeployed();\n\n return !isDeployed;\n};\n","import {\n type DynamicClient,\n getOwnerWalletAccountForSmartWalletAccount,\n signMessage as signMessageWithWalletAccount,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport { createKernelClientForWalletAccount } from '../../createKernelClientForWalletAccount';\nimport { shouldSignWithEoa } from '../shouldSignWithEoa';\n\ntype SignMessageParams = {\n message: string;\n walletAccount: EvmWalletAccount;\n};\n\n/* @notInstrumented /\nexport const signMessage = async (\n { walletAccount, message }: SignMessageParams,\n client: DynamicClient\n): Promise<{ signature: string }> => {\n const kernelClient = await createKernelClientForWalletAccount(\n { smartWalletAccount: walletAccount },\n client\n );\n\n const shouldUseEoa = await shouldSignWithEoa(\n {\n kernelClient,\n smartWalletAccount: walletAccount,\n },\n client\n );\n\n if (shouldUseEoa) {\n const eoaWalletAccount = getOwnerWalletAccountForSmartWalletAccount(\n { smartWalletAccount: walletAccount },\n client\n );\n\n assertDefined(eoaWalletAccount, 'Eoa wallet account not found');\n\n const { signature } = await signMessageWithWalletAccount({\n message,\n walletAccount: eoaWalletAccount,\n });\n\n return { signature };\n }\n\n const signature = await kernelClient.signMessage({ message });\n return { signature };\n};\n","/* @notInstrumented /\nexport const isGasSponsorshipError = (err: unknown): boolean => {\n const errorWithMessage = err as { message?: string } \| undefined;\n\n return (\n errorWithMessage?.message?.includes(\n 'userOp did not match any gas sponsoring policies'\n ) \|\| false\n );\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { InvalidParamError } from '@dynamic-labs-sdk/client';\nimport {\n type TransferAmountParams,\n parseAmountToSmallestUnit,\n} from '@dynamic-labs-sdk/client/core';\nimport { isEvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { Hex } from 'viem';\nimport { encodeFunctionData } from 'viem';\n\nimport { ERC20_TRANSFER_ABI } from '../../constants';\nimport { createKernelClientForWalletAccount } from '../../createKernelClientForWalletAccount';\nimport { isGasSponsorshipError } from '../../isGasSponsorshipError';\n\nconst EVM_NATIVE_DECIMALS = 18;\n\n/\n Transfers native ETH or an ERC-20 token via a ZeroDev smart wallet.\n \n Attempts with gas sponsorship first, then falls back to unsponsored\n * if the paymaster rejects.\n * @notInstrumented\n /\nexport const zerodevTransferAmount = async (\n { amount, recipient, token, walletAccount }: TransferAmountParams,\n client: DynamicClient\n): Promise<{ transactionHash: string }> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n // eslint-disable-next-line custom-rules/require-single-object-param\n const sendTransaction = async (withSponsorship: boolean) => {\n const kernelClient = await createKernelClientForWalletAccount(\n { smartWalletAccount: walletAccount, withSponsorship },\n client\n );\n\n if (token?.address) {\n const smallestUnit = parseAmountToSmallestUnit({\n amount,\n decimals: token.decimals,\n });\n\n const data = encodeFunctionData({\n abi: ERC20_TRANSFER_ABI,\n args: [recipient as Hex, smallestUnit],\n functionName: 'transfer',\n });\n\n return kernelClient.sendTransaction({\n data,\n to: token.address as Hex,\n });\n }\n\n const value = parseAmountToSmallestUnit({\n amount,\n decimals: EVM_NATIVE_DECIMALS,\n });\n\n return kernelClient.sendTransaction({\n to: recipient as Hex,\n value,\n });\n };\n\n try {\n const hash = await sendTransaction(true);\n\n return { transactionHash: hash };\n } catch (error) {\n if (!isGasSponsorshipError(error)) {\n throw error;\n }\n\n const hash = await sendTransaction(false);\n\n return { transactionHash: hash };\n }\n};\n","import {\n type Chain,\n type DynamicClient,\n InvalidParamError,\n UnrecognizedNetworkError,\n type WalletAccount,\n} from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n formatWalletProviderGroupKey,\n formatWalletProviderKey,\n getActiveNetworkIdFromLastKnownRegistry,\n switchActiveNetworkInLastKnownRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport {\n type EvmWalletProvider,\n isEvmWalletAccount,\n} from '@dynamic-labs-sdk/evm';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport { ZERODEV_METADATA } from '../../constants';\nimport { getAllUserZerodevAddresses } from '../getAllUserZerodevAddresses';\nimport { getZerodevChainProviderForNetworkId } from '../getZerodevChainProviderForNetworkId';\nimport { signMessage as signMessageUtils } from '../signMessage';\nimport { zerodevTransferAmount } from '../zerodevTransferAmount';\n\n/* @notInstrumented /\nexport const createZerodevWalletProvider = (\n client: DynamicClient\n): EvmWalletProvider => {\n const chain: Chain = 'EVM';\n const walletProviderType = WalletProviderEnum.SmartContractWallet;\n const key = formatWalletProviderKey({\n chain,\n displayName: ZERODEV_METADATA.displayName,\n walletProviderType,\n });\n\n const getActiveNetworkId = async () =>\n getActiveNetworkIdFromLastKnownRegistry({\n client,\n walletProviderKey: key,\n });\n\n const getConnectedAddresses = async () => {\n const zerodevAddresses = getAllUserZerodevAddresses(client);\n\n return {\n addresses: zerodevAddresses,\n };\n };\n\n const signMessage = async ({\n walletAccount,\n message,\n }: {\n message: string;\n walletAccount?: WalletAccount;\n }) => {\n assertDefined(walletAccount, 'Wallet account is required');\n\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError(`walletAccount is not an EVM wallet account`);\n }\n\n return signMessageUtils({ message, walletAccount }, client);\n };\n\n const switchActiveNetwork = async ({ networkId }: { networkId: string }) => {\n const isNetworkEnabled = getZerodevChainProviderForNetworkId(\n { networkId },\n client\n );\n\n if (!isNetworkEnabled) {\n throw new UnrecognizedNetworkError({\n networkId,\n originalError: null,\n walletProviderKey: key,\n });\n }\n\n return switchActiveNetworkInLastKnownRegistry({\n client,\n networkId,\n walletProviderKey: key,\n });\n };\n\n return {\n chain,\n getActiveNetworkId,\n getConnectedAddresses,\n groupKey: formatWalletProviderGroupKey(ZERODEV_METADATA.displayName),\n key,\n metadata: {\n displayName: ZERODEV_METADATA.displayName,\n icon: ZERODEV_METADATA.icon,\n },\n signMessage,\n switchActiveNetwork,\n transferAmount: (args) => zerodevTransferAmount(args, client),\n walletProviderType,\n };\n};\n","import {\n WalletProviderPriority,\n getDefaultClient,\n getWalletProviderRegistry,\n hasExtension,\n registerExtension,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { createZerodevWalletProvider } from '../utils/createZerodevWalletProvider';\n\nexport const ZERODEV_EXTENSION_KEY = 'zerodev';\n\n/\n Adds the ZeroDev extension to the Dynamic client.\n \n This extension enables Account Abstraction integration with ZeroDev\n \n @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @notInstrumented\n /\nexport const addZerodevExtension = (client = getDefaultClient()) => {\n if (hasExtension({ extensionKey: ZERODEV_EXTENSION_KEY }, client)) {\n return;\n }\n\n registerExtension({ extensionKey: ZERODEV_EXTENSION_KEY }, client);\n\n const walletProviderRegistry = getWalletProviderRegistry(client);\n\n const walletProvider = createZerodevWalletProvider(client);\n\n walletProviderRegistry.register({\n priority: WalletProviderPriority.WALLET_SDK,\n walletProvider,\n });\n};\n","import type { BatchCall } from '../../BatchCall.types';\nimport type { KernelClient } from '../../KernelClient.types';\n\nexport type PrepareUserOperationFromCallsParams = {\n calls: BatchCall[];\n kernelClient: KernelClient;\n};\n\n/\n Prepares a user operation from an array of calls\n * Replaces prepareUserOperationWithKernelClient to handle both single and batch transactions\n \n @param params.kernelClient - The kernel client to use for preparing the user operation\n * @param params.calls - Array of calls (can be single call or multiple calls)\n * @returns Promise resolving to the prepared user operation\n * @notInstrumented\n /\nexport const prepareUserOperationFromCalls = async ({\n kernelClient,\n calls,\n}: PrepareUserOperationFromCallsParams) => {\n // Normalize calls to ensure data field exists\n const normalizedCalls = calls.map((call) => ({\n data: call.data ?? '0x',\n to: call.to,\n value: call.value,\n }));\n\n const callData = await kernelClient.account.encodeCalls(normalizedCalls);\n\n return kernelClient.prepareUserOperation({\n callData,\n });\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport type { KernelClient } from '../KernelClient.types';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\ntype CanSponsorUserOperationBaseParams = {\n calls: BatchCall[];\n};\n\ntype CanSponsorUserOperationWithWalletParams =\n CanSponsorUserOperationBaseParams & {\n kernelClient?: never;\n walletAccount: EvmWalletAccount;\n };\n\ntype CanSponsorUserOperationWithClientParams =\n CanSponsorUserOperationBaseParams & {\n kernelClient: KernelClient;\n walletAccount?: never;\n };\n\nexport type CanSponsorUserOperationParams =\n \| CanSponsorUserOperationWithWalletParams\n \| CanSponsorUserOperationWithClientParams;\n\n/\n Checks if a user operation can be sponsored by the paymaster\n * Handles both single transactions and batch transactions\n \n @param params.calls - Array of calls (single call or multiple calls)\n * @param params.kernelClient - Optional kernel client with sponsorship configured\n * @param params.walletAccount - The wallet account to use (required if kernelClient not provided)\n * @returns True if the user operation can be sponsored, false otherwise\n * @notInstrumented\n /\nexport const canSponsorUserOperation = async ({\n walletAccount,\n calls,\n kernelClient,\n}: CanSponsorUserOperationParams): Promise<boolean> => {\n let kernelClientToUse = kernelClient;\n\n if (!kernelClientToUse) {\n assertDefined(\n walletAccount,\n 'Please provide either a wallet account or a kernel client in the parameters'\n );\n\n kernelClientToUse = await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n });\n }\n\n try {\n const sponsorResult = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientToUse,\n });\n\n const hasPaymaster = sponsorResult.paymasterAndData !== '0x';\n\n return hasPaymaster;\n } catch {\n return false;\n }\n};\n","import type { UserOperation } from 'viem/account-abstraction';\n\ntype CalculateGasForUserOperationParams = {\n userOperationData: Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n >;\n};\n\n/* @notInstrumented /\nexport const calculateGasForUserOperation = ({\n userOperationData,\n}: CalculateGasForUserOperationParams): bigint => {\n // Sum all gas units\n const totalGasUnits =\n userOperationData.callGasLimit +\n userOperationData.verificationGasLimit +\n userOperationData.preVerificationGas;\n\n // Multiply by maxFeePerGas to get the total gas cost in wei\n const gasCost = totalGasUnits userOperationData.maxFeePerGas;\n\n return gasCost;\n};\n","import type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport { calculateGasForUserOperation } from '../utils/calculateGasForUserOperation';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\nexport type EstimateUserOperationGasParams = {\n calls: BatchCall[];\n walletAccount: EvmWalletAccount;\n};\n\n/*\n Estimates the total gas cost for a user operation with one or more calls\n * Handles both single transactions and batch transactions\n \n @param params.calls - Array of calls (single call or multiple calls)\n * @param params.walletAccount - The wallet account that will execute the user operation\n * @returns The estimated gas cost in wei, or null if estimation fails\n * @notInstrumented\n /\nexport const estimateUserOperationGas = async ({\n walletAccount,\n calls,\n}: EstimateUserOperationGasParams): Promise<bigint \| null> => {\n try {\n const kernelClientWithoutSponsorship =\n await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n withSponsorship: false,\n });\n\n const unsponsoredUserOperation = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientWithoutSponsorship,\n });\n\n return calculateGasForUserOperation({\n userOperationData: unsponsoredUserOperation,\n });\n } catch {\n return null;\n }\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { UserOperationReceipt } from 'viem/account-abstraction';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport type { KernelClient } from '../KernelClient.types';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\ntype SendUserOperationBaseParams = {\n calls: BatchCall[];\n};\n\ntype SendUserOperationWithWalletParams = SendUserOperationBaseParams & {\n kernelClient?: never;\n walletAccount: EvmWalletAccount;\n withSponsorship?: boolean;\n};\n\ntype SendUserOperationWithClientParams = SendUserOperationBaseParams & {\n kernelClient: KernelClient;\n walletAccount?: never;\n withSponsorship?: never;\n};\n\nexport type SendUserOperationParams =\n \| SendUserOperationWithWalletParams\n \| SendUserOperationWithClientParams;\n\n/\n Sends a user operation with one or more calls\n * Handles both single transactions and batch transactions\n \n @param params.calls - Array of calls (single call or multiple calls)\n * @param params.kernelClient - Optional pre-configured kernel client\n * @param params.walletAccount - The wallet account to use (required if kernelClient not provided)\n * @param params.withSponsorship - Whether to use sponsorship (default: true, only used with walletAccount)\n * @returns Promise resolving to the UserOperation receipt\n * @notInstrumented\n /\nexport const sendUserOperation = async ({\n walletAccount,\n calls,\n kernelClient,\n withSponsorship = true,\n}: SendUserOperationParams): Promise<UserOperationReceipt> => {\n let kernelClientToUse = kernelClient;\n\n if (!kernelClientToUse) {\n assertDefined(\n walletAccount,\n 'Please provide either a wallet account or a kernel client in the parameters'\n );\n\n kernelClientToUse = await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n withSponsorship,\n });\n }\n\n const userOperation = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientToUse,\n });\n\n // Type cast needed: prepareUserOperation returns a fully prepared UserOperation with all fields,\n // but sendUserOperation's discriminated union types expect specific field combinations.\n // This is safe as the prepared operation is compatible at runtime.\n const userOperationHash = await kernelClientToUse.sendUserOperation(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n userOperation as any\n );\n\n return kernelClientToUse.waitForUserOperationReceipt({\n hash: userOperationHash,\n });\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n getNetworkDataForNetworkId,\n} from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport { mapNetworkDataToViemChain } from '@dynamic-labs-sdk/evm/viem';\nimport { constants } from '@zerodev/sdk';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\nimport { signAuthorization } from 'viem/actions';\n\nimport { getSignerForSmartWalletAccount } from '../getSignerForSmartWalletAccount';\n\nexport type SignEip7702AuthorizationParams = {\n networkId?: string;\n smartWalletAccount: EvmWalletAccount;\n};\n\n/\n Signs an EIP-7702 authorization for ZeroDev kernel delegation.\n \n This function creates a signed authorization that allows a wallet to delegate\n * its execution to the ZeroDev kernel contract. The signed authorization can then\n * be passed to `createKernelClientForWalletAccount` via the `eip7702Auth` parameter.\n \n @param params - The parameters for signing the authorization.\n * @param params.smartWalletAccount - The EVM smart wallet account to sign the authorization for.\n * @param [params.networkId] - The network ID to use for signing. If not provided, uses the wallet's active network.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A promise that resolves to the signed EIP-7702 authorization.\n * @notInstrumented\n /\nexport const signEip7702Authorization = async (\n { smartWalletAccount, networkId }: SignEip7702AuthorizationParams,\n client = getDefaultClient()\n): Promise<SignAuthorizationReturnType> => {\n const walletClient = await getSignerForSmartWalletAccount(\n { smartWalletAccount },\n client\n );\n\n let networkData: NetworkData \| undefined;\n\n if (networkId) {\n networkData = getNetworkDataForNetworkId(\n { chain: 'EVM', networkId },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for specified network ID: ${networkId}. Make sure the network is enabled for your project.`\n );\n } else {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount: smartWalletAccount },\n client\n );\n\n networkData = activeNetworkData.networkData;\n\n assertDefined(\n networkData,\n 'No active network data found for this wallet account.'\n );\n }\n\n const viemChain = mapNetworkDataToViemChain(networkData);\n\n return signAuthorization(walletClient, {\n chainId: viemChain.id,\n contractAddress: constants.KERNEL_7702_DELEGATION_ADDRESS,\n });\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport { ZERODEV_METADATA } from '../constants';\n\n/\n Type guard function to check if a wallet account is a Zerodev wallet account.\n \n @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is a Zerodev wallet account, false otherwise.\n * @notInstrumented\n /\nexport const isZerodevWalletAccount = (\n walletAccount: WalletAccount\n): boolean => {\n return walletAccount.walletProviderKey.startsWith(\n ZERODEV_METADATA.normalizedWalletName\n );\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { FeeEstimationFailedError } from '@dynamic-labs-sdk/client';\nimport type { EvmTransactionFeeData } from '@dynamic-labs-sdk/evm';\nimport { formatEther } from 'viem';\nimport type { UserOperation } from 'viem/account-abstraction';\n\nimport { calculateGasForUserOperation } from '../calculateGasForUserOperation';\n\ntype CalculateFeeForUserOperationParams = {\n nativeTokenPriceUsd?: number;\n networkData: NetworkData;\n userOperationData: Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n >;\n};\n\n/\n Calculates the estimated fee for a ZeroDev user operation.\n \n This function estimates the total gas cost for a user operation by summing\n * all gas components (call, verification, pre-verification) and multiplying\n * by the maximum fee per gas unit.\n \n @param params.userOperationData - The user operation data containing gas limits and fees.\n * @param params.networkData - Network configuration (not currently used but kept for consistency).\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 fee calculation fails.\n * @notInstrumented\n /\nexport const calculateFeeForUserOperation = ({\n userOperationData,\n networkData: _networkData,\n nativeTokenPriceUsd,\n}: CalculateFeeForUserOperationParams): EvmTransactionFeeData => {\n try {\n // Calculate total gas cost in wei\n const nativeAmount = calculateGasForUserOperation({ userOperationData });\n\n // Calculate total gas units\n const gasEstimate =\n userOperationData.callGasLimit +\n userOperationData.verificationGasLimit +\n userOperationData.preVerificationGas;\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 humanReadableAmount,\n maxFeePerGas: userOperationData.maxFeePerGas,\n nativeAmount,\n usdAmount,\n };\n } catch (error) {\n throw new FeeEstimationFailedError({\n cause: error instanceof Error ? error : undefined,\n message: 'Failed to calculate user operation fee',\n });\n }\n};\n","import type { UserOperation } from 'viem/account-abstraction';\n\ntype UserOperationWithGasFields = Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n>;\n\n/*\n Type guard to check if a partial user operation has all required gas fields.\n \n This function narrows the type of a Partial<UserOperation> to ensure it has\n * the required gas fields needed for fee calculation. Use this when you need to\n * validate that gas fields are present before performing fee calculations.\n \n @param userOperation - The partial user operation to check.\n * @returns True if all required gas fields are present, false otherwise.\n \n @example\n * ```typescript\n * if (hasRequiredGasFields(userOperation)) {\n * // TypeScript now knows these fields are defined\n * const fee = calculateFee({\n * callGasLimit: userOperation.callGasLimit,\n * maxFeePerGas: userOperation.maxFeePerGas,\n * preVerificationGas: userOperation.preVerificationGas,\n * verificationGasLimit: userOperation.verificationGasLimit,\n * });\n * }\n * ```\n * @notInstrumented\n /\nexport const hasRequiredGasFields = (\n userOperation: Partial<UserOperation>\n): userOperation is Partial<UserOperation> & UserOperationWithGasFields =>\n Boolean(\n userOperation.callGasLimit &&\n userOperation.verificationGasLimit &&\n userOperation.preVerificationGas &&\n userOperation.maxFeePerGas\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 {\n EvmSimulationResult,\n EvmWalletAccount,\n} from '@dynamic-labs-sdk/evm';\nimport { isEvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { UserOperation } from 'viem/account-abstraction';\n\nimport { canSponsorUserOperation } from '../canSponsorUserOperation';\nimport { isZerodevWalletAccount } from '../isZerodevWalletAccount';\nimport { calculateFeeForUserOperation } from '../utils/calculateFeeForUserOperation';\nimport { hasRequiredGasFields } from '../utils/hasRequiredGasFields';\n\ntype SimulateZerodevUserOperationParams = {\n entryPoint: string;\n includeFees?: boolean;\n networkId: string;\n userOperation: Partial<UserOperation>;\n walletAccount: EvmWalletAccount;\n};\n\n/\n Simulates a ZeroDev user operation to preview its effects before execution.\n \n This function uses the Blockaid API to analyze the user operation and returns\n * information about asset transfers, security validation, and optionally fee estimates.\n * For account abstraction wallets, it also checks if gas sponsorship is available.\n \n Important: A successful simulation does not guarantee the user operation will succeed.\n * The simulation may succeed but indicate the operation would fail (e.g., due to\n * insufficient balance, reverted contract call). Check the `validation` field in the\n * result for potential issues.\n \n @param params.walletAccount - The EVM smart wallet account that will execute the operation.\n * @param params.userOperation - The user operation to simulate.\n * @param params.networkId - The network ID where the operation will be executed (e.g., '137' for Polygon).\n * @param params.entryPoint - The entry point contract address for the user operation.\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 ZeroDev 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 simulateZerodevUserOperation = async (\n {\n walletAccount,\n userOperation,\n networkId,\n entryPoint,\n includeFees = false,\n }: SimulateZerodevUserOperationParams,\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 if (!isZerodevWalletAccount(walletAccount)) {\n throw new InvalidParamError(\n 'Wallet account must be a ZeroDev wallet account'\n );\n }\n\n // Get network data for the specified network\n const networksData = getNetworksData(client);\n const networkData = networksData.find(\n (data) => data.networkId === networkId && data.chain === 'EVM'\n );\n\n if (!networkData) {\n throw new InvalidParamError(\n `Network with ID ${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 // Note: The API endpoint for user operations might be different\n // This implementation assumes simulateUserOp exists on the API client\n // If it doesn't exist, we may need to use simulateEVMTransaction instead\n const response = await apiClient.simulateUserOp({\n environmentId: core.environmentId,\n simulateUserOpRequest: {\n chainId: networkId,\n entryPoint,\n operation: {\n callData: userOperation.callData \|\| '0x',\n callGasLimit: userOperation.callGasLimit?.toString() \|\| '0',\n maxFeePerGas: userOperation.maxFeePerGas?.toString() \|\| '0',\n maxPriorityFeePerGas:\n userOperation.maxPriorityFeePerGas?.toString() \|\| '0',\n nonce: userOperation.nonce?.toString() \|\| '0',\n preVerificationGas:\n userOperation.preVerificationGas?.toString() \|\| '0',\n sender: userOperation.sender \|\| '',\n signature: userOperation.signature \|\| '0x',\n verificationGasLimit:\n userOperation.verificationGasLimit?.toString() \|\| '0',\n },\n value: '0',\n },\n });\n\n // Calculate fees if requested\n let feeData: EvmSimulationResult['feeData'];\n\n if (includeFees) {\n // Check if the transaction can be sponsored\n const isSponsored =\n userOperation.callData &&\n userOperation.sender &&\n (await canSponsorUserOperation({\n calls: [\n {\n data: userOperation.callData,\n to: userOperation.sender as `0x${string}`,\n value: 0n,\n },\n ],\n walletAccount,\n }));\n\n if (isSponsored) {\n // Sponsored transaction - no fee for user\n feeData = {\n gasEstimate: 0n,\n humanReadableAmount: '0',\n nativeAmount: 0n,\n usdAmount: '0.00',\n };\n } else if (hasRequiredGasFields(userOperation)) {\n // User pays fee - calculate it\n feeData = calculateFeeForUserOperation({\n nativeTokenPriceUsd: response.priceData?.nativeTokenUsdPrice,\n networkData,\n userOperationData: {\n callGasLimit: userOperation.callGasLimit,\n maxFeePerGas: userOperation.maxFeePerGas,\n preVerificationGas: userOperation.preVerificationGas,\n verificationGasLimit: userOperation.verificationGasLimit,\n },\n });\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 ZeroDev user operation',\n });\n }\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { addZerodevExtension } from '../addZerodevExtension';\nexport type { BatchCall } from '../BatchCall.types';\nexport { canSponsorUserOperation } from '../canSponsorUserOperation';\nexport type { CanSponsorUserOperationParams } from '../canSponsorUserOperation';\nexport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nexport type { Eip7702Authorization } from '../createKernelClientForWalletAccount';\nexport { estimateUserOperationGas } from '../estimateUserOperationGas';\nexport type { EstimateUserOperationGasParams } from '../estimateUserOperationGas';\nexport { getSignerForSmartWalletAccount } from '../getSignerForSmartWalletAccount';\nexport { isGasSponsorshipError } from '../isGasSponsorshipError';\nexport type { KernelClient } from '../KernelClient.types';\nexport { sendUserOperation } from '../sendUserOperation';\nexport type { SendUserOperationParams } from '../sendUserOperation';\nexport { signEip7702Authorization } from '../signEip7702Authorization';\nexport { simulateZerodevUserOperation } from '../simulateZerodevUserOperation';\nexport { calculateFeeForUserOperation } from '../utils/calculateFeeForUserOperation';\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.cjs","names":["WalletProviderEnum","ZERODEV_METADATA","networkData: NetworkData \| undefined","getZerodevRpc","createKernelAccount","getPaymasterConfig","shouldUseEIP7702","InvalidParamError","ERC20_TRANSFER_ABI","chain: Chain","WalletProviderEnum","ZERODEV_METADATA","signMessage","InvalidParamError","signMessageUtils","getZerodevChainProviderForNetworkId","UnrecognizedNetworkError","WalletProviderPriority","getSignerForSmartWalletAccount","networkData: NetworkData \| undefined","constants","ZERODEV_METADATA","FeeEstimationFailedError","InvalidParamError","feeData: EvmSimulationResult['feeData']","FeeEstimationFailedError","SimulationFailedError","name","version"],"sources":["../src/utils/getAllUserZerodevAddresses/getAllUserZerodevAddresses.ts","../src/createKernelClientForWalletAccount/createKernelClientForWalletAccount.ts","../src/utils/shouldSignWithEoa/shouldSignWithEoa.ts","../src/utils/signMessage/signMessage.ts","../src/isGasSponsorshipError/isGasSponsorshipError.ts","../src/utils/zerodevTransferAmount/zerodevTransferAmount.ts","../src/utils/createZerodevWalletProvider/createZerodevWalletProvider.ts","../src/addZerodevExtension/addZerodevExtension.ts","../src/utils/prepareUserOperationFromCalls/prepareUserOperationFromCalls.ts","../src/canSponsorUserOperation/canSponsorUserOperation.ts","../src/utils/calculateGasForUserOperation/calculateGasForUserOperation.ts","../src/estimateUserOperationGas/estimateUserOperationGas.ts","../src/sendUserOperation/sendUserOperation.ts","../src/signEip7702Authorization/signEip7702Authorization.ts","../src/isZerodevWalletAccount/isZerodevWalletAccount.ts","../src/utils/calculateFeeForUserOperation/calculateFeeForUserOperation.ts","../src/utils/hasRequiredGasFields/hasRequiredGasFields.ts","../src/simulateZerodevUserOperation/simulateZerodevUserOperation.ts","../src/exports/index.ts"],"sourcesContent":["import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getChainFromVerifiedCredentialChain } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport { ZERODEV_METADATA } from '../../constants';\n\n/** @notInstrumented /\nexport const getAllUserZerodevAddresses = (client: DynamicClient): string[] => {\n const zerodevWalletCredentials =\n client.user?.verifiedCredentials.filter(\n (credential) =>\n credential.walletProvider === WalletProviderEnum.SmartContractWallet &&\n credential.walletName\n ?.toLowerCase()\n .startsWith(ZERODEV_METADATA.normalizedWalletName) &&\n credential.address &&\n credential.chain &&\n getChainFromVerifiedCredentialChain(credential.chain) === 'EVM'\n ) ?? [];\n\n const zerodevAddresses: string[] = zerodevWalletCredentials.map(\n // casting because we're already filtering out credentials without an address\n (credential) => credential.address as string\n );\n\n return zerodevAddresses;\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n getNetworkDataForNetworkId,\n} from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport { mapNetworkDataToViemChain } from '@dynamic-labs-sdk/evm/viem';\nimport type { ZerodevBundlerProvider } from '@dynamic-labs/sdk-api-core';\nimport {\n createKernelAccountClient,\n getUserOperationGasPrice,\n} from '@zerodev/sdk';\nimport type { Hex } from 'viem';\nimport { createPublicClient, http } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { KernelClient } from '../KernelClient.types';\nimport { createKernelAccount } from '../utils/createKernelAccount';\nimport { getPaymasterConfig } from '../utils/getPaymasterConfig';\nimport { getZerodevRpc } from '../utils/getZerodevRpc';\n\nexport type Eip7702Authorization = SignAuthorizationReturnType;\n\ntype CreateKernelClientForWalletAccountParams = {\n bundlerProvider?: ZerodevBundlerProvider;\n bundlerRpc?: string;\n eip7702Auth?: SignAuthorizationReturnType;\n gasTokenAddress?: Hex;\n networkId?: string;\n paymasterRpc?: string;\n smartWalletAccount: EvmWalletAccount;\n withSponsorship?: boolean;\n};\n\n/\n Creates a KernelClient instance for a given smart wallet account.\n \n @example\n * ```ts\n * const kernelClient = await createKernelClientForWalletAccount({\n * smartWalletAccount: evmSmartWallet,\n * });\n * ```\n \n @param params.smartWalletAccount - The smart wallet account to create the KernelClient for.\n * @param [params.bundlerProvider] - A custom bundler provider to use.\n * @param [params.bundlerRpc] - A custom bundler RPC to use.\n * @param [params.networkId] - The network ID to use for the KernelClient.\n * @param [params.paymasterRpc] - A custom paymaster RPC to use.\n * @param [params.gasTokenAddress] - The address of a custom ERC20 token to use as a gas token.\n * @param [params.withSponsorship] - Whether to use sponsorship for the KernelClient or not (default is true).\n * @param [params.eip7702Auth] - A pre-signed EIP-7702 authorization for singleUse MFA flows.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A promise that resolves to a KernelClient instance.\n * @see sendUserOperation\n * @see getSignerForSmartWalletAccount\n * @notInstrumented\n /\nexport const createKernelClientForWalletAccount = async (\n {\n smartWalletAccount,\n withSponsorship = true,\n bundlerProvider,\n networkId,\n bundlerRpc: bundlerRpcOverride,\n paymasterRpc: paymasterRpcOverride,\n gasTokenAddress,\n eip7702Auth,\n }: CreateKernelClientForWalletAccountParams,\n client = getDefaultClient()\n): Promise<KernelClient> => {\n let networkData: NetworkData \| undefined;\n\n if (networkId) {\n networkData = getNetworkDataForNetworkId(\n { chain: 'EVM', networkId },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for specified network ID: ${networkId}. Make sure the network is enabled for your project.`\n );\n } else {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount: smartWalletAccount },\n client\n );\n\n networkData = activeNetworkData.networkData;\n\n assertDefined(\n networkData,\n `No active network data found for this wallet account.`\n );\n }\n\n const viemChain = mapNetworkDataToViemChain(networkData);\n\n const bundlerRpc =\n bundlerRpcOverride ??\n getZerodevRpc(\n {\n bundlerProvider,\n networkId: networkData.networkId,\n rpcType: 'bundler',\n },\n client\n );\n\n const bundlerTransport = http(bundlerRpc);\n\n const publicClient = createPublicClient({\n chain: viemChain,\n transport: bundlerTransport,\n });\n\n const account = await createKernelAccount(\n {\n eip7702Auth,\n publicClient,\n smartWalletAccount,\n },\n client\n );\n\n const paymasterRpc =\n paymasterRpcOverride ??\n getZerodevRpc(\n {\n bundlerProvider,\n networkId: networkData.networkId,\n rpcType: 'paymaster',\n },\n client\n );\n\n const paymasterConfig = withSponsorship\n ? getPaymasterConfig({\n chain: viemChain,\n gasTokenAddress,\n paymasterRpc,\n })\n : {};\n\n return createKernelAccountClient({\n account,\n bundlerTransport,\n chain: viemChain,\n client: publicClient,\n userOperation: {\n estimateFeesPerGas: async ({ bundlerClient }) =>\n getUserOperationGasPrice(bundlerClient),\n },\n ...paymasterConfig,\n });\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { KernelClient } from '../../KernelClient.types';\nimport { shouldUseEIP7702 } from '../shouldUseEIP7702';\n\ntype ShouldSignWithEoaParams = {\n kernelClient: KernelClient;\n smartWalletAccount: EvmWalletAccount;\n};\n\n/* @notInstrumented /\nexport const shouldSignWithEoa = async (\n { kernelClient, smartWalletAccount }: ShouldSignWithEoaParams,\n client: DynamicClient\n) => {\n const useEIP7702 = shouldUseEIP7702({ smartWalletAccount }, client);\n\n if (!useEIP7702) {\n return false;\n }\n\n const isDeployed = await kernelClient.account.isDeployed();\n\n return !isDeployed;\n};\n","import {\n type DynamicClient,\n getOwnerWalletAccountForSmartWalletAccount,\n signMessage as signMessageWithWalletAccount,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport { createKernelClientForWalletAccount } from '../../createKernelClientForWalletAccount';\nimport { shouldSignWithEoa } from '../shouldSignWithEoa';\n\ntype SignMessageParams = {\n message: string;\n walletAccount: EvmWalletAccount;\n};\n\n/* @notInstrumented /\nexport const signMessage = async (\n { walletAccount, message }: SignMessageParams,\n client: DynamicClient\n): Promise<{ signature: string }> => {\n const kernelClient = await createKernelClientForWalletAccount(\n { smartWalletAccount: walletAccount },\n client\n );\n\n const shouldUseEoa = await shouldSignWithEoa(\n {\n kernelClient,\n smartWalletAccount: walletAccount,\n },\n client\n );\n\n if (shouldUseEoa) {\n const eoaWalletAccount = getOwnerWalletAccountForSmartWalletAccount(\n { smartWalletAccount: walletAccount },\n client\n );\n\n assertDefined(eoaWalletAccount, 'Eoa wallet account not found');\n\n const { signature } = await signMessageWithWalletAccount({\n message,\n walletAccount: eoaWalletAccount,\n });\n\n return { signature };\n }\n\n const signature = await kernelClient.signMessage({ message });\n return { signature };\n};\n","/\n Checks if an error is a ZeroDev gas sponsorship error, indicating the\n * user operation did not match any gas sponsoring policies.\n \n @example\n * ```ts\n * try {\n * await sendUserOperation({ walletAccount, calls });\n * } catch (err) {\n * if (isGasSponsorshipError(err)) {\n * // Handle missing sponsorship\n * }\n * }\n * ```\n \n @param err - The error to check.\n * @returns True if the error is a gas sponsorship policy mismatch, false otherwise.\n * @see canSponsorUserOperation\n * @see sendUserOperation\n * @notInstrumented\n /\nexport const isGasSponsorshipError = (err: unknown): boolean => {\n const errorWithMessage = err as { message?: string } \| undefined;\n\n return (\n errorWithMessage?.message?.includes(\n 'userOp did not match any gas sponsoring policies'\n ) \|\| false\n );\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { InvalidParamError } from '@dynamic-labs-sdk/client';\nimport {\n type TransferAmountParams,\n parseAmountToSmallestUnit,\n} from '@dynamic-labs-sdk/client/core';\nimport { isEvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { Hex } from 'viem';\nimport { encodeFunctionData } from 'viem';\n\nimport { ERC20_TRANSFER_ABI } from '../../constants';\nimport { createKernelClientForWalletAccount } from '../../createKernelClientForWalletAccount';\nimport { isGasSponsorshipError } from '../../isGasSponsorshipError';\n\nconst EVM_NATIVE_DECIMALS = 18;\n\n/\n Transfers native ETH or an ERC-20 token via a ZeroDev smart wallet.\n \n Attempts with gas sponsorship first, then falls back to unsponsored\n * if the paymaster rejects.\n * @notInstrumented\n /\nexport const zerodevTransferAmount = async (\n { amount, recipient, token, walletAccount }: TransferAmountParams,\n client: DynamicClient\n): Promise<{ transactionHash: string }> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n // eslint-disable-next-line custom-rules/require-single-object-param\n const sendTransaction = async (withSponsorship: boolean) => {\n const kernelClient = await createKernelClientForWalletAccount(\n { smartWalletAccount: walletAccount, withSponsorship },\n client\n );\n\n if (token?.address) {\n const smallestUnit = parseAmountToSmallestUnit({\n amount,\n decimals: token.decimals,\n });\n\n const data = encodeFunctionData({\n abi: ERC20_TRANSFER_ABI,\n args: [recipient as Hex, smallestUnit],\n functionName: 'transfer',\n });\n\n return kernelClient.sendTransaction({\n data,\n to: token.address as Hex,\n });\n }\n\n const value = parseAmountToSmallestUnit({\n amount,\n decimals: EVM_NATIVE_DECIMALS,\n });\n\n return kernelClient.sendTransaction({\n to: recipient as Hex,\n value,\n });\n };\n\n try {\n const hash = await sendTransaction(true);\n\n return { transactionHash: hash };\n } catch (error) {\n if (!isGasSponsorshipError(error)) {\n throw error;\n }\n\n const hash = await sendTransaction(false);\n\n return { transactionHash: hash };\n }\n};\n","import {\n type Chain,\n type DynamicClient,\n InvalidParamError,\n UnrecognizedNetworkError,\n type WalletAccount,\n} from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n formatWalletProviderGroupKey,\n formatWalletProviderKey,\n getActiveNetworkIdFromLastKnownRegistry,\n switchActiveNetworkInLastKnownRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport {\n type EvmWalletProvider,\n isEvmWalletAccount,\n} from '@dynamic-labs-sdk/evm';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport { ZERODEV_METADATA } from '../../constants';\nimport { getAllUserZerodevAddresses } from '../getAllUserZerodevAddresses';\nimport { getZerodevChainProviderForNetworkId } from '../getZerodevChainProviderForNetworkId';\nimport { signMessage as signMessageUtils } from '../signMessage';\nimport { zerodevTransferAmount } from '../zerodevTransferAmount';\n\n/* @notInstrumented /\nexport const createZerodevWalletProvider = (\n client: DynamicClient\n): EvmWalletProvider => {\n const chain: Chain = 'EVM';\n const walletProviderType = WalletProviderEnum.SmartContractWallet;\n const key = formatWalletProviderKey({\n chain,\n displayName: ZERODEV_METADATA.displayName,\n walletProviderType,\n });\n\n const getActiveNetworkId = async () =>\n getActiveNetworkIdFromLastKnownRegistry({\n client,\n walletProviderKey: key,\n });\n\n const getConnectedAddresses = async () => {\n const zerodevAddresses = getAllUserZerodevAddresses(client);\n\n return {\n addresses: zerodevAddresses,\n };\n };\n\n const signMessage = async ({\n walletAccount,\n message,\n }: {\n message: string;\n walletAccount?: WalletAccount;\n }) => {\n assertDefined(walletAccount, 'Wallet account is required');\n\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError(`walletAccount is not an EVM wallet account`);\n }\n\n return signMessageUtils({ message, walletAccount }, client);\n };\n\n const switchActiveNetwork = async ({ networkId }: { networkId: string }) => {\n const isNetworkEnabled = getZerodevChainProviderForNetworkId(\n { networkId },\n client\n );\n\n if (!isNetworkEnabled) {\n throw new UnrecognizedNetworkError({\n networkId,\n originalError: null,\n walletProviderKey: key,\n });\n }\n\n return switchActiveNetworkInLastKnownRegistry({\n client,\n networkId,\n walletProviderKey: key,\n });\n };\n\n return {\n chain,\n getActiveNetworkId,\n getConnectedAddresses,\n groupKey: formatWalletProviderGroupKey(ZERODEV_METADATA.displayName),\n key,\n metadata: {\n displayName: ZERODEV_METADATA.displayName,\n icon: ZERODEV_METADATA.icon,\n },\n signMessage,\n switchActiveNetwork,\n transferAmount: (args) => zerodevTransferAmount(args, client),\n walletProviderType,\n };\n};\n","import {\n WalletProviderPriority,\n getDefaultClient,\n getWalletProviderRegistry,\n hasExtension,\n registerExtension,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { createZerodevWalletProvider } from '../utils/createZerodevWalletProvider';\n\nexport const ZERODEV_EXTENSION_KEY = 'zerodev';\n\n/\n Adds the ZeroDev extension to the Dynamic client.\n \n This extension enables Account Abstraction integration with ZeroDev.\n \n @example\n * ```ts\n * const client = createDynamicClient({ environmentId: 'env-123' });\n * addZerodevExtension(client);\n * ```\n \n @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns void\n * @see createKernelClientForWalletAccount\n * @see sendUserOperation\n * @notInstrumented\n /\nexport const addZerodevExtension = (client = getDefaultClient()) => {\n if (hasExtension({ extensionKey: ZERODEV_EXTENSION_KEY }, client)) {\n return;\n }\n\n registerExtension({ extensionKey: ZERODEV_EXTENSION_KEY }, client);\n\n const walletProviderRegistry = getWalletProviderRegistry(client);\n\n const walletProvider = createZerodevWalletProvider(client);\n\n walletProviderRegistry.register({\n priority: WalletProviderPriority.WALLET_SDK,\n walletProvider,\n });\n};\n","import type { BatchCall } from '../../BatchCall.types';\nimport type { KernelClient } from '../../KernelClient.types';\n\nexport type PrepareUserOperationFromCallsParams = {\n calls: BatchCall[];\n kernelClient: KernelClient;\n};\n\n/\n Prepares a user operation from an array of calls\n * Replaces prepareUserOperationWithKernelClient to handle both single and batch transactions\n \n @param params.kernelClient - The kernel client to use for preparing the user operation\n * @param params.calls - Array of calls (can be single call or multiple calls)\n * @returns Promise resolving to the prepared user operation\n * @notInstrumented\n /\nexport const prepareUserOperationFromCalls = async ({\n kernelClient,\n calls,\n}: PrepareUserOperationFromCallsParams) => {\n // Normalize calls to ensure data field exists\n const normalizedCalls = calls.map((call) => ({\n data: call.data ?? '0x',\n to: call.to,\n value: call.value,\n }));\n\n const callData = await kernelClient.account.encodeCalls(normalizedCalls);\n\n return kernelClient.prepareUserOperation({\n callData,\n });\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport type { KernelClient } from '../KernelClient.types';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\ntype CanSponsorUserOperationBaseParams = {\n calls: BatchCall[];\n};\n\ntype CanSponsorUserOperationWithWalletParams =\n CanSponsorUserOperationBaseParams & {\n kernelClient?: never;\n walletAccount: EvmWalletAccount;\n };\n\ntype CanSponsorUserOperationWithClientParams =\n CanSponsorUserOperationBaseParams & {\n kernelClient: KernelClient;\n walletAccount?: never;\n };\n\nexport type CanSponsorUserOperationParams =\n \| CanSponsorUserOperationWithWalletParams\n \| CanSponsorUserOperationWithClientParams;\n\n/\n Checks if a user operation can be sponsored by the paymaster.\n * Handles both single transactions and batch transactions.\n \n @example\n * ```ts\n * const canSponsor = await canSponsorUserOperation({\n * walletAccount: smartWallet,\n * calls: [{ to: '0x...', value: 0n, data: '0x' }],\n * });\n * ```\n \n @param params.calls - Array of calls (single call or multiple calls).\n * @param params.kernelClient - Optional kernel client with sponsorship configured.\n * @param params.walletAccount - The wallet account to use (required if kernelClient not provided).\n * @returns True if the user operation can be sponsored, false otherwise.\n * @see sendUserOperation\n * @see estimateUserOperationGas\n * @notInstrumented\n /\nexport const canSponsorUserOperation = async ({\n walletAccount,\n calls,\n kernelClient,\n}: CanSponsorUserOperationParams): Promise<boolean> => {\n let kernelClientToUse = kernelClient;\n\n if (!kernelClientToUse) {\n assertDefined(\n walletAccount,\n 'Please provide either a wallet account or a kernel client in the parameters'\n );\n\n kernelClientToUse = await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n });\n }\n\n try {\n const sponsorResult = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientToUse,\n });\n\n const hasPaymaster = sponsorResult.paymasterAndData !== '0x';\n\n return hasPaymaster;\n } catch {\n return false;\n }\n};\n","import type { UserOperation } from 'viem/account-abstraction';\n\ntype CalculateGasForUserOperationParams = {\n userOperationData: Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n >;\n};\n\n/* @notInstrumented /\nexport const calculateGasForUserOperation = ({\n userOperationData,\n}: CalculateGasForUserOperationParams): bigint => {\n // Sum all gas units\n const totalGasUnits =\n userOperationData.callGasLimit +\n userOperationData.verificationGasLimit +\n userOperationData.preVerificationGas;\n\n // Multiply by maxFeePerGas to get the total gas cost in wei\n const gasCost = totalGasUnits userOperationData.maxFeePerGas;\n\n return gasCost;\n};\n","import type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport { calculateGasForUserOperation } from '../utils/calculateGasForUserOperation';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\nexport type EstimateUserOperationGasParams = {\n calls: BatchCall[];\n walletAccount: EvmWalletAccount;\n};\n\n/*\n Estimates the total gas cost for a user operation with one or more calls.\n * Handles both single transactions and batch transactions.\n \n @example\n * ```ts\n * const gasEstimate = await estimateUserOperationGas({\n * walletAccount: smartWallet,\n * calls: [{ to: '0x...', value: 0n, data: '0x' }],\n * });\n * ```\n \n @param params.calls - Array of calls (single call or multiple calls).\n * @param params.walletAccount - The wallet account that will execute the user operation.\n * @returns The estimated gas cost in wei, or null if estimation fails.\n * @see sendUserOperation\n * @see canSponsorUserOperation\n * @notInstrumented\n /\nexport const estimateUserOperationGas = async ({\n walletAccount,\n calls,\n}: EstimateUserOperationGasParams): Promise<bigint \| null> => {\n try {\n const kernelClientWithoutSponsorship =\n await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n withSponsorship: false,\n });\n\n const unsponsoredUserOperation = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientWithoutSponsorship,\n });\n\n return calculateGasForUserOperation({\n userOperationData: unsponsoredUserOperation,\n });\n } catch {\n return null;\n }\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { UserOperationReceipt } from 'viem/account-abstraction';\n\nimport type { BatchCall } from '../BatchCall.types';\nimport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nimport type { KernelClient } from '../KernelClient.types';\nimport { prepareUserOperationFromCalls } from '../utils/prepareUserOperationFromCalls';\n\ntype SendUserOperationBaseParams = {\n calls: BatchCall[];\n};\n\ntype SendUserOperationWithWalletParams = SendUserOperationBaseParams & {\n kernelClient?: never;\n walletAccount: EvmWalletAccount;\n withSponsorship?: boolean;\n};\n\ntype SendUserOperationWithClientParams = SendUserOperationBaseParams & {\n kernelClient: KernelClient;\n walletAccount?: never;\n withSponsorship?: never;\n};\n\nexport type SendUserOperationParams =\n \| SendUserOperationWithWalletParams\n \| SendUserOperationWithClientParams;\n\n/\n Sends a user operation with one or more calls.\n * Handles both single transactions and batch transactions.\n \n @example\n * ```ts\n * const receipt = await sendUserOperation({\n * walletAccount: smartWallet,\n * calls: [{ to: '0x...', value: 0n, data: '0x' }],\n * });\n * ```\n \n @param params.calls - Array of calls (single call or multiple calls).\n * @param params.kernelClient - Optional pre-configured kernel client.\n * @param params.walletAccount - The wallet account to use (required if kernelClient not provided).\n * @param params.withSponsorship - Whether to use sponsorship (default: true, only used with walletAccount).\n * @returns Promise resolving to the UserOperation receipt.\n * @see createKernelClientForWalletAccount\n * @see canSponsorUserOperation\n * @notInstrumented\n /\nexport const sendUserOperation = async ({\n walletAccount,\n calls,\n kernelClient,\n withSponsorship = true,\n}: SendUserOperationParams): Promise<UserOperationReceipt> => {\n let kernelClientToUse = kernelClient;\n\n if (!kernelClientToUse) {\n assertDefined(\n walletAccount,\n 'Please provide either a wallet account or a kernel client in the parameters'\n );\n\n kernelClientToUse = await createKernelClientForWalletAccount({\n smartWalletAccount: walletAccount,\n withSponsorship,\n });\n }\n\n const userOperation = await prepareUserOperationFromCalls({\n calls,\n kernelClient: kernelClientToUse,\n });\n\n // Type cast needed: prepareUserOperation returns a fully prepared UserOperation with all fields,\n // but sendUserOperation's discriminated union types expect specific field combinations.\n // This is safe as the prepared operation is compatible at runtime.\n const userOperationHash = await kernelClientToUse.sendUserOperation(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n userOperation as any\n );\n\n return kernelClientToUse.waitForUserOperationReceipt({\n hash: userOperationHash,\n });\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n getNetworkDataForNetworkId,\n} from '@dynamic-labs-sdk/client/core';\nimport type { EvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport { mapNetworkDataToViemChain } from '@dynamic-labs-sdk/evm/viem';\nimport { constants } from '@zerodev/sdk';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\nimport { signAuthorization } from 'viem/actions';\n\nimport { getSignerForSmartWalletAccount } from '../getSignerForSmartWalletAccount';\n\nexport type SignEip7702AuthorizationParams = {\n networkId?: string;\n smartWalletAccount: EvmWalletAccount;\n};\n\n/\n Signs an EIP-7702 authorization for ZeroDev kernel delegation.\n \n This function creates a signed authorization that allows a wallet to delegate\n * its execution to the ZeroDev kernel contract. The signed authorization can then\n * be passed to `createKernelClientForWalletAccount` via the `eip7702Auth` parameter.\n \n @example\n * ```ts\n * const auth = await signEip7702Authorization({\n * smartWalletAccount: evmSmartWallet,\n * });\n * const kernelClient = await createKernelClientForWalletAccount({\n * smartWalletAccount: evmSmartWallet,\n * eip7702Auth: auth,\n * });\n * ```\n \n @param params.smartWalletAccount - The EVM smart wallet account to sign the authorization for.\n * @param [params.networkId] - The network ID to use for signing. If not provided, uses the wallet's active network.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A promise that resolves to the signed EIP-7702 authorization.\n * @see createKernelClientForWalletAccount\n * @see sendUserOperation\n * @notInstrumented\n /\nexport const signEip7702Authorization = async (\n { smartWalletAccount, networkId }: SignEip7702AuthorizationParams,\n client = getDefaultClient()\n): Promise<SignAuthorizationReturnType> => {\n const walletClient = await getSignerForSmartWalletAccount(\n { smartWalletAccount },\n client\n );\n\n let networkData: NetworkData \| undefined;\n\n if (networkId) {\n networkData = getNetworkDataForNetworkId(\n { chain: 'EVM', networkId },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for specified network ID: ${networkId}. Make sure the network is enabled for your project.`\n );\n } else {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount: smartWalletAccount },\n client\n );\n\n networkData = activeNetworkData.networkData;\n\n assertDefined(\n networkData,\n 'No active network data found for this wallet account.'\n );\n }\n\n const viemChain = mapNetworkDataToViemChain(networkData);\n\n return signAuthorization(walletClient, {\n chainId: viemChain.id,\n contractAddress: constants.KERNEL_7702_DELEGATION_ADDRESS,\n });\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport { ZERODEV_METADATA } from '../constants';\n\n/\n Type guard function to check if a wallet account is a Zerodev wallet account.\n \n @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is a Zerodev wallet account, false otherwise.\n * @notInstrumented\n /\nexport const isZerodevWalletAccount = (\n walletAccount: WalletAccount\n): boolean => {\n return walletAccount.walletProviderKey.startsWith(\n ZERODEV_METADATA.normalizedWalletName\n );\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { FeeEstimationFailedError } from '@dynamic-labs-sdk/client';\nimport type { EvmTransactionFeeData } from '@dynamic-labs-sdk/evm';\nimport { formatEther } from 'viem';\nimport type { UserOperation } from 'viem/account-abstraction';\n\nimport { calculateGasForUserOperation } from '../calculateGasForUserOperation';\n\ntype CalculateFeeForUserOperationParams = {\n nativeTokenPriceUsd?: number;\n networkData: NetworkData;\n userOperationData: Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n >;\n};\n\n/\n Calculates the estimated fee for a ZeroDev user operation.\n \n This function estimates the total gas cost for a user operation by summing\n * all gas components (call, verification, pre-verification) and multiplying\n * by the maximum fee per gas unit.\n \n @example\n * ```ts\n * const fee = calculateFeeForUserOperation({\n * userOperationData: userOp,\n * networkData,\n * nativeTokenPriceUsd: 2500,\n * });\n * ```\n \n @param params.userOperationData - The user operation data containing gas limits and fees.\n * @param params.networkData - Network configuration (not currently used but kept for consistency).\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 fee calculation fails.\n * @see estimateUserOperationGas\n * @see sendUserOperation\n * @notInstrumented\n /\nexport const calculateFeeForUserOperation = ({\n userOperationData,\n networkData: _networkData,\n nativeTokenPriceUsd,\n}: CalculateFeeForUserOperationParams): EvmTransactionFeeData => {\n try {\n // Calculate total gas cost in wei\n const nativeAmount = calculateGasForUserOperation({ userOperationData });\n\n // Calculate total gas units\n const gasEstimate =\n userOperationData.callGasLimit +\n userOperationData.verificationGasLimit +\n userOperationData.preVerificationGas;\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 humanReadableAmount,\n maxFeePerGas: userOperationData.maxFeePerGas,\n nativeAmount,\n usdAmount,\n };\n } catch (error) {\n throw new FeeEstimationFailedError({\n cause: error instanceof Error ? error : undefined,\n message: 'Failed to calculate user operation fee',\n });\n }\n};\n","import type { UserOperation } from 'viem/account-abstraction';\n\ntype UserOperationWithGasFields = Pick<\n UserOperation,\n \| 'callGasLimit'\n \| 'verificationGasLimit'\n \| 'preVerificationGas'\n \| 'maxFeePerGas'\n>;\n\n/*\n Type guard to check if a partial user operation has all required gas fields.\n \n This function narrows the type of a Partial<UserOperation> to ensure it has\n * the required gas fields needed for fee calculation. Use this when you need to\n * validate that gas fields are present before performing fee calculations.\n \n @param userOperation - The partial user operation to check.\n * @returns True if all required gas fields are present, false otherwise.\n \n @example\n * ```typescript\n * if (hasRequiredGasFields(userOperation)) {\n * // TypeScript now knows these fields are defined\n * const fee = calculateFee({\n * callGasLimit: userOperation.callGasLimit,\n * maxFeePerGas: userOperation.maxFeePerGas,\n * preVerificationGas: userOperation.preVerificationGas,\n * verificationGasLimit: userOperation.verificationGasLimit,\n * });\n * }\n * ```\n * @notInstrumented\n /\nexport const hasRequiredGasFields = (\n userOperation: Partial<UserOperation>\n): userOperation is Partial<UserOperation> & UserOperationWithGasFields =>\n Boolean(\n userOperation.callGasLimit &&\n userOperation.verificationGasLimit &&\n userOperation.preVerificationGas &&\n userOperation.maxFeePerGas\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 {\n EvmSimulationResult,\n EvmWalletAccount,\n} from '@dynamic-labs-sdk/evm';\nimport { isEvmWalletAccount } from '@dynamic-labs-sdk/evm';\nimport type { UserOperation } from 'viem/account-abstraction';\n\nimport { canSponsorUserOperation } from '../canSponsorUserOperation';\nimport { isZerodevWalletAccount } from '../isZerodevWalletAccount';\nimport { calculateFeeForUserOperation } from '../utils/calculateFeeForUserOperation';\nimport { hasRequiredGasFields } from '../utils/hasRequiredGasFields';\n\ntype SimulateZerodevUserOperationParams = {\n entryPoint: string;\n includeFees?: boolean;\n networkId: string;\n userOperation: Partial<UserOperation>;\n walletAccount: EvmWalletAccount;\n};\n\n/\n Simulates a ZeroDev user operation to preview its effects before execution.\n \n This function uses the Blockaid API to analyze the user operation and returns\n * information about asset transfers, security validation, and optionally fee estimates.\n * For account abstraction wallets, it also checks if gas sponsorship is available.\n \n Important: A successful simulation does not guarantee the user operation will succeed.\n * The simulation may succeed but indicate the operation would fail (e.g., due to\n * insufficient balance, reverted contract call). Check the `validation` field in the\n * result for potential issues.\n \n @example\n * ```ts\n * const result = await simulateZerodevUserOperation({\n * walletAccount: smartWallet,\n * userOperation,\n * networkId: '137',\n * entryPoint: '0x5FF1...A000',\n * });\n * ```\n \n @param params.walletAccount - The EVM smart wallet account that will execute the operation.\n * @param params.userOperation - The user operation to simulate.\n * @param params.networkId - The network ID where the operation will be executed (e.g., '137' for Polygon).\n * @param params.entryPoint - The entry point contract address for the user operation.\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 ZeroDev 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 sendUserOperation\n * @see canSponsorUserOperation\n * @notInstrumented\n */\nexport const simulateZerodevUserOperation = async (\n {\n walletAccount,\n userOperation,\n networkId,\n entryPoint,\n includeFees = false,\n }: SimulateZerodevUserOperationParams,\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 if (!isZerodevWalletAccount(walletAccount)) {\n throw new InvalidParamError(\n 'Wallet account must be a ZeroDev wallet account'\n );\n }\n\n // Get network data for the specified network\n const networksData = getNetworksData(client);\n const networkData = networksData.find(\n (data) => data.networkId === networkId && data.chain === 'EVM'\n );\n\n if (!networkData) {\n throw new InvalidParamError(\n `Network with ID ${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 // Note: The API endpoint for user operations might be different\n // This implementation assumes simulateUserOp exists on the API client\n // If it doesn't exist, we may need to use simulateEVMTransaction instead\n const response = await apiClient.simulateUserOp({\n environmentId: core.environmentId,\n simulateUserOpRequest: {\n chainId: networkId,\n entryPoint,\n operation: {\n callData: userOperation.callData \|\| '0x',\n callGasLimit: userOperation.callGasLimit?.toString() \|\| '0',\n maxFeePerGas: userOperation.maxFeePerGas?.toString() \|\| '0',\n maxPriorityFeePerGas:\n userOperation.maxPriorityFeePerGas?.toString() \|\| '0',\n nonce: userOperation.nonce?.toString() \|\| '0',\n preVerificationGas:\n userOperation.preVerificationGas?.toString() \|\| '0',\n sender: userOperation.sender \|\| '',\n signature: userOperation.signature \|\| '0x',\n verificationGasLimit:\n userOperation.verificationGasLimit?.toString() \|\| '0',\n },\n value: '0',\n },\n });\n\n // Calculate fees if requested\n let feeData: EvmSimulationResult['feeData'];\n\n if (includeFees) {\n // Check if the transaction can be sponsored\n const isSponsored =\n userOperation.callData &&\n userOperation.sender &&\n (await canSponsorUserOperation({\n calls: [\n {\n data: userOperation.callData,\n to: userOperation.sender as `0x${string}`,\n value: 0n,\n },\n ],\n walletAccount,\n }));\n\n if (isSponsored) {\n // Sponsored transaction - no fee for user\n feeData = {\n gasEstimate: 0n,\n humanReadableAmount: '0',\n nativeAmount: 0n,\n usdAmount: '0.00',\n };\n } else if (hasRequiredGasFields(userOperation)) {\n // User pays fee - calculate it\n feeData = calculateFeeForUserOperation({\n nativeTokenPriceUsd: response.priceData?.nativeTokenUsdPrice,\n networkData,\n userOperationData: {\n callGasLimit: userOperation.callGasLimit,\n maxFeePerGas: userOperation.maxFeePerGas,\n preVerificationGas: userOperation.preVerificationGas,\n verificationGasLimit: userOperation.verificationGasLimit,\n },\n });\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 ZeroDev user operation',\n });\n }\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { addZerodevExtension } from '../addZerodevExtension';\nexport type { BatchCall } from '../BatchCall.types';\nexport { canSponsorUserOperation } from '../canSponsorUserOperation';\nexport type { CanSponsorUserOperationParams } from '../canSponsorUserOperation';\nexport { createKernelClientForWalletAccount } from '../createKernelClientForWalletAccount';\nexport type { Eip7702Authorization } from '../createKernelClientForWalletAccount';\nexport { estimateUserOperationGas } from '../estimateUserOperationGas';\nexport type { EstimateUserOperationGasParams } from '../estimateUserOperationGas';\nexport { getSignerForSmartWalletAccount } from '../getSignerForSmartWalletAccount';\nexport { isGasSponsorshipError } from '../isGasSponsorshipError';\nexport type { KernelClient } from '../KernelClient.types';\nexport { sendUserOperation } from '../sendUserOperation';\nexport type { SendUserOperationParams } from '../sendUserOperation';\nexport { signEip7702Authorization } from '../signEip7702Authorization';\nexport { simulateZerodevUserOperation } from '../simulateZerodevUserOperation';\nexport { calculateFeeForUserOperation } from '../utils/calculateFeeForUserOperation';\n"],"mappings":"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"}

package/dist/index.esm.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { c as getSignerForSmartWalletAccount, d as ERC20_TRANSFER_ABI, f as ZERODEV_METADATA, i as shouldUseEIP7702, l as getZerodevChainProviderForNetworkId, m as version, n as getPaymasterConfig, p as name, r as createKernelAccount$1, t as getZerodevRpc } from "./getZerodevRpc-Cd6_IvH2.esm.js";
+import { c as getSignerForSmartWalletAccount, d as ERC20_TRANSFER_ABI, f as ZERODEV_METADATA, i as shouldUseEIP7702, l as getZerodevChainProviderForNetworkId, m as version, n as getPaymasterConfig, p as name, r as createKernelAccount$1, t as getZerodevRpc } from "./getZerodevRpc-BWlvnCuL.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { WalletProviderPriority, assertDefined, createApiClient, formatWalletProviderGroupKey, formatWalletProviderKey, getActiveNetworkIdFromLastKnownRegistry, getChainFromVerifiedCredentialChain, getCore, getDefaultClient, getNetworkDataForNetworkId, getWalletProviderRegistry, hasExtension, parseAmountToSmallestUnit, registerExtension, switchActiveNetworkInLastKnownRegistry } from "@dynamic-labs-sdk/client/core";
 import { FeeEstimationFailedError, InvalidParamError, SimulationFailedError, UnrecognizedNetworkError, getActiveNetworkData, getDefaultClient as getDefaultClient$1, getNetworksData, getOwnerWalletAccountForSmartWalletAccount, signMessage } from "@dynamic-labs-sdk/client";
@@ -20,19 +20,25 @@ const getAllUserZerodevAddresses = (client) => {
 /**
 * Creates a KernelClient instance for a given smart wallet account.
 *
+* @example
+* ```ts
+* const kernelClient = await createKernelClientForWalletAccount({
+*   smartWalletAccount: evmSmartWallet,
+* });
+* ```
+*
 * @param params.smartWalletAccount - The smart wallet account to create the KernelClient for.
-* @param [params.bundlerProvider] - A custom bundler provider to use
-* @param [params.bundlerRpc] - A custom bundler RPC to use
+* @param [params.bundlerProvider] - A custom bundler provider to use.
+* @param [params.bundlerRpc] - A custom bundler RPC to use.
 * @param [params.networkId] - The network ID to use for the KernelClient.
-* If not provided, the network ID will be fetched from the active network data.
-* @param [params.paymasterRpc] - A custom paymaster RPC to use
-* @param [params.gasTokenAddress] - The address of a custom ERC20 token to use as a gas token
+* @param [params.paymasterRpc] - A custom paymaster RPC to use.
+* @param [params.gasTokenAddress] - The address of a custom ERC20 token to use as a gas token.
 * @param [params.withSponsorship] - Whether to use sponsorship for the KernelClient or not (default is true).
-* @param [params.eip7702Auth] - A pre-signed EIP-7702 authorization. When provided, the kernel client uses
-* this authorization instead of signing a new one internally. Useful for singleUse MFA flows where you need
-* to separate the authorization signing step from the transaction step.
+* @param [params.eip7702Auth] - A pre-signed EIP-7702 authorization for singleUse MFA flows.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to a KernelClient instance.
+* @see sendUserOperation
+* @see getSignerForSmartWalletAccount
 * @notInstrumented
 */
 const createKernelClientForWalletAccount = async ({ smartWalletAccount, withSponsorship = true, bundlerProvider, networkId, bundlerRpc: bundlerRpcOverride, paymasterRpc: paymasterRpcOverride, gasTokenAddress, eip7702Auth }, client = getDefaultClient()) => {
@@ -111,7 +117,27 @@ const signMessage$1 = async ({ walletAccount, message }, client) => {
 //#endregion
 //#region src/isGasSponsorshipError/isGasSponsorshipError.ts
-/** @notInstrumented */
+/**
+* Checks if an error is a ZeroDev gas sponsorship error, indicating the
+* user operation did not match any gas sponsoring policies.
+*
+* @example
+* ```ts
+* try {
+*   await sendUserOperation({ walletAccount, calls });
+* } catch (err) {
+*   if (isGasSponsorshipError(err)) {
+*     // Handle missing sponsorship
+*   }
+* }
+* ```
+*
+* @param err - The error to check.
+* @returns True if the error is a gas sponsorship policy mismatch, false otherwise.
+* @see canSponsorUserOperation
+* @see sendUserOperation
+* @notInstrumented
+*/
 const isGasSponsorshipError = (err) => {
 	return err?.message?.includes("userOp did not match any gas sponsoring policies") || false;
 };
@@ -225,9 +251,18 @@ const ZERODEV_EXTENSION_KEY = "zerodev";
 /**
 * Adds the ZeroDev extension to the Dynamic client.
 *
-* This extension enables Account Abstraction integration with ZeroDev
+* This extension enables Account Abstraction integration with ZeroDev.
+*
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: 'env-123' });
+* addZerodevExtension(client);
+* ```
 *
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see createKernelClientForWalletAccount
+* @see sendUserOperation
 * @notInstrumented
 */
 const addZerodevExtension = (client = getDefaultClient()) => {
@@ -265,13 +300,23 @@ const prepareUserOperationFromCalls = async ({ kernelClient, calls }) => {
 //#endregion
 //#region src/canSponsorUserOperation/canSponsorUserOperation.ts
 /**
-* Checks if a user operation can be sponsored by the paymaster
-* Handles both single transactions and batch transactions
+* Checks if a user operation can be sponsored by the paymaster.
+* Handles both single transactions and batch transactions.
 *
-* @param params.calls - Array of calls (single call or multiple calls)
-* @param params.kernelClient - Optional kernel client with sponsorship configured
-* @param params.walletAccount - The wallet account to use (required if kernelClient not provided)
-* @returns True if the user operation can be sponsored, false otherwise
+* @example
+* ```ts
+* const canSponsor = await canSponsorUserOperation({
+*   walletAccount: smartWallet,
+*   calls: [{ to: '0x...', value: 0n, data: '0x' }],
+* });
+* ```
+*
+* @param params.calls - Array of calls (single call or multiple calls).
+* @param params.kernelClient - Optional kernel client with sponsorship configured.
+* @param params.walletAccount - The wallet account to use (required if kernelClient not provided).
+* @returns True if the user operation can be sponsored, false otherwise.
+* @see sendUserOperation
+* @see estimateUserOperationGas
 * @notInstrumented
 */
 const canSponsorUserOperation = async ({ walletAccount, calls, kernelClient }) => {
@@ -300,12 +345,22 @@ const calculateGasForUserOperation = ({ userOperationData }) => {
 //#endregion
 //#region src/estimateUserOperationGas/estimateUserOperationGas.ts
 /**
-* Estimates the total gas cost for a user operation with one or more calls
-* Handles both single transactions and batch transactions
+* Estimates the total gas cost for a user operation with one or more calls.
+* Handles both single transactions and batch transactions.
+*
+* @example
+* ```ts
+* const gasEstimate = await estimateUserOperationGas({
+*   walletAccount: smartWallet,
+*   calls: [{ to: '0x...', value: 0n, data: '0x' }],
+* });
+* ```
 *
-* @param params.calls - Array of calls (single call or multiple calls)
-* @param params.walletAccount - The wallet account that will execute the user operation
-* @returns The estimated gas cost in wei, or null if estimation fails
+* @param params.calls - Array of calls (single call or multiple calls).
+* @param params.walletAccount - The wallet account that will execute the user operation.
+* @returns The estimated gas cost in wei, or null if estimation fails.
+* @see sendUserOperation
+* @see canSponsorUserOperation
 * @notInstrumented
 */
 const estimateUserOperationGas = async ({ walletAccount, calls }) => {
@@ -325,14 +380,24 @@ const estimateUserOperationGas = async ({ walletAccount, calls }) => {
 //#endregion
 //#region src/sendUserOperation/sendUserOperation.ts
 /**
-* Sends a user operation with one or more calls
-* Handles both single transactions and batch transactions
+* Sends a user operation with one or more calls.
+* Handles both single transactions and batch transactions.
 *
-* @param params.calls - Array of calls (single call or multiple calls)
-* @param params.kernelClient - Optional pre-configured kernel client
-* @param params.walletAccount - The wallet account to use (required if kernelClient not provided)
-* @param params.withSponsorship - Whether to use sponsorship (default: true, only used with walletAccount)
-* @returns Promise resolving to the UserOperation receipt
+* @example
+* ```ts
+* const receipt = await sendUserOperation({
+*   walletAccount: smartWallet,
+*   calls: [{ to: '0x...', value: 0n, data: '0x' }],
+* });
+* ```
+*
+* @param params.calls - Array of calls (single call or multiple calls).
+* @param params.kernelClient - Optional pre-configured kernel client.
+* @param params.walletAccount - The wallet account to use (required if kernelClient not provided).
+* @param params.withSponsorship - Whether to use sponsorship (default: true, only used with walletAccount).
+* @returns Promise resolving to the UserOperation receipt.
+* @see createKernelClientForWalletAccount
+* @see canSponsorUserOperation
 * @notInstrumented
 */
 const sendUserOperation = async ({ walletAccount, calls, kernelClient, withSponsorship = true }) => {
@@ -361,11 +426,23 @@ const sendUserOperation = async ({ walletAccount, calls, kernelClient, withSpons
 * its execution to the ZeroDev kernel contract. The signed authorization can then
 * be passed to `createKernelClientForWalletAccount` via the `eip7702Auth` parameter.
 *
-* @param params - The parameters for signing the authorization.
+* @example
+* ```ts
+* const auth = await signEip7702Authorization({
+*   smartWalletAccount: evmSmartWallet,
+* });
+* const kernelClient = await createKernelClientForWalletAccount({
+*   smartWalletAccount: evmSmartWallet,
+*   eip7702Auth: auth,
+* });
+* ```
+*
 * @param params.smartWalletAccount - The EVM smart wallet account to sign the authorization for.
 * @param [params.networkId] - The network ID to use for signing. If not provided, uses the wallet's active network.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the signed EIP-7702 authorization.
+* @see createKernelClientForWalletAccount
+* @see sendUserOperation
 * @notInstrumented
 */
 const signEip7702Authorization = async ({ smartWalletAccount, networkId }, client = getDefaultClient()) => {
@@ -409,11 +486,22 @@ const isZerodevWalletAccount = (walletAccount) => {
 * all gas components (call, verification, pre-verification) and multiplying
 * by the maximum fee per gas unit.
 *
+* @example
+* ```ts
+* const fee = calculateFeeForUserOperation({
+*   userOperationData: userOp,
+*   networkData,
+*   nativeTokenPriceUsd: 2500,
+* });
+* ```
+*
 * @param params.userOperationData - The user operation data containing gas limits and fees.
 * @param params.networkData - Network configuration (not currently used but kept for consistency).
 * @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 fee calculation fails.
+* @see estimateUserOperationGas
+* @see sendUserOperation
 * @notInstrumented
 */
 const calculateFeeForUserOperation = ({ userOperationData, networkData: _networkData, nativeTokenPriceUsd }) => {
@@ -479,6 +567,16 @@ const hasRequiredGasFields = (userOperation) => Boolean(userOperation.callGasLim
 * insufficient balance, reverted contract call). Check the `validation` field in the
 * result for potential issues.
 *
+* @example
+* ```ts
+* const result = await simulateZerodevUserOperation({
+*   walletAccount: smartWallet,
+*   userOperation,
+*   networkId: '137',
+*   entryPoint: '0x5FF1...A000',
+* });
+* ```
+*
 * @param params.walletAccount - The EVM smart wallet account that will execute the operation.
 * @param params.userOperation - The user operation to simulate.
 * @param params.networkId - The network ID where the operation will be executed (e.g., '137' for Polygon).
@@ -489,6 +587,8 @@ const hasRequiredGasFields = (userOperation) => Boolean(userOperation.callGasLim
 * @throws {InvalidParamError} If wallet account is not an EVM ZeroDev 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 sendUserOperation
+* @see canSponsorUserOperation
 * @notInstrumented
 */
 const simulateZerodevUserOperation = async ({ walletAccount, userOperation, networkId, entryPoint, includeFees = false }, client = getDefaultClient$1()) => {