EIP-5792 (Batched Calls)

Use wallet_getCapabilities and wallet_sendCalls to batch and sponsor EVM transactions.

EIP-5792 adds a small set of JSON-RPC methods that let dapps ask wallets for advanced capabilities — atomic batches, paymaster sponsorship, and conditional execution — without needing to understand ERC-4337 internals.

The standard introduces:

• wallet_getCapabilities
• wallet_sendCalls
• wallet_getCallsStatus
• wallet_showCallsStatus

Support is rolling out across wallets. See the EIP-5792 ecosystem tracker for the current list. The Viem WalletClient returned by createWalletClientForWalletAccount exposes these methods directly.

Check capabilities

Use getCapabilities() to see which features the wallet supports for a given chain before sending calls.

import { createWalletClientForWalletAccount } from '@dynamic-labs-sdk/evm/viem';
import { getActiveNetworkData } from '@dynamic-labs-sdk/client';

const checkCapabilities = async (walletAccount) => {
  const walletClient = await createWalletClientForWalletAccount({ walletAccount });
  const { networkData } = await getActiveNetworkData({ walletAccount });
  const chainId = networkData.chainId;

  const capabilities = await walletClient.getCapabilities();
  const chainCapabilities = capabilities?.[chainId];

  if (!chainCapabilities) {
    return { atomic: false, paymaster: false };
  }

  const atomicSupported =
    chainCapabilities.atomic?.status === 'ready' ||
    chainCapabilities.atomic?.status === 'supported';

  const paymasterSupported = Boolean(
    chainCapabilities.paymasterService?.supported
  );

  return { atomic: atomicSupported, paymaster: paymasterSupported };
};

Batch calls

sendCalls submits multiple calls atomically when the wallet supports it. Optionally include paymasterService capabilities to request gas sponsorship.

import { parseEther } from 'viem';
import { createWalletClientForWalletAccount } from '@dynamic-labs-sdk/evm/viem';
import { getActiveNetworkData } from '@dynamic-labs-sdk/client';

const sendBatchedCalls = async (walletAccount) => {
  const walletClient = await createWalletClientForWalletAccount({ walletAccount });
  const { networkData } = await getActiveNetworkData({ walletAccount });
  const chainId = networkData.chainId;

  const capabilities = await walletClient.getCapabilities();
  const chainCapabilities = capabilities?.[chainId];

  const atomicSupported =
    chainCapabilities?.atomic?.status === 'ready' ||
    chainCapabilities?.atomic?.status === 'supported';

  if (!atomicSupported) {
    throw new Error(`Atomic batching not supported on chain ${chainId}`);
  }

  const callParams: Parameters<typeof walletClient.sendCalls>[0] = {
    calls: [
      {
        to: '0x1111111111111111111111111111111111111111',
        value: parseEther('0.001'),
      },
      {
        to: '0x2222222222222222222222222222222222222222',
        value: parseEther('0.001'),
      },
    ],
  };

  if (chainCapabilities?.paymasterService?.supported) {
    callParams.capabilities = {
      paymasterService: { url: undefined },
    };
  }

  const { id } = await walletClient.sendCalls(callParams);
  return id;
};

Track status

getCallsStatus returns the execution state for a batch. Poll it until the batch settles.

const status = await walletClient.getCallsStatus({ id });

if (status.status === 'success') {
  console.log('Batch executed:', status.receipts);
}

viem ≥ 2.28: waitForCallsStatus is available on the wallet client as a convenience wrapper that polls getCallsStatus internally and resolves once the batch reaches a terminal state. On older viem versions, poll getCallsStatus yourself in a loop with a delay.

showCallsStatus lets the wallet present a transaction status UI to the user — handy for relayer-style flows.

Notes

• If the wallet doesn’t support EIP-5792, getCapabilities and sendCalls will throw or return empty capabilities. Always check capabilities first and fall back to a sequential sendTransaction loop.
• Atomic batching is a wallet-level guarantee — the wallet decides whether to submit calls atomically, sequentially, or via account abstraction.
• Paymaster sponsorship requires both wallet support and a configured paymaster URL. If you’re using ZeroDev for sponsorship, see the Gas Sponsorship Quickstart for a more direct ERC-4337 path.

Related functions

• Getting a Viem WalletClient
• Get Active Network
• Sign Typed Data (EIP-712)
• Sign a Transaction
• ZeroDev Gas Sponsorship Quickstart