Send Bundle

Introduction to Send Bundle of BlockRazor Block Builder and integration methods

Introduction

This API is used to receive bundles, with the method name eth_sendBundle.

The block construction algorithm of BlockRazor Builder favors bundles that transfer more native tokens (BNB) to BlockRazor Builder EOA of which address is 0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20 currently.

The gas price for transactions within the bundle must be at least the minimum standard required by BSC Validators (Currently at 0.05 gwei).

Request Parameter

Parameters	Mandatory	Format	Example	Description
txs	Mandatory	array[hex]	["0x…4b", "0x…5c"]	List of signed raw transactions
maxBlockNumber	Optional	uint64	39177941	The maximum block number for the bundle to be valid, with the default set to the current block number + 100
minTimestamp	Optional	uint64	1710229370	Expected minimum Unix timestamp (in seconds) for the bundle to be valid
maxTimestamp	Optional	uint64	1710829390	Expected maximum Unix timestamp (in seconds) for the bundle to be valid
revertingTxHashes	Optional	array[hash]	["0x…c7", "0x…b7"]	List of transaction hashes allowed for revert
noMerge	Optional	bool	false	Bundle merge can increase block value and inclusion rate. If not set, the default value is false (allowing bundle merging)
positionFirst	Optional	bool	false	Strictly order bundles by priorityFee. If set to false (default), late-arriving bundles may be appended to the block tail to guarantee inclusion in the current block.

Request Example

HTTPS

curl https://virginia.builder.blockrazor.io \
  -H 'content-type: application/json' \
  -H 'Authorization: <auth-token>' \
  --data '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "eth_sendBundle",
    "params": [{
      "txs": [
        "0x...4b",
        "0x...5c"
      ],
      "maxBlockNumber": 39177941,
      "minTimestamp": 1710229370,
      "maxTimestamp": 1710829390,
      "revertingTxHashes": [
        "0x44b89abe860142d3c3bda789cf955b69ba00b71882cd968ec407a70f4719ff06",
        "0x7d7652c685e9fda4fe2e41bad017519cffeed8ba03d59aa6401284be2ec4244c"
      ],
      "noMerge": false
    }]
  }'

Response Example

{
 "jsonrpc":"2.0",
 "id":"1",
 "result":"0xa06b……f7e8ec"  //bundle hash
}‍

{
  "jsonrpc":"2.0",
  "id":"1",
  "error":{
    "code":-38000,
    "message":"the maxBlockNumber should not be smaller than currentBlockNum"
    }
}