eth_callBundle - Arc

eth_callBundle. Simulates a bundle of transactions against a specified block without submitting it to the network.

eth_callBundle - arc [Value: 20CU]
Simulates a bundle of signed transactions against a specific block, including simulating at the top of the next block, without submitting anything to the network
Use cases

Use cases

  • Test a transaction bundle's gas usage and outcome before submitting it
  • Preview an arbitrage or liquidation bundle's profitability ahead of execution
Constraints

Constraints

  • txs must be pre-signed, RLP-encoded raw transactions
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl https://arc-testnet.drpc.org \
-X POST \
-H "Content-Type: application/json" \
-d '{"method":"eth_callBundle",
    "params":[{"txs": ["0x123abc...", "0x456def..."], "blockNumber": "0xb63dcd", "stateBlockNumber": "latest", "timestamp": 1615920932}],
    "id":1,
    "jsonrpc":"2.0"}'
Copy
Response
200
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "bundleGasPrice": "476190476193",
    "bundleHash": "0x73b1e258c7a42fd0230b2fd05529c5d4b6fcb66c227783f8bece8aeacdd1db2e",
    "coinbaseDiff": "20000000000126000",
    "ethSentToCoinbase": "20000000000000000",
    "gasFees": "126000",
    "results": [
      {
        "coinbaseDiff": "10000000000063000",
        "ethSentToCoinbase": "10000000000000000",
        "fromAddress": "0x02A727155aeF8609c9f7F2179b2a1f560B39F5A0",
        "gasFees": "63000",
        "gasPrice": "476190476193",
        "gasUsed": 21000,
        "toAddress": "0x73625f59CAdc5009Cb458B751b3E7b6b48C06f2C",
        "txHash": "0x669b4704a7d993a946cdd6e2f95233f308ce0c4649d2e04944e8299efcaa098a",
        "value": "0x"
      }
    ],
    "stateBlockNumber": 5221585,
    "totalGasUsed": 42000
  }
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersarray
array
bundleobject
The bundle simulation parameters.
array
txsarray_of_strings
Signed, RLP-encoded transactions to execute in an atomic bundle.
blockNumberstring
The block the bundle is valid for, as a hex string.
stateBlockNumberstring
The block number or tag whose state the simulation is based on. Can be "latest".
timestampinteger
(optional) The timestamp to use for the simulation, in Unix seconds.

Response

200
The bundle simulation result, with aggregate gas and fee figures plus a per-transaction breakdown

Response params

object
idinteger
jsonrpcstring
resultobject
The bundle simulation result.
object
bundleGasPricestring
The gas price used for the bundle simulation.
bundleHashstring
The hash of the bundle.
coinbaseDiffstring
The total difference in coinbase payments.
ethSentToCoinbasestring
The total ETH sent to the coinbase.
gasFeesstring
The total gas fees for the bundle.
resultsarray_of_objects
The result of each transaction in the bundle, in order.
object
coinbaseDiffstring
The coinbase difference for this transaction.
ethSentToCoinbasestring
The ETH sent to coinbase for this transaction.
fromAddressstring
The address that sent the transaction.
gasFeesstring
The gas fees for this transaction.
gasPricestring
The gas price used for this transaction.
gasUsedinteger
The amount of gas used by this transaction.
toAddressstring
The address the transaction was sent to.
txHashstring
The hash of the transaction.
valuestring
The value transferred in the transaction.
stateBlockNumberinteger
The block number used for state simulation.
totalGasUsedinteger
The total gas used by all transactions in the bundle.
eth_simulateV1Gas estimation