npm - @dynamic-labs-sdk/evm - Versions diffs - 1.17.1 → 1.19.0 - Mend

@dynamic-labs-sdk/evm 1.17.1 → 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 (96) hide show

package/dist/evmTransferAmount-D9Sygfbl.native.esm.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"evmTransferAmount-D9Sygfbl.native.esm.js","names":["DELEGATION_CONTRACT_ADDRESS: Hex","BATCH_CALL_OPDATA_AUTH_MODE: Hex","data: { relayerAddress?: string }","getDefaultClient","getDefaultClient","getDefaultClient","getDefaultClient","data: { requestId?: string }","getDefaultClient","data: {\n errorMessage?: string;\n status: SponsoredTransactionStatus;\n transactionHash?: string;\n }","calls: SponsoredTransactionCall[]","gasParams: Record<string, bigint>"],"sources":["../src/errors/SponsorTransactionError/SponsorTransactionError.ts","../src/gasless/constants.ts","../src/gasless/generateRandomNonce/generateRandomNonce.ts","../src/gasless/generateIntentNonce/generateIntentNonce.ts","../src/gasless/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.ts","../src/gasless/create7702DelegationRegistry/create7702DelegationRegistry.ts","../src/gasless/get7702DelegationRegistry/get7702DelegationRegistry.ts","../src/gasless/is7702DelegationActive/is7702DelegationActive.ts","../src/gasless/resolveChainId/resolveChainId.ts","../src/gasless/sign7702Authorization/sign7702Authorization.ts","../src/gasless/resolveAuthorization/resolveAuthorization.ts","../src/gasless/toSerializedAuthorization/toSerializedAuthorization.ts","../src/gasless/signSponsoredTransaction/signSponsoredTransaction.ts","../src/gasless/relaySponsoredTransaction/relaySponsoredTransaction.ts","../src/gasless/getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.ts","../src/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.ts","../src/gasless/sendSponsoredTransaction/sendSponsoredTransaction.ts","../src/errors/RpcError.ts","../src/utils/fetchEvmBalance/fetchEvmBalance.ts","../src/utils/createEvmNetworkProvider/createEvmNetworkProvider.ts","../src/registerEvmNetworkProviderBuilder/registerEvmNetworkProviderBuilder.ts","../src/utils/isEvmWalletAccount/isEvmWalletAccount.ts","../src/utils/evmConfirmTransaction/evmConfirmTransaction.ts","../src/gasless/isEvmGasSponsorshipEnabled/isEvmGasSponsorshipEnabled.ts","../src/utils/approveErc20/approveErc20.ts","../src/utils/getErc20Allowance/getErc20Allowance.ts","../src/utils/approveErc20IfRequiredAndWaitReceipt/approveErc20IfRequiredAndWaitReceipt.ts","../src/utils/evmExecuteSponsoredSwapTransaction/evmExecuteSponsoredSwapTransaction.ts","../src/utils/evmExecuteSwapTransaction/evmExecuteSwapTransaction.ts","../src/utils/evmTransferAmount/evmTransferAmount.ts"],"sourcesContent":["import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class SponsorTransactionError extends BaseError {\n // eslint-disable-next-line custom-rules/require-single-object-param -- mirrors viem-style error constructors: (cause, details)\n constructor(cause?: Error | null, details?: string) {\n super({\n cause: cause ?? null,\n code: 'sponsor_transaction_error',\n details,\n docsUrl: null,\n name: 'SponsorTransactionError',\n shortMessage: 'Failed to sponsor EVM transaction',\n });\n }\n}\n","import type { Hex } from 'viem';\n\n/** The Fireblocks Universal Gasless Delegate (UGD) contract address used for EIP-7702 delegation. */\nexport const DELEGATION_CONTRACT_ADDRESS: Hex =\n '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';\n\n/** Default sponsored transaction validity duration in seconds (10 minutes). */\nexport const DEFAULT_VALID_FOR_SECONDS = 600;\n\n/** EIP-7702 delegation code prefix used to identify delegated accounts. */\nexport const DELEGATION_CODE_PREFIX = '0xef0100';\n\n/** ERC-7579 batch call with opData and auth mode identifier. */\nexport const BATCH_CALL_OPDATA_AUTH_MODE: Hex =\n '0x0100000000007821000100000000000000000000000000000000000000000000';\n\n/** EIP-712 typed data types for UGD AuthorizedExecutions signing. */\nexport const AUTHORIZED_EXECUTIONS_TYPES = {\n AuthorizedExecutions: [\n { name: 'calls', type: 'Execution[]' },\n { name: 'deadline', type: 'uint256' },\n { name: 'mode', type: 'bytes32' },\n { name: 'nonce', type: 'uint256' },\n { name: 'relayer', type: 'address' },\n ],\n Execution: [\n { name: 'target', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'data', type: 'bytes' },\n ],\n} as const;\n\n/** Minimal ABI for the UGD contract's nonce validation function. */\nexport const UGD_ABI = [\n {\n inputs: [{ name: 'nonce', type: 'uint256' }],\n name: 'isNonceUsed',\n outputs: [{ name: '', type: 'bool' }],\n stateMutability: 'view',\n type: 'function',\n },\n] as const;\n","/**\n * Generates a cryptographically random 256-bit nonce.\n *\n * @returns A random bigint nonce.\n * @notInstrumented\n */\nexport const generateRandomNonce = (): bigint => {\n const bytes = new Uint8Array(32);\n crypto.getRandomValues(bytes);\n\n return bytes.reduce((acc, byte) => (acc << 8n) | BigInt(byte), 0n);\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { UGD_ABI } from '../constants';\nimport { generateRandomNonce } from '../generateRandomNonce';\n\ntype GenerateIntentNonceParams = {\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Generates a random bitmap nonce for UGD AuthorizedExecutions signing.\n *\n * Uses crypto.getRandomValues() for 256-bit randomness. Validates against\n * the on-chain isNonceUsed check as a safety measure, although collision\n * is essentially impossible with 256-bit random values.\n *\n * @param params.walletAccount - The wallet account whose delegation contract is checked.\n * @param [client] - The Dynamic client instance.\n * @returns A unique bigint nonce for the EIP-712 intent.\n * @notInstrumented\n */\nexport const generateIntentNonce = async (\n { walletAccount }: GenerateIntentNonceParams,\n client: DynamicClient\n): Promise<bigint> => {\n const nonce = generateRandomNonce();\n\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n try {\n // Call isNonceUsed on the wallet address because UGD code is\n // delegated to the EOA via EIP-7702\n const isUsed = await publicClient.readContract({\n abi: UGD_ABI,\n address: walletAccount.address as Hex,\n args: [nonce],\n functionName: 'isNonceUsed',\n });\n\n if (isUsed) {\n return generateRandomNonce();\n }\n } catch {\n // Contract call may fail if delegation is not yet active —\n // the nonce is still safe to use since it was randomly generated\n }\n\n return nonce;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { createApiClient, getCore } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\n\ntype GetAvailableEvmGaslessRelayerParams = {\n /** The EVM chain ID the sponsored transaction will target. */\n chainId: number;\n};\n\ntype GetAvailableEvmGaslessRelayerResult = {\n /** Relayer EOA that will broadcast the sponsored transaction on-chain. */\n relayerAddress: Hex;\n};\n\n/**\n * Fetches the relayer address to embed in the EIP-712 sponsored-transaction\n * intent for the given chain.\n *\n * The returned address is owned by the project's relay backend and is the\n * eventual `from` of the on-chain broadcast. It must be set as the `relayer`\n * field of the EIP-712 intent before signing — the on-chain delegate validates\n * the signature against this address.\n *\n * @param params.chainId - The EVM chain ID the sponsored transaction targets.\n * @param client - The Dynamic client instance.\n * @returns The relayer address to embed in the EIP-712 intent.\n * @throws {SponsorTransactionError} If the API call fails or returns no relayer address.\n * @notInstrumented\n */\nexport const getAvailableEvmGaslessRelayer = async (\n { chainId }: GetAvailableEvmGaslessRelayerParams,\n client: DynamicClient,\n): Promise<GetAvailableEvmGaslessRelayerResult> => {\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: { relayerAddress?: string };\n\n try {\n data = await apiClient.getAvailableEVMGaslessRelayer({\n chainId,\n environmentId: core.environmentId,\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n if (!data.relayerAddress) {\n throw new SponsorTransactionError();\n }\n\n return { relayerAddress: data.relayerAddress as Hex };\n};\n","type Delegation7702Registry = {\n /** Returns true if delegation is known to be active for this wallet+chain. */\n isDelegated: (params: { chainId: number; walletAddress: string }) => boolean;\n /** Marks delegation as active for this wallet+chain. */\n markDelegated: (params: {\n chainId: number;\n walletAddress: string;\n }) => void;\n};\n\n/**\n * Creates an in-memory registry that tracks which wallet+chain combinations\n * have active EIP-7702 delegation. Only active delegations are cached —\n * a missing entry means the status is unknown and should be checked via RPC.\n *\n * @notInstrumented\n */\nexport const create7702DelegationRegistry = (): Delegation7702Registry => {\n const delegated = new Map<string, true>();\n\n const buildKey = ({\n chainId,\n walletAddress,\n }: {\n chainId: number;\n walletAddress: string;\n }): string => `${walletAddress.toLowerCase()}:${chainId}`;\n\n return {\n isDelegated: (params) => delegated.has(buildKey(params)),\n markDelegated: (params) => {\n delegated.set(buildKey(params), true);\n },\n };\n};\n\nexport type { Delegation7702Registry };\n","import { createRuntimeServiceAccessKey } from '@dynamic-labs-sdk/client/core';\n\nimport { create7702DelegationRegistry } from '../create7702DelegationRegistry';\n\n/**\n * Returns the per-client EIP-7702 delegation registry, creating it on first access.\n *\n * @notInstrumented\n */\nexport const get7702DelegationRegistry = createRuntimeServiceAccessKey(\n 'evm-7702-delegation-registry',\n () => create7702DelegationRegistry()\n);\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined, getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\nimport {\n DELEGATION_CODE_PREFIX,\n DELEGATION_CONTRACT_ADDRESS,\n} from '../constants';\nimport { get7702DelegationRegistry } from '../get7702DelegationRegistry';\n\ntype Is7702DelegationActiveParams = {\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Checks whether EIP-7702 delegation to the Dynamic gasless contract is active\n * for the given wallet account on its current network.\n *\n * Results are cached per wallet+chain in an in-memory registry.\n *\n * @example\n * ```ts\n * const isDelegated = await is7702DelegationActive({ walletAccount: evmAccount });\n * if (!isDelegated) {\n * await activate7702Delegation({ walletAccount: evmAccount });\n * }\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to check delegation status for.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True if the wallet has an active delegation to the gasless contract.\n * @see activate7702Delegation\n * @see sign7702Authorization\n * @notInstrumented\n */\nexport const is7702DelegationActive = async (\n { walletAccount }: Is7702DelegationActiveParams,\n client = getDefaultClient()\n): Promise<boolean> => {\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const chainId = mapNetworkDataToViemChain(networkData).id;\n const registry = get7702DelegationRegistry(client);\n\n if (registry.isDelegated({ chainId, walletAddress: walletAccount.address })) {\n return true;\n }\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n const bytecode = await publicClient.getCode({\n address: walletAccount.address as Hex,\n });\n\n if (!bytecode) {\n return false;\n }\n\n const expectedPrefix =\n DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS.slice(2).toLowerCase();\n\n const isActive = bytecode.toLowerCase().startsWith(expectedPrefix);\n\n if (isActive) {\n registry.markDelegated({ chainId, walletAddress: walletAccount.address });\n }\n\n return isActive;\n};\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { DynamicClient } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\n\ntype ResolveChainIdParams = {\n chainId?: number;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Resolves a chain ID from either an explicit override or the wallet's active network.\n *\n * @param params.chainId - Explicit chain ID override.\n * @param params.walletAccount - The wallet account to resolve the chain from.\n * @param client - The Dynamic client instance.\n * @returns The resolved chain ID.\n * @notInstrumented\n */\nexport const resolveChainId = async (\n { chainId, walletAccount }: ResolveChainIdParams,\n client: DynamicClient\n): Promise<number> => {\n if (chainId !== undefined) {\n return chainId;\n }\n\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n return mapNetworkDataToViemChain(networkData).id;\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\nimport { signAuthorization } from 'viem/actions';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { DELEGATION_CONTRACT_ADDRESS } from '../constants';\nimport { resolveChainId } from '../resolveChainId';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\n\ntype Sign7702AuthorizationParams = {\n chainId?: number;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Signs an EIP-7702 authorization to delegate the wallet to the Dynamic\n * gasless delegation contract.\n *\n * The signed authorization can be included in a sponsored transaction to\n * activate the delegation on-chain. If no chainId is provided, the wallet's\n * active network chain ID is used.\n *\n * @example\n * ```ts\n * const authorization = await sign7702Authorization({ walletAccount: evmAccount });\n * await activate7702Delegation({ walletAccount: evmAccount, authorization });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to sign the authorization for.\n * @param [params.chainId] - Override chain ID. Defaults to the wallet's active network.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The signed EIP-7702 authorization.\n * @see activate7702Delegation\n * @see is7702DelegationActive\n * @notInstrumented\n */\nexport const sign7702Authorization = async (\n { walletAccount, chainId }: Sign7702AuthorizationParams,\n client = getDefaultClient()\n): Promise<SignAuthorizationReturnType> => {\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const resolvedChainId = await resolveChainId(\n { chainId, walletAccount },\n client\n );\n\n return signAuthorization(walletClient, {\n chainId: resolvedChainId,\n contractAddress: DELEGATION_CONTRACT_ADDRESS,\n });\n};\n","import type { getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { is7702DelegationActive } from '../is7702DelegationActive';\nimport { sign7702Authorization } from '../sign7702Authorization';\n\ntype ResolveAuthorizationParams = {\n authorization?: SignAuthorizationReturnType;\n autoDelegate: boolean;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Resolves the EIP-7702 authorization for a sponsored transaction.\n *\n * Returns the provided authorization if given, auto-signs one if needed\n * and autoDelegate is true, or returns undefined if the wallet is already\n * delegated or autoDelegate is false.\n *\n * @notInstrumented\n */\nexport const resolveAuthorization = async (\n {\n authorization,\n autoDelegate,\n walletAccount,\n }: ResolveAuthorizationParams,\n client: ReturnType<typeof getDefaultClient>\n): Promise<SignAuthorizationReturnType | undefined> => {\n // Explicit authorization always takes priority\n if (authorization) {\n return authorization;\n }\n\n // When autoDelegate is false, user manages delegation separately\n if (!autoDelegate) {\n return undefined;\n }\n\n // Auto-delegate: check if delegation is already active\n const isDelegated = await is7702DelegationActive({ walletAccount }, client);\n\n if (isDelegated) {\n return undefined;\n }\n\n return sign7702Authorization({ walletAccount }, client);\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { SerializedAuthorization } from '../gasless.types';\n\n/**\n * Converts a viem SignAuthorizationReturnType into a plain serializable object\n * suitable for JSON transport to the sponsorship API.\n *\n * @notInstrumented\n */\nexport const toSerializedAuthorization = (\n auth: SignAuthorizationReturnType\n): SerializedAuthorization => {\n // viem's Signature type allows legacy v-only signatures without yParity.\n // Our signing flow should always produce yParity, but a wrong value would silently produce invalid authorizations.\n assertDefined(auth.yParity, 'Signed authorization is missing yParity');\n\n return {\n address: auth.address,\n chainId: auth.chainId,\n nonce: auth.nonce,\n r: auth.r as Hex,\n s: auth.s as Hex,\n yParity: auth.yParity,\n };\n};\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport {\n AUTHORIZED_EXECUTIONS_TYPES,\n BATCH_CALL_OPDATA_AUTH_MODE,\n DEFAULT_VALID_FOR_SECONDS,\n DELEGATION_CONTRACT_ADDRESS,\n} from '../constants';\nimport { generateIntentNonce } from '../generateIntentNonce';\nimport { getAvailableEvmGaslessRelayer } from '../getAvailableEvmGaslessRelayer';\nimport { resolveAuthorization } from '../resolveAuthorization';\nimport { toSerializedAuthorization } from '../toSerializedAuthorization';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\n\ntype SignSponsoredTransactionParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, intent nonce\n * generation is skipped entirely (no on-chain `isNonceUsed` check) and the\n * supplied value is used as-is. Matches the `nonce` field returned on the\n * signed-transaction result so callers can reuse it. Useful for\n * mutually-exclusive / cancel-replace intents: signing multiple intents with\n * the same nonce so at most one can ever land on-chain.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Signs a sponsored transaction by creating an EIP-712 intent signature.\n *\n * This function handles the complete signing flow:\n * - If an authorization is provided, it is included in the payload.\n * - If autoDelegate is true (default) and no authorization is provided,\n * checks whether delegation is active and signs a 7702 authorization if needed.\n * - If autoDelegate is false and no authorization is provided, the intent\n * is signed without any authorization (user manages delegation separately).\n *\n * @example\n * ```ts\n * const signedTx = await signSponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * const { requestId } = await relaySponsoredTransaction({ signedTransaction: signedTx });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to sign with.\n * @param params.calls - The batch of calls to execute.\n * @param [params.authorization] - Pre-signed EIP-7702 authorization. Takes priority over autoDelegate.\n * @param [params.autoDelegate] - Whether to auto-sign 7702 if not delegated. Defaults to true.\n * @param [params.nonce] - Optional bitmap nonce. When provided, nonce generation (and its on-chain check) is skipped and the supplied value is used.\n * @param [params.validForSeconds] - How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes).\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The signed sponsored transaction payload ready to be sent to the API.\n * @see sendSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const signSponsoredTransaction = async (\n {\n walletAccount,\n calls,\n authorization,\n autoDelegate = true,\n nonce: providedNonce,\n validForSeconds = DEFAULT_VALID_FOR_SECONDS,\n }: SignSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<SignedSponsoredTransaction> => {\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const resolvedAuthorization = await resolveAuthorization(\n { authorization, autoDelegate, walletAccount },\n client\n );\n\n const nonce =\n providedNonce ?? (await generateIntentNonce({ walletAccount }, client));\n\n const deadline = BigInt(\n Math.floor(Date.now() / 1000) + validForSeconds\n );\n\n const chainId = mapNetworkDataToViemChain(networkData).id;\n\n const { relayerAddress } = await getAvailableEvmGaslessRelayer(\n { chainId },\n client\n );\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const signature = await walletClient.signTypedData({\n domain: {\n chainId,\n verifyingContract: DELEGATION_CONTRACT_ADDRESS,\n },\n message: {\n calls: calls.map((c) => ({\n data: c.data,\n target: c.target,\n value: c.value,\n })),\n deadline,\n mode: BATCH_CALL_OPDATA_AUTH_MODE,\n nonce,\n relayer: relayerAddress,\n },\n primaryType: 'AuthorizedExecutions',\n types: AUTHORIZED_EXECUTIONS_TYPES,\n });\n\n return {\n authorization: resolvedAuthorization\n ? toSerializedAuthorization(resolvedAuthorization)\n : undefined,\n calls,\n chainId,\n deadline: deadline.toString(),\n nonce: nonce.toString(),\n relayer: relayerAddress,\n signature: signature as Hex,\n walletAddress: walletAccount.address as Hex,\n };\n};\n","import {\n createApiClient,\n getCore,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport { DEFAULT_VALID_FOR_SECONDS } from '../constants';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { signSponsoredTransaction } from '../signSponsoredTransaction';\n\ntype RelaySponsoredTransactionWithCallsParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, nonce\n * generation (and its on-chain check) is skipped and the supplied value is\n * used as-is. Useful for mutually-exclusive / cancel-replace intents.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign and relay the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\ntype RelaySponsoredTransactionWithSignedTxParams = {\n /** A pre-signed sponsored transaction payload from signSponsoredTransaction. */\n signedTransaction: SignedSponsoredTransaction;\n};\n\ntype RelaySponsoredTransactionParams =\n | RelaySponsoredTransactionWithCallsParams\n | RelaySponsoredTransactionWithSignedTxParams;\n\nconst isSignedTransactionParams = (\n params: RelaySponsoredTransactionParams,\n): params is RelaySponsoredTransactionWithSignedTxParams =>\n 'signedTransaction' in params;\n\n/**\n * Relays a sponsored EVM transaction to the Dynamic backend.\n *\n * Accepts either a pre-signed transaction or unsigned calls. When given\n * unsigned calls, signs the transaction first via signSponsoredTransaction.\n *\n * The backend encodes the transaction, submits it to the relay provider,\n * and returns a request ID for tracking. The relay may retry the on-chain\n * submission, so the request ID (not a transaction hash) is the stable\n * identifier for the sponsored transaction.\n *\n * @example\n * ```ts\n * const { requestId } = await relaySponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * const { transactionHash } = await waitForSponsoredTransaction({ requestId });\n * ```\n *\n * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the request ID for tracking the relayed transaction.\n * @throws {SponsorTransactionError} If the API call fails or returns an unexpected response.\n * @see waitForSponsoredTransaction\n * @see signSponsoredTransaction\n * @notInstrumented\n */\nexport const relaySponsoredTransaction = async (\n params: RelaySponsoredTransactionParams,\n client = getDefaultClient(),\n): Promise<{ requestId: string }> => {\n const signedTransaction = isSignedTransactionParams(params)\n ? params.signedTransaction\n : await signSponsoredTransaction(\n {\n authorization: params.authorization,\n autoDelegate: params.autoDelegate,\n calls: params.calls,\n nonce: params.nonce,\n validForSeconds: params.validForSeconds ?? DEFAULT_VALID_FOR_SECONDS,\n walletAccount: params.walletAccount,\n },\n client,\n );\n\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: { requestId?: string };\n\n try {\n data = await apiClient.sponsorEVMTransaction({\n environmentId: core.environmentId,\n sponsorEVMTransactionRequest: {\n authorization: signedTransaction.authorization,\n calls: signedTransaction.calls.map((c) => ({\n data: c.data,\n target: c.target,\n value: c.value.toString(),\n })),\n chainId: signedTransaction.chainId,\n deadline: signedTransaction.deadline,\n nonce: signedTransaction.nonce,\n relayer: signedTransaction.relayer,\n signature: signedTransaction.signature,\n walletAddress: signedTransaction.walletAddress,\n },\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n if (!data.requestId) {\n throw new SponsorTransactionError();\n }\n\n return { requestId: data.requestId };\n};\n","import {\n createApiClient,\n getCore,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport type {\n SponsoredTransactionStatus,\n SponsoredTransactionStatusResult,\n} from '../gasless.types';\n\ntype GetEVMSponsoredTransactionStatusParams = {\n /** The request ID returned by `relaySponsoredTransaction` / `sendSponsoredTransaction`. */\n requestId: string;\n};\n\n/**\n * Fetches the current relay state for a sponsored EVM transaction.\n *\n * Returns the lifecycle status, the on-chain transaction hash (when the relay\n * has broadcast it), and any terminal-failure error message. Use this as the\n * building block for custom polling flows; for the common \"wait until done\"\n * case prefer `waitForSponsoredTransaction`.\n *\n * @example\n * ```ts\n * const status = await getEVMSponsoredTransactionStatus({ requestId });\n * if (status.transactionHash) {\n * console.log('On-chain:', status.transactionHash);\n * }\n * ```\n *\n * @param params.requestId - The request ID returned when the transaction was relayed.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The current status, optional transaction hash, and optional error message.\n * @throws {SponsorTransactionError} If the API call fails.\n * @see waitForSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const getEVMSponsoredTransactionStatus = async (\n { requestId }: GetEVMSponsoredTransactionStatusParams,\n client = getDefaultClient(),\n): Promise<SponsoredTransactionStatusResult> => {\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: {\n errorMessage?: string;\n status: SponsoredTransactionStatus;\n transactionHash?: string;\n };\n\n try {\n data = await apiClient.getEVMSponsoredTransactionStatus({\n environmentId: core.environmentId,\n requestId,\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n return {\n errorMessage: data.errorMessage,\n status: data.status,\n transactionHash: data.transactionHash as Hex | undefined,\n };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport type { SponsoredTransactionStatus } from '../gasless.types';\nimport { getEVMSponsoredTransactionStatus } from '../getEVMSponsoredTransactionStatus';\n\nconst POLL_INTERVAL_MS = 2_000;\nconst TIMEOUT_MS = 60_000;\nconst MAX_POLLING_ATTEMPTS = TIMEOUT_MS / POLL_INTERVAL_MS;\n\nconst TERMINAL_FAILURE_STATUSES = new Set<SponsoredTransactionStatus>([\n 'failure',\n]);\n\ntype WaitForSponsoredTransactionParams = {\n /** The request ID returned by `relaySponsoredTransaction` / `sendSponsoredTransaction`. */\n requestId: string;\n};\n\n/**\n * Polls `getEVMSponsoredTransactionStatus` until the relay reports the\n * transaction has been included on-chain, then returns the transaction hash.\n *\n * @example\n * ```ts\n * const { requestId } = await relaySponsoredTransaction({ signedTransaction });\n * const { transactionHash } = await waitForSponsoredTransaction({ requestId });\n * ```\n *\n * @param params.requestId - The request ID returned when the transaction was relayed.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see relaySponsoredTransaction\n * @see getEVMSponsoredTransactionStatus\n * @notInstrumented\n */\nexport const waitForSponsoredTransaction = async (\n { requestId }: WaitForSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> => {\n for (let attempt = 0; attempt < MAX_POLLING_ATTEMPTS; attempt++) {\n const result = await getEVMSponsoredTransactionStatus(\n { requestId },\n client\n );\n\n if (TERMINAL_FAILURE_STATUSES.has(result.status)) {\n throw new SponsorTransactionError(null, result.errorMessage);\n }\n\n if (result.transactionHash) {\n return { transactionHash: result.transactionHash };\n }\n\n if (attempt < MAX_POLLING_ATTEMPTS - 1) {\n await new Promise<void>((resolve) =>\n setTimeout(resolve, POLL_INTERVAL_MS)\n );\n }\n }\n\n throw new SponsorTransactionError(\n null,\n `Timed out waiting for sponsored transaction ${requestId}`\n );\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { relaySponsoredTransaction } from '../relaySponsoredTransaction';\nimport { waitForSponsoredTransaction } from '../waitForSponsoredTransaction';\n\ntype SendSponsoredTransactionWithCallsParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, nonce\n * generation (and its on-chain check) is skipped and the supplied value is\n * used as-is. Useful for mutually-exclusive / cancel-replace intents.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign and send the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\ntype SendSponsoredTransactionWithSignedTxParams = {\n /** A pre-signed sponsored transaction payload from signSponsoredTransaction. */\n signedTransaction: SignedSponsoredTransaction;\n};\n\ntype SendSponsoredTransactionParams =\n | SendSponsoredTransactionWithCallsParams\n | SendSponsoredTransactionWithSignedTxParams;\n\n/**\n * Sends a sponsored EVM transaction and waits for on-chain inclusion.\n *\n * Accepts either a pre-signed transaction or unsigned calls. When given\n * unsigned calls, signs the transaction first via signSponsoredTransaction.\n * Relays the transaction and resolves as soon as the relay reports the\n * transaction has been included on-chain.\n *\n * @example\n * ```ts\n * const { transactionHash } = await sendSponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * ```\n *\n * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see signSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const sendSponsoredTransaction = async (\n params: SendSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> => {\n const { requestId } = await relaySponsoredTransaction(params, client);\n return waitForSponsoredTransaction({ requestId }, client);\n};\n","import { BaseError, type BaseErrorParameters } from '@dynamic-labs-sdk/client';\n\nexport type RpcErrorParameters = Pick<BaseErrorParameters, 'shortMessage'> &\n Partial<Omit<BaseErrorParameters, 'shortMessage'>>;\n\nexport class RpcError extends BaseError {\n constructor(args: RpcErrorParameters) {\n super({\n cause: args.cause ?? null,\n code: args.code ?? 'rpc_error',\n details: args.details,\n docsUrl: args.docsUrl ?? null,\n metaMessages: args.metaMessages,\n name: args.name ?? 'RpcError',\n shortMessage: args.shortMessage,\n });\n }\n}\n","import type { DynamicClient, NetworkData } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\nimport { RpcError } from '../../errors/RpcError';\n\ntype FetchEvmBalanceParams = {\n address: string;\n networkData: NetworkData;\n};\n\n/** @notInstrumented */\nexport const fetchEvmBalance = async (\n { address, networkData }: FetchEvmBalanceParams,\n client: DynamicClient\n): Promise<string | null> => {\n const rpcUrl = networkData.rpcUrls.http[0];\n const core = getCore(client);\n\n try {\n // Perform a POST request to the RPC URL with the JSON-RPC payload\n const response = await core.fetch(rpcUrl, {\n /**\n * The JSON-RPC method 'eth_getBalance' takes the address and a block tag ('latest' is the most recent)\n * See EIP-1474: https://eips.ethereum.org/EIPS/eip-1474\n * See eth_getBalance spec: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance\n */\n body: JSON.stringify({\n id: Math.floor(Date.now() + Math.random() * 1000),\n jsonrpc: '2.0',\n method: 'eth_getBalance',\n params: [address, 'latest'],\n }),\n\n headers: {\n 'Content-Type': 'application/json',\n },\n\n method: 'POST',\n });\n\n // Check if the network response was successful\n if (!response.ok) {\n throw new RpcError({\n code: 'http_error',\n shortMessage: `HTTP error! status: ${response.status}`,\n });\n }\n\n const data = await response.json();\n\n // Check for a JSON-RPC error in the response\n if (data.error) {\n throw new RpcError({\n cause: data.error instanceof Error ? data.error : undefined,\n code: 'json_rpc_error',\n shortMessage: `RPC Error: ${data.error.message}`,\n });\n }\n\n // The result is a hexadecimal string representing the balance in Wei\n const balanceWeiHex = data.result;\n\n // Convert the hexadecimal string to a BigInt\n const balanceWei = BigInt(balanceWeiHex);\n\n // Convert the balance from Wei to Ether (1 Ether = 10^18 Wei)\n // We use a BigInt for the conversion to maintain precision with large numbers\n const oneEther = BigInt(1e18);\n\n // Perform the division and return the result as a number\n // Note: This conversion can lose precision for very small amounts, but is generally fine for display purposes.\n const balanceEther = Number(balanceWei) / Number(oneEther);\n\n return balanceEther.toString();\n } catch (error) {\n if (error instanceof Error) {\n throw new RpcError({\n cause: error,\n code: 'rpc_error',\n shortMessage: `Failed to fetch balance for address ${address}`,\n });\n }\n\n throw error;\n }\n};\n","import type { DynamicClient, NetworkData } from '@dynamic-labs-sdk/client';\nimport { createBaseNetworkProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { EvmNetworkProvider } from '../../EvmNetworkProvider';\nimport { fetchEvmBalance } from '../fetchEvmBalance';\n\n/** @notInstrumented */\nexport const createEvmNetworkProvider = (\n networkData: NetworkData,\n client: DynamicClient\n): EvmNetworkProvider => ({\n ...createBaseNetworkProvider('EVM', networkData),\n\n getBalance: async ({ address }) => ({\n balance: await fetchEvmBalance(\n {\n address,\n networkData,\n },\n client\n ),\n }),\n});\n","import { type DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworkProviderBuilderRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { createEvmNetworkProvider } from '../utils/createEvmNetworkProvider';\n\n/** @notInstrumented */\nexport const registerEvmNetworkProviderBuilder = (\n client: DynamicClient\n): void => {\n const networkProviderBuilderRegistry =\n getNetworkProviderBuilderRegistry(client);\n\n /**\n * If the Ethereum network provider builder is already registered, return.\n */\n if (networkProviderBuilderRegistry.get().get('EVM')) {\n return;\n }\n\n networkProviderBuilderRegistry.register({\n builder: (networkData) => createEvmNetworkProvider(networkData, client),\n chain: 'EVM',\n });\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\n\n/**\n * Type guard function to check if a wallet account is an EVM wallet account.\n *\n * @example\n * ```ts\n * const accounts = getWalletAccounts();\n * const evmAccounts = accounts.filter(isEvmWalletAccount);\n * ```\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an EVM wallet account, false otherwise.\n * @see isEvmNetworkProvider\n * @see addEvmExtension\n * @notInstrumented\n */\nexport const isEvmWalletAccount = (\n walletAccount: WalletAccount\n): walletAccount is EvmWalletAccount => walletAccount.chain === 'EVM';\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport type { ConfirmTransactionParams } from '@dynamic-labs-sdk/client/core';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\n/**\n * Waits for an EVM transaction to be confirmed on-chain.\n *\n * @param params.transactionHash - The transaction hash to wait for.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param client - The Dynamic client instance.\n * @notInstrumented\n */\nexport const evmConfirmTransaction = async (\n { transactionHash, walletAccount }: ConfirmTransactionParams,\n client: DynamicClient\n): Promise<void> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n await publicClient.waitForTransactionReceipt({\n hash: transactionHash as `0x${string}`,\n });\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\n/**\n * Checks if EVM gas sponsorship is enabled for the current project.\n *\n * @example\n * ```ts\n * if (isEvmGasSponsorshipEnabled()) {\n * await sendSponsoredTransaction({ walletAccount, calls });\n * }\n * ```\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True if EVM gas sponsorship is enabled, false otherwise.\n * @see sendSponsoredTransaction\n * @see activate7702Delegation\n * @notInstrumented\n */\nexport const isEvmGasSponsorshipEnabled = (\n client = getDefaultClient()\n): boolean => {\n assertDefined(client.projectSettings, 'Project settings are not defined');\n\n return (\n client.projectSettings.sdk.embeddedWallets?.evmGasSponsorshipEnabled ??\n false\n );\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { encodeFunctionData, erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\n\ntype ApproveErc20Params = {\n amount: bigint;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Sends an ERC-20 `approve` transaction, granting a spender an allowance\n * to transfer tokens on behalf of the wallet account.\n *\n * Encodes the `approve(spender, amount)` call using viem's `encodeFunctionData`\n * and sends it through the wallet account's viem wallet client.\n *\n * @param params.amount - The amount to approve in the token's smallest unit.\n * @param params.spenderAddress - The address being granted the allowance.\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.walletAccount - The EVM wallet account sending the approval.\n * @param client - The Dynamic client instance.\n * @returns The approval transaction hash.\n * @notInstrumented\n */\nexport const approveErc20 = async (\n { amount, spenderAddress, tokenAddress, walletAccount }: ApproveErc20Params,\n client: DynamicClient\n): Promise<{ transactionHash: string }> => {\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const data = encodeFunctionData({\n abi: erc20Abi,\n args: [spenderAddress as `0x${string}`, amount],\n functionName: 'approve',\n });\n\n const hash = await walletClient.sendTransaction({\n data,\n to: tokenAddress as `0x${string}`,\n });\n\n return { transactionHash: hash };\n};\n","import {\n type DynamicClient,\n type NetworkData,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport { erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\n\ntype GetErc20AllowanceParams = {\n networkData?: NetworkData;\n ownerAddress: string;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Reads the current ERC-20 token allowance granted by an owner to a spender.\n *\n * Uses a viem public client derived from the wallet account's active network\n * to call the `allowance(owner, spender)` method on the token contract.\n *\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.ownerAddress - The address that granted the allowance.\n * @param params.spenderAddress - The address allowed to spend the tokens.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param [params.networkData] - The network data to use for the public client. If not provided, the active network data will be used.\n * @param client - The Dynamic client instance.\n * @returns The current allowance as a bigint in the token's smallest unit.\n * @notInstrumented\n */\nexport const getErc20Allowance = async (\n {\n networkData,\n ownerAddress,\n spenderAddress,\n tokenAddress,\n walletAccount,\n }: GetErc20AllowanceParams,\n client: DynamicClient\n): Promise<bigint> => {\n if (!networkData) {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount },\n client\n );\n networkData = activeNetworkData.networkData;\n }\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n return publicClient.readContract({\n abi: erc20Abi,\n address: tokenAddress as `0x${string}`,\n args: [ownerAddress as `0x${string}`, spenderAddress as `0x${string}`],\n functionName: 'allowance',\n });\n};\n","import {\n type DynamicClient,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { TransactionReceipt } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { approveErc20 } from '../approveErc20';\nimport { getErc20Allowance } from '../getErc20Allowance';\n\ntype ApproveErc20IfRequiredAndWaitReceiptParams = {\n amount: string;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Approves an ERC-20 token if the current allowance is insufficient and waits for the transaction receipt.\n *\n * @param params.amount - The amount of tokens to approve.\n * @param params.ownerAddress - The address that granted the allowance.\n * @param params.spenderAddress - The address allowed to spend the tokens.\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param client - The Dynamic client instance.\n * @returns The transaction receipt if an approval was sent, otherwise undefined.\n * @notInstrumented\n */\nexport const approveErc20IfRequiredAndWaitReceipt = async (\n {\n amount,\n spenderAddress,\n tokenAddress,\n walletAccount,\n }: ApproveErc20IfRequiredAndWaitReceiptParams,\n client: DynamicClient\n): Promise<{ receipt: TransactionReceipt } | undefined> => {\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const currentAllowance = await getErc20Allowance(\n {\n networkData,\n ownerAddress: walletAccount.address,\n spenderAddress,\n tokenAddress,\n walletAccount,\n },\n client\n );\n\n const approvalAmount = BigInt(amount);\n\n if (currentAllowance >= approvalAmount) {\n return undefined;\n }\n\n const result = await approveErc20(\n {\n amount: approvalAmount,\n spenderAddress,\n tokenAddress,\n walletAccount,\n },\n client\n );\n const approvalTransactionHash = result.transactionHash;\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: approvalTransactionHash as `0x${string}`,\n });\n\n return { receipt };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n} from '@dynamic-labs-sdk/client';\nimport type { ExecuteSwapTransactionResult } from '@dynamic-labs-sdk/client/core';\nimport type { SwapSigningPayload } from '@dynamic-labs/sdk-api-core';\nimport { type Hex, encodeFunctionData, erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport type { SponsoredTransactionCall } from '../../gasless/gasless.types';\nimport { sendSponsoredTransaction } from '../../gasless/sendSponsoredTransaction';\nimport { getErc20Allowance } from '../getErc20Allowance';\n\ntype EvmExecuteSponsoredSwapTransactionParams = {\n onStepChange?: (step: 'approval' | 'transaction') => void;\n signingPayload: SwapSigningPayload;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Executes an EVM swap as a single gas-sponsored transaction.\n *\n * Unlike the user-paid path, the optional ERC-20 approval and the swap call\n * are batched into one sponsored transaction (EVM gas sponsorship supports\n * call batching), so there is no separate approval transaction hash.\n *\n * 1. If the signing payload includes an `evmApproval`, reads the current\n * allowance and prepends an `approve` call only when it is insufficient\n * 2. Appends the main swap call (gas fields are dropped — the relayer pays gas)\n * 3. Relays the batch via `sendSponsoredTransaction` and waits for inclusion\n *\n * @param params.signingPayload - The signing payload containing `evmTransaction` and optional `evmApproval`.\n * @param params.walletAccount - The embedded EVM wallet account whose gas is sponsored.\n * @param params.onStepChange - Optional callback invoked with `'approval'` or `'transaction'` as each step begins.\n * @param client - The Dynamic client instance.\n * @returns The on-chain transaction hash of the sponsored swap.\n * @notInstrumented\n */\nexport const evmExecuteSponsoredSwapTransaction = async (\n {\n onStepChange,\n signingPayload,\n walletAccount,\n }: EvmExecuteSponsoredSwapTransactionParams,\n client: DynamicClient\n): Promise<ExecuteSwapTransactionResult> => {\n const { evmTransaction, evmApproval } = signingPayload;\n\n if (!evmTransaction) {\n throw new InvalidParamError(\n 'Signing payload is missing EVM transaction data'\n );\n }\n\n const calls: SponsoredTransactionCall[] = [];\n\n if (evmApproval) {\n const approvalAmount = BigInt(evmApproval.amount);\n\n const currentAllowance = await getErc20Allowance(\n {\n ownerAddress: walletAccount.address,\n spenderAddress: evmApproval.spenderAddress,\n tokenAddress: evmApproval.tokenAddress,\n walletAccount,\n },\n client\n );\n\n // Only batch an approval call when the existing allowance is insufficient,\n // matching the user-paid path's allowance check.\n if (currentAllowance < approvalAmount) {\n onStepChange?.('approval');\n\n calls.push({\n data: encodeFunctionData({\n abi: erc20Abi,\n args: [evmApproval.spenderAddress as Hex, approvalAmount],\n functionName: 'approve',\n }),\n target: evmApproval.tokenAddress as Hex,\n value: 0n,\n });\n }\n }\n\n onStepChange?.('transaction');\n\n // Gas fields from the quote are intentionally omitted — the relayer funds gas.\n calls.push({\n data: evmTransaction.data as Hex,\n target: evmTransaction.to as Hex,\n value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n,\n });\n\n const { transactionHash } = await sendSponsoredTransaction(\n { calls, walletAccount },\n client\n );\n\n return { transactionHash };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n} from '@dynamic-labs-sdk/client';\nimport {\n type ExecuteSwapTransactionParams,\n type ExecuteSwapTransactionResult,\n getWalletProviderFromWalletAccount,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { isEvmGasSponsorshipEnabled } from '../../gasless/isEvmGasSponsorshipEnabled';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { isEvmWalletProviderWithCustomViemClient } from '../../viem/utils/walletProviderHasCustomWalletClient';\nimport { approveErc20IfRequiredAndWaitReceipt } from '../approveErc20IfRequiredAndWaitReceipt';\nimport { evmExecuteSponsoredSwapTransaction } from '../evmExecuteSponsoredSwapTransaction';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\n/**\n * Executes an EVM checkout transaction by handling optional ERC-20 approval\n * and sending the main swap transaction on-chain.\n *\n * 1. Validates that the wallet account is an EVM wallet account\n * 2. When EVM gas sponsorship is enabled and the wallet is a Dynamic embedded\n * wallet (and `sponsorshipMode` is not `'off'`), routes the swap through the\n * gas-sponsored path, batching any required approval with the swap call\n * 3. Otherwise, if the signing payload includes an `evmApproval`, checks the\n * current ERC-20 allowance and sends an approve transaction when insufficient\n * 4. Sends the main transaction using the viem wallet client\n *\n * @param params.signingPayload - The chain-aware signing payload containing `evmTransaction` and optional `evmApproval`.\n * @param params.walletAccount - The wallet account used to sign and send transactions.\n * @param params.onStepChange - Optional callback invoked with `'approval'` or `'transaction'` as each step begins.\n * @param params.sponsorshipMode - `'auto'` (default) sponsors when eligible; `'off'` never sponsors.\n * @param client - The Dynamic client instance.\n * @returns The main transaction hash and, if a separate approval was sent, the approval transaction hash.\n * @notInstrumented\n */\nexport const evmExecuteSwapTransaction = async (\n {\n onStepChange,\n signingPayload,\n sponsorshipMode = 'auto',\n walletAccount,\n }: ExecuteSwapTransactionParams,\n client: DynamicClient\n): Promise<ExecuteSwapTransactionResult> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n const walletProvider = getWalletProviderFromWalletAccount(\n { walletAccount },\n client\n );\n\n // Sponsorship requires an embedded wallet (custom viem client) so the\n // EIP-7702 authorization can be signed; external wallets fall through to the\n // user-paid path below.\n if (\n sponsorshipMode === 'auto' &&\n isEvmGasSponsorshipEnabled(client) &&\n isEvmWalletProviderWithCustomViemClient(walletProvider)\n ) {\n return evmExecuteSponsoredSwapTransaction(\n { onStepChange, signingPayload, walletAccount },\n client\n );\n }\n\n const { evmTransaction, evmApproval } = signingPayload;\n\n if (!evmTransaction) {\n throw new InvalidParamError(\n 'Signing payload is missing EVM transaction data'\n );\n }\n\n if (evmApproval) {\n onStepChange?.('approval');\n\n await approveErc20IfRequiredAndWaitReceipt(\n {\n amount: evmApproval.amount,\n spenderAddress: evmApproval.spenderAddress,\n tokenAddress: evmApproval.tokenAddress,\n walletAccount,\n },\n client\n );\n }\n\n onStepChange?.('transaction');\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n // sendTransaction expects gasPrice or maxFeePerGas and maxPriorityFeePerGas\n let gasParams: Record<string, bigint> = {};\n if (evmTransaction.maxFeePerGas && evmTransaction.maxPriorityFeePerGas) {\n gasParams = {\n maxFeePerGas: BigInt(evmTransaction.maxFeePerGas),\n maxPriorityFeePerGas: BigInt(evmTransaction.maxPriorityFeePerGas),\n };\n } else {\n gasParams = {\n ...(evmTransaction.gasPrice && {\n gasPrice: BigInt(evmTransaction.gasPrice),\n }),\n };\n }\n\n const transactionHash = await walletClient.sendTransaction({\n data: evmTransaction.data as `0x${string}`,\n to: evmTransaction.to as `0x${string}`,\n value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n,\n ...(evmTransaction.gasLimit && { gas: BigInt(evmTransaction.gasLimit) }),\n ...gasParams,\n ...(evmTransaction.nonce && { nonce: evmTransaction.nonce }),\n });\n\n return { transactionHash };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { TransferAmountParams } from '@dynamic-labs-sdk/client/core';\nimport { encodeFunctionData, erc20Abi, parseEther, parseUnits } from 'viem';\n\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\nconst DEFAULT_DECIMALS = 18;\n\n/** @notInstrumented */\nexport const evmTransferAmount = 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 const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n const nonce = await publicClient.getTransactionCount({\n address: walletAccount.address as `0x${string}`,\n });\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n // non-native token transfers\n if (token) {\n const decimals = token.decimals ?? DEFAULT_DECIMALS;\n\n const data = encodeFunctionData({\n abi: erc20Abi,\n args: [recipient as `0x${string}`, parseUnits(amount, decimals)],\n functionName: 'transfer',\n });\n\n const hash = await walletClient.sendTransaction({\n data,\n nonce,\n to: token.address as `0x${string}`,\n });\n\n return { transactionHash: hash };\n }\n\n // native token transfers\n const hash = await walletClient.sendTransaction({\n nonce,\n to: recipient as `0x${string}`,\n value: parseEther(amount),\n });\n\n return { transactionHash: hash };\n};\n"],"mappings":"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"}

