@metamask/eip-5792-middleware 1.1.0 → 1.2.1

package/dist/hooks/processSendCalls.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"processSendCalls.cjs","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { KeyringTypes } from '@metamask/keyring-controller';\nimport { JsonRpcError, rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  BatchTransactionParams,\n  IsAtomicBatchSupportedResultEntry,\n  SecurityAlertResponse,\n  TransactionController,\n  ValidateSecurityRequest,\n} from '@metamask/transaction-controller';\nimport { TransactionEnvelopeType } from '@metamask/transaction-controller';\nimport type { Hex, JsonRpcRequest } from '@metamask/utils';\nimport { bytesToHex } from '@metamask/utils';\nimport { parse, v4 as uuid } from 'uuid';\n\nimport {\n  EIP5792ErrorCode,\n  KEYRING_TYPES_SUPPORTING_7702,\n  MessageType,\n  VERSION,\n} from '../constants';\nimport type {\n  EIP5792Messenger,\n  SendCallsPayload,\n  SendCallsResult,\n} from '../types';\nimport { getAccountKeyringType } from '../utils';\n\n/**\n * Type definition for required controller hooks and utilities of {@link processSendCalls}\n */\nexport type ProcessSendCallsHooks = {\n  /** Function to add a batch of transactions atomically */\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  /** Function to add a single transaction */\n  addTransaction: TransactionController['addTransaction'];\n  /** Function to check if smart account suggestions are disabled */\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  /** Function to check if atomic batching is supported for given parameters */\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  /** Function to validate security for transaction requests */\n  validateSecurity: (\n    securityAlertId: string,\n    request: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n};\n\n/**\n * A valid JSON-RPC request object for `wallet_sendCalls`.\n */\nexport type ProcessSendCallsRequest = JsonRpcRequest & {\n  /** The identifier for the network client that has been created for this RPC endpoint */\n  networkClientId: string;\n  /** The origin of the RPC request */\n  origin?: string;\n};\n\n/**\n * Processes a sendCalls request for EIP-5792 transactions.\n *\n * @param hooks - Object containing required controller hooks and utilities.\n * @param messenger - Messenger instance for controller communication.\n * @param params - The sendCalls parameters containing transaction calls and metadata.\n * @param req - The original JSON-RPC request.\n * @returns Promise resolving to a SendCallsResult containing the batch ID.\n */\nexport async function processSendCalls(\n  hooks: ProcessSendCallsHooks,\n  messenger: EIP5792Messenger,\n  params: SendCallsPayload,\n  req: ProcessSendCallsRequest,\n): Promise<SendCallsResult> {\n  const {\n    addTransactionBatch,\n    addTransaction,\n    getDismissSmartAccountSuggestionEnabled,\n    isAtomicBatchSupported,\n    validateSecurity: validateSecurityHook,\n  } = hooks;\n\n  const { calls, from: paramFrom } = params;\n  const { networkClientId, origin } = req;\n  const transactions = calls.map((call) => ({ params: call }));\n\n  const { chainId } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  ).configuration;\n\n  const from =\n    paramFrom ??\n    (messenger.call('AccountsController:getSelectedAccount').address as Hex);\n\n  const securityAlertId = uuid();\n  const validateSecurity = validateSecurityHook.bind(null, securityAlertId);\n\n  let batchId: Hex;\n  if (Object.keys(transactions).length === 1) {\n    batchId = await processSingleTransaction({\n      addTransaction,\n      chainId,\n      from,\n      networkClientId,\n      origin,\n      securityAlertId,\n      sendCalls: params,\n      transactions,\n      validateSecurity,\n    });\n  } else {\n    batchId = await processMultipleTransaction({\n      addTransactionBatch,\n      isAtomicBatchSupported,\n      chainId,\n      from,\n      getDismissSmartAccountSuggestionEnabled,\n      messenger,\n      networkClientId,\n      origin,\n      sendCalls: params,\n      securityAlertId,\n      transactions,\n      validateSecurity,\n    });\n  }\n\n  return { id: batchId };\n}\n\n/**\n * Processes a single transaction from a sendCalls request.\n *\n * @param params - Object containing all parameters needed for single transaction processing.\n * @param params.addTransaction - Function to add a single transaction.\n * @param params.chainId - The chain ID for the transaction.\n * @param params.from - The sender address.\n * @param params.networkClientId - The network client ID.\n * @param params.origin - The origin of the request (optional).\n * @param params.securityAlertId - The security alert ID for this transaction.\n * @param params.sendCalls - The original sendCalls request.\n * @param params.transactions - Array containing the single transaction.\n * @param params.validateSecurity - Function to validate security for the transaction.\n * @returns Promise resolving to the generated batch ID for the transaction.\n */\nasync function processSingleTransaction({\n  addTransaction,\n  chainId,\n  from,\n  networkClientId,\n  origin,\n  securityAlertId,\n  sendCalls,\n  transactions,\n  validateSecurity,\n}: {\n  addTransaction: TransactionController['addTransaction'];\n  chainId: Hex;\n  from: Hex;\n  networkClientId: string;\n  origin?: string;\n  securityAlertId: string;\n  sendCalls: SendCallsPayload;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => void;\n}) {\n  validateSingleSendCall(sendCalls, chainId);\n\n  const txParams = {\n    from,\n    ...transactions[0].params,\n    type: TransactionEnvelopeType.feeMarket,\n  };\n\n  const securityRequest: ValidateSecurityRequest = {\n    method: MessageType.SendTransaction,\n    params: [txParams],\n    origin,\n  };\n  validateSecurity(securityRequest, chainId);\n\n  const batchId = generateBatchId();\n\n  await addTransaction(txParams, {\n    networkClientId,\n    origin,\n    securityAlertResponse: { securityAlertId } as SecurityAlertResponse,\n    batchId,\n  });\n  return batchId;\n}\n\n/**\n * Processes multiple transactions from a sendCalls request as an atomic batch.\n *\n * @param params - Object containing all parameters needed for multiple transaction processing.\n * @param params.addTransactionBatch - Function to add a batch of transactions atomically.\n * @param params.isAtomicBatchSupported - Function to check if atomic batching is supported.\n * @param params.chainId - The chain ID for the transactions.\n * @param params.from - The sender address.\n * @param params.getDismissSmartAccountSuggestionEnabled - Function to check if smart account suggestions are disabled.\n * @param params.networkClientId - The network client ID.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.origin - The origin of the request (optional).\n * @param params.sendCalls - The original sendCalls request.\n * @param params.securityAlertId - The security alert ID for this batch.\n * @param params.transactions - Array of transactions to process.\n * @param params.validateSecurity - Function to validate security for the transactions.\n * @returns Promise resolving to the generated batch ID for the transaction batch.\n */\nasync function processMultipleTransaction({\n  addTransactionBatch,\n  isAtomicBatchSupported,\n  chainId,\n  from,\n  getDismissSmartAccountSuggestionEnabled,\n  networkClientId,\n  messenger,\n  origin,\n  sendCalls,\n  securityAlertId,\n  transactions,\n  validateSecurity,\n}: {\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  chainId: Hex;\n  from: Hex;\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  sendCalls: SendCallsPayload;\n  securityAlertId: string;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n}) {\n  const batchSupport = await isAtomicBatchSupported({\n    address: from,\n    chainIds: [chainId],\n  });\n\n  const chainBatchSupport = batchSupport?.[0];\n\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  const dismissSmartAccountSuggestionEnabled =\n    getDismissSmartAccountSuggestionEnabled();\n\n  validateSendCalls(\n    sendCalls,\n    chainId,\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n\n  const result = await addTransactionBatch({\n    from,\n    networkClientId,\n    origin,\n    securityAlertId,\n    transactions,\n    validateSecurity,\n  });\n  return result.batchId;\n}\n\n/**\n * Generate a transaction batch ID.\n *\n * @returns  A unique batch ID as a hexadecimal string.\n */\nfunction generateBatchId(): Hex {\n  const idString = uuid();\n  const idBytes = new Uint8Array(parse(idString));\n  return bytesToHex(idBytes);\n}\n\n/**\n * Validates a single sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to.\n */\nfunction validateSingleSendCall(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  validateSendCallsVersion(sendCalls);\n  validateCapabilities(sendCalls);\n  validateDappChainId(sendCalls, dappChainId);\n}\n\n/**\n * Validates a sendCalls request for multiple transactions.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n */\nfunction validateSendCalls(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport);\n  validateCapabilities(sendCalls);\n  validateUpgrade(\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n}\n\n/**\n * Validates the version of a sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if the version is not supported.\n */\nfunction validateSendCallsVersion(sendCalls: SendCallsPayload) {\n  const { version } = sendCalls;\n\n  if (version !== VERSION) {\n    throw rpcErrors.invalidInput(\n      `Version not supported: Got ${version}, expected ${VERSION}`,\n    );\n  }\n}\n\n/**\n * Validates that the chain ID in the sendCalls request matches the dApp's selected network.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @throws JsonRpcError if the chain IDs don't match\n */\nfunction validateDappChainId(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  const { chainId: requestChainId } = sendCalls;\n\n  if (\n    requestChainId &&\n    requestChainId.toLowerCase() !== dappChainId.toLowerCase()\n  ) {\n    throw rpcErrors.invalidParams(\n      `Chain ID must match the dApp selected network: Got ${requestChainId}, expected ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates the chain ID for sendCalls requests with additional EIP-7702 support checks.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param chainBatchSupport - Information about atomic batch support for the chain\n * @throws JsonRpcError if the chain ID doesn't match or EIP-7702 is not supported\n */\nfunction validateSendCallsChainId(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n) {\n  validateDappChainId(sendCalls, dappChainId);\n  if (!chainBatchSupport) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedChainId,\n      `EIP-7702 not supported on chain: ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates that all required capabilities in the sendCalls request are supported.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if unsupported non-optional capabilities are requested.\n */\nfunction validateCapabilities(sendCalls: SendCallsPayload) {\n  const { calls, capabilities } = sendCalls;\n\n  const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter(\n    (name) => capabilities?.[name].optional !== true,\n  );\n\n  const requiredCallCapabilities = calls.flatMap((call) =>\n    Object.keys(call.capabilities ?? {}).filter(\n      (name) => call.capabilities?.[name].optional !== true,\n    ),\n  );\n\n  const requiredCapabilities = [\n    ...requiredTopLevelCapabilities,\n    ...requiredCallCapabilities,\n  ];\n\n  if (requiredCapabilities?.length) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capabilities: ${requiredCapabilities.join(\n        ', ',\n      )}`,\n    );\n  }\n}\n\n/**\n * Validates whether an EIP-7702 upgrade is allowed for the given parameters.\n *\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @throws JsonRpcError if the upgrade is rejected due to user settings or account type.\n */\nfunction validateUpgrade(\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  if (chainBatchSupport?.delegationAddress) {\n    return;\n  }\n\n  if (dismissSmartAccountSuggestionEnabled) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade disabled by the user',\n    );\n  }\n\n  if (!KEYRING_TYPES_SUPPORTING_7702.includes(keyringType)) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade not supported on account',\n    );\n  }\n}\n"]}
+{"version":3,"file":"processSendCalls.cjs","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { KeyringTypes } from '@metamask/keyring-controller';\nimport { JsonRpcError, rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  BatchTransactionParams,\n  IsAtomicBatchSupportedResultEntry,\n  SecurityAlertResponse,\n  TransactionController,\n  ValidateSecurityRequest,\n} from '@metamask/transaction-controller';\nimport { TransactionEnvelopeType } from '@metamask/transaction-controller';\nimport type { Hex, JsonRpcRequest } from '@metamask/utils';\nimport { add0x, bytesToHex } from '@metamask/utils';\nimport { groupBy } from 'lodash';\nimport { parse, v4 as uuid } from 'uuid';\n\nimport {\n  EIP5792ErrorCode,\n  EIP7682ErrorCode,\n  KEYRING_TYPES_SUPPORTING_7702,\n  MessageType,\n  SupportedCapabilities,\n  VERSION,\n} from '../constants';\nimport type {\n  EIP5792Messenger,\n  SendCallsPayload,\n  SendCallsRequiredAssetsParam,\n  SendCallsResult,\n} from '../types';\nimport { getAccountKeyringType } from '../utils';\n\n/**\n * Type definition for required controller hooks and utilities of {@link processSendCalls}\n */\nexport type ProcessSendCallsHooks = {\n  /** Function to add a batch of transactions atomically */\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  /** Function to add a single transaction */\n  addTransaction: TransactionController['addTransaction'];\n  /** Function to check if smart account suggestions are disabled */\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  /** Function to check if atomic batching is supported for given parameters */\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  /** Function to validate security for transaction requests */\n  validateSecurity: (\n    securityAlertId: string,\n    request: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n  /** Function to validate if auxiliary funds capability is supported. */\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n};\n\n/**\n * A valid JSON-RPC request object for `wallet_sendCalls`.\n */\nexport type ProcessSendCallsRequest = JsonRpcRequest & {\n  /** The identifier for the network client that has been created for this RPC endpoint */\n  networkClientId: string;\n  /** The origin of the RPC request */\n  origin?: string;\n};\n\n/**\n * Processes a sendCalls request for EIP-5792 transactions.\n *\n * @param hooks - Object containing required controller hooks and utilities.\n * @param messenger - Messenger instance for controller communication.\n * @param params - The sendCalls parameters containing transaction calls and metadata.\n * @param req - The original JSON-RPC request.\n * @returns Promise resolving to a SendCallsResult containing the batch ID.\n */\nexport async function processSendCalls(\n  hooks: ProcessSendCallsHooks,\n  messenger: EIP5792Messenger,\n  params: SendCallsPayload,\n  req: ProcessSendCallsRequest,\n): Promise<SendCallsResult> {\n  const {\n    addTransactionBatch,\n    addTransaction,\n    getDismissSmartAccountSuggestionEnabled,\n    isAtomicBatchSupported,\n    validateSecurity: validateSecurityHook,\n    isAuxiliaryFundsSupported,\n  } = hooks;\n\n  const { calls, from: paramFrom } = params;\n  const { networkClientId, origin } = req;\n  const transactions = calls.map((call) => ({ params: call }));\n\n  const { chainId } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  ).configuration;\n\n  const from =\n    paramFrom ??\n    (messenger.call('AccountsController:getSelectedAccount').address as Hex);\n\n  const securityAlertId = uuid();\n  const validateSecurity = validateSecurityHook.bind(null, securityAlertId);\n\n  let batchId: Hex;\n  if (Object.keys(transactions).length === 1) {\n    batchId = await processSingleTransaction({\n      addTransaction,\n      chainId,\n      from,\n      messenger,\n      networkClientId,\n      origin,\n      securityAlertId,\n      sendCalls: params,\n      transactions,\n      validateSecurity,\n      isAuxiliaryFundsSupported,\n    });\n  } else {\n    batchId = await processMultipleTransaction({\n      addTransactionBatch,\n      isAtomicBatchSupported,\n      chainId,\n      from,\n      getDismissSmartAccountSuggestionEnabled,\n      messenger,\n      networkClientId,\n      origin,\n      sendCalls: params,\n      securityAlertId,\n      transactions,\n      validateSecurity,\n      isAuxiliaryFundsSupported,\n    });\n  }\n\n  return { id: batchId };\n}\n\n/**\n * Processes a single transaction from a sendCalls request.\n *\n * @param params - Object containing all parameters needed for single transaction processing.\n * @param params.addTransaction - Function to add a single transaction.\n * @param params.chainId - The chain ID for the transaction.\n * @param params.from - The sender address.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.networkClientId - The network client ID.\n * @param params.origin - The origin of the request (optional).\n * @param params.securityAlertId - The security alert ID for this transaction.\n * @param params.sendCalls - The original sendCalls request.\n * @param params.transactions - Array containing the single transaction.\n * @param params.validateSecurity - Function to validate security for the transaction.\n * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @returns Promise resolving to the generated batch ID for the transaction.\n */\nasync function processSingleTransaction({\n  addTransaction,\n  chainId,\n  from,\n  messenger,\n  networkClientId,\n  origin,\n  securityAlertId,\n  sendCalls,\n  transactions,\n  validateSecurity,\n  isAuxiliaryFundsSupported,\n}: {\n  addTransaction: TransactionController['addTransaction'];\n  chainId: Hex;\n  from: Hex;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  securityAlertId: string;\n  sendCalls: SendCallsPayload;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => void;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  validateSingleSendCall(\n    sendCalls,\n    chainId,\n    keyringType,\n    isAuxiliaryFundsSupported,\n  );\n\n  const txParams = {\n    from,\n    ...transactions[0].params,\n    type: TransactionEnvelopeType.feeMarket,\n  };\n\n  const securityRequest: ValidateSecurityRequest = {\n    method: MessageType.SendTransaction,\n    params: [txParams],\n    origin,\n  };\n  validateSecurity(securityRequest, chainId);\n\n  dedupeAuxiliaryFundsRequiredAssets(sendCalls);\n\n  const batchId = generateBatchId();\n\n  await addTransaction(txParams, {\n    networkClientId,\n    origin,\n    securityAlertResponse: { securityAlertId } as SecurityAlertResponse,\n    batchId,\n  });\n  return batchId;\n}\n\n/**\n * Processes multiple transactions from a sendCalls request as an atomic batch.\n *\n * @param params - Object containing all parameters needed for multiple transaction processing.\n * @param params.addTransactionBatch - Function to add a batch of transactions atomically.\n * @param params.isAtomicBatchSupported - Function to check if atomic batching is supported.\n * @param params.chainId - The chain ID for the transactions.\n * @param params.from - The sender address.\n * @param params.getDismissSmartAccountSuggestionEnabled - Function to check if smart account suggestions are disabled.\n * @param params.networkClientId - The network client ID.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.origin - The origin of the request (optional).\n * @param params.sendCalls - The original sendCalls request.\n * @param params.securityAlertId - The security alert ID for this batch.\n * @param params.transactions - Array of transactions to process.\n * @param params.validateSecurity - Function to validate security for the transactions.\n * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @returns Promise resolving to the generated batch ID for the transaction batch.\n */\nasync function processMultipleTransaction({\n  addTransactionBatch,\n  isAtomicBatchSupported,\n  chainId,\n  from,\n  getDismissSmartAccountSuggestionEnabled,\n  networkClientId,\n  messenger,\n  origin,\n  sendCalls,\n  securityAlertId,\n  transactions,\n  validateSecurity,\n  isAuxiliaryFundsSupported,\n}: {\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  chainId: Hex;\n  from: Hex;\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  sendCalls: SendCallsPayload;\n  securityAlertId: string;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  const batchSupport = await isAtomicBatchSupported({\n    address: from,\n    chainIds: [chainId],\n  });\n\n  const chainBatchSupport = batchSupport?.[0];\n\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  const dismissSmartAccountSuggestionEnabled =\n    getDismissSmartAccountSuggestionEnabled();\n\n  validateSendCalls(\n    sendCalls,\n    chainId,\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n    isAuxiliaryFundsSupported,\n  );\n\n  dedupeAuxiliaryFundsRequiredAssets(sendCalls);\n\n  const result = await addTransactionBatch({\n    from,\n    networkClientId,\n    origin,\n    securityAlertId,\n    transactions,\n    validateSecurity,\n  });\n  return result.batchId;\n}\n\n/**\n * Generate a transaction batch ID.\n *\n * @returns  A unique batch ID as a hexadecimal string.\n */\nfunction generateBatchId(): Hex {\n  const idString = uuid();\n  const idBytes = new Uint8Array(parse(idString));\n  return bytesToHex(idBytes);\n}\n\n/**\n * Validates a single sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n */\nfunction validateSingleSendCall(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);\n  validateDappChainId(sendCalls, dappChainId);\n}\n\n/**\n * Validates a sendCalls request for multiple transactions.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n */\nfunction validateSendCalls(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport);\n  validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);\n  validateUpgrade(\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n}\n\n/**\n * Validates the version of a sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if the version is not supported.\n */\nfunction validateSendCallsVersion(sendCalls: SendCallsPayload) {\n  const { version } = sendCalls;\n\n  if (version !== VERSION) {\n    throw rpcErrors.invalidInput(\n      `Version not supported: Got ${version}, expected ${VERSION}`,\n    );\n  }\n}\n\n/**\n * Validates that the chain ID in the sendCalls request matches the dApp's selected network.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @throws JsonRpcError if the chain IDs don't match\n */\nfunction validateDappChainId(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  const { chainId: requestChainId } = sendCalls;\n\n  if (\n    requestChainId &&\n    requestChainId.toLowerCase() !== dappChainId.toLowerCase()\n  ) {\n    throw rpcErrors.invalidParams(\n      `Chain ID must match the dApp selected network: Got ${requestChainId}, expected ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates the chain ID for sendCalls requests with additional EIP-7702 support checks.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param chainBatchSupport - Information about atomic batch support for the chain\n * @throws JsonRpcError if the chain ID doesn't match or EIP-7702 is not supported\n */\nfunction validateSendCallsChainId(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n) {\n  validateDappChainId(sendCalls, dappChainId);\n  if (!chainBatchSupport) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedChainId,\n      `EIP-7702 not supported on chain: ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates that all required capabilities in the sendCalls request are supported.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n *\n * @throws JsonRpcError if unsupported non-optional capabilities are requested.\n */\nfunction validateCapabilities(\n  sendCalls: SendCallsPayload,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  const { calls, capabilities, chainId } = sendCalls;\n\n  const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter(\n    (name) =>\n      // Non optional capabilities other than `auxiliaryFunds` are not supported by the wallet\n      name !== SupportedCapabilities.AuxiliaryFunds.toString() &&\n      capabilities?.[name].optional !== true,\n  );\n\n  const requiredCallCapabilities = calls.flatMap((call) =>\n    Object.keys(call.capabilities ?? {}).filter(\n      (name) =>\n        name !== SupportedCapabilities.AuxiliaryFunds.toString() &&\n        call.capabilities?.[name].optional !== true,\n    ),\n  );\n\n  const requiredCapabilities = [\n    ...requiredTopLevelCapabilities,\n    ...requiredCallCapabilities,\n  ];\n\n  if (requiredCapabilities?.length) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capabilities: ${requiredCapabilities.join(\n        ', ',\n      )}`,\n    );\n  }\n\n  if (capabilities?.auxiliaryFunds) {\n    validateAuxFundsSupportAndRequiredAssets({\n      auxiliaryFunds: capabilities.auxiliaryFunds,\n      chainId,\n      keyringType,\n      isAuxiliaryFundsSupported,\n    });\n  }\n}\n\n/**\n * Validates EIP-7682 optional `requiredAssets` to see if the account and chain are supported, and that param is well-formed.\n *\n * docs: {@link https://eips.ethereum.org/EIPS/eip-7682#extended-usage-requiredassets-parameter}\n *\n * @param param - The parameter object.\n * @param param.auxiliaryFunds - The auxiliaryFunds param to validate.\n * @param param.auxiliaryFunds.optional - Metadata to signal for wallets that support this optional capability, while maintaining compatibility with wallets that do not.\n * @param param.auxiliaryFunds.requiredAssets - Metadata that enables a wallets support for `auxiliaryFunds` capability.\n * @param param.chainId - The chain ID of the incoming request.\n * @param param.keyringType - The type of keyring associated with the account.\n * @param param.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @throws JsonRpcError if auxiliary funds capability is not supported.\n */\nfunction validateAuxFundsSupportAndRequiredAssets({\n  auxiliaryFunds,\n  chainId,\n  keyringType,\n  isAuxiliaryFundsSupported,\n}: {\n  auxiliaryFunds: {\n    optional?: boolean;\n    requiredAssets?: SendCallsRequiredAssetsParam[];\n  };\n  chainId: Hex;\n  keyringType: KeyringTypes;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  // If we can make use of that capability then we should, but otherwise we can process the request and ignore the capability\n  // so if the capability is signaled as optional, no validation is required, so we don't block the transaction from happening.\n  if (auxiliaryFunds.optional) {\n    return;\n  }\n  const isSupportedAccount =\n    KEYRING_TYPES_SUPPORTING_7702.includes(keyringType);\n\n  if (!isSupportedAccount) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capability: ${SupportedCapabilities.AuxiliaryFunds}`,\n    );\n  }\n\n  if (!isAuxiliaryFundsSupported(chainId)) {\n    throw new JsonRpcError(\n      EIP7682ErrorCode.UnsupportedChain,\n      `The wallet no longer supports auxiliary funds on the requested chain: ${chainId}`,\n    );\n  }\n\n  if (!auxiliaryFunds?.requiredAssets) {\n    return;\n  }\n\n  for (const asset of auxiliaryFunds.requiredAssets) {\n    if (asset.standard !== 'erc20') {\n      throw new JsonRpcError(\n        EIP7682ErrorCode.UnsupportedAsset,\n        `The requested asset ${asset.address} is not available through the wallet’s auxiliary fund system: unsupported token standard ${asset.standard}`,\n      );\n    }\n  }\n}\n\n/**\n * Validates whether an EIP-7702 upgrade is allowed for the given parameters.\n *\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @throws JsonRpcError if the upgrade is rejected due to user settings or account type.\n */\nfunction validateUpgrade(\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  if (chainBatchSupport?.delegationAddress) {\n    return;\n  }\n\n  if (dismissSmartAccountSuggestionEnabled) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade disabled by the user',\n    );\n  }\n\n  if (!KEYRING_TYPES_SUPPORTING_7702.includes(keyringType)) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade not supported on account',\n    );\n  }\n}\n\n/**\n * Function to possibly deduplicate `auxiliaryFunds` capability `requiredAssets`.\n * Does nothing if no `requiredAssets` exists in `auxiliaryFunds` capability.\n *\n * @param sendCalls - The original sendCalls request.\n */\nfunction dedupeAuxiliaryFundsRequiredAssets(sendCalls: SendCallsPayload): void {\n  if (sendCalls.capabilities?.auxiliaryFunds?.requiredAssets) {\n    const { requiredAssets } = sendCalls.capabilities.auxiliaryFunds;\n    // Group assets by their address (lowercased) and standard\n    const grouped = groupBy(\n      requiredAssets,\n      (asset) => `${asset.address.toLowerCase()}-${asset.standard}`,\n    );\n\n    // For each group, sum the amounts and return a single asset\n    const deduplicatedAssets = Object.values(grouped).map((group) => {\n      if (group.length === 1) {\n        return group[0];\n      }\n\n      const totalAmount = group.reduce((sum, asset) => {\n        return sum + BigInt(asset.amount);\n      }, 0n);\n\n      return {\n        ...group[0],\n        amount: add0x(totalAmount.toString(16)),\n      };\n    });\n\n    sendCalls.capabilities.auxiliaryFunds.requiredAssets = deduplicatedAssets;\n  }\n}\n"]}

