wallet_sendCalls

Send multiple blockchain calls in a single bundled transaction.

Requests for the Wallet to broadcast a bundle of calls to the network.

Request#

type Request = {
  method: 'wallet_sendCalls',
  params: [{
    /** Calls to prepare. */
    calls: {
      /** Recipient. */
      to: `0x${string}`;
      /** Calldata. */
      data?: `0x${string}`;
      /** Value to transfer. */
      value?: `0x${string}`;
    }[];
    /** 
     * Chain ID to send the calls to.
     * If not provided, the current chain will be used.
     */
    chainId?: `0x${string}`;
    /** 
     * Address of the account to send the calls from.
     * If not provided, the Account will be filled by the Wallet.
     */
    from?: `0x${string}`;
    /** Capabilities. */
    capabilities?: {
      permissions?: {
        /** ID of the permission to use. */
        id: `0x${string}`;
      };
    };
  }]
}

Response#

type Response = {
  /** ID of the bundle. */
  id: string;
}

Example#

To make these instructions concrete, we have created a sample cross-app wallet called Rapidfire ID. To interact with it, you can find its SDK in the NPM package directory: @rapidfire/id.

You can check out the GitHub repository for Rapidfire Wallet to learn how to create your own wallet.

import RapidfireID from '@rapidfire/id'
const rapidfire = new RapidfireID()
const provider = rapidfire.getEthereumProvider()
const response = await provider.request({ 
  method: 'wallet_sendCalls', 
  params: [{ 
    calls: [{ 
      to: '0xcafebabecafebabecafebabecafebabecafebabe', 
      value: '0x12345678', 
    }], 
  }] 
})

Mint ERC20 Tokens#

The example below demonstrates minting 100 EXP on the Odyssey testnet.

import RapidfireID from '@rapidfire/id'
import { encodeFunctionData, parseAbi, parseEther } from 'viem'
const rapidfire = new RapidfireID()
const provider = rapidfire.getEthereumProvider()
const [account] = await provider.request({
  method: 'eth_accounts',
})
const hash = await provider.request({ 
  method: 'wallet_sendCalls', 
  params: [{ 
    calls: [{ 
      to: '0x706aa5c8e5cc2c67da21ee220718f6f6b154e75c', 
      data: encodeFunctionData({ 
        abi: parseAbi([ 
          'function mint(address, uint256)', 
        ]), 
        functionName: 'mint', 
        args: [account, parseEther('100')], 
      }), 
    }], 
  }], 
})