Skip to main content

eth_sendBundle

note

Access to this endpoint is permissioned via Infura, and is not relevant for node operators as it's available on sequencers only. To add this endpoint to your Infura account, please open a ticket via the "Contact" button on our support page.

Privately sends a bundle of signed transactions to be executed atomically, allowing the caller to define transaction execution order. This enables services such as:

  • Frontrunning protection
  • Gas abstraction
  • Revert protection.

Due to being sent atomically, the bundle will only be executed if all transactions are confirmed.

The method can also improve UX, as users can review and approve a bundle of transactions with one click, rather than multiple clicks. (Assuming the dapp and wallet being used have implemented EIP-5792, and the wallet supports eth_sendBundle on Linea.)

info

Methods for cancelling the bundle (eth_cancelBundle) or retrieving its status (eth_getBundleStatus) are not yet supported. To get the bundle status, we recommend wallets use eth_getTransactionReceipt on each transaction in the bundle. Dapps can fetch status by using the wallet_getCallsStatus method added in EIP-5792.

Parameters​

  • txs: An array of signed transactions to execute in the bundle.
  • blockNumber: Hexadecimal block number for the block the bundle is valid in.
  • minTimestamp: [optional] A number representing the minimum timestamp for which the bundle is valid, in seconds since the unix epoch.
  • maxTimestamp: [optional] A number representing the maximum timestamp for which the bundle is valid, in seconds since the unix epoch.

Additional optional parameters supported elsewhere are not supported on Linea.

Returns​

  • bundleHash: The hash of the executed bundle.

Example​

Request​

curl 'https://linea-mainnet.infura.io/v3/YOUR-API-KEY' \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0","method": "eth_sendBundle","params":[{"txs": ["0x1234567890abcdef...", "0x1234567890abcdef..."],"blockNumber": "0x123..."}],"id": 1}'

Response​

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "bundleHash": "0x1234567890abcdef..."
    }
}