sendCalls

Name: viem-go
Author: viem-go

Sends a batch of calls (EIP-5792)

Import

Import the wallet actions package so you can call this action.

import "github.com/ChefBingbong/viem-go/actions/wallet"

Usage

See how to construct a wallet client and call this action.

import (
  "context"
  "log"
  "math/big"

  "github.com/ChefBingbong/viem-go/actions/wallet"
  "github.com/ChefBingbong/viem-go/client"
  "github.com/ChefBingbong/viem-go/client/transport"
  "github.com/ChefBingbong/viem-go/chain/definitions"
)

ctx := context.Background()

walletClient, err := client.CreateWalletClient(client.WalletClientConfig{
  Chain:     definitions.Mainnet,
  Transport: transport.HTTP("https://eth.llamarpc.com"),
})
if err != nil {
  log.Fatal(err)
}
defer func() { _ = walletClient.Close() }()

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{
      {Data: "0xdeadbeef", To: "0x70997970c51812dc3a010c7d01b50e0d17dc79c8"},
      {To: "0x70997970c51812dc3a010c7d01b50e0d17dc79c8", Value: big.NewInt(69420)},
  },
})
if err != nil {
  log.Fatal(err)
}
log.Printf("Call batch ID: %s", result.ID)

Contract Calls

The Calls property also accepts contract calls with ABI encoding:

import (
  "github.com/ChefBingbong/viem-go/abi"
  "github.com/ChefBingbong/viem-go/actions/wallet"
)

parsedABI, _ := abi.Parse([]byte(`[{"type":"function","name":"approve",...}]`))

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{
      {
          To:           "0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2",
          ABI:          parsedABI,
          FunctionName: "approve",
          Args:         []any{"0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC", big.NewInt(100)},
      },
  },
})

Returns

*SendCallsReturnType

An object containing:

ID - The identifier for the call batch
Capabilities - The wallet capabilities (optional)

Parameters

Configuration options accepted by this action.

Account

Control which account is used to send the batched calls.

Type: Account
Optional

The account to send from. If nil, uses the client's account.

Calls

Provide the list of calls that will be batched and sent.

Type: []wallet.Call
Required

An array of calls to be signed and broadcasted.

Each call can have:

To - Recipient address (optional)
Data - Calldata (optional, or use ABI encoding)
Value - Amount of ETH to send (optional)
ABI - Contract ABI for encoding (optional)
FunctionName - Function name (used with ABI)
Args - Function arguments (used with ABI)
DataSuffix - Data to append to the end of calldata (optional)

import "math/big"

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{
      {Data: "0xdeadbeef", To: "0x70997970c51812dc3a010c7d01b50e0d17dc79c8"},
      {To: "0x70997970c51812dc3a010c7d01b50e0d17dc79c8", Value: big.NewInt(69420)},
  },
})

ForceAtomic

Type: bool
Default: false
Optional

Force the calls to be executed atomically.

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{...},
  ForceAtomic: true,
})

ID

Type: string
Optional

An optional identifier for the call batch.

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{...},
  ID:    "<my-batch-id>",
})

Version

Type: string
Default: "2.0.0"
Optional

The EIP-5792 version.

Capabilities

Type: map[string]any
Optional

Capability metadata for the calls (e.g. specifying a paymaster).

result, err := wallet.SendCalls(ctx, walletClient, wallet.SendCallsParameters{
  Calls: []wallet.Call{...},
  Capabilities: map[string]any{
      "paymasterService": map[string]any{"url": "https://..."},
  },
})

ExperimentalFallback

Type: bool
Default: false
Optional

When true, falls back to eth_sendTransaction if wallet_sendCalls is not supported.

:::warning When using ExperimentalFallback with a wallet that does not support EIP-5792, viem-go will return a custom bundle identifier (id). While this identifier works with viem-go's getCallsStatus action, it cannot be used with the native wallet_getCallsStatus RPC method. :::

ExperimentalFallbackDelay

Type: *int
Default: 32ms
Optional

The delay (in milliseconds) between fallback transactions when using ExperimentalFallback.

JSON-RPC Method

wallet_sendCalls (EIP-5792)