Polygon API Documentation

eth_callBundle RPC Method

eth_callBundle can be used to simulate a bundle against a specific block number, including simulating a bundle at the top of the next block. A bundle is a collection of transactions.

Parameters

1.BUNDLE OBJECT [required]

• object - The bundle object

  • txs - An array of raw transaction strings

  • blockNumber - A hex encoded block number for which this bundle is valid on

  • stateBlockNumber - Either a hex encoded number or a block tag for which state to base this simulation on. Can use "latest"

  • timestamp [optional] - Number, the timestamp to use for this bundle simulation, in seconds since the unix epoch

Request

POST https://<network>.chainnodes.org/YOUR-API-KEY

Returns

• object - The bundle call result

  • bundleGasPrice - Gas price of the bundle

  • bundleHash - The bundle hash

  • coinbaseDiff - The diff of the coinbase

  • ethSentToCoinbase - How much eth was sent to the coinbase

  • gasFees - The gas fees of the bundle

  • stateBlockNumber - The state block number

  • totalGasUsed - The total gas used in this bundle

  • results - The array of actual call results for the transactions

    • coinbaseDiff - The diff of the coinbase for this transaction

    • ethSentToCoinbase - ETH sent to the coinbase for this transaction

    • fromAddress - The from address

    • gasFees - The gas fees

    • gasPrice - The gas price

    • gasUsed - The gas used

    • toAddress - The to address

    • txHash- The transaction hash

    • value - The amount of ETH sent in this transaction

Example

curl https://polygon-mainnet.chainnodes.org/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"eth_callBundle","params":[{"txs":["0x123abc...","0x456def..."],"blockNumber":"0xb63dcd","stateBlockNumber":"latest","timestamp":1615920932}]}'

Body

{
  "jsonrpc": "2.0",
  "id": "123",
  "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"
      },
      {
        "coinbaseDiff": "10000000000063000",
        "ethSentToCoinbase": "10000000000000000",
        "fromAddress": "0x02A727155aeF8609c9f7F2179b2a1f560B39F5A0",
        "gasFees": "63000",
        "gasPrice": "476190476193",
        "gasUsed": 21000,
        "toAddress": "0x73625f59CAdc5009Cb458B751b3E7b6b48C06f2C",
        "txHash": "0xa839ee83465657cac01adc1d50d96c1b586ed498120a84a64749c0034b4f19fa",
        "value": "0x"
      }
    ],
    "stateBlockNumber": 5221585,
    "totalGasUsed": 42000
  }
}

JSON-RPC API Documentation by CHAINNODES is based on Erigon node client. Contact us if you are interested in specific methods that are only available on geth, besu, Nethermind or reth