wallet_sendCalls

{
  "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"
      }
    ]
  }]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "wallet_sendCalls",
  "params": [{
    "version": "2.0.0",
    "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    "chainId": "0x2105",
    "atomicRequired": true,
    "calls": [
      {
        "to": "0x54f1C1965B355e1AB9ec3465616136be35bb5Ff7",
        "value": "0x0",
        "data": "0x095ea7b3...",
        "capabilities": {
          "gasLimitOverride": {
            "value": "0x13880"
          }
        }
      },
      {
        "to": "0x2D48e6f5Ae053e4E918d2be53570961D880905F2",
        "value": "0x0",
        "data": "0x38ed1739...",
        "capabilities": {
          "gasLimitOverride": {
            "value": "0x30D40"
          }
        }
      }
    ]
  }]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "batchId": "0x123...",
    "status": "pending"
  }
}

Defined in EIP-5792

Requests that the wallet submits a batch of calls. This method allows applications to send multiple transactions atomically or sequentially.

Parameters

version

string

required

The version of the API format. This must be “2.0.0”.

string

The ID of the batch of calls for tracking purposes.

from

string

required

The sender’s address. Pattern: ^0x[0-9a-fA-F]{40}$

chainId

string

required

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)$

atomicRequired

boolean

required

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.

calls

array

required

An array of call objects to execute.

Show Call object structure

string

required

The recipient address for the call.

value

string

required

The value to send with the call (in wei, hex format).

data

string

The call data (optional, hex format).

capabilities

object

Optional call-level capabilities. For example, gasLimitOverride allows you to specify a gas limit for an individual call.

capabilities

object

Dapps can use this object to communicate with the wallet about supported capabilities.

Returns

result

object

An object containing information about the sent batch, including transaction details and status.

Example Usage

{
  "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"
      }
    ]
  }]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "wallet_sendCalls",
  "params": [{
    "version": "2.0.0",
    "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    "chainId": "0x2105",
    "atomicRequired": true,
    "calls": [
      {
        "to": "0x54f1C1965B355e1AB9ec3465616136be35bb5Ff7",
        "value": "0x0",
        "data": "0x095ea7b3...",
        "capabilities": {
          "gasLimitOverride": {
            "value": "0x13880"
          }
        }
      },
      {
        "to": "0x2D48e6f5Ae053e4E918d2be53570961D880905F2",
        "value": "0x0",
        "data": "0x38ed1739...",
        "capabilities": {
          "gasLimitOverride": {
            "value": "0x30D40"
          }
        }
      }
    ]
  }]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "batchId": "0x123...",
    "status": "pending"
  }
}

Error Handling

code

number

Error code indicating the type of error that occurred.

message

string

Human-readable error message describing what went wrong.

Code	Message	Description
-32602	The wallet cannot parse the request	Invalid request format
-32000	Version not supported	API version not supported
4001	User rejected the request	User denied the transaction
4100	The requested account and/or method has not been authorized by the user	Authorization required
5700	The wallet does not support a capability that was not marked as optional	Missing capability
5710	EIP-7702 not supported on the specified chain ID	Chain not supported
5720	There is already a batch submitted with the specified batch ID	Duplicate batch ID
5740	The batch is too large for the wallet to process	Batch size limit exceeded
5750	EIP-7702 upgrade rejected for this chain and account	Upgrade rejected

Ensure that the chainId matches the currently selected network in the wallet to avoid transaction failures.

When atomicRequired is set to false, consider the implications of partial execution if some calls fail while others succeed.

wallet_connect

wallet_getCallsStatus

⌘I

Introduction

Quickstart

Guides

Framework Integrations

Reference

More

Basenames

Contribute

Parameters

Returns

Example Usage

Error Handling

​Parameters

​Returns

​Example Usage

​Error Handling

Parameters

Returns

Example Usage

Error Handling