Direct Route API

📙
Bundles

Calls related to bundles

eth_sendBundle

Returns the bundle hash if it is accepted by the service.
Parameters
  • txs, Array[String], A list of signed transactions to execute in an atomic bundle
  • maxBlockNumber, String, a hex encoded block number for which this bundle is valid before.
  • minTimestamp, (Optional) Number, the minimum timestamp for which this bundle is valid, in seconds since the unix epoch
  • maxTimestamp,(Optional) Number, the maximum timestamp for which this bundle is valid, in seconds since the unix epoch
  • revertingTxHashes,(Optional) Array[String], A list of tx hashes that are allowed to revert
Returns
Object - An object with the following fields, or null when nothing was found:
  • hash: Number - Returns the bundle hash if it is accepted by the service.
Example
Curl
Postman
curl -X POST \
--data '{"jsonrpc":"2.0","method":"eth_sendBundle",\
"params":[{"txs": ["0xf87181f785028fa6ae00830f424094d11bb98886dc49a8a925d830511e1db43be528658609184e72a00084f9da581d81e6a0c9c62706b5425cc51da2e20e2861d18b6c79d83cede37d582f40ce85fd79af06a0605c3d97b55f405f687de99425bff0ced9e5cd9830ea168a747e6517161eff0a"], "maxBlockNumber":"0x123", "minTimestamp": "231","maxTimestamp":"1231", "revertingTxHashes": ["xx1","xx2"]}],"id":83}' \
-H "Content-Type: application/json"
URL: https://api.nodereal.io/direct-route
RequestType: POST
Body:
{
"jsonrpc":"2.0",
"method":"eth_sendBundle",
params":[{"txs": ["0xf87181f785028fa6ae00830f424094d11bb98886dc49a8a925d830511e1db43be528658609184e72a00084f9da581d81e6a0c9c62706b5425cc51da2e20e2861d18b6c79d83cede37d582f40ce85fd79af06a0605c3d97b55f405f687de99425bff0ced9e5cd9830ea168a747e6517161eff0a"], "maxBlockNumber":"0x123", "minTimestamp": "231","maxTimestamp":"1231", "revertingTxHashes": ["xx1","xx2"]}],
"id":0
}
Result
{
"jsonrpc":"2.0",
"id":83,
"result":"0x2ed12f960e3c47fc8ea5a26d047c3ce11c166c68e65cd51d700d5fb070ea4894"
}

eth_bundlePrice

Returns the suggested bundle price. Parameters
none
Returns
PRICE - integer of the current suggested bundle price.
Example
Curl
Postman
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_bundlePrice","params":[],"id":83}' -H "Content-Type: application/json"
URL: https://api.nodereal.io/direct-route
RequestType: POST
Body:
{
"jsonrpc":"2.0",
"method":"eth_bundlePrice",
params":[],
"id":0
}
Return
{"jsonrpc":"2.0","id":83,"result":"0x210000"}

txpool_getBundleByHash

Returns the bundle object if it exists. Parameters
  • bundleHash: the hash of the bundle.
Returns
  • txs, Array[String], A list of signed transactions to execute in an atomic bundle
  • maxBlockNumber, String, a hex encoded block number for which this bundle is valid before.
  • minTimestamp, (Optional) Number, the minimum timestamp for which this bundle is valid, in seconds since the unix epoch
  • maxTimestamp,(Optional) Number, the maximum timestamp for which this bundle is valid, in seconds since the unix epoch
  • revertingTxHashes,(Optional) Array[String], A list of tx hashes that are allowed to revert
Example
Curl
Postman
curl -X POST \
--data '{"jsonrpc":"2.0","method":"txpool_getBundleByHash","params":[“0x2ed12f960e3c47fc8ea5a26d047c3ce11c166c68e65cd51d700d5fb070ea4894”],"id":83}'\
-H "Content-Type: application/json"
URL: https://api.nodereal.io/direct-route
RequestType: POST
Body:
{
"jsonrpc":"2.0",
"method":"txpool_getBundleByHash",
params":[“0x2ed12f960e3c47fc8ea5a26d047c3ce11c166c68e65cd51d700d5fb070ea4894”],
"id":0
}
Return
{
"jsonrpc":"2.0",
"id":83,
"result":{
"txs":[
"0xf87181f785028fa6ae00830f424094d11bb98886dc49a8a925d830511e1db43be528658609184e72a00084f9da581d81e6a0c9c62706b5425cc51da2e20e2861d18b6c79d83cede37d582f40ce85fd79af06a0605c3d97b55f405f687de99425bff0ced9e5cd9830ea168a747e6517161eff0a"
],
"maxBlockNumber":"0x123",
"minTimestamp":"231",
"maxTimestamp":"1231",
"revertingTxHashes":[
"xx1",
"xx2"
]
}
}
Copy link
On this page
Bundles
eth_sendBundle
eth_bundlePrice
txpool_getBundleByHash