eth_callBundle
Simulate transactions bundle in flashbots relay via eth_callBundle
You can simulate transactions bundle in flashbots relay before send them to the miner through this api without dealing with flashbots reducing technical costs.
Supported on Ethereum, Goerli.

Parameters

Object - An object with the following fields (required):
  • txsHex(array of string, required) - array or string that contains raw transactions hash.
  • blockNumber(integer number, optional) - the blockNumber that the bundle could be included. pass 0 than it would be set to latest future block.

Returns

Object - An object with the following fields:
  • id(integer number) - json-rpc id.
  • jsonrpc(string) - json-rpc version.
  • result(object) - an object with the following fields:
    • bundleHash(hex string) - the hash value of the bundle.
    • txsResult(array of objects, defined below) - simulating transactions result of the bundle.
  • Object schema:
    • fromAddress(hex string) - the origin address of the transaction.
    • gasPrice(integer number) - price of gas of the transaction.
    • txHash(hex string) - hash value of the transaction.
    • gasUsed(integer number) - used gas of the transaction.
    • metadata(object, defined below) - meta info of the transaction.
  • Metadata object schema:
    • coinbaseDiff(integer number) - the amount of ETH that miner would receiver.
    • ethSentToCoinbase(integer number) - the amount of ETH that pay for the miner directly.
    • gasFees(integer number) - the amount of gas used in this transaction.

Example

Request

curl --location --request POST 'https://apis.blockvision.org/v1/<api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "2.0",
"method": "eth_callBundle",
"params": {
"txsHex": [
"0xf868820154820428825208944592d8f8d7b001e72cb26a73e4fa1806a51ac79d85e8d4a51000802da03412f32337c2b1218fd76f6d953efb487a184d2c80ce0e3d7ceb5a130f25fc91a036031b6e93392eda68b5154b01b67ba68ababe32b8c93cdcf47c66d1bb2edff1",
"0xf868820155820428825208944592d8f8d7b001e72cb26a73e4fa1806a51ac79d85e8d4a51000802da0b0f88f3b49b63aef6148a316dbf6acb534731245b16c25110ec54f954fcef481a026fc384eaa960bed026e39e9f65ae1712ba5afb7250f7513299d896aeb384af1"
],
"blockNumber": 7626710
},
"id": 1
}'

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"bundleHash": "0x161a90b226ba43b0e283d9fda02e801a3685fd4f550f55226016e5c4a8ab3428",
"txsResut": [
{
"metadata": {
"coinbaseDiff": "21861000",
"ethSentToCoinbase": "0",
"gasFees": "21861000"
},
"fromAddress": "0x137be392780558568fc0aB86c73495243Bc6062e",
"gasPrice": "1041",
"txHash": "0x978f0214e0e0ff944d1798fa17b6fe55fda061465f60ee5cc4b707be6f0816fb",
"gasUsed": 21000
},
{
"metadata": {
"coinbaseDiff": "21861000",
"ethSentToCoinbase": "0",
"gasFees": "21861000"
},
"fromAddress": "0x137be392780558568fc0aB86c73495243Bc6062e",
"gasPrice": "1041",
"txHash": "0xc9ed41d6c50d575fcf2f83f370b094f834ecae2d08ffdfa48732c49fa81b03c0",
"gasUsed": 21000
}
]
}
}
Copy link
Outline
Parameters
Returns
Example
Request
Result