eth_callBundle

zkLink Nova chain RPC Methods & 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

Need RPC API keys?

Get 12.5M archival requests for free today.

Example

  • HTTPS POST Request with a JSON RPC call in the body
  • Replace YOUR-API-KEY with the API key from your CHAINNODES.ORG Dashboard
  • You can use a different supported network by replacing zklink-nova-mainnet
curl https://zklink-nova-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
  }
}

💡 Confusing?

Ask our experienced blockchain developers in Telegram