package/dist/hooks/processSendCalls.d.cts

@@ -15,6 +15,8 @@ export type ProcessSendCallsHooks = {
     isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];
     /** Function to validate security for transaction requests */
     validateSecurity: (securityAlertId: string, request: ValidateSecurityRequest, chainId: Hex) => Promise<void>;
+    /** Function to validate if auxiliary funds capability is supported. */
+    isAuxiliaryFundsSupported: (chainId: Hex) => boolean;
 };
 /**
  * A valid JSON-RPC request object for `wallet_sendCalls`.

package/dist/hooks/processSendCalls.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"processSendCalls.d.cts","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,qBAAqB,EACrB,uBAAuB,EACxB,yCAAyC;AAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,wBAAwB;AAU3D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,qBAAiB;AAGlB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IAClE,2CAA2C;IAC3C,cAAc,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACxD,kEAAkE;IAClE,uCAAuC,EAAE,MAAM,OAAO,CAAC;IACvD,6EAA6E;IAC7E,sBAAsB,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IACxE,6DAA6D;IAC7D,gBAAgB,EAAE,CAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,GAAG,KACT,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAwD1B"}
+{"version":3,"file":"processSendCalls.d.cts","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,qBAAqB,EACrB,uBAAuB,EACxB,yCAAyC;AAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,wBAAwB;AAa3D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EAChB,qBAAiB;AAGlB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IAClE,2CAA2C;IAC3C,cAAc,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACxD,kEAAkE;IAClE,uCAAuC,EAAE,MAAM,OAAO,CAAC;IACvD,6EAA6E;IAC7E,sBAAsB,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IACxE,6DAA6D;IAC7D,gBAAgB,EAAE,CAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,GAAG,KACT,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,uEAAuE;IACvE,yBAAyB,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA4D1B"}

package/dist/hooks/processSendCalls.d.mts

@@ -15,6 +15,8 @@ export type ProcessSendCallsHooks = {
     isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];
     /** Function to validate security for transaction requests */
     validateSecurity: (securityAlertId: string, request: ValidateSecurityRequest, chainId: Hex) => Promise<void>;
