Send Bundle
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 BNB tips to the NodeReal Builder tip 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 the NodeReal Builder tip address
This aligns with BSC’s BEP-95 fee burn mechanism. - NodeReal Builder Tip:
- Address:
0x216dfead2298B9044847073206B0671a360E67b7 - Including a direct BNB tip to this address can improve your bundle’s priority when NodeReal Builder selects bundles for a block.
- Address:
- 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
| Parameter | Required | Type | Description |
|---|---|---|---|
txs | Yes | array[hex] | Array of signed raw transactions. |
maxBlockNumber | No | uint64 | Upper block number limit (default = current block + 100). |
maxTimestamp | No | uint64 | Upper UNIX timestamp bound (sec). |
revertingTxHashes | No | array[hash] | Transactions allowed to revert. |
noMerge | No | bool | Disable bundle merging (defaults to false). |
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"
}
}Updated 1 day ago
Did this page help you?