package/dist/{evmTransferAmount-C1msMTNe.cjs → evmTransferAmount-bPkkINFr.cjs} RENAMED Viewed

@@ -1,5 +1,5 @@
-const require_mapNetworkDataToViemChain = require('./mapNetworkDataToViemChain-DHni6ErD.cjs');
-const require_createWalletClientForWalletAccount = require('./createWalletClientForWalletAccount-Cb2uMZxJ.cjs');
+const require_mapNetworkDataToViemChain = require('./mapNetworkDataToViemChain-y9sq6Oak.cjs');
+const require_createWalletClientForWalletAccount = require('./createWalletClientForWalletAccount-DZ1SUxot.cjs');
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
 let viem = require("viem");
@@ -195,11 +195,21 @@ const get7702DelegationRegistry = (0, _dynamic_labs_sdk_client_core.createRuntim
 * Checks whether EIP-7702 delegation to the Dynamic gasless contract is active
 * for the given wallet account on its current network.
 *
-* Results are cached per wallet+chain in an in-memory registry
+* Results are cached per wallet+chain in an in-memory registry.
+*
+* @example
+* ```ts
+* const isDelegated = await is7702DelegationActive({ walletAccount: evmAccount });
+* if (!isDelegated) {
+*   await activate7702Delegation({ walletAccount: evmAccount });
+* }
+* ```
 *
 * @param params.walletAccount - The EVM wallet account to check delegation status for.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns True if the wallet has an active delegation to the gasless contract.
+* @see activate7702Delegation
+* @see sign7702Authorization
 * @notInstrumented
 */
 const is7702DelegationActive = async ({ walletAccount }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -250,10 +260,18 @@ const resolveChainId = async ({ chainId, walletAccount }, client) => {
 * activate the delegation on-chain. If no chainId is provided, the wallet's
 * active network chain ID is used.
 *
+* @example
+* ```ts
+* const authorization = await sign7702Authorization({ walletAccount: evmAccount });
+* await activate7702Delegation({ walletAccount: evmAccount, authorization });
+* ```
+*
 * @param params.walletAccount - The EVM wallet account to sign the authorization for.
 * @param [params.chainId] - Override chain ID. Defaults to the wallet's active network.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The signed EIP-7702 authorization.
+* @see activate7702Delegation
+* @see is7702DelegationActive
 * @notInstrumented
 */
 const sign7702Authorization = async ({ walletAccount, chainId }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -316,6 +334,15 @@ const toSerializedAuthorization = (auth) => {
 * - If autoDelegate is false and no authorization is provided, the intent
 *   is signed without any authorization (user manages delegation separately).
 *
+* @example
+* ```ts
+* const signedTx = await signSponsoredTransaction({
+*   walletAccount: evmAccount,
+*   calls: [{ target: '0x...', data: '0x...', value: 0n }],
+* });
+* const { requestId } = await relaySponsoredTransaction({ signedTransaction: signedTx });
+* ```
+*
 * @param params.walletAccount - The EVM wallet account to sign with.
 * @param params.calls - The batch of calls to execute.
 * @param [params.authorization] - Pre-signed EIP-7702 authorization. Takes priority over autoDelegate.
@@ -324,6 +351,8 @@ const toSerializedAuthorization = (auth) => {
 * @param [params.validForSeconds] - How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes).
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The signed sponsored transaction payload ready to be sent to the API.
+* @see sendSponsoredTransaction
+* @see relaySponsoredTransaction
 * @notInstrumented
 */
 const signSponsoredTransaction = async ({ walletAccount, calls, authorization, autoDelegate = true, nonce: providedNonce, validForSeconds = DEFAULT_VALID_FOR_SECONDS }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -383,10 +412,21 @@ const isSignedTransactionParams = (params) => "signedTransaction" in params;
 * submission, so the request ID (not a transaction hash) is the stable
 * identifier for the sponsored transaction.
 *
+* @example
+* ```ts
+* const { requestId } = await relaySponsoredTransaction({
+*   walletAccount: evmAccount,
+*   calls: [{ target: '0x...', data: '0x...', value: 0n }],
+* });
+* const { transactionHash } = await waitForSponsoredTransaction({ requestId });
+* ```
+*
 * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the request ID for tracking the relayed transaction.
 * @throws {SponsorTransactionError} If the API call fails or returns an unexpected response.
+* @see waitForSponsoredTransaction
+* @see signSponsoredTransaction
 * @notInstrumented
 */
 const relaySponsoredTransaction = async (params, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -436,10 +476,20 @@ const relaySponsoredTransaction = async (params, client = (0, _dynamic_labs_sdk_
 * building block for custom polling flows; for the common "wait until done"
 * case prefer `waitForSponsoredTransaction`.
 *
+* @example
+* ```ts
+* const status = await getEVMSponsoredTransactionStatus({ requestId });
+* if (status.transactionHash) {
+*   console.log('On-chain:', status.transactionHash);
+* }
+* ```
+*
 * @param params.requestId - The request ID returned when the transaction was relayed.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The current status, optional transaction hash, and optional error message.
 * @throws {SponsorTransactionError} If the API call fails.
+* @see waitForSponsoredTransaction
+* @see relaySponsoredTransaction
 * @notInstrumented
 */
 const getEVMSponsoredTransactionStatus = async ({ requestId }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
@@ -470,10 +520,18 @@ const TERMINAL_FAILURE_STATUSES = new Set(["failure"]);
 * Polls `getEVMSponsoredTransactionStatus` until the relay reports the
 * transaction has been included on-chain, then returns the transaction hash.
 *
+* @example
+* ```ts
+* const { requestId } = await relaySponsoredTransaction({ signedTransaction });
+* const { transactionHash } = await waitForSponsoredTransaction({ requestId });
+* ```
+*
 * @param params.requestId - The request ID returned when the transaction was relayed.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the on-chain transaction hash.
 * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+* @see relaySponsoredTransaction
+* @see getEVMSponsoredTransactionStatus
 * @notInstrumented
 */
 const waitForSponsoredTransaction = async ({ requestId }, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
@@ -496,10 +554,20 @@ const waitForSponsoredTransaction = async ({ requestId }, client = (0, _dynamic_
 * Relays the transaction and resolves as soon as the relay reports the
 * transaction has been included on-chain.
 *
+* @example
+* ```ts
+* const { transactionHash } = await sendSponsoredTransaction({
+*   walletAccount: evmAccount,
+*   calls: [{ target: '0x...', data: '0x...', value: 0n }],
+* });
+* ```
+*
 * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An object containing the on-chain transaction hash.
 * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.
+* @see signSponsoredTransaction
+* @see relaySponsoredTransaction
 * @notInstrumented
 */
 const sendSponsoredTransaction = async (params, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
@@ -595,8 +663,16 @@ const registerEvmNetworkProviderBuilder = (client) => {
 /**
 * Type guard function to check if a wallet account is an EVM wallet account.
 *
+* @example
+* ```ts
+* const accounts = getWalletAccounts();
+* const evmAccounts = accounts.filter(isEvmWalletAccount);
+* ```
+*
 * @param walletAccount - The wallet account to check.
 * @returns True if the wallet account is an EVM wallet account, false otherwise.
+* @see isEvmNetworkProvider
+* @see addEvmExtension
 * @notInstrumented
 */
 const isEvmWalletAccount = (walletAccount) => walletAccount.chain === "EVM";
@@ -623,8 +699,17 @@ const evmConfirmTransaction = async ({ transactionHash, walletAccount }, client)
 /**
 * Checks if EVM gas sponsorship is enabled for the current project.
 *
+* @example
+* ```ts
+* if (isEvmGasSponsorshipEnabled()) {
+*   await sendSponsoredTransaction({ walletAccount, calls });
+* }
+* ```
+*
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns True if EVM gas sponsorship is enabled, false otherwise.
+* @see sendSponsoredTransaction
+* @see activate7702Delegation
 * @notInstrumented
 */
 const isEvmGasSponsorshipEnabled = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
@@ -962,4 +1047,4 @@ Object.defineProperty(exports, 'waitForSponsoredTransaction', {
     return waitForSponsoredTransaction;
   }
 });
-//# sourceMappingURL=evmTransferAmount-C1msMTNe.cjs.map
+//# sourceMappingURL=evmTransferAmount-bPkkINFr.cjs.map

package/dist/evmTransferAmount-bPkkINFr.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"evmTransferAmount-bPkkINFr.cjs","names":["BaseError","DELEGATION_CONTRACT_ADDRESS: Hex","BATCH_CALL_OPDATA_AUTH_MODE: Hex","createPublicClientFromNetworkData","data: { relayerAddress?: string }","mapNetworkDataToViemChain","createPublicClientFromNetworkData","mapNetworkDataToViemChain","createWalletClientForWalletAccount","mapNetworkDataToViemChain","createWalletClientForWalletAccount","data: { requestId?: string }","data: {\n errorMessage?: string;\n status: SponsoredTransactionStatus;\n transactionHash?: string;\n }","BaseError","InvalidParamError","createPublicClientFromNetworkData","createWalletClientForWalletAccount","erc20Abi","createPublicClientFromNetworkData","erc20Abi","createPublicClientFromNetworkData","InvalidParamError","calls: SponsoredTransactionCall[]","erc20Abi","InvalidParamError","isEvmWalletProviderWithCustomViemClient","createWalletClientForWalletAccount","gasParams: Record<string, bigint>","InvalidParamError","createPublicClientFromNetworkData","createWalletClientForWalletAccount","erc20Abi"],"sources":["../src/errors/SponsorTransactionError/SponsorTransactionError.ts","../src/gasless/constants.ts","../src/gasless/generateRandomNonce/generateRandomNonce.ts","../src/gasless/generateIntentNonce/generateIntentNonce.ts","../src/gasless/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.ts","../src/gasless/create7702DelegationRegistry/create7702DelegationRegistry.ts","../src/gasless/get7702DelegationRegistry/get7702DelegationRegistry.ts","../src/gasless/is7702DelegationActive/is7702DelegationActive.ts","../src/gasless/resolveChainId/resolveChainId.ts","../src/gasless/sign7702Authorization/sign7702Authorization.ts","../src/gasless/resolveAuthorization/resolveAuthorization.ts","../src/gasless/toSerializedAuthorization/toSerializedAuthorization.ts","../src/gasless/signSponsoredTransaction/signSponsoredTransaction.ts","../src/gasless/relaySponsoredTransaction/relaySponsoredTransaction.ts","../src/gasless/getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.ts","../src/gasless/waitForSponsoredTransaction/waitForSponsoredTransaction.ts","../src/gasless/sendSponsoredTransaction/sendSponsoredTransaction.ts","../src/errors/RpcError.ts","../src/utils/fetchEvmBalance/fetchEvmBalance.ts","../src/utils/createEvmNetworkProvider/createEvmNetworkProvider.ts","../src/registerEvmNetworkProviderBuilder/registerEvmNetworkProviderBuilder.ts","../src/utils/isEvmWalletAccount/isEvmWalletAccount.ts","../src/utils/evmConfirmTransaction/evmConfirmTransaction.ts","../src/gasless/isEvmGasSponsorshipEnabled/isEvmGasSponsorshipEnabled.ts","../src/utils/approveErc20/approveErc20.ts","../src/utils/getErc20Allowance/getErc20Allowance.ts","../src/utils/approveErc20IfRequiredAndWaitReceipt/approveErc20IfRequiredAndWaitReceipt.ts","../src/utils/evmExecuteSponsoredSwapTransaction/evmExecuteSponsoredSwapTransaction.ts","../src/utils/evmExecuteSwapTransaction/evmExecuteSwapTransaction.ts","../src/utils/evmTransferAmount/evmTransferAmount.ts"],"sourcesContent":["import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class SponsorTransactionError extends BaseError {\n // eslint-disable-next-line custom-rules/require-single-object-param -- mirrors viem-style error constructors: (cause, details)\n constructor(cause?: Error | null, details?: string) {\n super({\n cause: cause ?? null,\n code: 'sponsor_transaction_error',\n details,\n docsUrl: null,\n name: 'SponsorTransactionError',\n shortMessage: 'Failed to sponsor EVM transaction',\n });\n }\n}\n","import type { Hex } from 'viem';\n\n/** The Fireblocks Universal Gasless Delegate (UGD) contract address used for EIP-7702 delegation. */\nexport const DELEGATION_CONTRACT_ADDRESS: Hex =\n '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';\n\n/** Default sponsored transaction validity duration in seconds (10 minutes). */\nexport const DEFAULT_VALID_FOR_SECONDS = 600;\n\n/** EIP-7702 delegation code prefix used to identify delegated accounts. */\nexport const DELEGATION_CODE_PREFIX = '0xef0100';\n\n/** ERC-7579 batch call with opData and auth mode identifier. */\nexport const BATCH_CALL_OPDATA_AUTH_MODE: Hex =\n '0x0100000000007821000100000000000000000000000000000000000000000000';\n\n/** EIP-712 typed data types for UGD AuthorizedExecutions signing. */\nexport const AUTHORIZED_EXECUTIONS_TYPES = {\n AuthorizedExecutions: [\n { name: 'calls', type: 'Execution[]' },\n { name: 'deadline', type: 'uint256' },\n { name: 'mode', type: 'bytes32' },\n { name: 'nonce', type: 'uint256' },\n { name: 'relayer', type: 'address' },\n ],\n Execution: [\n { name: 'target', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'data', type: 'bytes' },\n ],\n} as const;\n\n/** Minimal ABI for the UGD contract's nonce validation function. */\nexport const UGD_ABI = [\n {\n inputs: [{ name: 'nonce', type: 'uint256' }],\n name: 'isNonceUsed',\n outputs: [{ name: '', type: 'bool' }],\n stateMutability: 'view',\n type: 'function',\n },\n] as const;\n","/**\n * Generates a cryptographically random 256-bit nonce.\n *\n * @returns A random bigint nonce.\n * @notInstrumented\n */\nexport const generateRandomNonce = (): bigint => {\n const bytes = new Uint8Array(32);\n crypto.getRandomValues(bytes);\n\n return bytes.reduce((acc, byte) => (acc << 8n) | BigInt(byte), 0n);\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { UGD_ABI } from '../constants';\nimport { generateRandomNonce } from '../generateRandomNonce';\n\ntype GenerateIntentNonceParams = {\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Generates a random bitmap nonce for UGD AuthorizedExecutions signing.\n *\n * Uses crypto.getRandomValues() for 256-bit randomness. Validates against\n * the on-chain isNonceUsed check as a safety measure, although collision\n * is essentially impossible with 256-bit random values.\n *\n * @param params.walletAccount - The wallet account whose delegation contract is checked.\n * @param [client] - The Dynamic client instance.\n * @returns A unique bigint nonce for the EIP-712 intent.\n * @notInstrumented\n */\nexport const generateIntentNonce = async (\n { walletAccount }: GenerateIntentNonceParams,\n client: DynamicClient\n): Promise<bigint> => {\n const nonce = generateRandomNonce();\n\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n try {\n // Call isNonceUsed on the wallet address because UGD code is\n // delegated to the EOA via EIP-7702\n const isUsed = await publicClient.readContract({\n abi: UGD_ABI,\n address: walletAccount.address as Hex,\n args: [nonce],\n functionName: 'isNonceUsed',\n });\n\n if (isUsed) {\n return generateRandomNonce();\n }\n } catch {\n // Contract call may fail if delegation is not yet active —\n // the nonce is still safe to use since it was randomly generated\n }\n\n return nonce;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { createApiClient, getCore } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\n\ntype GetAvailableEvmGaslessRelayerParams = {\n /** The EVM chain ID the sponsored transaction will target. */\n chainId: number;\n};\n\ntype GetAvailableEvmGaslessRelayerResult = {\n /** Relayer EOA that will broadcast the sponsored transaction on-chain. */\n relayerAddress: Hex;\n};\n\n/**\n * Fetches the relayer address to embed in the EIP-712 sponsored-transaction\n * intent for the given chain.\n *\n * The returned address is owned by the project's relay backend and is the\n * eventual `from` of the on-chain broadcast. It must be set as the `relayer`\n * field of the EIP-712 intent before signing — the on-chain delegate validates\n * the signature against this address.\n *\n * @param params.chainId - The EVM chain ID the sponsored transaction targets.\n * @param client - The Dynamic client instance.\n * @returns The relayer address to embed in the EIP-712 intent.\n * @throws {SponsorTransactionError} If the API call fails or returns no relayer address.\n * @notInstrumented\n */\nexport const getAvailableEvmGaslessRelayer = async (\n { chainId }: GetAvailableEvmGaslessRelayerParams,\n client: DynamicClient,\n): Promise<GetAvailableEvmGaslessRelayerResult> => {\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: { relayerAddress?: string };\n\n try {\n data = await apiClient.getAvailableEVMGaslessRelayer({\n chainId,\n environmentId: core.environmentId,\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n if (!data.relayerAddress) {\n throw new SponsorTransactionError();\n }\n\n return { relayerAddress: data.relayerAddress as Hex };\n};\n","type Delegation7702Registry = {\n /** Returns true if delegation is known to be active for this wallet+chain. */\n isDelegated: (params: { chainId: number; walletAddress: string }) => boolean;\n /** Marks delegation as active for this wallet+chain. */\n markDelegated: (params: {\n chainId: number;\n walletAddress: string;\n }) => void;\n};\n\n/**\n * Creates an in-memory registry that tracks which wallet+chain combinations\n * have active EIP-7702 delegation. Only active delegations are cached —\n * a missing entry means the status is unknown and should be checked via RPC.\n *\n * @notInstrumented\n */\nexport const create7702DelegationRegistry = (): Delegation7702Registry => {\n const delegated = new Map<string, true>();\n\n const buildKey = ({\n chainId,\n walletAddress,\n }: {\n chainId: number;\n walletAddress: string;\n }): string => `${walletAddress.toLowerCase()}:${chainId}`;\n\n return {\n isDelegated: (params) => delegated.has(buildKey(params)),\n markDelegated: (params) => {\n delegated.set(buildKey(params), true);\n },\n };\n};\n\nexport type { Delegation7702Registry };\n","import { createRuntimeServiceAccessKey } from '@dynamic-labs-sdk/client/core';\n\nimport { create7702DelegationRegistry } from '../create7702DelegationRegistry';\n\n/**\n * Returns the per-client EIP-7702 delegation registry, creating it on first access.\n *\n * @notInstrumented\n */\nexport const get7702DelegationRegistry = createRuntimeServiceAccessKey(\n 'evm-7702-delegation-registry',\n () => create7702DelegationRegistry()\n);\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined, getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\nimport {\n DELEGATION_CODE_PREFIX,\n DELEGATION_CONTRACT_ADDRESS,\n} from '../constants';\nimport { get7702DelegationRegistry } from '../get7702DelegationRegistry';\n\ntype Is7702DelegationActiveParams = {\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Checks whether EIP-7702 delegation to the Dynamic gasless contract is active\n * for the given wallet account on its current network.\n *\n * Results are cached per wallet+chain in an in-memory registry.\n *\n * @example\n * ```ts\n * const isDelegated = await is7702DelegationActive({ walletAccount: evmAccount });\n * if (!isDelegated) {\n * await activate7702Delegation({ walletAccount: evmAccount });\n * }\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to check delegation status for.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True if the wallet has an active delegation to the gasless contract.\n * @see activate7702Delegation\n * @see sign7702Authorization\n * @notInstrumented\n */\nexport const is7702DelegationActive = async (\n { walletAccount }: Is7702DelegationActiveParams,\n client = getDefaultClient()\n): Promise<boolean> => {\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const chainId = mapNetworkDataToViemChain(networkData).id;\n const registry = get7702DelegationRegistry(client);\n\n if (registry.isDelegated({ chainId, walletAddress: walletAccount.address })) {\n return true;\n }\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n const bytecode = await publicClient.getCode({\n address: walletAccount.address as Hex,\n });\n\n if (!bytecode) {\n return false;\n }\n\n const expectedPrefix =\n DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS.slice(2).toLowerCase();\n\n const isActive = bytecode.toLowerCase().startsWith(expectedPrefix);\n\n if (isActive) {\n registry.markDelegated({ chainId, walletAddress: walletAccount.address });\n }\n\n return isActive;\n};\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { DynamicClient } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\n\ntype ResolveChainIdParams = {\n chainId?: number;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Resolves a chain ID from either an explicit override or the wallet's active network.\n *\n * @param params.chainId - Explicit chain ID override.\n * @param params.walletAccount - The wallet account to resolve the chain from.\n * @param client - The Dynamic client instance.\n * @returns The resolved chain ID.\n * @notInstrumented\n */\nexport const resolveChainId = async (\n { chainId, walletAccount }: ResolveChainIdParams,\n client: DynamicClient\n): Promise<number> => {\n if (chainId !== undefined) {\n return chainId;\n }\n\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n return mapNetworkDataToViemChain(networkData).id;\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\nimport { signAuthorization } from 'viem/actions';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { DELEGATION_CONTRACT_ADDRESS } from '../constants';\nimport { resolveChainId } from '../resolveChainId';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\n\ntype Sign7702AuthorizationParams = {\n chainId?: number;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Signs an EIP-7702 authorization to delegate the wallet to the Dynamic\n * gasless delegation contract.\n *\n * The signed authorization can be included in a sponsored transaction to\n * activate the delegation on-chain. If no chainId is provided, the wallet's\n * active network chain ID is used.\n *\n * @example\n * ```ts\n * const authorization = await sign7702Authorization({ walletAccount: evmAccount });\n * await activate7702Delegation({ walletAccount: evmAccount, authorization });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to sign the authorization for.\n * @param [params.chainId] - Override chain ID. Defaults to the wallet's active network.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The signed EIP-7702 authorization.\n * @see activate7702Delegation\n * @see is7702DelegationActive\n * @notInstrumented\n */\nexport const sign7702Authorization = async (\n { walletAccount, chainId }: Sign7702AuthorizationParams,\n client = getDefaultClient()\n): Promise<SignAuthorizationReturnType> => {\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const resolvedChainId = await resolveChainId(\n { chainId, walletAccount },\n client\n );\n\n return signAuthorization(walletClient, {\n chainId: resolvedChainId,\n contractAddress: DELEGATION_CONTRACT_ADDRESS,\n });\n};\n","import type { getDefaultClient } from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { is7702DelegationActive } from '../is7702DelegationActive';\nimport { sign7702Authorization } from '../sign7702Authorization';\n\ntype ResolveAuthorizationParams = {\n authorization?: SignAuthorizationReturnType;\n autoDelegate: boolean;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Resolves the EIP-7702 authorization for a sponsored transaction.\n *\n * Returns the provided authorization if given, auto-signs one if needed\n * and autoDelegate is true, or returns undefined if the wallet is already\n * delegated or autoDelegate is false.\n *\n * @notInstrumented\n */\nexport const resolveAuthorization = async (\n {\n authorization,\n autoDelegate,\n walletAccount,\n }: ResolveAuthorizationParams,\n client: ReturnType<typeof getDefaultClient>\n): Promise<SignAuthorizationReturnType | undefined> => {\n // Explicit authorization always takes priority\n if (authorization) {\n return authorization;\n }\n\n // When autoDelegate is false, user manages delegation separately\n if (!autoDelegate) {\n return undefined;\n }\n\n // Auto-delegate: check if delegation is already active\n const isDelegated = await is7702DelegationActive({ walletAccount }, client);\n\n if (isDelegated) {\n return undefined;\n }\n\n return sign7702Authorization({ walletAccount }, client);\n};\n","import { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { SerializedAuthorization } from '../gasless.types';\n\n/**\n * Converts a viem SignAuthorizationReturnType into a plain serializable object\n * suitable for JSON transport to the sponsorship API.\n *\n * @notInstrumented\n */\nexport const toSerializedAuthorization = (\n auth: SignAuthorizationReturnType\n): SerializedAuthorization => {\n // viem's Signature type allows legacy v-only signatures without yParity.\n // Our signing flow should always produce yParity, but a wrong value would silently produce invalid authorizations.\n assertDefined(auth.yParity, 'Signed authorization is missing yParity');\n\n return {\n address: auth.address,\n chainId: auth.chainId,\n nonce: auth.nonce,\n r: auth.r as Hex,\n s: auth.s as Hex,\n yParity: auth.yParity,\n };\n};\n","import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\nimport {\n assertDefined,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport {\n AUTHORIZED_EXECUTIONS_TYPES,\n BATCH_CALL_OPDATA_AUTH_MODE,\n DEFAULT_VALID_FOR_SECONDS,\n DELEGATION_CONTRACT_ADDRESS,\n} from '../constants';\nimport { generateIntentNonce } from '../generateIntentNonce';\nimport { getAvailableEvmGaslessRelayer } from '../getAvailableEvmGaslessRelayer';\nimport { resolveAuthorization } from '../resolveAuthorization';\nimport { toSerializedAuthorization } from '../toSerializedAuthorization';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { mapNetworkDataToViemChain } from '../../viem/utils/mapNetworkDataToViemChain';\n\ntype SignSponsoredTransactionParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, intent nonce\n * generation is skipped entirely (no on-chain `isNonceUsed` check) and the\n * supplied value is used as-is. Matches the `nonce` field returned on the\n * signed-transaction result so callers can reuse it. Useful for\n * mutually-exclusive / cancel-replace intents: signing multiple intents with\n * the same nonce so at most one can ever land on-chain.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Signs a sponsored transaction by creating an EIP-712 intent signature.\n *\n * This function handles the complete signing flow:\n * - If an authorization is provided, it is included in the payload.\n * - If autoDelegate is true (default) and no authorization is provided,\n * checks whether delegation is active and signs a 7702 authorization if needed.\n * - If autoDelegate is false and no authorization is provided, the intent\n * is signed without any authorization (user manages delegation separately).\n *\n * @example\n * ```ts\n * const signedTx = await signSponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * const { requestId } = await relaySponsoredTransaction({ signedTransaction: signedTx });\n * ```\n *\n * @param params.walletAccount - The EVM wallet account to sign with.\n * @param params.calls - The batch of calls to execute.\n * @param [params.authorization] - Pre-signed EIP-7702 authorization. Takes priority over autoDelegate.\n * @param [params.autoDelegate] - Whether to auto-sign 7702 if not delegated. Defaults to true.\n * @param [params.nonce] - Optional bitmap nonce. When provided, nonce generation (and its on-chain check) is skipped and the supplied value is used.\n * @param [params.validForSeconds] - How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes).\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The signed sponsored transaction payload ready to be sent to the API.\n * @see sendSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const signSponsoredTransaction = async (\n {\n walletAccount,\n calls,\n authorization,\n autoDelegate = true,\n nonce: providedNonce,\n validForSeconds = DEFAULT_VALID_FOR_SECONDS,\n }: SignSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<SignedSponsoredTransaction> => {\n const { networkData } = await getActiveNetworkData(\n { walletAccount },\n client\n );\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const resolvedAuthorization = await resolveAuthorization(\n { authorization, autoDelegate, walletAccount },\n client\n );\n\n const nonce =\n providedNonce ?? (await generateIntentNonce({ walletAccount }, client));\n\n const deadline = BigInt(\n Math.floor(Date.now() / 1000) + validForSeconds\n );\n\n const chainId = mapNetworkDataToViemChain(networkData).id;\n\n const { relayerAddress } = await getAvailableEvmGaslessRelayer(\n { chainId },\n client\n );\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const signature = await walletClient.signTypedData({\n domain: {\n chainId,\n verifyingContract: DELEGATION_CONTRACT_ADDRESS,\n },\n message: {\n calls: calls.map((c) => ({\n data: c.data,\n target: c.target,\n value: c.value,\n })),\n deadline,\n mode: BATCH_CALL_OPDATA_AUTH_MODE,\n nonce,\n relayer: relayerAddress,\n },\n primaryType: 'AuthorizedExecutions',\n types: AUTHORIZED_EXECUTIONS_TYPES,\n });\n\n return {\n authorization: resolvedAuthorization\n ? toSerializedAuthorization(resolvedAuthorization)\n : undefined,\n calls,\n chainId,\n deadline: deadline.toString(),\n nonce: nonce.toString(),\n relayer: relayerAddress,\n signature: signature as Hex,\n walletAddress: walletAccount.address as Hex,\n };\n};\n","import {\n createApiClient,\n getCore,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport { DEFAULT_VALID_FOR_SECONDS } from '../constants';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { signSponsoredTransaction } from '../signSponsoredTransaction';\n\ntype RelaySponsoredTransactionWithCallsParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, nonce\n * generation (and its on-chain check) is skipped and the supplied value is\n * used as-is. Useful for mutually-exclusive / cancel-replace intents.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign and relay the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\ntype RelaySponsoredTransactionWithSignedTxParams = {\n /** A pre-signed sponsored transaction payload from signSponsoredTransaction. */\n signedTransaction: SignedSponsoredTransaction;\n};\n\ntype RelaySponsoredTransactionParams =\n | RelaySponsoredTransactionWithCallsParams\n | RelaySponsoredTransactionWithSignedTxParams;\n\nconst isSignedTransactionParams = (\n params: RelaySponsoredTransactionParams,\n): params is RelaySponsoredTransactionWithSignedTxParams =>\n 'signedTransaction' in params;\n\n/**\n * Relays a sponsored EVM transaction to the Dynamic backend.\n *\n * Accepts either a pre-signed transaction or unsigned calls. When given\n * unsigned calls, signs the transaction first via signSponsoredTransaction.\n *\n * The backend encodes the transaction, submits it to the relay provider,\n * and returns a request ID for tracking. The relay may retry the on-chain\n * submission, so the request ID (not a transaction hash) is the stable\n * identifier for the sponsored transaction.\n *\n * @example\n * ```ts\n * const { requestId } = await relaySponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * const { transactionHash } = await waitForSponsoredTransaction({ requestId });\n * ```\n *\n * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the request ID for tracking the relayed transaction.\n * @throws {SponsorTransactionError} If the API call fails or returns an unexpected response.\n * @see waitForSponsoredTransaction\n * @see signSponsoredTransaction\n * @notInstrumented\n */\nexport const relaySponsoredTransaction = async (\n params: RelaySponsoredTransactionParams,\n client = getDefaultClient(),\n): Promise<{ requestId: string }> => {\n const signedTransaction = isSignedTransactionParams(params)\n ? params.signedTransaction\n : await signSponsoredTransaction(\n {\n authorization: params.authorization,\n autoDelegate: params.autoDelegate,\n calls: params.calls,\n nonce: params.nonce,\n validForSeconds: params.validForSeconds ?? DEFAULT_VALID_FOR_SECONDS,\n walletAccount: params.walletAccount,\n },\n client,\n );\n\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: { requestId?: string };\n\n try {\n data = await apiClient.sponsorEVMTransaction({\n environmentId: core.environmentId,\n sponsorEVMTransactionRequest: {\n authorization: signedTransaction.authorization,\n calls: signedTransaction.calls.map((c) => ({\n data: c.data,\n target: c.target,\n value: c.value.toString(),\n })),\n chainId: signedTransaction.chainId,\n deadline: signedTransaction.deadline,\n nonce: signedTransaction.nonce,\n relayer: signedTransaction.relayer,\n signature: signedTransaction.signature,\n walletAddress: signedTransaction.walletAddress,\n },\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n if (!data.requestId) {\n throw new SponsorTransactionError();\n }\n\n return { requestId: data.requestId };\n};\n","import {\n createApiClient,\n getCore,\n getDefaultClient,\n} from '@dynamic-labs-sdk/client/core';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport type {\n SponsoredTransactionStatus,\n SponsoredTransactionStatusResult,\n} from '../gasless.types';\n\ntype GetEVMSponsoredTransactionStatusParams = {\n /** The request ID returned by `relaySponsoredTransaction` / `sendSponsoredTransaction`. */\n requestId: string;\n};\n\n/**\n * Fetches the current relay state for a sponsored EVM transaction.\n *\n * Returns the lifecycle status, the on-chain transaction hash (when the relay\n * has broadcast it), and any terminal-failure error message. Use this as the\n * building block for custom polling flows; for the common \"wait until done\"\n * case prefer `waitForSponsoredTransaction`.\n *\n * @example\n * ```ts\n * const status = await getEVMSponsoredTransactionStatus({ requestId });\n * if (status.transactionHash) {\n * console.log('On-chain:', status.transactionHash);\n * }\n * ```\n *\n * @param params.requestId - The request ID returned when the transaction was relayed.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The current status, optional transaction hash, and optional error message.\n * @throws {SponsorTransactionError} If the API call fails.\n * @see waitForSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const getEVMSponsoredTransactionStatus = async (\n { requestId }: GetEVMSponsoredTransactionStatusParams,\n client = getDefaultClient(),\n): Promise<SponsoredTransactionStatusResult> => {\n const core = getCore(client);\n const apiClient = createApiClient({}, client);\n\n let data: {\n errorMessage?: string;\n status: SponsoredTransactionStatus;\n transactionHash?: string;\n };\n\n try {\n data = await apiClient.getEVMSponsoredTransactionStatus({\n environmentId: core.environmentId,\n requestId,\n });\n } catch (error) {\n const cause = error instanceof Error ? error : null;\n throw new SponsorTransactionError(cause);\n }\n\n return {\n errorMessage: data.errorMessage,\n status: data.status,\n transactionHash: data.transactionHash as Hex | undefined,\n };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\n\nimport { SponsorTransactionError } from '../../errors/SponsorTransactionError';\nimport type { SponsoredTransactionStatus } from '../gasless.types';\nimport { getEVMSponsoredTransactionStatus } from '../getEVMSponsoredTransactionStatus';\n\nconst POLL_INTERVAL_MS = 2_000;\nconst TIMEOUT_MS = 60_000;\nconst MAX_POLLING_ATTEMPTS = TIMEOUT_MS / POLL_INTERVAL_MS;\n\nconst TERMINAL_FAILURE_STATUSES = new Set<SponsoredTransactionStatus>([\n 'failure',\n]);\n\ntype WaitForSponsoredTransactionParams = {\n /** The request ID returned by `relaySponsoredTransaction` / `sendSponsoredTransaction`. */\n requestId: string;\n};\n\n/**\n * Polls `getEVMSponsoredTransactionStatus` until the relay reports the\n * transaction has been included on-chain, then returns the transaction hash.\n *\n * @example\n * ```ts\n * const { requestId } = await relaySponsoredTransaction({ signedTransaction });\n * const { transactionHash } = await waitForSponsoredTransaction({ requestId });\n * ```\n *\n * @param params.requestId - The request ID returned when the transaction was relayed.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see relaySponsoredTransaction\n * @see getEVMSponsoredTransactionStatus\n * @notInstrumented\n */\nexport const waitForSponsoredTransaction = async (\n { requestId }: WaitForSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> => {\n for (let attempt = 0; attempt < MAX_POLLING_ATTEMPTS; attempt++) {\n const result = await getEVMSponsoredTransactionStatus(\n { requestId },\n client\n );\n\n if (TERMINAL_FAILURE_STATUSES.has(result.status)) {\n throw new SponsorTransactionError(null, result.errorMessage);\n }\n\n if (result.transactionHash) {\n return { transactionHash: result.transactionHash };\n }\n\n if (attempt < MAX_POLLING_ATTEMPTS - 1) {\n await new Promise<void>((resolve) =>\n setTimeout(resolve, POLL_INTERVAL_MS)\n );\n }\n }\n\n throw new SponsorTransactionError(\n null,\n `Timed out waiting for sponsored transaction ${requestId}`\n );\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { Hex } from 'viem';\nimport type { SignAuthorizationReturnType } from 'viem/accounts';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport type {\n SignedSponsoredTransaction,\n SponsoredTransactionCall,\n} from '../gasless.types';\nimport { relaySponsoredTransaction } from '../relaySponsoredTransaction';\nimport { waitForSponsoredTransaction } from '../waitForSponsoredTransaction';\n\ntype SendSponsoredTransactionWithCallsParams = {\n /** Pre-signed EIP-7702 authorization. Takes priority over autoDelegate. */\n authorization?: SignAuthorizationReturnType;\n /** Whether to automatically sign 7702 authorization if not delegated. Defaults to true. */\n autoDelegate?: boolean;\n /** The batch of calls to execute. */\n calls: SponsoredTransactionCall[];\n /**\n * Optional bitmap nonce to sign the intent with. When provided, nonce\n * generation (and its on-chain check) is skipped and the supplied value is\n * used as-is. Useful for mutually-exclusive / cancel-replace intents.\n */\n nonce?: bigint;\n /** How long the signed intent remains valid, in seconds. Defaults to 600 (10 minutes). */\n validForSeconds?: number;\n /** The EVM wallet account to sign and send the transaction for. */\n walletAccount: EvmWalletAccount;\n};\n\ntype SendSponsoredTransactionWithSignedTxParams = {\n /** A pre-signed sponsored transaction payload from signSponsoredTransaction. */\n signedTransaction: SignedSponsoredTransaction;\n};\n\ntype SendSponsoredTransactionParams =\n | SendSponsoredTransactionWithCallsParams\n | SendSponsoredTransactionWithSignedTxParams;\n\n/**\n * Sends a sponsored EVM transaction and waits for on-chain inclusion.\n *\n * Accepts either a pre-signed transaction or unsigned calls. When given\n * unsigned calls, signs the transaction first via signSponsoredTransaction.\n * Relays the transaction and resolves as soon as the relay reports the\n * transaction has been included on-chain.\n *\n * @example\n * ```ts\n * const { transactionHash } = await sendSponsoredTransaction({\n * walletAccount: evmAccount,\n * calls: [{ target: '0x...', data: '0x...', value: 0n }],\n * });\n * ```\n *\n * @param params - Either { signedTransaction } or { walletAccount, calls, ... }.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the on-chain transaction hash.\n * @throws {SponsorTransactionError} If the relay returns a terminal failure or polling times out.\n * @see signSponsoredTransaction\n * @see relaySponsoredTransaction\n * @notInstrumented\n */\nexport const sendSponsoredTransaction = async (\n params: SendSponsoredTransactionParams,\n client = getDefaultClient()\n): Promise<{ transactionHash: Hex }> => {\n const { requestId } = await relaySponsoredTransaction(params, client);\n return waitForSponsoredTransaction({ requestId }, client);\n};\n","import { BaseError, type BaseErrorParameters } from '@dynamic-labs-sdk/client';\n\nexport type RpcErrorParameters = Pick<BaseErrorParameters, 'shortMessage'> &\n Partial<Omit<BaseErrorParameters, 'shortMessage'>>;\n\nexport class RpcError extends BaseError {\n constructor(args: RpcErrorParameters) {\n super({\n cause: args.cause ?? null,\n code: args.code ?? 'rpc_error',\n details: args.details,\n docsUrl: args.docsUrl ?? null,\n metaMessages: args.metaMessages,\n name: args.name ?? 'RpcError',\n shortMessage: args.shortMessage,\n });\n }\n}\n","import type { DynamicClient, NetworkData } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\nimport { RpcError } from '../../errors/RpcError';\n\ntype FetchEvmBalanceParams = {\n address: string;\n networkData: NetworkData;\n};\n\n/** @notInstrumented */\nexport const fetchEvmBalance = async (\n { address, networkData }: FetchEvmBalanceParams,\n client: DynamicClient\n): Promise<string | null> => {\n const rpcUrl = networkData.rpcUrls.http[0];\n const core = getCore(client);\n\n try {\n // Perform a POST request to the RPC URL with the JSON-RPC payload\n const response = await core.fetch(rpcUrl, {\n /**\n * The JSON-RPC method 'eth_getBalance' takes the address and a block tag ('latest' is the most recent)\n * See EIP-1474: https://eips.ethereum.org/EIPS/eip-1474\n * See eth_getBalance spec: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance\n */\n body: JSON.stringify({\n id: Math.floor(Date.now() + Math.random() * 1000),\n jsonrpc: '2.0',\n method: 'eth_getBalance',\n params: [address, 'latest'],\n }),\n\n headers: {\n 'Content-Type': 'application/json',\n },\n\n method: 'POST',\n });\n\n // Check if the network response was successful\n if (!response.ok) {\n throw new RpcError({\n code: 'http_error',\n shortMessage: `HTTP error! status: ${response.status}`,\n });\n }\n\n const data = await response.json();\n\n // Check for a JSON-RPC error in the response\n if (data.error) {\n throw new RpcError({\n cause: data.error instanceof Error ? data.error : undefined,\n code: 'json_rpc_error',\n shortMessage: `RPC Error: ${data.error.message}`,\n });\n }\n\n // The result is a hexadecimal string representing the balance in Wei\n const balanceWeiHex = data.result;\n\n // Convert the hexadecimal string to a BigInt\n const balanceWei = BigInt(balanceWeiHex);\n\n // Convert the balance from Wei to Ether (1 Ether = 10^18 Wei)\n // We use a BigInt for the conversion to maintain precision with large numbers\n const oneEther = BigInt(1e18);\n\n // Perform the division and return the result as a number\n // Note: This conversion can lose precision for very small amounts, but is generally fine for display purposes.\n const balanceEther = Number(balanceWei) / Number(oneEther);\n\n return balanceEther.toString();\n } catch (error) {\n if (error instanceof Error) {\n throw new RpcError({\n cause: error,\n code: 'rpc_error',\n shortMessage: `Failed to fetch balance for address ${address}`,\n });\n }\n\n throw error;\n }\n};\n","import type { DynamicClient, NetworkData } from '@dynamic-labs-sdk/client';\nimport { createBaseNetworkProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { EvmNetworkProvider } from '../../EvmNetworkProvider';\nimport { fetchEvmBalance } from '../fetchEvmBalance';\n\n/** @notInstrumented */\nexport const createEvmNetworkProvider = (\n networkData: NetworkData,\n client: DynamicClient\n): EvmNetworkProvider => ({\n ...createBaseNetworkProvider('EVM', networkData),\n\n getBalance: async ({ address }) => ({\n balance: await fetchEvmBalance(\n {\n address,\n networkData,\n },\n client\n ),\n }),\n});\n","import { type DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworkProviderBuilderRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { createEvmNetworkProvider } from '../utils/createEvmNetworkProvider';\n\n/** @notInstrumented */\nexport const registerEvmNetworkProviderBuilder = (\n client: DynamicClient\n): void => {\n const networkProviderBuilderRegistry =\n getNetworkProviderBuilderRegistry(client);\n\n /**\n * If the Ethereum network provider builder is already registered, return.\n */\n if (networkProviderBuilderRegistry.get().get('EVM')) {\n return;\n }\n\n networkProviderBuilderRegistry.register({\n builder: (networkData) => createEvmNetworkProvider(networkData, client),\n chain: 'EVM',\n });\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\n\n/**\n * Type guard function to check if a wallet account is an EVM wallet account.\n *\n * @example\n * ```ts\n * const accounts = getWalletAccounts();\n * const evmAccounts = accounts.filter(isEvmWalletAccount);\n * ```\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an EVM wallet account, false otherwise.\n * @see isEvmNetworkProvider\n * @see addEvmExtension\n * @notInstrumented\n */\nexport const isEvmWalletAccount = (\n walletAccount: WalletAccount\n): walletAccount is EvmWalletAccount => walletAccount.chain === 'EVM';\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport type { ConfirmTransactionParams } from '@dynamic-labs-sdk/client/core';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\n/**\n * Waits for an EVM transaction to be confirmed on-chain.\n *\n * @param params.transactionHash - The transaction hash to wait for.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param client - The Dynamic client instance.\n * @notInstrumented\n */\nexport const evmConfirmTransaction = async (\n { transactionHash, walletAccount }: ConfirmTransactionParams,\n client: DynamicClient\n): Promise<void> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n await publicClient.waitForTransactionReceipt({\n hash: transactionHash as `0x${string}`,\n });\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\n/**\n * Checks if EVM gas sponsorship is enabled for the current project.\n *\n * @example\n * ```ts\n * if (isEvmGasSponsorshipEnabled()) {\n * await sendSponsoredTransaction({ walletAccount, calls });\n * }\n * ```\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True if EVM gas sponsorship is enabled, false otherwise.\n * @see sendSponsoredTransaction\n * @see activate7702Delegation\n * @notInstrumented\n */\nexport const isEvmGasSponsorshipEnabled = (\n client = getDefaultClient()\n): boolean => {\n assertDefined(client.projectSettings, 'Project settings are not defined');\n\n return (\n client.projectSettings.sdk.embeddedWallets?.evmGasSponsorshipEnabled ??\n false\n );\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { encodeFunctionData, erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\n\ntype ApproveErc20Params = {\n amount: bigint;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Sends an ERC-20 `approve` transaction, granting a spender an allowance\n * to transfer tokens on behalf of the wallet account.\n *\n * Encodes the `approve(spender, amount)` call using viem's `encodeFunctionData`\n * and sends it through the wallet account's viem wallet client.\n *\n * @param params.amount - The amount to approve in the token's smallest unit.\n * @param params.spenderAddress - The address being granted the allowance.\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.walletAccount - The EVM wallet account sending the approval.\n * @param client - The Dynamic client instance.\n * @returns The approval transaction hash.\n * @notInstrumented\n */\nexport const approveErc20 = async (\n { amount, spenderAddress, tokenAddress, walletAccount }: ApproveErc20Params,\n client: DynamicClient\n): Promise<{ transactionHash: string }> => {\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n const data = encodeFunctionData({\n abi: erc20Abi,\n args: [spenderAddress as `0x${string}`, amount],\n functionName: 'approve',\n });\n\n const hash = await walletClient.sendTransaction({\n data,\n to: tokenAddress as `0x${string}`,\n });\n\n return { transactionHash: hash };\n};\n","import {\n type DynamicClient,\n type NetworkData,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport { erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\n\ntype GetErc20AllowanceParams = {\n networkData?: NetworkData;\n ownerAddress: string;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Reads the current ERC-20 token allowance granted by an owner to a spender.\n *\n * Uses a viem public client derived from the wallet account's active network\n * to call the `allowance(owner, spender)` method on the token contract.\n *\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.ownerAddress - The address that granted the allowance.\n * @param params.spenderAddress - The address allowed to spend the tokens.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param [params.networkData] - The network data to use for the public client. If not provided, the active network data will be used.\n * @param client - The Dynamic client instance.\n * @returns The current allowance as a bigint in the token's smallest unit.\n * @notInstrumented\n */\nexport const getErc20Allowance = async (\n {\n networkData,\n ownerAddress,\n spenderAddress,\n tokenAddress,\n walletAccount,\n }: GetErc20AllowanceParams,\n client: DynamicClient\n): Promise<bigint> => {\n if (!networkData) {\n const activeNetworkData = await getActiveNetworkData(\n { walletAccount },\n client\n );\n networkData = activeNetworkData.networkData;\n }\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n return publicClient.readContract({\n abi: erc20Abi,\n address: tokenAddress as `0x${string}`,\n args: [ownerAddress as `0x${string}`, spenderAddress as `0x${string}`],\n functionName: 'allowance',\n });\n};\n","import {\n type DynamicClient,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { TransactionReceipt } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { approveErc20 } from '../approveErc20';\nimport { getErc20Allowance } from '../getErc20Allowance';\n\ntype ApproveErc20IfRequiredAndWaitReceiptParams = {\n amount: string;\n spenderAddress: string;\n tokenAddress: string;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Approves an ERC-20 token if the current allowance is insufficient and waits for the transaction receipt.\n *\n * @param params.amount - The amount of tokens to approve.\n * @param params.ownerAddress - The address that granted the allowance.\n * @param params.spenderAddress - The address allowed to spend the tokens.\n * @param params.tokenAddress - The ERC-20 token contract address.\n * @param params.walletAccount - The EVM wallet account used to resolve the active network.\n * @param client - The Dynamic client instance.\n * @returns The transaction receipt if an approval was sent, otherwise undefined.\n * @notInstrumented\n */\nexport const approveErc20IfRequiredAndWaitReceipt = async (\n {\n amount,\n spenderAddress,\n tokenAddress,\n walletAccount,\n }: ApproveErc20IfRequiredAndWaitReceiptParams,\n client: DynamicClient\n): Promise<{ receipt: TransactionReceipt } | undefined> => {\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const currentAllowance = await getErc20Allowance(\n {\n networkData,\n ownerAddress: walletAccount.address,\n spenderAddress,\n tokenAddress,\n walletAccount,\n },\n client\n );\n\n const approvalAmount = BigInt(amount);\n\n if (currentAllowance >= approvalAmount) {\n return undefined;\n }\n\n const result = await approveErc20(\n {\n amount: approvalAmount,\n spenderAddress,\n tokenAddress,\n walletAccount,\n },\n client\n );\n const approvalTransactionHash = result.transactionHash;\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: approvalTransactionHash as `0x${string}`,\n });\n\n return { receipt };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n} from '@dynamic-labs-sdk/client';\nimport type { ExecuteSwapTransactionResult } from '@dynamic-labs-sdk/client/core';\nimport type { SwapSigningPayload } from '@dynamic-labs/sdk-api-core';\nimport { type Hex, encodeFunctionData, erc20Abi } from 'viem';\n\nimport type { EvmWalletAccount } from '../../EvmWalletAccount.types';\nimport type { SponsoredTransactionCall } from '../../gasless/gasless.types';\nimport { sendSponsoredTransaction } from '../../gasless/sendSponsoredTransaction';\nimport { getErc20Allowance } from '../getErc20Allowance';\n\ntype EvmExecuteSponsoredSwapTransactionParams = {\n onStepChange?: (step: 'approval' | 'transaction') => void;\n signingPayload: SwapSigningPayload;\n walletAccount: EvmWalletAccount;\n};\n\n/**\n * Executes an EVM swap as a single gas-sponsored transaction.\n *\n * Unlike the user-paid path, the optional ERC-20 approval and the swap call\n * are batched into one sponsored transaction (EVM gas sponsorship supports\n * call batching), so there is no separate approval transaction hash.\n *\n * 1. If the signing payload includes an `evmApproval`, reads the current\n * allowance and prepends an `approve` call only when it is insufficient\n * 2. Appends the main swap call (gas fields are dropped — the relayer pays gas)\n * 3. Relays the batch via `sendSponsoredTransaction` and waits for inclusion\n *\n * @param params.signingPayload - The signing payload containing `evmTransaction` and optional `evmApproval`.\n * @param params.walletAccount - The embedded EVM wallet account whose gas is sponsored.\n * @param params.onStepChange - Optional callback invoked with `'approval'` or `'transaction'` as each step begins.\n * @param client - The Dynamic client instance.\n * @returns The on-chain transaction hash of the sponsored swap.\n * @notInstrumented\n */\nexport const evmExecuteSponsoredSwapTransaction = async (\n {\n onStepChange,\n signingPayload,\n walletAccount,\n }: EvmExecuteSponsoredSwapTransactionParams,\n client: DynamicClient\n): Promise<ExecuteSwapTransactionResult> => {\n const { evmTransaction, evmApproval } = signingPayload;\n\n if (!evmTransaction) {\n throw new InvalidParamError(\n 'Signing payload is missing EVM transaction data'\n );\n }\n\n const calls: SponsoredTransactionCall[] = [];\n\n if (evmApproval) {\n const approvalAmount = BigInt(evmApproval.amount);\n\n const currentAllowance = await getErc20Allowance(\n {\n ownerAddress: walletAccount.address,\n spenderAddress: evmApproval.spenderAddress,\n tokenAddress: evmApproval.tokenAddress,\n walletAccount,\n },\n client\n );\n\n // Only batch an approval call when the existing allowance is insufficient,\n // matching the user-paid path's allowance check.\n if (currentAllowance < approvalAmount) {\n onStepChange?.('approval');\n\n calls.push({\n data: encodeFunctionData({\n abi: erc20Abi,\n args: [evmApproval.spenderAddress as Hex, approvalAmount],\n functionName: 'approve',\n }),\n target: evmApproval.tokenAddress as Hex,\n value: 0n,\n });\n }\n }\n\n onStepChange?.('transaction');\n\n // Gas fields from the quote are intentionally omitted — the relayer funds gas.\n calls.push({\n data: evmTransaction.data as Hex,\n target: evmTransaction.to as Hex,\n value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n,\n });\n\n const { transactionHash } = await sendSponsoredTransaction(\n { calls, walletAccount },\n client\n );\n\n return { transactionHash };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n} from '@dynamic-labs-sdk/client';\nimport {\n type ExecuteSwapTransactionParams,\n type ExecuteSwapTransactionResult,\n getWalletProviderFromWalletAccount,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { isEvmGasSponsorshipEnabled } from '../../gasless/isEvmGasSponsorshipEnabled';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { isEvmWalletProviderWithCustomViemClient } from '../../viem/utils/walletProviderHasCustomWalletClient';\nimport { approveErc20IfRequiredAndWaitReceipt } from '../approveErc20IfRequiredAndWaitReceipt';\nimport { evmExecuteSponsoredSwapTransaction } from '../evmExecuteSponsoredSwapTransaction';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\n/**\n * Executes an EVM checkout transaction by handling optional ERC-20 approval\n * and sending the main swap transaction on-chain.\n *\n * 1. Validates that the wallet account is an EVM wallet account\n * 2. When EVM gas sponsorship is enabled and the wallet is a Dynamic embedded\n * wallet (and `sponsorshipMode` is not `'off'`), routes the swap through the\n * gas-sponsored path, batching any required approval with the swap call\n * 3. Otherwise, if the signing payload includes an `evmApproval`, checks the\n * current ERC-20 allowance and sends an approve transaction when insufficient\n * 4. Sends the main transaction using the viem wallet client\n *\n * @param params.signingPayload - The chain-aware signing payload containing `evmTransaction` and optional `evmApproval`.\n * @param params.walletAccount - The wallet account used to sign and send transactions.\n * @param params.onStepChange - Optional callback invoked with `'approval'` or `'transaction'` as each step begins.\n * @param params.sponsorshipMode - `'auto'` (default) sponsors when eligible; `'off'` never sponsors.\n * @param client - The Dynamic client instance.\n * @returns The main transaction hash and, if a separate approval was sent, the approval transaction hash.\n * @notInstrumented\n */\nexport const evmExecuteSwapTransaction = async (\n {\n onStepChange,\n signingPayload,\n sponsorshipMode = 'auto',\n walletAccount,\n }: ExecuteSwapTransactionParams,\n client: DynamicClient\n): Promise<ExecuteSwapTransactionResult> => {\n if (!isEvmWalletAccount(walletAccount)) {\n throw new InvalidParamError('Wallet account is not an EVM wallet account');\n }\n\n const walletProvider = getWalletProviderFromWalletAccount(\n { walletAccount },\n client\n );\n\n // Sponsorship requires an embedded wallet (custom viem client) so the\n // EIP-7702 authorization can be signed; external wallets fall through to the\n // user-paid path below.\n if (\n sponsorshipMode === 'auto' &&\n isEvmGasSponsorshipEnabled(client) &&\n isEvmWalletProviderWithCustomViemClient(walletProvider)\n ) {\n return evmExecuteSponsoredSwapTransaction(\n { onStepChange, signingPayload, walletAccount },\n client\n );\n }\n\n const { evmTransaction, evmApproval } = signingPayload;\n\n if (!evmTransaction) {\n throw new InvalidParamError(\n 'Signing payload is missing EVM transaction data'\n );\n }\n\n if (evmApproval) {\n onStepChange?.('approval');\n\n await approveErc20IfRequiredAndWaitReceipt(\n {\n amount: evmApproval.amount,\n spenderAddress: evmApproval.spenderAddress,\n tokenAddress: evmApproval.tokenAddress,\n walletAccount,\n },\n client\n );\n }\n\n onStepChange?.('transaction');\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n // sendTransaction expects gasPrice or maxFeePerGas and maxPriorityFeePerGas\n let gasParams: Record<string, bigint> = {};\n if (evmTransaction.maxFeePerGas && evmTransaction.maxPriorityFeePerGas) {\n gasParams = {\n maxFeePerGas: BigInt(evmTransaction.maxFeePerGas),\n maxPriorityFeePerGas: BigInt(evmTransaction.maxPriorityFeePerGas),\n };\n } else {\n gasParams = {\n ...(evmTransaction.gasPrice && {\n gasPrice: BigInt(evmTransaction.gasPrice),\n }),\n };\n }\n\n const transactionHash = await walletClient.sendTransaction({\n data: evmTransaction.data as `0x${string}`,\n to: evmTransaction.to as `0x${string}`,\n value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n,\n ...(evmTransaction.gasLimit && { gas: BigInt(evmTransaction.gasLimit) }),\n ...gasParams,\n ...(evmTransaction.nonce && { nonce: evmTransaction.nonce }),\n });\n\n return { transactionHash };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\nimport type { TransferAmountParams } from '@dynamic-labs-sdk/client/core';\nimport { encodeFunctionData, erc20Abi, parseEther, parseUnits } from 'viem';\n\nimport { createPublicClientFromNetworkData } from '../../viem/createPublicClientFromNetworkData';\nimport { createWalletClientForWalletAccount } from '../../viem/createWalletClientForWalletAccount';\nimport { isEvmWalletAccount } from '../isEvmWalletAccount';\n\nconst DEFAULT_DECIMALS = 18;\n\n/** @notInstrumented */\nexport const evmTransferAmount = 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 const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const publicClient = createPublicClientFromNetworkData({ networkData });\n const nonce = await publicClient.getTransactionCount({\n address: walletAccount.address as `0x${string}`,\n });\n\n const walletClient = await createWalletClientForWalletAccount(\n { walletAccount },\n client\n );\n\n // non-native token transfers\n if (token) {\n const decimals = token.decimals ?? DEFAULT_DECIMALS;\n\n const data = encodeFunctionData({\n abi: erc20Abi,\n args: [recipient as `0x${string}`, parseUnits(amount, decimals)],\n functionName: 'transfer',\n });\n\n const hash = await walletClient.sendTransaction({\n data,\n nonce,\n to: token.address as `0x${string}`,\n });\n\n return { transactionHash: hash };\n }\n\n // native token transfers\n const hash = await walletClient.sendTransaction({\n nonce,\n to: recipient as `0x${string}`,\n value: parseEther(amount),\n });\n\n return { transactionHash: hash };\n};\n"],"mappings":";;;;;;;;AAEA,IAAa,0BAAb,cAA6CA,mCAAU;CAErD,YAAY,OAAsB,SAAkB;AAClD,QAAM;GACJ,OAAO,SAAS;GAChB,MAAM;GACN;GACA,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;;;;;;;ACTN,MAAaC,8BACX;;AAGF,MAAa,4BAA4B;;AAGzC,MAAa,yBAAyB;;AAGtC,MAAaC,8BACX;;AAGF,MAAa,8BAA8B;CACzC,sBAAsB;EACpB;GAAE,MAAM;GAAS,MAAM;GAAe;EACtC;GAAE,MAAM;GAAY,MAAM;GAAW;EACrC;GAAE,MAAM;GAAQ,MAAM;GAAW;EACjC;GAAE,MAAM;GAAS,MAAM;GAAW;EAClC;GAAE,MAAM;GAAW,MAAM;GAAW;EACrC;CACD,WAAW;EACT;GAAE,MAAM;GAAU,MAAM;GAAW;EACnC;GAAE,MAAM;GAAS,MAAM;GAAW;EAClC;GAAE,MAAM;GAAQ,MAAM;GAAS;EAChC;CACF;;AAGD,MAAa,UAAU,CACrB;CACE,QAAQ,CAAC;EAAE,MAAM;EAAS,MAAM;EAAW,CAAC;CAC5C,MAAM;CACN,SAAS,CAAC;EAAE,MAAM;EAAI,MAAM;EAAQ,CAAC;CACrC,iBAAiB;CACjB,MAAM;CACP,CACF;;;;;;;;;;ACnCD,MAAa,4BAAoC;CAC/C,MAAM,QAAQ,IAAI,WAAW,GAAG;AAChC,QAAO,gBAAgB,MAAM;AAE7B,QAAO,MAAM,QAAQ,KAAK,SAAU,OAAO,KAAM,OAAO,KAAK,EAAE,GAAG;;;;;;;;;;;;;;;;;ACgBpE,MAAa,sBAAsB,OACjC,EAAE,iBACF,WACoB;CACpB,MAAM,QAAQ,qBAAqB;CAEnC,MAAM,EAAE,gBAAgB,yDACtB,EAAE,eAAe,EACjB,OACD;AAED,kDACE,aACA,4CAA4C,cAAc,UAC3D;CAED,MAAM,eAAeC,6EAAkC,EAAE,aAAa,CAAC;AAEvE,KAAI;AAUF,MAPe,MAAM,aAAa,aAAa;GAC7C,KAAK;GACL,SAAS,cAAc;GACvB,MAAM,CAAC,MAAM;GACb,cAAc;GACf,CAAC,CAGA,QAAO,qBAAqB;SAExB;AAKR,QAAO;;;;;;;;;;;;;;;;;;;;AC/BT,MAAa,gCAAgC,OAC3C,EAAE,WACF,WACiD;CACjD,MAAM,kDAAe,OAAO;CAC5B,MAAM,+DAA4B,EAAE,EAAE,OAAO;CAE7C,IAAIC;AAEJ,KAAI;AACF,SAAO,MAAM,UAAU,8BAA8B;GACnD;GACA,eAAe,KAAK;GACrB,CAAC;UACK,OAAO;AAEd,QAAM,IAAI,wBADI,iBAAiB,QAAQ,QAAQ,KACP;;AAG1C,KAAI,CAAC,KAAK,eACR,OAAM,IAAI,yBAAyB;AAGrC,QAAO,EAAE,gBAAgB,KAAK,gBAAuB;;;;;;;;;;;;ACrCvD,MAAa,qCAA6D;CACxE,MAAM,4BAAY,IAAI,KAAmB;CAEzC,MAAM,YAAY,EAChB,SACA,oBAIY,GAAG,cAAc,aAAa,CAAC,GAAG;AAEhD,QAAO;EACL,cAAc,WAAW,UAAU,IAAI,SAAS,OAAO,CAAC;EACxD,gBAAgB,WAAW;AACzB,aAAU,IAAI,SAAS,OAAO,EAAE,KAAK;;EAExC;;;;;;;;;;ACxBH,MAAa,6FACX,sCACM,8BAA8B,CACrC;;;;;;;;;;;;;;;;;;;;;;;;;AC0BD,MAAa,yBAAyB,OACpC,EAAE,iBACF,8DAA2B,KACN;CACrB,MAAM,EAAE,gBAAgB,yDAA2B,EAAE,eAAe,EAAE,OAAO;AAE7E,kDACE,aACA,4CAA4C,cAAc,UAC3D;CAED,MAAM,UAAUC,4DAA0B,YAAY,CAAC;CACvD,MAAM,WAAW,0BAA0B,OAAO;AAElD,KAAI,SAAS,YAAY;EAAE;EAAS,eAAe,cAAc;EAAS,CAAC,CACzE,QAAO;CAKT,MAAM,WAAW,MAFIC,6EAAkC,EAAE,aAAa,CAAC,CAEnC,QAAQ,EAC1C,SAAS,cAAc,SACxB,CAAC;AAEF,KAAI,CAAC,SACH,QAAO;CAGT,MAAM,iBACJ,yBAAyB,4BAA4B,MAAM,EAAE,CAAC,aAAa;CAE7E,MAAM,WAAW,SAAS,aAAa,CAAC,WAAW,eAAe;AAElE,KAAI,SACF,UAAS,cAAc;EAAE;EAAS,eAAe,cAAc;EAAS,CAAC;AAG3E,QAAO;;;;;;;;;;;;;;ACtDT,MAAa,iBAAiB,OAC5B,EAAE,SAAS,iBACX,WACoB;AACpB,KAAI,YAAY,OACd,QAAO;CAGT,MAAM,EAAE,gBAAgB,yDACtB,EAAE,eAAe,EACjB,OACD;AAED,kDACE,aACA,4CAA4C,cAAc,UAC3D;AAED,QAAOC,4DAA0B,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;ACHhD,MAAa,wBAAwB,OACnC,EAAE,eAAe,WACjB,8DAA2B,KACc;AAWzC,4CAVqB,MAAMC,8EACzB,EAAE,eAAe,EACjB,OACD,EAOsC;EACrC,SANsB,MAAM,eAC5B;GAAE;GAAS;GAAe,EAC1B,OACD;EAIC,iBAAiB;EAClB,CAAC;;;;;;;;;;;;;;AC/BJ,MAAa,uBAAuB,OAClC,EACE,eACA,cACA,iBAEF,WACqD;AAErD,KAAI,cACF,QAAO;AAIT,KAAI,CAAC,aACH;AAMF,KAFoB,MAAM,uBAAuB,EAAE,eAAe,EAAE,OAAO,CAGzE;AAGF,QAAO,sBAAsB,EAAE,eAAe,EAAE,OAAO;;;;;;;;;;;ACnCzD,MAAa,6BACX,SAC4B;AAG5B,kDAAc,KAAK,SAAS,0CAA0C;AAEtE,QAAO;EACL,SAAS,KAAK;EACd,SAAS,KAAK;EACd,OAAO,KAAK;EACZ,GAAG,KAAK;EACR,GAAG,KAAK;EACR,SAAS,KAAK;EACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACqDH,MAAa,2BAA2B,OACtC,EACE,eACA,OACA,eACA,eAAe,MACf,OAAO,eACP,kBAAkB,6BAEpB,8DAA2B,KACa;CACxC,MAAM,EAAE,gBAAgB,yDACtB,EAAE,eAAe,EACjB,OACD;AAED,kDACE,aACA,4CAA4C,cAAc,UAC3D;CAED,MAAM,wBAAwB,MAAM,qBAClC;EAAE;EAAe;EAAc;EAAe,EAC9C,OACD;CAED,MAAM,QACJ,iBAAkB,MAAM,oBAAoB,EAAE,eAAe,EAAE,OAAO;CAExE,MAAM,WAAW,OACf,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK,GAAG,gBACjC;CAED,MAAM,UAAUC,4DAA0B,YAAY,CAAC;CAEvD,MAAM,EAAE,mBAAmB,MAAM,8BAC/B,EAAE,SAAS,EACX,OACD;CAOD,MAAM,YAAY,OALG,MAAMC,8EACzB,EAAE,eAAe,EACjB,OACD,EAEoC,cAAc;EACjD,QAAQ;GACN;GACA,mBAAmB;GACpB;EACD,SAAS;GACP,OAAO,MAAM,KAAK,OAAO;IACvB,MAAM,EAAE;IACR,QAAQ,EAAE;IACV,OAAO,EAAE;IACV,EAAE;GACH;GACA,MAAM;GACN;GACA,SAAS;GACV;EACD,aAAa;EACb,OAAO;EACR,CAAC;AAEF,QAAO;EACL,eAAe,wBACX,0BAA0B,sBAAsB,GAChD;EACJ;EACA;EACA,UAAU,SAAS,UAAU;EAC7B,OAAO,MAAM,UAAU;EACvB,SAAS;EACE;EACX,eAAe,cAAc;EAC9B;;;;;AC/GH,MAAM,6BACJ,WAEA,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BzB,MAAa,4BAA4B,OACvC,QACA,8DAA2B,KACQ;CACnC,MAAM,oBAAoB,0BAA0B,OAAO,GACvD,OAAO,oBACP,MAAM,yBACJ;EACE,eAAe,OAAO;EACtB,cAAc,OAAO;EACrB,OAAO,OAAO;EACd,OAAO,OAAO;EACd,iBAAiB,OAAO,mBAAmB;EAC3C,eAAe,OAAO;EACvB,EACD,OACD;CAEL,MAAM,kDAAe,OAAO;CAC5B,MAAM,+DAA4B,EAAE,EAAE,OAAO;CAE7C,IAAIC;AAEJ,KAAI;AACF,SAAO,MAAM,UAAU,sBAAsB;GAC3C,eAAe,KAAK;GACpB,8BAA8B;IAC5B,eAAe,kBAAkB;IACjC,OAAO,kBAAkB,MAAM,KAAK,OAAO;KACzC,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,OAAO,EAAE,MAAM,UAAU;KAC1B,EAAE;IACH,SAAS,kBAAkB;IAC3B,UAAU,kBAAkB;IAC5B,OAAO,kBAAkB;IACzB,SAAS,kBAAkB;IAC3B,WAAW,kBAAkB;IAC7B,eAAe,kBAAkB;IAClC;GACF,CAAC;UACK,OAAO;AAEd,QAAM,IAAI,wBADI,iBAAiB,QAAQ,QAAQ,KACP;;AAG1C,KAAI,CAAC,KAAK,UACR,OAAM,IAAI,yBAAyB;AAGrC,QAAO,EAAE,WAAW,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrFtC,MAAa,mCAAmC,OAC9C,EAAE,aACF,8DAA2B,KACmB;CAC9C,MAAM,kDAAe,OAAO;CAC5B,MAAM,+DAA4B,EAAE,EAAE,OAAO;CAE7C,IAAIC;AAMJ,KAAI;AACF,SAAO,MAAM,UAAU,iCAAiC;GACtD,eAAe,KAAK;GACpB;GACD,CAAC;UACK,OAAO;AAEd,QAAM,IAAI,wBADI,iBAAiB,QAAQ,QAAQ,KACP;;AAG1C,QAAO;EACL,cAAc,KAAK;EACnB,QAAQ,KAAK;EACb,iBAAiB,KAAK;EACvB;;;;;AC9DH,MAAM,mBAAmB;AAEzB,MAAM,uBADa,MACuB;AAE1C,MAAM,4BAA4B,IAAI,IAAgC,CACpE,UACD,CAAC;;;;;;;;;;;;;;;;;;;AAyBF,MAAa,8BAA8B,OACzC,EAAE,aACF,yDAA2B,KACW;AACtC,MAAK,IAAI,UAAU,GAAG,UAAU,sBAAsB,WAAW;EAC/D,MAAM,SAAS,MAAM,iCACnB,EAAE,WAAW,EACb,OACD;AAED,MAAI,0BAA0B,IAAI,OAAO,OAAO,CAC9C,OAAM,IAAI,wBAAwB,MAAM,OAAO,aAAa;AAG9D,MAAI,OAAO,gBACT,QAAO,EAAE,iBAAiB,OAAO,iBAAiB;AAGpD,MAAI,UAAU,uBAAuB,EACnC,OAAM,IAAI,SAAe,YACvB,WAAW,SAAS,iBAAiB,CACtC;;AAIL,OAAM,IAAI,wBACR,MACA,+CAA+C,YAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFH,MAAa,2BAA2B,OACtC,QACA,yDAA2B,KACW;CACtC,MAAM,EAAE,cAAc,MAAM,0BAA0B,QAAQ,OAAO;AACrE,QAAO,4BAA4B,EAAE,WAAW,EAAE,OAAO;;;;;AChE3D,IAAa,WAAb,cAA8BC,mCAAU;CACtC,YAAY,MAA0B;AACpC,QAAM;GACJ,OAAO,KAAK,SAAS;GACrB,MAAM,KAAK,QAAQ;GACnB,SAAS,KAAK;GACd,SAAS,KAAK,WAAW;GACzB,cAAc,KAAK;GACnB,MAAM,KAAK,QAAQ;GACnB,cAAc,KAAK;GACpB,CAAC;;;;;;;ACJN,MAAa,kBAAkB,OAC7B,EAAE,SAAS,eACX,WAC2B;CAC3B,MAAM,SAAS,YAAY,QAAQ,KAAK;CACxC,MAAM,kDAAe,OAAO;AAE5B,KAAI;EAEF,MAAM,WAAW,MAAM,KAAK,MAAM,QAAQ;GAMxC,MAAM,KAAK,UAAU;IACnB,IAAI,KAAK,MAAM,KAAK,KAAK,GAAG,KAAK,QAAQ,GAAG,IAAK;IACjD,SAAS;IACT,QAAQ;IACR,QAAQ,CAAC,SAAS,SAAS;IAC5B,CAAC;GAEF,SAAS,EACP,gBAAgB,oBACjB;GAED,QAAQ;GACT,CAAC;AAGF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,SAAS;GACjB,MAAM;GACN,cAAc,uBAAuB,SAAS;GAC/C,CAAC;EAGJ,MAAM,OAAO,MAAM,SAAS,MAAM;AAGlC,MAAI,KAAK,MACP,OAAM,IAAI,SAAS;GACjB,OAAO,KAAK,iBAAiB,QAAQ,KAAK,QAAQ;GAClD,MAAM;GACN,cAAc,cAAc,KAAK,MAAM;GACxC,CAAC;EAIJ,MAAM,gBAAgB,KAAK;EAG3B,MAAM,aAAa,OAAO,cAAc;EAIxC,MAAM,WAAW,OAAO,kBAAK;AAM7B,UAFqB,OAAO,WAAW,GAAG,OAAO,SAAS,EAEtC,UAAU;UACvB,OAAO;AACd,MAAI,iBAAiB,MACnB,OAAM,IAAI,SAAS;GACjB,OAAO;GACP,MAAM;GACN,cAAc,uCAAuC;GACtD,CAAC;AAGJ,QAAM;;;;;;;AC5EV,MAAa,4BACX,aACA,YACwB;CACxB,gEAA6B,OAAO,YAAY;CAEhD,YAAY,OAAO,EAAE,eAAe,EAClC,SAAS,MAAM,gBACb;EACE;EACA;EACD,EACD,OACD,EACF;CACF;;;;;AChBD,MAAa,qCACX,WACS;CACT,MAAM,sGAC8B,OAAO;;;;AAK3C,KAAI,+BAA+B,KAAK,CAAC,IAAI,MAAM,CACjD;AAGF,gCAA+B,SAAS;EACtC,UAAU,gBAAgB,yBAAyB,aAAa,OAAO;EACvE,OAAO;EACR,CAAC;;;;;;;;;;;;;;;;;;;;ACHJ,MAAa,sBACX,kBACsC,cAAc,UAAU;;;;;;;;;;;;ACFhE,MAAa,wBAAwB,OACnC,EAAE,iBAAiB,iBACnB,WACkB;AAClB,KAAI,CAAC,mBAAmB,cAAc,CACpC,OAAM,IAAIC,2CAAkB,8CAA8C;CAG5E,MAAM,EAAE,gBAAgB,yDAA2B,EAAE,eAAe,EAAE,OAAO;AAE7E,kDACE,aACA,4CAA4C,cAAc,UAC3D;AAID,OAFqBC,6EAAkC,EAAE,aAAa,CAAC,CAEpD,0BAA0B,EAC3C,MAAM,iBACP,CAAC;;;;;;;;;;;;;;;;;;;;;ACnBJ,MAAa,8BACX,yDAA2B,KACf;AACZ,kDAAc,OAAO,iBAAiB,mCAAmC;AAEzE,QACE,OAAO,gBAAgB,IAAI,iBAAiB,4BAC5C;;;;;;;;;;;;;;;;;;;;ACEJ,MAAa,eAAe,OAC1B,EAAE,QAAQ,gBAAgB,cAAc,iBACxC,WACyC;CACzC,MAAM,eAAe,MAAMC,8EACzB,EAAE,eAAe,EACjB,OACD;CAED,MAAM,oCAA0B;EAC9B,KAAKC;EACL,MAAM,CAAC,gBAAiC,OAAO;EAC/C,cAAc;EACf,CAAC;AAOF,QAAO,EAAE,iBALI,MAAM,aAAa,gBAAgB;EAC9C;EACA,IAAI;EACL,CAAC,EAE8B;;;;;;;;;;;;;;;;;;;;ACdlC,MAAa,oBAAoB,OAC/B,EACE,aACA,cACA,gBACA,cACA,iBAEF,WACoB;AACpB,KAAI,CAAC,YAKH,gBAJ0B,yDACxB,EAAE,eAAe,EACjB,OACD,EAC+B;AAGlC,kDACE,aACA,4CAA4C,cAAc,UAC3D;AAID,QAFqBC,6EAAkC,EAAE,aAAa,CAAC,CAEnD,aAAa;EAC/B,KAAKC;EACL,SAAS;EACT,MAAM,CAAC,cAA+B,eAAgC;EACtE,cAAc;EACf,CAAC;;;;;;;;;;;;;;;;;ACjCJ,MAAa,uCAAuC,OAClD,EACE,QACA,gBACA,cACA,iBAEF,WACyD;CACzD,MAAM,EAAE,gBAAgB,yDAA2B,EAAE,eAAe,EAAE,OAAO;AAE7E,kDACE,aACA,4CAA4C,cAAc,UAC3D;CAED,MAAM,mBAAmB,MAAM,kBAC7B;EACE;EACA,cAAc,cAAc;EAC5B;EACA;EACA;EACD,EACD,OACD;CAED,MAAM,iBAAiB,OAAO,OAAO;AAErC,KAAI,oBAAoB,eACtB;CAYF,MAAM,2BATS,MAAM,aACnB;EACE,QAAQ;EACR;EACA;EACA;EACD,EACD,OACD,EACsC;AAQvC,QAAO,EAAE,SAJO,MAFKC,6EAAkC,EAAE,aAAa,CAAC,CAEpC,0BAA0B,EAC3D,MAAM,yBACP,CAAC,EAEgB;;;;;;;;;;;;;;;;;;;;;;;;AC3CpB,MAAa,qCAAqC,OAChD,EACE,cACA,gBACA,iBAEF,WAC0C;CAC1C,MAAM,EAAE,gBAAgB,gBAAgB;AAExC,KAAI,CAAC,eACH,OAAM,IAAIC,2CACR,kDACD;CAGH,MAAMC,QAAoC,EAAE;AAE5C,KAAI,aAAa;EACf,MAAM,iBAAiB,OAAO,YAAY,OAAO;AAcjD,MAZyB,MAAM,kBAC7B;GACE,cAAc,cAAc;GAC5B,gBAAgB,YAAY;GAC5B,cAAc,YAAY;GAC1B;GACD,EACD,OACD,GAIsB,gBAAgB;AACrC,kBAAe,WAAW;AAE1B,SAAM,KAAK;IACT,mCAAyB;KACvB,KAAKC;KACL,MAAM,CAAC,YAAY,gBAAuB,eAAe;KACzD,cAAc;KACf,CAAC;IACF,QAAQ,YAAY;IACpB,OAAO;IACR,CAAC;;;AAIN,gBAAe,cAAc;AAG7B,OAAM,KAAK;EACT,MAAM,eAAe;EACrB,QAAQ,eAAe;EACvB,OAAO,eAAe,QAAQ,OAAO,eAAe,MAAM,GAAG;EAC9D,CAAC;CAEF,MAAM,EAAE,oBAAoB,MAAM,yBAChC;EAAE;EAAO;EAAe,EACxB,OACD;AAED,QAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;AC/D5B,MAAa,4BAA4B,OACvC,EACE,cACA,gBACA,kBAAkB,QAClB,iBAEF,WAC0C;AAC1C,KAAI,CAAC,mBAAmB,cAAc,CACpC,OAAM,IAAIC,2CAAkB,8CAA8C;CAG5E,MAAM,uFACJ,EAAE,eAAe,EACjB,OACD;AAKD,KACE,oBAAoB,UACpB,2BAA2B,OAAO,IAClCC,mFAAwC,eAAe,CAEvD,QAAO,mCACL;EAAE;EAAc;EAAgB;EAAe,EAC/C,OACD;CAGH,MAAM,EAAE,gBAAgB,gBAAgB;AAExC,KAAI,CAAC,eACH,OAAM,IAAID,2CACR,kDACD;AAGH,KAAI,aAAa;AACf,iBAAe,WAAW;AAE1B,QAAM,qCACJ;GACE,QAAQ,YAAY;GACpB,gBAAgB,YAAY;GAC5B,cAAc,YAAY;GAC1B;GACD,EACD,OACD;;AAGH,gBAAe,cAAc;CAE7B,MAAM,eAAe,MAAME,8EACzB,EAAE,eAAe,EACjB,OACD;CAGD,IAAIC,YAAoC,EAAE;AAC1C,KAAI,eAAe,gBAAgB,eAAe,qBAChD,aAAY;EACV,cAAc,OAAO,eAAe,aAAa;EACjD,sBAAsB,OAAO,eAAe,qBAAqB;EAClE;KAED,aAAY,EACV,GAAI,eAAe,YAAY,EAC7B,UAAU,OAAO,eAAe,SAAS,EAC1C,EACF;AAYH,QAAO,EAAE,iBATe,MAAM,aAAa,gBAAgB;EACzD,MAAM,eAAe;EACrB,IAAI,eAAe;EACnB,OAAO,eAAe,QAAQ,OAAO,eAAe,MAAM,GAAG;EAC7D,GAAI,eAAe,YAAY,EAAE,KAAK,OAAO,eAAe,SAAS,EAAE;EACvE,GAAG;EACH,GAAI,eAAe,SAAS,EAAE,OAAO,eAAe,OAAO;EAC5D,CAAC,EAEwB;;;;;AC7G5B,MAAM,mBAAmB;;AAGzB,MAAa,oBAAoB,OAC/B,EAAE,QAAQ,WAAW,OAAO,iBAC5B,WACyC;AACzC,KAAI,CAAC,mBAAmB,cAAc,CACpC,OAAM,IAAIC,2CAAkB,8CAA8C;CAG5E,MAAM,EAAE,gBAAgB,yDAA2B,EAAE,eAAe,EAAE,OAAO;AAE7E,kDACE,aACA,4CAA4C,cAAc,UAC3D;CAGD,MAAM,QAAQ,MADOC,6EAAkC,EAAE,aAAa,CAAC,CACtC,oBAAoB,EACnD,SAAS,cAAc,SACxB,CAAC;CAEF,MAAM,eAAe,MAAMC,8EACzB,EAAE,eAAe,EACjB,OACD;AAGD,KAAI,OAAO;EAGT,MAAM,oCAA0B;GAC9B,KAAKC;GACL,MAAM,CAAC,gCAAuC,QAJ/B,MAAM,YAAY,iBAI8B,CAAC;GAChE,cAAc;GACf,CAAC;AAQF,SAAO,EAAE,iBANI,MAAM,aAAa,gBAAgB;GAC9C;GACA;GACA,IAAI,MAAM;GACX,CAAC,EAE8B;;AAUlC,QAAO,EAAE,iBANI,MAAM,aAAa,gBAAgB;EAC9C;EACA,IAAI;EACJ,4BAAkB,OAAO;EAC1B,CAAC,EAE8B"}