Skip to content

wallet_sendCalls

Defined in EIP-5792

Requests that the wallet submits a batch of calls.

Parameters

interface SendCallsParameter {
  /**
   * The version of the API format. This must be 2.0.0.
   */
  version: string;
  /**
   * The ID of the batch of calls.
   */
  id?: string;
  /**
   * The sender's address.
   * Pattern: ^0x[0-9a-fA-F]{40}$
   */
  from: string;
  /**
   * The EIP-155 chain ID of the calls. This must match the currently selected network in the wallet.
   * Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
   */
  chainId: string;
  /**
   * true if the wallet must execute all calls atomically. If false, the wallet may execute the calls sequentially without atomicity.
   * If false and the wallet is capable of executing the calls atomically, it may do so.
   */
  atomicRequired: boolean;
  /**
   * An array of call objects.
   */
  calls: Array<{
    to: string;
    value: string;
  }>;
  /**
   * Dapps can use this object to communicate with the wallet about supported capabilities.
   */
  capabilities?: Record<string, unknown>;
}
 
type SendCallsParams = [SendCallsParameter]

Returns

object

An object containing information about the sent batch.

Example

Request:

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "wallet_sendCalls",
  "params": [{
    "version": "2.0.0",
    "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    "chainId": "0xaa36a7",
    "atomicRequired": true,
    "calls": [
      {
        "to": "0x54f1C1965B355e1AB9ec3465616136be35bb5Ff7",
        "value": "0x0"
      },
      {
        "to": "0x2D48e6f5Ae053e4E918d2be53570961D880905F2",
        "value": "0x0"
      }
    ]
  }]
}

Errors

CodeMessage
-32602The wallet cannot parse the request
-32000Version not supported
4001User rejected the request
4100The requested account and/or method has not been authorized by the user
5700The wallet does not support a capability that was not marked as optional
5710EIP-7702 not supported on the specified chain ID
5720There is already a batch submitted with the specified batch ID
5740The batch is too large for the wallet to process
5750EIP-7702 upgrade rejected for this chain and account