@metamask/eip-5792-middleware 1.0.0 → 1.2.0

package/dist/{methods → hooks}/processSendCalls.cjs

@@ -4,6 +4,7 @@ exports.processSendCalls = void 0;
 const rpc_errors_1 = require("@metamask/rpc-errors");
 const transaction_controller_1 = require("@metamask/transaction-controller");
 const utils_1 = require("@metamask/utils");
+const lodash_1 = require("lodash");
 const uuid_1 = require("uuid");
 const constants_1 = require("../constants.cjs");
 const utils_2 = require("../utils.cjs");
@@ -17,7 +18,7 @@ const utils_2 = require("../utils.cjs");
  * @returns Promise resolving to a SendCallsResult containing the batch ID.
  */
 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 }));
@@ -32,12 +33,14 @@ async function processSendCalls(hooks, messenger, params, req) {
             addTransaction,
             chainId,
             from,
+            messenger,
             networkClientId,
             origin,
             securityAlertId,
             sendCalls: params,
             transactions,
             validateSecurity,
+            isAuxiliaryFundsSupported,
         });
     }
     else {
@@ -54,6 +57,7 @@ async function processSendCalls(hooks, messenger, params, req) {
             securityAlertId,
             transactions,
             validateSecurity,
+            isAuxiliaryFundsSupported,
         });
     }
     return { id: batchId };
@@ -66,16 +70,19 @@ exports.processSendCalls = processSendCalls;
  * @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 = (0, utils_2.getAccountKeyringType)(from, messenger);
+    validateSingleSendCall(sendCalls, chainId, keyringType, isAuxiliaryFundsSupported);
     const txParams = {
         from,
         ...transactions[0].params,
@@ -87,6 +94,7 @@ async function processSingleTransaction({ addTransaction, chainId, from, network
         origin,
     };
     validateSecurity(securityRequest, chainId);
+    dedupeAuxiliaryFundsRequiredAssets(sendCalls);
     const batchId = generateBatchId();
     await addTransaction(txParams, {
         networkClientId,
@@ -112,9 +120,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],
@@ -122,7 +131,8 @@ async function processMultipleTransaction({ addTransactionBatch, isAtomicBatchSu
     const chainBatchSupport = batchSupport?.[0];
     const keyringType = (0, utils_2.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,
@@ -148,10 +158,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);
 }
 /**
@@ -162,11 +174,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);
 }
 /**
@@ -213,12 +226,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 !== constants_1.SupportedCapabilities.AuxiliaryFunds.toString() &&
+        capabilities?.[name].optional !== true);
+    const requiredCallCapabilities = calls.flatMap((call) => Object.keys(call.capabilities ?? {}).filter((name) => name !== constants_1.SupportedCapabilities.AuxiliaryFunds.toString() &&
+        call.capabilities?.[name].optional !== true));
     const requiredCapabilities = [
         ...requiredTopLevelCapabilities,
         ...requiredCallCapabilities,
@@ -226,6 +246,50 @@ function validateCapabilities(sendCalls) {
     if (requiredCapabilities?.length) {
         throw new rpc_errors_1.JsonRpcError(constants_1.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 = constants_1.KEYRING_TYPES_SUPPORTING_7702.includes(keyringType);
+    if (!isSupportedAccount) {
+        throw new rpc_errors_1.JsonRpcError(constants_1.EIP5792ErrorCode.UnsupportedNonOptionalCapability, `Unsupported non-optional capability: ${constants_1.SupportedCapabilities.AuxiliaryFunds}`);
+    }
+    if (!isAuxiliaryFundsSupported(chainId)) {
+        throw new rpc_errors_1.JsonRpcError(constants_1.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 rpc_errors_1.JsonRpcError(constants_1.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.
@@ -246,4 +310,31 @@ function validateUpgrade(dismissSmartAccountSuggestionEnabled, chainBatchSupport
         throw new rpc_errors_1.JsonRpcError(constants_1.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 = (0, lodash_1.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: (0, utils_1.add0x)(totalAmount.toString(16)),
+            };
+        });
+        sendCalls.capabilities.auxiliaryFunds.requiredAssets = deduplicatedAssets;
+    }
+}
 //# sourceMappingURL=processSendCalls.cjs.map

package/dist/hooks/processSendCalls.cjs.map

@@ -0,0 +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 { 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/{methods → hooks}/processSendCalls.d.cts

@@ -1,7 +1,6 @@
-import type { SendCalls, SendCallsResult } from "@metamask/eth-json-rpc-middleware";
 import type { TransactionController, ValidateSecurityRequest } from "@metamask/transaction-controller";
 import type { Hex, JsonRpcRequest } from "@metamask/utils";
-import type { EIP5792Messenger } from "../types.cjs";
+import type { EIP5792Messenger, SendCallsPayload, SendCallsResult } from "../types.cjs";
 /**
  * Type definition for required controller hooks and utilities of {@link processSendCalls}
  */
@@ -16,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`.
@@ -35,5 +36,5 @@ export type ProcessSendCallsRequest = JsonRpcRequest & {
  * @param req - The original JSON-RPC request.
  * @returns Promise resolving to a SendCallsResult containing the batch ID.
  */
-export declare function processSendCalls(hooks: ProcessSendCallsHooks, messenger: EIP5792Messenger, params: SendCalls, req: ProcessSendCallsRequest): Promise<SendCallsResult>;
+export declare function processSendCalls(hooks: ProcessSendCallsHooks, messenger: EIP5792Messenger, params: SendCallsPayload, req: ProcessSendCallsRequest): Promise<SendCallsResult>;
 //# sourceMappingURL=processSendCalls.d.cts.map

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

@@ -0,0 +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;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/{methods → hooks}/processSendCalls.d.mts

@@ -1,7 +1,6 @@
-import type { SendCalls, SendCallsResult } from "@metamask/eth-json-rpc-middleware";
 import type { TransactionController, ValidateSecurityRequest } from "@metamask/transaction-controller";
 import type { Hex, JsonRpcRequest } from "@metamask/utils";
-import type { EIP5792Messenger } from "../types.mjs";
+import type { EIP5792Messenger, SendCallsPayload, SendCallsResult } from "../types.mjs";
 /**
  * Type definition for required controller hooks and utilities of {@link processSendCalls}
  */
@@ -16,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`.
@@ -35,5 +36,5 @@ export type ProcessSendCallsRequest = JsonRpcRequest & {
  * @param req - The original JSON-RPC request.
  * @returns Promise resolving to a SendCallsResult containing the batch ID.
  */
-export declare function processSendCalls(hooks: ProcessSendCallsHooks, messenger: EIP5792Messenger, params: SendCalls, req: ProcessSendCallsRequest): Promise<SendCallsResult>;
+export declare function processSendCalls(hooks: ProcessSendCallsHooks, messenger: EIP5792Messenger, params: SendCallsPayload, req: ProcessSendCallsRequest): Promise<SendCallsResult>;
 //# sourceMappingURL=processSendCalls.d.mts.map

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

@@ -0,0 +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;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/{methods → 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