+    /** Function to validate if auxiliary funds capability is supported. */
+    isAuxiliaryFundsSupported: (chainId: Hex) => boolean;
 };
 /**
  * A valid JSON-RPC request object for `wallet_sendCalls`.

package/dist/hooks/processSendCalls.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"processSendCalls.d.mts","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,qBAAqB,EACrB,uBAAuB,EACxB,yCAAyC;AAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,wBAAwB;AAU3D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,qBAAiB;AAGlB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IAClE,2CAA2C;IAC3C,cAAc,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACxD,kEAAkE;IAClE,uCAAuC,EAAE,MAAM,OAAO,CAAC;IACvD,6EAA6E;IAC7E,sBAAsB,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IACxE,6DAA6D;IAC7D,gBAAgB,EAAE,CAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,GAAG,KACT,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAwD1B"}
+{"version":3,"file":"processSendCalls.d.mts","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,qBAAqB,EACrB,uBAAuB,EACxB,yCAAyC;AAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,wBAAwB;AAa3D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EAChB,qBAAiB;AAGlB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IAClE,2CAA2C;IAC3C,cAAc,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACxD,kEAAkE;IAClE,uCAAuC,EAAE,MAAM,OAAO,CAAC;IACvD,6EAA6E;IAC7E,sBAAsB,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IACxE,6DAA6D;IAC7D,gBAAgB,EAAE,CAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,GAAG,KACT,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,uEAAuE;IACvE,yBAAyB,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA4D1B"}

package/dist/hooks/processSendCalls.mjs

@@ -1,8 +1,10 @@
 import { JsonRpcError, rpcErrors } from "@metamask/rpc-errors";
 import { TransactionEnvelopeType } from "@metamask/transaction-controller";
-import { bytesToHex } from "@metamask/utils";
+import { add0x, bytesToHex } from "@metamask/utils";
+import $lodash from "lodash";
+const { groupBy } = $lodash;
 import { parse, v4 as uuid } from "uuid";
-import { EIP5792ErrorCode, KEYRING_TYPES_SUPPORTING_7702, MessageType, VERSION } from "../constants.mjs";
+import { EIP5792ErrorCode, EIP7682ErrorCode, KEYRING_TYPES_SUPPORTING_7702, MessageType, SupportedCapabilities, VERSION } from "../constants.mjs";
 import { getAccountKeyringType } from "../utils.mjs";
 /**
  * Processes a sendCalls request for EIP-5792 transactions.
@@ -14,7 +16,7 @@ import { getAccountKeyringType } from "../utils.mjs";
  * @returns Promise resolving to a SendCallsResult containing the batch ID.
  */
 export async function processSendCalls(hooks, messenger, params, req) {
-    const { addTransactionBatch, addTransaction, getDismissSmartAccountSuggestionEnabled, isAtomicBatchSupported, validateSecurity: validateSecurityHook, } = hooks;
+    const { addTransactionBatch, addTransaction, getDismissSmartAccountSuggestionEnabled, isAtomicBatchSupported, validateSecurity: validateSecurityHook, isAuxiliaryFundsSupported, } = hooks;
     const { calls, from: paramFrom } = params;
     const { networkClientId, origin } = req;
     const transactions = calls.map((call) => ({ params: call }));
@@ -29,12 +31,14 @@ export async function processSendCalls(hooks, messenger, params, req) {
             addTransaction,
             chainId,
             from,
+            messenger,
             networkClientId,
             origin,
             securityAlertId,
             sendCalls: params,
             transactions,
             validateSecurity,
+            isAuxiliaryFundsSupported,
         });
     }
     else {
@@ -51,6 +55,7 @@ export async function processSendCalls(hooks, messenger, params, req) {
             securityAlertId,
             transactions,
             validateSecurity,
+            isAuxiliaryFundsSupported,
         });
     }
     return { id: batchId };
