Send Bundle

API Overview

Method: eth_sendBundle
Allows users to submit multiple signed raw transactions as an atomic bundle—either all succeed together, or none execute.
NodeReal’s block-building algorithm favors bundles that include higher effective gas fees and direct transfers to the system address, maximizing validator value while preserving fairness and security.

Auction Mechanism

NodeReal employs an auction-like priority mechanism for bundles:

• Bundle Score Formula:
  Bundle Score = (Sum of effective gas fees from private (non-public mempool) transactions × (1 − burnRate)) + BNB tip to SystemAddress
  This aligns with BSC’s BEP-95 fee burn mechanism.
• SystemAddress Tip:
  • Address: 0xffffFFFfFFffffffffffffffFfFFFfffFFFfFFfE (the universally accepted system account)
  • Including a direct BNB tip to this address enhances your bundle’s priority in inclusion queues.
• Gas Requirement:
  • Gas price per transaction must meet or exceed BSC validator minimum (currently ~0.1 gwei).
  • Bundles may include 0-gwei transactions; however, the average gas price across private transactions must still meet the minimum threshold.

Request Parameters

Example Request

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "eth_sendBundle",
  "params": [
    {
      "txs":["0x…f1", "0x…b7"],    // List of signed raw transactions
      "maxBlockNumber":39177941,   // The maximum block number for the bundle to be valid, with the default set to the current block number + 100
      "maxTimestamp":1710829390,   // Expected maximum Unix timestamp (in unix) for the bundle to be valid
      "revertingTxHashes":[
        "0xa1b2c3d4e5f60718293abcdeff1234567890abcdef1234567890abcdef123456"
        ],                         // List of transaction hashes allowed for revert
    }
  ]
}‍

Example Response

{
 "jsonrpc":"2.0",
 "id":"1",
 "result":"0x274a……053b"  //bundle hash
}‍

{
  "jsonrpc":"2.0",
  "id":"1",
  "error":{
    "code":-38000,
    "message":"bundle already exist"
    }
}