@@ -62,16 +67,19 @@ export async function processSendCalls(hooks, messenger, params, req) {
  * @param params.addTransaction - Function to add a single transaction.
  * @param params.chainId - The chain ID for the transaction.
  * @param params.from - The sender address.
+ * @param params.messenger - Messenger instance for controller communication.
  * @param params.networkClientId - The network client ID.
  * @param params.origin - The origin of the request (optional).
  * @param params.securityAlertId - The security alert ID for this transaction.
  * @param params.sendCalls - The original sendCalls request.
  * @param params.transactions - Array containing the single transaction.
  * @param params.validateSecurity - Function to validate security for the transaction.
+ * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
  * @returns Promise resolving to the generated batch ID for the transaction.
  */
-async function processSingleTransaction({ addTransaction, chainId, from, networkClientId, origin, securityAlertId, sendCalls, transactions, validateSecurity, }) {
-    validateSingleSendCall(sendCalls, chainId);
+async function processSingleTransaction({ addTransaction, chainId, from, messenger, networkClientId, origin, securityAlertId, sendCalls, transactions, validateSecurity, isAuxiliaryFundsSupported, }) {
+    const keyringType = getAccountKeyringType(from, messenger);
+    validateSingleSendCall(sendCalls, chainId, keyringType, isAuxiliaryFundsSupported);
     const txParams = {
         from,
         ...transactions[0].params,
@@ -83,6 +91,7 @@ async function processSingleTransaction({ addTransaction, chainId, from, network
         origin,
     };
     validateSecurity(securityRequest, chainId);
+    dedupeAuxiliaryFundsRequiredAssets(sendCalls);
     const batchId = generateBatchId();
     await addTransaction(txParams, {
         networkClientId,
@@ -108,9 +117,10 @@ async function processSingleTransaction({ addTransaction, chainId, from, network
  * @param params.securityAlertId - The security alert ID for this batch.
  * @param params.transactions - Array of transactions to process.
  * @param params.validateSecurity - Function to validate security for the transactions.
+ * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
  * @returns Promise resolving to the generated batch ID for the transaction batch.
  */
-async function processMultipleTransaction({ addTransactionBatch, isAtomicBatchSupported, chainId, from, getDismissSmartAccountSuggestionEnabled, networkClientId, messenger, origin, sendCalls, securityAlertId, transactions, validateSecurity, }) {
+async function processMultipleTransaction({ addTransactionBatch, isAtomicBatchSupported, chainId, from, getDismissSmartAccountSuggestionEnabled, networkClientId, messenger, origin, sendCalls, securityAlertId, transactions, validateSecurity, isAuxiliaryFundsSupported, }) {
     const batchSupport = await isAtomicBatchSupported({
         address: from,
         chainIds: [chainId],
@@ -118,7 +128,8 @@ async function processMultipleTransaction({ addTransactionBatch, isAtomicBatchSu
     const chainBatchSupport = batchSupport?.[0];
     const keyringType = getAccountKeyringType(from, messenger);
     const dismissSmartAccountSuggestionEnabled = getDismissSmartAccountSuggestionEnabled();
-    validateSendCalls(sendCalls, chainId, dismissSmartAccountSuggestionEnabled, chainBatchSupport, keyringType);
+    validateSendCalls(sendCalls, chainId, dismissSmartAccountSuggestionEnabled, chainBatchSupport, keyringType, isAuxiliaryFundsSupported);
+    dedupeAuxiliaryFundsRequiredAssets(sendCalls);
     const result = await addTransactionBatch({
         from,
         networkClientId,
@@ -144,10 +155,12 @@ function generateBatchId() {
  *
  * @param sendCalls - The sendCalls request to validate.
  * @param dappChainId - The chain ID that the dApp is connected to.
+ * @param keyringType - The type of keyring associated with the account.
+ * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
  */
-function validateSingleSendCall(sendCalls, dappChainId) {
+function validateSingleSendCall(sendCalls, dappChainId, keyringType, isAuxiliaryFundsSupported) {
     validateSendCallsVersion(sendCalls);
-    validateCapabilities(sendCalls);
+    validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);
     validateDappChainId(sendCalls, dappChainId);
 }
 /**
@@ -158,11 +171,12 @@ function validateSingleSendCall(sendCalls, dappChainId) {
  * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.
  * @param chainBatchSupport - Information about atomic batch support for the chain.
  * @param keyringType - The type of keyring associated with the account.
+ * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
  */
-function validateSendCalls(sendCalls, dappChainId, dismissSmartAccountSuggestionEnabled, chainBatchSupport, keyringType) {
+function validateSendCalls(sendCalls, dappChainId, dismissSmartAccountSuggestionEnabled, chainBatchSupport, keyringType, isAuxiliaryFundsSupported) {
     validateSendCallsVersion(sendCalls);
     validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport);
-    validateCapabilities(sendCalls);
+    validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);
     validateUpgrade(dismissSmartAccountSuggestionEnabled, chainBatchSupport, keyringType);
 }
 /**
@@ -209,12 +223,19 @@ function validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport) {
  * Validates that all required capabilities in the sendCalls request are supported.
  *
  * @param sendCalls - The sendCalls request to validate.
+ * @param keyringType - The type of keyring associated with the account.
+ * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
+ *
  * @throws JsonRpcError if unsupported non-optional capabilities are requested.
  */
-function validateCapabilities(sendCalls) {
-    const { calls, capabilities } = sendCalls;
-    const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter((name) => capabilities?.[name].optional !== true);
-    const requiredCallCapabilities = calls.flatMap((call) => Object.keys(call.capabilities ?? {}).filter((name) => call.capabilities?.[name].optional !== true));
+function validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported) {
+    const { calls, capabilities, chainId } = sendCalls;
+    const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter((name) => 
+    // Non optional capabilities other than `auxiliaryFunds` are not supported by the wallet
+    name !== SupportedCapabilities.AuxiliaryFunds.toString() &&
+        capabilities?.[name].optional !== true);
+    const requiredCallCapabilities = calls.flatMap((call) => Object.keys(call.capabilities ?? {}).filter((name) => name !== SupportedCapabilities.AuxiliaryFunds.toString() &&
+        call.capabilities?.[name].optional !== true));
     const requiredCapabilities = [
         ...requiredTopLevelCapabilities,
         ...requiredCallCapabilities,
@@ -222,6 +243,50 @@ function validateCapabilities(sendCalls) {
     if (requiredCapabilities?.length) {
         throw new JsonRpcError(EIP5792ErrorCode.UnsupportedNonOptionalCapability, `Unsupported non-optional capabilities: ${requiredCapabilities.join(', ')}`);
     }
+    if (capabilities?.auxiliaryFunds) {
+        validateAuxFundsSupportAndRequiredAssets({
+            auxiliaryFunds: capabilities.auxiliaryFunds,
+            chainId,
+            keyringType,
+            isAuxiliaryFundsSupported,
+        });
+    }
+}
+/**
+ * Validates EIP-7682 optional `requiredAssets` to see if the account and chain are supported, and that param is well-formed.
+ *
+ * docs: {@link https://eips.ethereum.org/EIPS/eip-7682#extended-usage-requiredassets-parameter}
+ *
+ * @param param - The parameter object.
+ * @param param.auxiliaryFunds - The auxiliaryFunds param to validate.
+ * @param param.auxiliaryFunds.optional - Metadata to signal for wallets that support this optional capability, while maintaining compatibility with wallets that do not.
+ * @param param.auxiliaryFunds.requiredAssets - Metadata that enables a wallets support for `auxiliaryFunds` capability.
+ * @param param.chainId - The chain ID of the incoming request.
+ * @param param.keyringType - The type of keyring associated with the account.
+ * @param param.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.
+ * @throws JsonRpcError if auxiliary funds capability is not supported.
+ */
+function validateAuxFundsSupportAndRequiredAssets({ auxiliaryFunds, chainId, keyringType, isAuxiliaryFundsSupported, }) {
+    // If we can make use of that capability then we should, but otherwise we can process the request and ignore the capability
+    // so if the capability is signaled as optional, no validation is required, so we don't block the transaction from happening.
+    if (auxiliaryFunds.optional) {
+        return;
+    }
+    const isSupportedAccount = KEYRING_TYPES_SUPPORTING_7702.includes(keyringType);
+    if (!isSupportedAccount) {
+        throw new JsonRpcError(EIP5792ErrorCode.UnsupportedNonOptionalCapability, `Unsupported non-optional capability: ${SupportedCapabilities.AuxiliaryFunds}`);
+    }
+    if (!isAuxiliaryFundsSupported(chainId)) {
+        throw new JsonRpcError(EIP7682ErrorCode.UnsupportedChain, `The wallet no longer supports auxiliary funds on the requested chain: ${chainId}`);
+    }
+    if (!auxiliaryFunds?.requiredAssets) {
+        return;
+    }
+    for (const asset of auxiliaryFunds.requiredAssets) {
+        if (asset.standard !== 'erc20') {
+            throw new JsonRpcError(EIP7682ErrorCode.UnsupportedAsset, `The requested asset ${asset.address} is not available through the wallet’s auxiliary fund system: unsupported token standard ${asset.standard}`);
+        }
+    }
 }
 /**
  * Validates whether an EIP-7702 upgrade is allowed for the given parameters.
@@ -242,4 +307,31 @@ function validateUpgrade(dismissSmartAccountSuggestionEnabled, chainBatchSupport
         throw new JsonRpcError(EIP5792ErrorCode.RejectedUpgrade, 'EIP-7702 upgrade not supported on account');
     }
 }
+/**
+ * Function to possibly deduplicate `auxiliaryFunds` capability `requiredAssets`.
+ * Does nothing if no `requiredAssets` exists in `auxiliaryFunds` capability.
+ *
+ * @param sendCalls - The original sendCalls request.
+ */
+function dedupeAuxiliaryFundsRequiredAssets(sendCalls) {
+    if (sendCalls.capabilities?.auxiliaryFunds?.requiredAssets) {
+        const { requiredAssets } = sendCalls.capabilities.auxiliaryFunds;
+        // Group assets by their address (lowercased) and standard
+        const grouped = groupBy(requiredAssets, (asset) => `${asset.address.toLowerCase()}-${asset.standard}`);
+        // For each group, sum the amounts and return a single asset
+        const deduplicatedAssets = Object.values(grouped).map((group) => {
+            if (group.length === 1) {
+                return group[0];
+            }
+            const totalAmount = group.reduce((sum, asset) => {
+                return sum + BigInt(asset.amount);
+            }, 0n);
+            return {
+                ...group[0],
+                amount: add0x(totalAmount.toString(16)),
+            };
+        });
+        sendCalls.capabilities.auxiliaryFunds.requiredAssets = deduplicatedAssets;
+    }
+}
 //# sourceMappingURL=processSendCalls.mjs.map

package/dist/hooks/processSendCalls.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"processSendCalls.mjs","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { KeyringTypes } from '@metamask/keyring-controller';\nimport { JsonRpcError, rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  BatchTransactionParams,\n  IsAtomicBatchSupportedResultEntry,\n  SecurityAlertResponse,\n  TransactionController,\n  ValidateSecurityRequest,\n} from '@metamask/transaction-controller';\nimport { TransactionEnvelopeType } from '@metamask/transaction-controller';\nimport type { Hex, JsonRpcRequest } from '@metamask/utils';\nimport { bytesToHex } from '@metamask/utils';\nimport { parse, v4 as uuid } from 'uuid';\n\nimport {\n  EIP5792ErrorCode,\n  KEYRING_TYPES_SUPPORTING_7702,\n  MessageType,\n  VERSION,\n} from '../constants';\nimport type {\n  EIP5792Messenger,\n  SendCallsPayload,\n  SendCallsResult,\n} from '../types';\nimport { getAccountKeyringType } from '../utils';\n\n/**\n * Type definition for required controller hooks and utilities of {@link processSendCalls}\n */\nexport type ProcessSendCallsHooks = {\n  /** Function to add a batch of transactions atomically */\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  /** Function to add a single transaction */\n  addTransaction: TransactionController['addTransaction'];\n  /** Function to check if smart account suggestions are disabled */\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  /** Function to check if atomic batching is supported for given parameters */\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  /** Function to validate security for transaction requests */\n  validateSecurity: (\n    securityAlertId: string,\n    request: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n};\n\n/**\n * A valid JSON-RPC request object for `wallet_sendCalls`.\n */\nexport type ProcessSendCallsRequest = JsonRpcRequest & {\n  /** The identifier for the network client that has been created for this RPC endpoint */\n  networkClientId: string;\n  /** The origin of the RPC request */\n  origin?: string;\n};\n\n/**\n * Processes a sendCalls request for EIP-5792 transactions.\n *\n * @param hooks - Object containing required controller hooks and utilities.\n * @param messenger - Messenger instance for controller communication.\n * @param params - The sendCalls parameters containing transaction calls and metadata.\n * @param req - The original JSON-RPC request.\n * @returns Promise resolving to a SendCallsResult containing the batch ID.\n */\nexport async function processSendCalls(\n  hooks: ProcessSendCallsHooks,\n  messenger: EIP5792Messenger,\n  params: SendCallsPayload,\n  req: ProcessSendCallsRequest,\n): Promise<SendCallsResult> {\n  const {\n    addTransactionBatch,\n    addTransaction,\n    getDismissSmartAccountSuggestionEnabled,\n    isAtomicBatchSupported,\n    validateSecurity: validateSecurityHook,\n  } = hooks;\n\n  const { calls, from: paramFrom } = params;\n  const { networkClientId, origin } = req;\n  const transactions = calls.map((call) => ({ params: call }));\n\n  const { chainId } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  ).configuration;\n\n  const from =\n    paramFrom ??\n    (messenger.call('AccountsController:getSelectedAccount').address as Hex);\n\n  const securityAlertId = uuid();\n  const validateSecurity = validateSecurityHook.bind(null, securityAlertId);\n\n  let batchId: Hex;\n  if (Object.keys(transactions).length === 1) {\n    batchId = await processSingleTransaction({\n      addTransaction,\n      chainId,\n      from,\n      networkClientId,\n      origin,\n      securityAlertId,\n      sendCalls: params,\n      transactions,\n      validateSecurity,\n    });\n  } else {\n    batchId = await processMultipleTransaction({\n      addTransactionBatch,\n      isAtomicBatchSupported,\n      chainId,\n      from,\n      getDismissSmartAccountSuggestionEnabled,\n      messenger,\n      networkClientId,\n      origin,\n      sendCalls: params,\n      securityAlertId,\n      transactions,\n      validateSecurity,\n    });\n  }\n\n  return { id: batchId };\n}\n\n/**\n * Processes a single transaction from a sendCalls request.\n *\n * @param params - Object containing all parameters needed for single transaction processing.\n * @param params.addTransaction - Function to add a single transaction.\n * @param params.chainId - The chain ID for the transaction.\n * @param params.from - The sender address.\n * @param params.networkClientId - The network client ID.\n * @param params.origin - The origin of the request (optional).\n * @param params.securityAlertId - The security alert ID for this transaction.\n * @param params.sendCalls - The original sendCalls request.\n * @param params.transactions - Array containing the single transaction.\n * @param params.validateSecurity - Function to validate security for the transaction.\n * @returns Promise resolving to the generated batch ID for the transaction.\n */\nasync function processSingleTransaction({\n  addTransaction,\n  chainId,\n  from,\n  networkClientId,\n  origin,\n  securityAlertId,\n  sendCalls,\n  transactions,\n  validateSecurity,\n}: {\n  addTransaction: TransactionController['addTransaction'];\n  chainId: Hex;\n  from: Hex;\n  networkClientId: string;\n  origin?: string;\n  securityAlertId: string;\n  sendCalls: SendCallsPayload;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => void;\n}) {\n  validateSingleSendCall(sendCalls, chainId);\n\n  const txParams = {\n    from,\n    ...transactions[0].params,\n    type: TransactionEnvelopeType.feeMarket,\n  };\n\n  const securityRequest: ValidateSecurityRequest = {\n    method: MessageType.SendTransaction,\n    params: [txParams],\n    origin,\n  };\n  validateSecurity(securityRequest, chainId);\n\n  const batchId = generateBatchId();\n\n  await addTransaction(txParams, {\n    networkClientId,\n    origin,\n    securityAlertResponse: { securityAlertId } as SecurityAlertResponse,\n    batchId,\n  });\n  return batchId;\n}\n\n/**\n * Processes multiple transactions from a sendCalls request as an atomic batch.\n *\n * @param params - Object containing all parameters needed for multiple transaction processing.\n * @param params.addTransactionBatch - Function to add a batch of transactions atomically.\n * @param params.isAtomicBatchSupported - Function to check if atomic batching is supported.\n * @param params.chainId - The chain ID for the transactions.\n * @param params.from - The sender address.\n * @param params.getDismissSmartAccountSuggestionEnabled - Function to check if smart account suggestions are disabled.\n * @param params.networkClientId - The network client ID.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.origin - The origin of the request (optional).\n * @param params.sendCalls - The original sendCalls request.\n * @param params.securityAlertId - The security alert ID for this batch.\n * @param params.transactions - Array of transactions to process.\n * @param params.validateSecurity - Function to validate security for the transactions.\n * @returns Promise resolving to the generated batch ID for the transaction batch.\n */\nasync function processMultipleTransaction({\n  addTransactionBatch,\n  isAtomicBatchSupported,\n  chainId,\n  from,\n  getDismissSmartAccountSuggestionEnabled,\n  networkClientId,\n  messenger,\n  origin,\n  sendCalls,\n  securityAlertId,\n  transactions,\n  validateSecurity,\n}: {\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  chainId: Hex;\n  from: Hex;\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  sendCalls: SendCallsPayload;\n  securityAlertId: string;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n}) {\n  const batchSupport = await isAtomicBatchSupported({\n    address: from,\n    chainIds: [chainId],\n  });\n\n  const chainBatchSupport = batchSupport?.[0];\n\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  const dismissSmartAccountSuggestionEnabled =\n    getDismissSmartAccountSuggestionEnabled();\n\n  validateSendCalls(\n    sendCalls,\n    chainId,\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n\n  const result = await addTransactionBatch({\n    from,\n    networkClientId,\n    origin,\n    securityAlertId,\n    transactions,\n    validateSecurity,\n  });\n  return result.batchId;\n}\n\n/**\n * Generate a transaction batch ID.\n *\n * @returns  A unique batch ID as a hexadecimal string.\n */\nfunction generateBatchId(): Hex {\n  const idString = uuid();\n  const idBytes = new Uint8Array(parse(idString));\n  return bytesToHex(idBytes);\n}\n\n/**\n * Validates a single sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to.\n */\nfunction validateSingleSendCall(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  validateSendCallsVersion(sendCalls);\n  validateCapabilities(sendCalls);\n  validateDappChainId(sendCalls, dappChainId);\n}\n\n/**\n * Validates a sendCalls request for multiple transactions.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n */\nfunction validateSendCalls(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport);\n  validateCapabilities(sendCalls);\n  validateUpgrade(\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n}\n\n/**\n * Validates the version of a sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if the version is not supported.\n */\nfunction validateSendCallsVersion(sendCalls: SendCallsPayload) {\n  const { version } = sendCalls;\n\n  if (version !== VERSION) {\n    throw rpcErrors.invalidInput(\n      `Version not supported: Got ${version}, expected ${VERSION}`,\n    );\n  }\n}\n\n/**\n * Validates that the chain ID in the sendCalls request matches the dApp's selected network.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @throws JsonRpcError if the chain IDs don't match\n */\nfunction validateDappChainId(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  const { chainId: requestChainId } = sendCalls;\n\n  if (\n    requestChainId &&\n    requestChainId.toLowerCase() !== dappChainId.toLowerCase()\n  ) {\n    throw rpcErrors.invalidParams(\n      `Chain ID must match the dApp selected network: Got ${requestChainId}, expected ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates the chain ID for sendCalls requests with additional EIP-7702 support checks.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param chainBatchSupport - Information about atomic batch support for the chain\n * @throws JsonRpcError if the chain ID doesn't match or EIP-7702 is not supported\n */\nfunction validateSendCallsChainId(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n) {\n  validateDappChainId(sendCalls, dappChainId);\n  if (!chainBatchSupport) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedChainId,\n      `EIP-7702 not supported on chain: ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates that all required capabilities in the sendCalls request are supported.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if unsupported non-optional capabilities are requested.\n */\nfunction validateCapabilities(sendCalls: SendCallsPayload) {\n  const { calls, capabilities } = sendCalls;\n\n  const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter(\n    (name) => capabilities?.[name].optional !== true,\n  );\n\n  const requiredCallCapabilities = calls.flatMap((call) =>\n    Object.keys(call.capabilities ?? {}).filter(\n      (name) => call.capabilities?.[name].optional !== true,\n    ),\n  );\n\n  const requiredCapabilities = [\n    ...requiredTopLevelCapabilities,\n    ...requiredCallCapabilities,\n  ];\n\n  if (requiredCapabilities?.length) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capabilities: ${requiredCapabilities.join(\n        ', ',\n      )}`,\n    );\n  }\n}\n\n/**\n * Validates whether an EIP-7702 upgrade is allowed for the given parameters.\n *\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @throws JsonRpcError if the upgrade is rejected due to user settings or account type.\n */\nfunction validateUpgrade(\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  if (chainBatchSupport?.delegationAddress) {\n    return;\n  }\n\n  if (dismissSmartAccountSuggestionEnabled) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade disabled by the user',\n    );\n  }\n\n  if (!KEYRING_TYPES_SUPPORTING_7702.includes(keyringType)) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade not supported on account',\n    );\n  }\n}\n"]}
+{"version":3,"file":"processSendCalls.mjs","sourceRoot":"","sources":["../../src/hooks/processSendCalls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,6BAA6B;AAQ/D,OAAO,EAAE,uBAAuB,EAAE,yCAAyC;AAE3E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB;;;AAEpD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,aAAa;AAEzC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,WAAW,EACX,qBAAqB,EACrB,OAAO,EACR,yBAAqB;AAOtB,OAAO,EAAE,qBAAqB,EAAE,qBAAiB;AAkCjD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA4B,EAC5B,SAA2B,EAC3B,MAAwB,EACxB,GAA4B;IAE5B,MAAM,EACJ,mBAAmB,EACnB,cAAc,EACd,uCAAuC,EACvC,sBAAsB,EACtB,gBAAgB,EAAE,oBAAoB,EACtC,yBAAyB,GAC1B,GAAG,KAAK,CAAC;IAEV,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACxC,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE7D,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAChC,wCAAwC,EACxC,eAAe,CAChB,CAAC,aAAa,CAAC;IAEhB,MAAM,IAAI,GACR,SAAS;QACR,SAAS,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,OAAe,CAAC;IAE3E,MAAM,eAAe,GAAG,IAAI,EAAE,CAAC;IAC/B,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAE1E,IAAI,OAAY,CAAC;IACjB,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;QAC1C,OAAO,GAAG,MAAM,wBAAwB,CAAC;YACvC,cAAc;YACd,OAAO;YACP,IAAI;YACJ,SAAS;YACT,eAAe;YACf,MAAM;YACN,eAAe;YACf,SAAS,EAAE,MAAM;YACjB,YAAY;YACZ,gBAAgB;YAChB,yBAAyB;SAC1B,CAAC,CAAC;KACJ;SAAM;QACL,OAAO,GAAG,MAAM,0BAA0B,CAAC;YACzC,mBAAmB;YACnB,sBAAsB;YACtB,OAAO;YACP,IAAI;YACJ,uCAAuC;YACvC,SAAS;YACT,eAAe;YACf,MAAM;YACN,SAAS,EAAE,MAAM;YACjB,eAAe;YACf,YAAY;YACZ,gBAAgB;YAChB,yBAAyB;SAC1B,CAAC,CAAC;KACJ;IAED,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,KAAK,UAAU,wBAAwB,CAAC,EACtC,cAAc,EACd,OAAO,EACP,IAAI,EACJ,SAAS,EACT,eAAe,EACf,MAAM,EACN,eAAe,EACf,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,GAgB1B;IACC,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAE3D,sBAAsB,CACpB,SAAS,EACT,OAAO,EACP,WAAW,EACX,yBAAyB,CAC1B,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,IAAI;QACJ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM;QACzB,IAAI,EAAE,uBAAuB,CAAC,SAAS;KACxC,CAAC;IAEF,MAAM,eAAe,GAA4B;QAC/C,MAAM,EAAE,WAAW,CAAC,eAAe;QACnC,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,MAAM;KACP,CAAC;IACF,gBAAgB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE3C,kCAAkC,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAElC,MAAM,cAAc,CAAC,QAAQ,EAAE;QAC7B,eAAe;QACf,MAAM;QACN,qBAAqB,EAAE,EAAE,eAAe,EAA2B;QACnE,OAAO;KACR,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,KAAK,UAAU,0BAA0B,CAAC,EACxC,mBAAmB,EACnB,sBAAsB,EACtB,OAAO,EACP,IAAI,EACJ,uCAAuC,EACvC,eAAe,EACf,SAAS,EACT,MAAM,EACN,SAAS,EACT,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,GAkB1B;IACC,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC;QAChD,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAE3D,MAAM,oCAAoC,GACxC,uCAAuC,EAAE,CAAC;IAE5C,iBAAiB,CACf,SAAS,EACT,OAAO,EACP,oCAAoC,EACpC,iBAAiB,EACjB,WAAW,EACX,yBAAyB,CAC1B,CAAC;IAEF,kCAAkC,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,IAAI;QACJ,eAAe;QACf,MAAM;QACN,eAAe;QACf,YAAY;QACZ,gBAAgB;KACjB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAC7B,SAA2B,EAC3B,WAAgB,EAChB,WAAyB,EACzB,yBAAoD;IAEpD,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACpC,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC;IACxE,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CACxB,SAA2B,EAC3B,WAAgB,EAChB,oCAA6C,EAC7C,iBAAgE,EAChE,WAAyB,EACzB,yBAAoD;IAEpD,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACpC,wBAAwB,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACpE,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC;IACxE,eAAe,CACb,oCAAoC,EACpC,iBAAiB,EACjB,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,SAA2B;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAE9B,IAAI,OAAO,KAAK,OAAO,EAAE;QACvB,MAAM,SAAS,CAAC,YAAY,CAC1B,8BAA8B,OAAO,cAAc,OAAO,EAAE,CAC7D,CAAC;KACH;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,SAA2B,EAAE,WAAgB;IACxE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IAE9C,IACE,cAAc;QACd,cAAc,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,EAC1D;QACA,MAAM,SAAS,CAAC,aAAa,CAC3B,sDAAsD,cAAc,cAAc,WAAW,EAAE,CAChG,CAAC;KACH;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,SAA2B,EAC3B,WAAgB,EAChB,iBAAgE;IAEhE,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,iBAAiB,EAAE;QACtB,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,kBAAkB,EACnC,oCAAoC,WAAW,EAAE,CAClD,CAAC;KACH;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAC3B,SAA2B,EAC3B,WAAyB,EACzB,yBAAoD;IAEpD,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAEnD,MAAM,4BAA4B,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CACzE,CAAC,IAAI,EAAE,EAAE;IACP,wFAAwF;IACxF,IAAI,KAAK,qBAAqB,CAAC,cAAc,CAAC,QAAQ,EAAE;QACxD,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CACzC,CAAC;IAEF,MAAM,wBAAwB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACtD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CACzC,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,KAAK,qBAAqB,CAAC,cAAc,CAAC,QAAQ,EAAE;QACxD,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAC9C,CACF,CAAC;IAEF,MAAM,oBAAoB,GAAG;QAC3B,GAAG,4BAA4B;QAC/B,GAAG,wBAAwB;KAC5B,CAAC;IAEF,IAAI,oBAAoB,EAAE,MAAM,EAAE;QAChC,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,gCAAgC,EACjD,0CAA0C,oBAAoB,CAAC,IAAI,CACjE,IAAI,CACL,EAAE,CACJ,CAAC;KACH;IAED,IAAI,YAAY,EAAE,cAAc,EAAE;QAChC,wCAAwC,CAAC;YACvC,cAAc,EAAE,YAAY,CAAC,cAAc;YAC3C,OAAO;YACP,WAAW;YACX,yBAAyB;SAC1B,CAAC,CAAC;KACJ;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,wCAAwC,CAAC,EAChD,cAAc,EACd,OAAO,EACP,WAAW,EACX,yBAAyB,GAS1B;IACC,2HAA2H;IAC3H,6HAA6H;IAC7H,IAAI,cAAc,CAAC,QAAQ,EAAE;QAC3B,OAAO;KACR;IACD,MAAM,kBAAkB,GACtB,6BAA6B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEtD,IAAI,CAAC,kBAAkB,EAAE;QACvB,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,gCAAgC,EACjD,wCAAwC,qBAAqB,CAAC,cAAc,EAAE,CAC/E,CAAC;KACH;IAED,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE;QACvC,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,gBAAgB,EACjC,yEAAyE,OAAO,EAAE,CACnF,CAAC;KACH;IAED,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE;QACnC,OAAO;KACR;IAED,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,cAAc,EAAE;QACjD,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE;YAC9B,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,gBAAgB,EACjC,uBAAuB,KAAK,CAAC,OAAO,4FAA4F,KAAK,CAAC,QAAQ,EAAE,CACjJ,CAAC;SACH;KACF;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,oCAA6C,EAC7C,iBAAgE,EAChE,WAAyB;IAEzB,IAAI,iBAAiB,EAAE,iBAAiB,EAAE;QACxC,OAAO;KACR;IAED,IAAI,oCAAoC,EAAE;QACxC,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,eAAe,EAChC,uCAAuC,CACxC,CAAC;KACH;IAED,IAAI,CAAC,6BAA6B,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACxD,MAAM,IAAI,YAAY,CACpB,gBAAgB,CAAC,eAAe,EAChC,2CAA2C,CAC5C,CAAC;KACH;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,kCAAkC,CAAC,SAA2B;IACrE,IAAI,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE;QAC1D,MAAM,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC;QACjE,0DAA0D;QAC1D,MAAM,OAAO,GAAG,OAAO,CACrB,cAAc,EACd,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAC9D,CAAC;QAEF,4DAA4D;QAC5D,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;gBACtB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;aACjB;YAED,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC9C,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC,EAAE,EAAE,CAAC,CAAC;YAEP,OAAO;gBACL,GAAG,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;aACxC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC,cAAc,GAAG,kBAAkB,CAAC;KAC3E;AACH,CAAC","sourcesContent":["import type { KeyringTypes } from '@metamask/keyring-controller';\nimport { JsonRpcError, rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  BatchTransactionParams,\n  IsAtomicBatchSupportedResultEntry,\n  SecurityAlertResponse,\n  TransactionController,\n  ValidateSecurityRequest,\n} from '@metamask/transaction-controller';\nimport { TransactionEnvelopeType } from '@metamask/transaction-controller';\nimport type { Hex, JsonRpcRequest } from '@metamask/utils';\nimport { add0x, bytesToHex } from '@metamask/utils';\nimport { groupBy } from 'lodash';\nimport { parse, v4 as uuid } from 'uuid';\n\nimport {\n  EIP5792ErrorCode,\n  EIP7682ErrorCode,\n  KEYRING_TYPES_SUPPORTING_7702,\n  MessageType,\n  SupportedCapabilities,\n  VERSION,\n} from '../constants';\nimport type {\n  EIP5792Messenger,\n  SendCallsPayload,\n  SendCallsRequiredAssetsParam,\n  SendCallsResult,\n} from '../types';\nimport { getAccountKeyringType } from '../utils';\n\n/**\n * Type definition for required controller hooks and utilities of {@link processSendCalls}\n */\nexport type ProcessSendCallsHooks = {\n  /** Function to add a batch of transactions atomically */\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  /** Function to add a single transaction */\n  addTransaction: TransactionController['addTransaction'];\n  /** Function to check if smart account suggestions are disabled */\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  /** Function to check if atomic batching is supported for given parameters */\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  /** Function to validate security for transaction requests */\n  validateSecurity: (\n    securityAlertId: string,\n    request: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n  /** Function to validate if auxiliary funds capability is supported. */\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n};\n\n/**\n * A valid JSON-RPC request object for `wallet_sendCalls`.\n */\nexport type ProcessSendCallsRequest = JsonRpcRequest & {\n  /** The identifier for the network client that has been created for this RPC endpoint */\n  networkClientId: string;\n  /** The origin of the RPC request */\n  origin?: string;\n};\n\n/**\n * Processes a sendCalls request for EIP-5792 transactions.\n *\n * @param hooks - Object containing required controller hooks and utilities.\n * @param messenger - Messenger instance for controller communication.\n * @param params - The sendCalls parameters containing transaction calls and metadata.\n * @param req - The original JSON-RPC request.\n * @returns Promise resolving to a SendCallsResult containing the batch ID.\n */\nexport async function processSendCalls(\n  hooks: ProcessSendCallsHooks,\n  messenger: EIP5792Messenger,\n  params: SendCallsPayload,\n  req: ProcessSendCallsRequest,\n): Promise<SendCallsResult> {\n  const {\n    addTransactionBatch,\n    addTransaction,\n    getDismissSmartAccountSuggestionEnabled,\n    isAtomicBatchSupported,\n    validateSecurity: validateSecurityHook,\n    isAuxiliaryFundsSupported,\n  } = hooks;\n\n  const { calls, from: paramFrom } = params;\n  const { networkClientId, origin } = req;\n  const transactions = calls.map((call) => ({ params: call }));\n\n  const { chainId } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  ).configuration;\n\n  const from =\n    paramFrom ??\n    (messenger.call('AccountsController:getSelectedAccount').address as Hex);\n\n  const securityAlertId = uuid();\n  const validateSecurity = validateSecurityHook.bind(null, securityAlertId);\n\n  let batchId: Hex;\n  if (Object.keys(transactions).length === 1) {\n    batchId = await processSingleTransaction({\n      addTransaction,\n      chainId,\n      from,\n      messenger,\n      networkClientId,\n      origin,\n      securityAlertId,\n      sendCalls: params,\n      transactions,\n      validateSecurity,\n      isAuxiliaryFundsSupported,\n    });\n  } else {\n    batchId = await processMultipleTransaction({\n      addTransactionBatch,\n      isAtomicBatchSupported,\n      chainId,\n      from,\n      getDismissSmartAccountSuggestionEnabled,\n      messenger,\n      networkClientId,\n      origin,\n      sendCalls: params,\n      securityAlertId,\n      transactions,\n      validateSecurity,\n      isAuxiliaryFundsSupported,\n    });\n  }\n\n  return { id: batchId };\n}\n\n/**\n * Processes a single transaction from a sendCalls request.\n *\n * @param params - Object containing all parameters needed for single transaction processing.\n * @param params.addTransaction - Function to add a single transaction.\n * @param params.chainId - The chain ID for the transaction.\n * @param params.from - The sender address.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.networkClientId - The network client ID.\n * @param params.origin - The origin of the request (optional).\n * @param params.securityAlertId - The security alert ID for this transaction.\n * @param params.sendCalls - The original sendCalls request.\n * @param params.transactions - Array containing the single transaction.\n * @param params.validateSecurity - Function to validate security for the transaction.\n * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @returns Promise resolving to the generated batch ID for the transaction.\n */\nasync function processSingleTransaction({\n  addTransaction,\n  chainId,\n  from,\n  messenger,\n  networkClientId,\n  origin,\n  securityAlertId,\n  sendCalls,\n  transactions,\n  validateSecurity,\n  isAuxiliaryFundsSupported,\n}: {\n  addTransaction: TransactionController['addTransaction'];\n  chainId: Hex;\n  from: Hex;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  securityAlertId: string;\n  sendCalls: SendCallsPayload;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => void;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  validateSingleSendCall(\n    sendCalls,\n    chainId,\n    keyringType,\n    isAuxiliaryFundsSupported,\n  );\n\n  const txParams = {\n    from,\n    ...transactions[0].params,\n    type: TransactionEnvelopeType.feeMarket,\n  };\n\n  const securityRequest: ValidateSecurityRequest = {\n    method: MessageType.SendTransaction,\n    params: [txParams],\n    origin,\n  };\n  validateSecurity(securityRequest, chainId);\n\n  dedupeAuxiliaryFundsRequiredAssets(sendCalls);\n\n  const batchId = generateBatchId();\n\n  await addTransaction(txParams, {\n    networkClientId,\n    origin,\n    securityAlertResponse: { securityAlertId } as SecurityAlertResponse,\n    batchId,\n  });\n  return batchId;\n}\n\n/**\n * Processes multiple transactions from a sendCalls request as an atomic batch.\n *\n * @param params - Object containing all parameters needed for multiple transaction processing.\n * @param params.addTransactionBatch - Function to add a batch of transactions atomically.\n * @param params.isAtomicBatchSupported - Function to check if atomic batching is supported.\n * @param params.chainId - The chain ID for the transactions.\n * @param params.from - The sender address.\n * @param params.getDismissSmartAccountSuggestionEnabled - Function to check if smart account suggestions are disabled.\n * @param params.networkClientId - The network client ID.\n * @param params.messenger - Messenger instance for controller communication.\n * @param params.origin - The origin of the request (optional).\n * @param params.sendCalls - The original sendCalls request.\n * @param params.securityAlertId - The security alert ID for this batch.\n * @param params.transactions - Array of transactions to process.\n * @param params.validateSecurity - Function to validate security for the transactions.\n * @param params.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @returns Promise resolving to the generated batch ID for the transaction batch.\n */\nasync function processMultipleTransaction({\n  addTransactionBatch,\n  isAtomicBatchSupported,\n  chainId,\n  from,\n  getDismissSmartAccountSuggestionEnabled,\n  networkClientId,\n  messenger,\n  origin,\n  sendCalls,\n  securityAlertId,\n  transactions,\n  validateSecurity,\n  isAuxiliaryFundsSupported,\n}: {\n  addTransactionBatch: TransactionController['addTransactionBatch'];\n  isAtomicBatchSupported: TransactionController['isAtomicBatchSupported'];\n  chainId: Hex;\n  from: Hex;\n  getDismissSmartAccountSuggestionEnabled: () => boolean;\n  messenger: EIP5792Messenger;\n  networkClientId: string;\n  origin?: string;\n  sendCalls: SendCallsPayload;\n  securityAlertId: string;\n  transactions: { params: BatchTransactionParams }[];\n  validateSecurity: (\n    securityRequest: ValidateSecurityRequest,\n    chainId: Hex,\n  ) => Promise<void>;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  const batchSupport = await isAtomicBatchSupported({\n    address: from,\n    chainIds: [chainId],\n  });\n\n  const chainBatchSupport = batchSupport?.[0];\n\n  const keyringType = getAccountKeyringType(from, messenger);\n\n  const dismissSmartAccountSuggestionEnabled =\n    getDismissSmartAccountSuggestionEnabled();\n\n  validateSendCalls(\n    sendCalls,\n    chainId,\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n    isAuxiliaryFundsSupported,\n  );\n\n  dedupeAuxiliaryFundsRequiredAssets(sendCalls);\n\n  const result = await addTransactionBatch({\n    from,\n    networkClientId,\n    origin,\n    securityAlertId,\n    transactions,\n    validateSecurity,\n  });\n  return result.batchId;\n}\n\n/**\n * Generate a transaction batch ID.\n *\n * @returns  A unique batch ID as a hexadecimal string.\n */\nfunction generateBatchId(): Hex {\n  const idString = uuid();\n  const idBytes = new Uint8Array(parse(idString));\n  return bytesToHex(idBytes);\n}\n\n/**\n * Validates a single sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n */\nfunction validateSingleSendCall(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);\n  validateDappChainId(sendCalls, dappChainId);\n}\n\n/**\n * Validates a sendCalls request for multiple transactions.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n */\nfunction validateSendCalls(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  validateSendCallsVersion(sendCalls);\n  validateSendCallsChainId(sendCalls, dappChainId, chainBatchSupport);\n  validateCapabilities(sendCalls, keyringType, isAuxiliaryFundsSupported);\n  validateUpgrade(\n    dismissSmartAccountSuggestionEnabled,\n    chainBatchSupport,\n    keyringType,\n  );\n}\n\n/**\n * Validates the version of a sendCalls request.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @throws JsonRpcError if the version is not supported.\n */\nfunction validateSendCallsVersion(sendCalls: SendCallsPayload) {\n  const { version } = sendCalls;\n\n  if (version !== VERSION) {\n    throw rpcErrors.invalidInput(\n      `Version not supported: Got ${version}, expected ${VERSION}`,\n    );\n  }\n}\n\n/**\n * Validates that the chain ID in the sendCalls request matches the dApp's selected network.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @throws JsonRpcError if the chain IDs don't match\n */\nfunction validateDappChainId(sendCalls: SendCallsPayload, dappChainId: Hex) {\n  const { chainId: requestChainId } = sendCalls;\n\n  if (\n    requestChainId &&\n    requestChainId.toLowerCase() !== dappChainId.toLowerCase()\n  ) {\n    throw rpcErrors.invalidParams(\n      `Chain ID must match the dApp selected network: Got ${requestChainId}, expected ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates the chain ID for sendCalls requests with additional EIP-7702 support checks.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param dappChainId - The chain ID that the dApp is connected to\n * @param chainBatchSupport - Information about atomic batch support for the chain\n * @throws JsonRpcError if the chain ID doesn't match or EIP-7702 is not supported\n */\nfunction validateSendCallsChainId(\n  sendCalls: SendCallsPayload,\n  dappChainId: Hex,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n) {\n  validateDappChainId(sendCalls, dappChainId);\n  if (!chainBatchSupport) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedChainId,\n      `EIP-7702 not supported on chain: ${dappChainId}`,\n    );\n  }\n}\n\n/**\n * Validates that all required capabilities in the sendCalls request are supported.\n *\n * @param sendCalls - The sendCalls request to validate.\n * @param keyringType - The type of keyring associated with the account.\n * @param isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n *\n * @throws JsonRpcError if unsupported non-optional capabilities are requested.\n */\nfunction validateCapabilities(\n  sendCalls: SendCallsPayload,\n  keyringType: KeyringTypes,\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean,\n) {\n  const { calls, capabilities, chainId } = sendCalls;\n\n  const requiredTopLevelCapabilities = Object.keys(capabilities ?? {}).filter(\n    (name) =>\n      // Non optional capabilities other than `auxiliaryFunds` are not supported by the wallet\n      name !== SupportedCapabilities.AuxiliaryFunds.toString() &&\n      capabilities?.[name].optional !== true,\n  );\n\n  const requiredCallCapabilities = calls.flatMap((call) =>\n    Object.keys(call.capabilities ?? {}).filter(\n      (name) =>\n        name !== SupportedCapabilities.AuxiliaryFunds.toString() &&\n        call.capabilities?.[name].optional !== true,\n    ),\n  );\n\n  const requiredCapabilities = [\n    ...requiredTopLevelCapabilities,\n    ...requiredCallCapabilities,\n  ];\n\n  if (requiredCapabilities?.length) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capabilities: ${requiredCapabilities.join(\n        ', ',\n      )}`,\n    );\n  }\n\n  if (capabilities?.auxiliaryFunds) {\n    validateAuxFundsSupportAndRequiredAssets({\n      auxiliaryFunds: capabilities.auxiliaryFunds,\n      chainId,\n      keyringType,\n      isAuxiliaryFundsSupported,\n    });\n  }\n}\n\n/**\n * Validates EIP-7682 optional `requiredAssets` to see if the account and chain are supported, and that param is well-formed.\n *\n * docs: {@link https://eips.ethereum.org/EIPS/eip-7682#extended-usage-requiredassets-parameter}\n *\n * @param param - The parameter object.\n * @param param.auxiliaryFunds - The auxiliaryFunds param to validate.\n * @param param.auxiliaryFunds.optional - Metadata to signal for wallets that support this optional capability, while maintaining compatibility with wallets that do not.\n * @param param.auxiliaryFunds.requiredAssets - Metadata that enables a wallets support for `auxiliaryFunds` capability.\n * @param param.chainId - The chain ID of the incoming request.\n * @param param.keyringType - The type of keyring associated with the account.\n * @param param.isAuxiliaryFundsSupported - Function to validate if auxiliary funds capability is supported.\n * @throws JsonRpcError if auxiliary funds capability is not supported.\n */\nfunction validateAuxFundsSupportAndRequiredAssets({\n  auxiliaryFunds,\n  chainId,\n  keyringType,\n  isAuxiliaryFundsSupported,\n}: {\n  auxiliaryFunds: {\n    optional?: boolean;\n    requiredAssets?: SendCallsRequiredAssetsParam[];\n  };\n  chainId: Hex;\n  keyringType: KeyringTypes;\n  isAuxiliaryFundsSupported: (chainId: Hex) => boolean;\n}) {\n  // If we can make use of that capability then we should, but otherwise we can process the request and ignore the capability\n  // so if the capability is signaled as optional, no validation is required, so we don't block the transaction from happening.\n  if (auxiliaryFunds.optional) {\n    return;\n  }\n  const isSupportedAccount =\n    KEYRING_TYPES_SUPPORTING_7702.includes(keyringType);\n\n  if (!isSupportedAccount) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.UnsupportedNonOptionalCapability,\n      `Unsupported non-optional capability: ${SupportedCapabilities.AuxiliaryFunds}`,\n    );\n  }\n\n  if (!isAuxiliaryFundsSupported(chainId)) {\n    throw new JsonRpcError(\n      EIP7682ErrorCode.UnsupportedChain,\n      `The wallet no longer supports auxiliary funds on the requested chain: ${chainId}`,\n    );\n  }\n\n  if (!auxiliaryFunds?.requiredAssets) {\n    return;\n  }\n\n  for (const asset of auxiliaryFunds.requiredAssets) {\n    if (asset.standard !== 'erc20') {\n      throw new JsonRpcError(\n        EIP7682ErrorCode.UnsupportedAsset,\n        `The requested asset ${asset.address} is not available through the wallet’s auxiliary fund system: unsupported token standard ${asset.standard}`,\n      );\n    }\n  }\n}\n\n/**\n * Validates whether an EIP-7702 upgrade is allowed for the given parameters.\n *\n * @param dismissSmartAccountSuggestionEnabled - Whether smart account suggestions are disabled.\n * @param chainBatchSupport - Information about atomic batch support for the chain.\n * @param keyringType - The type of keyring associated with the account.\n * @throws JsonRpcError if the upgrade is rejected due to user settings or account type.\n */\nfunction validateUpgrade(\n  dismissSmartAccountSuggestionEnabled: boolean,\n  chainBatchSupport: IsAtomicBatchSupportedResultEntry | undefined,\n  keyringType: KeyringTypes,\n) {\n  if (chainBatchSupport?.delegationAddress) {\n    return;\n  }\n\n  if (dismissSmartAccountSuggestionEnabled) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade disabled by the user',\n    );\n  }\n\n  if (!KEYRING_TYPES_SUPPORTING_7702.includes(keyringType)) {\n    throw new JsonRpcError(\n      EIP5792ErrorCode.RejectedUpgrade,\n      'EIP-7702 upgrade not supported on account',\n    );\n  }\n}\n\n/**\n * Function to possibly deduplicate `auxiliaryFunds` capability `requiredAssets`.\n * Does nothing if no `requiredAssets` exists in `auxiliaryFunds` capability.\n *\n * @param sendCalls - The original sendCalls request.\n */\nfunction dedupeAuxiliaryFundsRequiredAssets(sendCalls: SendCallsPayload): void {\n  if (sendCalls.capabilities?.auxiliaryFunds?.requiredAssets) {\n    const { requiredAssets } = sendCalls.capabilities.auxiliaryFunds;\n    // Group assets by their address (lowercased) and standard\n    const grouped = groupBy(\n      requiredAssets,\n      (asset) => `${asset.address.toLowerCase()}-${asset.standard}`,\n    );\n\n    // For each group, sum the amounts and return a single asset\n    const deduplicatedAssets = Object.values(grouped).map((group) => {\n      if (group.length === 1) {\n        return group[0];\n      }\n\n      const totalAmount = group.reduce((sum, asset) => {\n        return sum + BigInt(asset.amount);\n      }, 0n);\n\n      return {\n        ...group[0],\n        amount: add0x(totalAmount.toString(16)),\n      };\n    });\n\n    sendCalls.capabilities.auxiliaryFunds.requiredAssets = deduplicatedAssets;\n  }\n}\n"]}

package/dist/types.cjs

@@ -11,8 +11,14 @@ exports.GetCapabilitiesStruct = (0, superstruct_1.tuple)([
     utils_1.HexChecksumAddressStruct,
     (0, superstruct_1.optional)((0, superstruct_1.array)(utils_1.StrictHexStruct)),
 ]);
+const RequiredAssetStruct = (0, superstruct_1.type)({
+    address: (0, superstruct_1.nonempty)(utils_1.HexChecksumAddressStruct),
+    amount: (0, superstruct_1.nonempty)(utils_1.StrictHexStruct),
+    standard: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+});
 exports.CapabilitiesStruct = (0, superstruct_1.record)((0, superstruct_1.string)(), (0, superstruct_1.type)({
     optional: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    requiredAssets: (0, superstruct_1.optional)((0, superstruct_1.array)(RequiredAssetStruct)),
 }));
 exports.SendCallsStruct = (0, superstruct_1.tuple)([
     (0, superstruct_1.object)({

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAWA,uDAU+B;AAG/B,2CAA4E;AAiE5E,kBAAkB;AAClB,0FAA0F;AAC1F,+CAA+C;AAClC,QAAA,oBAAoB,GAAG,IAAA,mBAAK,EAAC,CAAC,uBAAe,CAAC,CAAC,CAAC;AAEhD,QAAA,qBAAqB,GAAG,IAAA,mBAAK,EAAC;IACzC,gCAAwB;IACxB,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,uBAAe,CAAC,CAAC;CACjC,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAG,IAAA,oBAAM,EACtC,IAAA,oBAAM,GAAE,EACR,IAAA,kBAAI,EAAC;IACH,QAAQ,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;CAC9B,CAAC,CACH,CAAC;AAEW,QAAA,eAAe,GAAG,IAAA,mBAAK,EAAC;IACnC,IAAA,oBAAM,EAAC;QACL,OAAO,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;QAC3B,EAAE,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;QAC7B,IAAI,EAAE,IAAA,sBAAQ,EAAC,gCAAwB,CAAC;QACxC,OAAO,EAAE,uBAAe;QACxB,cAAc,EAAE,IAAA,qBAAO,GAAE;QACzB,KAAK,EAAE,IAAA,mBAAK,EACV,IAAA,oBAAM,EAAC;YACL,EAAE,EAAE,IAAA,sBAAQ,EAAC,gCAAwB,CAAC;YACtC,IAAI,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;YAC/B,KAAK,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;YAChC,YAAY,EAAE,IAAA,sBAAQ,EAAC,0BAAkB,CAAC;SAC3C,CAAC,CACH;QACD,YAAY,EAAE,IAAA,sBAAQ,EAAC,0BAAkB,CAAC;KAC3C,CAAC;CACH,CAAC,CAAC","sourcesContent":["import type {\n  AccountsControllerGetSelectedAccountAction,\n  AccountsControllerGetStateAction,\n} from '@metamask/accounts-controller';\nimport type { Messenger } from '@metamask/base-controller';\nimport type {\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetStateAction,\n} from '@metamask/network-controller';\nimport type { PreferencesControllerGetStateAction } from '@metamask/preferences-controller';\nimport type { Infer } from '@metamask/superstruct';\nimport {\n  array,\n  boolean,\n  nonempty,\n  object,\n  optional,\n  record,\n  string,\n  tuple,\n  type,\n} from '@metamask/superstruct';\nimport type { TransactionControllerGetStateAction } from '@metamask/transaction-controller';\nimport type { Hex, Json, JsonRpcRequest } from '@metamask/utils';\nimport { HexChecksumAddressStruct, StrictHexStruct } from '@metamask/utils';\n\ntype Actions =\n  | AccountsControllerGetStateAction\n  | AccountsControllerGetSelectedAccountAction\n  | NetworkControllerGetNetworkClientByIdAction\n  | TransactionControllerGetStateAction\n  | PreferencesControllerGetStateAction\n  | NetworkControllerGetStateAction;\n\nexport type EIP5792Messenger = Messenger<Actions, never>;\n\n// wallet_getCallStatus\nexport type GetCallsStatusParams = Infer<typeof GetCallsStatusStruct>;\n\nexport type GetCallsStatusResult = {\n  version: string;\n  id: Hex;\n  chainId: Hex;\n  status: number;\n  atomic: boolean;\n  receipts?: {\n    logs: {\n      address: Hex;\n      data: Hex;\n      topics: Hex[];\n    }[];\n    status: '0x0' | '0x1';\n    blockHash: Hex;\n    blockNumber: Hex;\n    gasUsed: Hex;\n    transactionHash: Hex;\n  }[];\n  capabilities?: Record<string, Json>;\n};\n\nexport type GetCallsStatusHook = (\n  id: GetCallsStatusParams[0],\n  req: JsonRpcRequest,\n) => Promise<GetCallsStatusResult>;\n\n// wallet_getCapabilities\nexport type GetCapabilitiesParams = Infer<typeof GetCapabilitiesStruct>;\nexport type GetCapabilitiesResult = Record<Hex, Record<string, Json>>;\n\nexport type GetCapabilitiesHook = (\n  address: GetCapabilitiesParams[0],\n  chainIds: GetCapabilitiesParams[1],\n  req: JsonRpcRequest,\n) => Promise<GetCapabilitiesResult>;\n\n// wallet_sendCalls\nexport type SendCallsParams = Infer<typeof SendCallsStruct>;\nexport type SendCallsPayload = SendCallsParams[0];\n\nexport type SendCallsResult = {\n  id: Hex;\n  capabilities?: Record<string, Json>;\n};\n\nexport type ProcessSendCallsHook = (\n  sendCalls: SendCallsPayload,\n  req: JsonRpcRequest,\n) => Promise<SendCallsResult>;\n\n// /** Structs **/\n// Even though these aren't actually typescript types, these structs essentially represent\n// runtime types, so we keep them in this file.\nexport const GetCallsStatusStruct = tuple([StrictHexStruct]);\n\nexport const GetCapabilitiesStruct = tuple([\n  HexChecksumAddressStruct,\n  optional(array(StrictHexStruct)),\n]);\n\nexport const CapabilitiesStruct = record(\n  string(),\n  type({\n    optional: optional(boolean()),\n  }),\n);\n\nexport const SendCallsStruct = tuple([\n  object({\n    version: nonempty(string()),\n    id: optional(StrictHexStruct),\n    from: optional(HexChecksumAddressStruct),\n    chainId: StrictHexStruct,\n    atomicRequired: boolean(),\n    calls: array(\n      object({\n        to: optional(HexChecksumAddressStruct),\n        data: optional(StrictHexStruct),\n        value: optional(StrictHexStruct),\n        capabilities: optional(CapabilitiesStruct),\n      }),\n    ),\n    capabilities: optional(CapabilitiesStruct),\n  }),\n]);\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAWA,uDAU+B;AAG/B,2CAA4E;AAmE5E,kBAAkB;AAClB,0FAA0F;AAC1F,+CAA+C;AAClC,QAAA,oBAAoB,GAAG,IAAA,mBAAK,EAAC,CAAC,uBAAe,CAAC,CAAC,CAAC;AAEhD,QAAA,qBAAqB,GAAG,IAAA,mBAAK,EAAC;IACzC,gCAAwB;IACxB,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,uBAAe,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAA,kBAAI,EAAC;IAC/B,OAAO,EAAE,IAAA,sBAAQ,EAAC,gCAAwB,CAAC;IAC3C,MAAM,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IACjC,QAAQ,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC7B,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAG,IAAA,oBAAM,EACtC,IAAA,oBAAM,GAAE,EACR,IAAA,kBAAI,EAAC;IACH,QAAQ,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;IAC7B,cAAc,EAAE,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,mBAAmB,CAAC,CAAC;CACrD,CAAC,CACH,CAAC;AAEW,QAAA,eAAe,GAAG,IAAA,mBAAK,EAAC;IACnC,IAAA,oBAAM,EAAC;QACL,OAAO,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;QAC3B,EAAE,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;QAC7B,IAAI,EAAE,IAAA,sBAAQ,EAAC,gCAAwB,CAAC;QACxC,OAAO,EAAE,uBAAe;QACxB,cAAc,EAAE,IAAA,qBAAO,GAAE;QACzB,KAAK,EAAE,IAAA,mBAAK,EACV,IAAA,oBAAM,EAAC;YACL,EAAE,EAAE,IAAA,sBAAQ,EAAC,gCAAwB,CAAC;YACtC,IAAI,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;YAC/B,KAAK,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;YAChC,YAAY,EAAE,IAAA,sBAAQ,EAAC,0BAAkB,CAAC;SAC3C,CAAC,CACH;QACD,YAAY,EAAE,IAAA,sBAAQ,EAAC,0BAAkB,CAAC;KAC3C,CAAC;CACH,CAAC,CAAC","sourcesContent":["import type {\n  AccountsControllerGetSelectedAccountAction,\n  AccountsControllerGetStateAction,\n} from '@metamask/accounts-controller';\nimport type { Messenger } from '@metamask/base-controller';\nimport type {\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetStateAction,\n} from '@metamask/network-controller';\nimport type { PreferencesControllerGetStateAction } from '@metamask/preferences-controller';\nimport type { Infer } from '@metamask/superstruct';\nimport {\n  array,\n  boolean,\n  nonempty,\n  object,\n  optional,\n  record,\n  string,\n  tuple,\n  type,\n} from '@metamask/superstruct';\nimport type { TransactionControllerGetStateAction } from '@metamask/transaction-controller';\nimport type { Hex, Json, JsonRpcRequest } from '@metamask/utils';\nimport { HexChecksumAddressStruct, StrictHexStruct } from '@metamask/utils';\n\ntype Actions =\n  | AccountsControllerGetStateAction\n  | AccountsControllerGetSelectedAccountAction\n  | NetworkControllerGetNetworkClientByIdAction\n  | TransactionControllerGetStateAction\n  | PreferencesControllerGetStateAction\n  | NetworkControllerGetStateAction;\n\nexport type EIP5792Messenger = Messenger<Actions, never>;\n\n// wallet_getCallStatus\nexport type GetCallsStatusParams = Infer<typeof GetCallsStatusStruct>;\n\nexport type GetCallsStatusResult = {\n  version: string;\n  id: Hex;\n  chainId: Hex;\n  status: number;\n  atomic: boolean;\n  receipts?: {\n    logs: {\n      address: Hex;\n      data: Hex;\n      topics: Hex[];\n    }[];\n    status: '0x0' | '0x1';\n    blockHash: Hex;\n    blockNumber: Hex;\n    gasUsed: Hex;\n    transactionHash: Hex;\n  }[];\n  capabilities?: Record<string, Json>;\n};\n\nexport type GetCallsStatusHook = (\n  id: GetCallsStatusParams[0],\n  req: JsonRpcRequest,\n) => Promise<GetCallsStatusResult>;\n\n// wallet_getCapabilities\nexport type GetCapabilitiesParams = Infer<typeof GetCapabilitiesStruct>;\nexport type GetCapabilitiesResult = Record<Hex, Record<string, Json>>;\n\nexport type GetCapabilitiesHook = (\n  address: GetCapabilitiesParams[0],\n  chainIds: GetCapabilitiesParams[1],\n  req: JsonRpcRequest,\n) => Promise<GetCapabilitiesResult>;\n\n// wallet_sendCalls\nexport type SendCallsParams = Infer<typeof SendCallsStruct>;\nexport type SendCallsPayload = SendCallsParams[0];\n\nexport type SendCallsRequiredAssetsParam = Infer<typeof RequiredAssetStruct>;\n\nexport type SendCallsResult = {\n  id: Hex;\n  capabilities?: Record<string, Json>;\n};\n\nexport type ProcessSendCallsHook = (\n  sendCalls: SendCallsPayload,\n  req: JsonRpcRequest,\n) => Promise<SendCallsResult>;\n\n// /** Structs **/\n// Even though these aren't actually typescript types, these structs essentially represent\n// runtime types, so we keep them in this file.\nexport const GetCallsStatusStruct = tuple([StrictHexStruct]);\n\nexport const GetCapabilitiesStruct = tuple([\n  HexChecksumAddressStruct,\n  optional(array(StrictHexStruct)),\n]);\n\nconst RequiredAssetStruct = type({\n  address: nonempty(HexChecksumAddressStruct),\n  amount: nonempty(StrictHexStruct),\n  standard: nonempty(string()),\n});\n\nexport const CapabilitiesStruct = record(\n  string(),\n  type({\n    optional: optional(boolean()),\n    requiredAssets: optional(array(RequiredAssetStruct)),\n  }),\n);\n\nexport const SendCallsStruct = tuple([\n  object({\n    version: nonempty(string()),\n    id: optional(StrictHexStruct),\n    from: optional(HexChecksumAddressStruct),\n    chainId: StrictHexStruct,\n    atomicRequired: boolean(),\n    calls: array(\n      object({\n        to: optional(HexChecksumAddressStruct),\n        data: optional(StrictHexStruct),\n        value: optional(StrictHexStruct),\n        capabilities: optional(CapabilitiesStruct),\n      }),\n    ),\n    capabilities: optional(CapabilitiesStruct),\n  }),\n]);\n"]}

package/dist/types.d.cts

@@ -34,6 +34,7 @@ export type GetCapabilitiesResult = Record<Hex, Record<string, Json>>;
 export type GetCapabilitiesHook = (address: GetCapabilitiesParams[0], chainIds: GetCapabilitiesParams[1], req: JsonRpcRequest) => Promise<GetCapabilitiesResult>;
 export type SendCallsParams = Infer<typeof SendCallsStruct>;
 export type SendCallsPayload = SendCallsParams[0];
+export type SendCallsRequiredAssetsParam = Infer<typeof RequiredAssetStruct>;
 export type SendCallsResult = {
     id: Hex;
     capabilities?: Record<string, Json>;
@@ -41,8 +42,22 @@ export type SendCallsResult = {
 export type ProcessSendCallsHook = (sendCalls: SendCallsPayload, req: JsonRpcRequest) => Promise<SendCallsResult>;
 export declare const GetCallsStatusStruct: import("@metamask/superstruct").Struct<[`0x${string}`], null>;
 export declare const GetCapabilitiesStruct: import("@metamask/superstruct").Struct<[`0x${string}`, `0x${string}`[] | undefined], null>;
+declare const RequiredAssetStruct: import("@metamask/superstruct").Struct<{
+    address: `0x${string}`;
+    standard: string;
+    amount: `0x${string}`;
+}, {
+    address: import("@metamask/superstruct").Struct<`0x${string}`, null>;
+    amount: import("@metamask/superstruct").Struct<`0x${string}`, null>;
+    standard: import("@metamask/superstruct").Struct<string, null>;
+}>;
 export declare const CapabilitiesStruct: import("@metamask/superstruct").Struct<Record<string, {
     optional?: boolean | undefined;
+    requiredAssets?: {
+        address: `0x${string}`;
+        standard: string;
+        amount: `0x${string}`;
+    }[] | undefined;
 }>, null>;
 export declare const SendCallsStruct: import("@metamask/superstruct").Struct<[{
     version: string;
@@ -54,12 +69,22 @@ export declare const SendCallsStruct: import("@metamask/superstruct").Struct<[{
         to?: `0x${string}` | undefined;
         capabilities?: Record<string, {
             optional?: boolean | undefined;
+            requiredAssets?: {
+                address: `0x${string}`;
+                standard: string;
+                amount: `0x${string}`;
+            }[] | undefined;
         }> | undefined;
     }[];
     id?: `0x${string}` | undefined;
     from?: `0x${string}` | undefined;
     capabilities?: Record<string, {
         optional?: boolean | undefined;
+        requiredAssets?: {
+            address: `0x${string}`;
+            standard: string;
+            amount: `0x${string}`;
+        }[] | undefined;
     }> | undefined;
 }], null>;
 export {};

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0CAA0C,EAC1C,gCAAgC,EACjC,sCAAsC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EACV,2CAA2C,EAC3C,+BAA+B,EAChC,qCAAqC;AACtC,OAAO,KAAK,EAAE,mCAAmC,EAAE,yCAAyC;AAC5F,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAYnD,OAAO,KAAK,EAAE,mCAAmC,EAAE,yCAAyC;AAC5F,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,wBAAwB;AAGjE,KAAK,OAAO,GACR,gCAAgC,GAChC,0CAA0C,GAC1C,2CAA2C,GAC3C,mCAAmC,GACnC,mCAAmC,GACnC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAGzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,GAAG,CAAC;IACR,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE;YACJ,OAAO,EAAE,GAAG,CAAC;YACb,IAAI,EAAE,GAAG,CAAC;YACV,MAAM,EAAE,GAAG,EAAE,CAAC;SACf,EAAE,CAAC;QACJ,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;QACtB,SAAS,EAAE,GAAG,CAAC;QACf,WAAW,EAAE,GAAG,CAAC;QACjB,OAAO,EAAE,GAAG,CAAC;QACb,eAAe,EAAE,GAAG,CAAC;KACtB,EAAE,CAAC;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAGnC,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACjC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAClC,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAGpC,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,GAAG,CAAC;IACR,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CACjC,SAAS,EAAE,gBAAgB,EAC3B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,eAAe,CAAC,CAAC;AAK9B,eAAO,MAAM,oBAAoB,+DAA2B,CAAC;AAE7D,eAAO,MAAM,qBAAqB,4FAGhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;SAK9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;SAiB1B,CAAC"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}