Transaction Boost

Wallets and Dapps can seamlessly integrate Blocknative’s Transaction Boost, enabling users to send private transactions to multiple RPC endpoints simultaneously while conveniently monitoring transaction statuses. This integration offers complete customization to adapt to specific preferences.
The table below outlines the endpoints available:

Setting up and customizing the endpoint

Transaction Boost defaults to automatically forwarding transactions to the RPC endpoints and block builders below. Developers can configure the endpoint to send to specific RPCs using the query parameters.

Supported RPCs:

Default

If no endpoint is explicitly defined the aggregator will forward to all supported RPC endpoints listed above.
  • https://rpc.blocknative.com/boost
Use the following query parameters to customize the entities that receive your private transactions.

RPC Query Parameters

rpc
Only include specific comma separate RPC endpoints. For example in https://rpc.blocknative.com/boost?rpc=MEV-Blocker,PropellerHeads,Titan,Blocknative , transactions will only be sent to MEV-Blocker, PropellerHeads, Titan builder, and the Blocknative builder.
exclude
Defaults to false, when set to true it will exclude the RPC endpoints defined in the RPC query parameter. For example in https://rpc.blocknative.com/boost?rpc=Builder0x69&exclude=true , transactions will be forwarded to all RPC endpoints except Builder0x69.
originID
This specifies the private ID of the transaction originator. For example: https://rpc.blocknative.com/boost?rpc=Titan&originID=Donquixote. It's recommended to keep the ID private, since it allows you to later visualize all the history of your order flow.
mevsharehints
Allows specifying MEV-Share hints. For example: https://rpc.blocknative.com/boost?rpc=MEV-Share&mevsharehints=calldata,logs . Note that if no hints are specified it will automatically default to use hash as the unique hint. To honor privacy, all transactions with specified mevsharehints will not be forwarded to other builders. Read more on hints here .
mevsharerefunds
If sending to MEV-Share, allows specifying of refunds parameters. For example: https://rpc.blocknative.com/boost?rpc=MEV-Share&mevsharerefunds=0x864bD4E84BdF3DCeE9F4212dc32f198277056E22:10 . Read more on refunds here.
mevsharebuilders
If sending to MEV-Share, allows for specifying which builders within MEV-Share can receive the transaction. For examplehttps://rpc.blocknative.com/boost?rpc=MEV-Share&mevsharebuilders=rsync,Titan will only send transactions to rsync and Titan builders on MEV-Share.

Checking Transaction Status

You can check the live status of your private transaction by simply using the following URLs:
  • Mainnet: https://rpc.blocknative.com/boost/tx/YOUR_TX_HASH
  • Goerli: https://rpc.blocknative.com/boost/tx/YOUR_TX_HASH?network=goerli
After sending the request, you will receive a JSON response in the following format:
{
"txHash":"0x284ff37c96c65579249e11337ccb3f54a4148d98a2638d5a2984e8da6e785478",
"status":"CONFIRMED",
"forwardedTo":[
{
"endpoint":"MEV-Blocker",
"receivedAt":"2023-07-17T15:25:23.218343Z",
"status":"RECEIVED",
"endpointMsg":{
// the fields below are only available for txs forwarded to MEV-Blocker
"shared": true,
"backruns": 0,
"referrer": null,
"refundRecipient": null,
"refund": 0
}
},
{
"endpoint":"Blocknative",
"receivedAt":"2023-07-17T15:25:23.218343Z",
"status":"RECEIVED",
"endpointMsg":{}
},
{
"endpoint":"Titan",
"receivedAt":"2023-07-17T15:25:23.218343Z",
"status":"RECEIVED",
"endpointMsg":{}
}
],
"transaction":{
"from":"0x48bdc4Ed4b6c6a0E32bD2D7075c99eD5F917DDA0",
"to":"0x99F18940Cb6396FE9233EAFc61D1187Fe86eb43D",
"gasLimit":21000,
"maxFeePerGas":1651273110,
"maxPriorityFeePerGas":1650000000,
"nonce":12,
"value":20000000
},
"gasUsed":21000,
"blockNumber":9266498,
"builder":"Blocknative",
"confirmedAt":"2023-07-17T15:25:23.218343Z",
"seenInMempool": false,
"firstSeenInMempool":"..." //shows timestamp of when the tx entered mempool (if applicable)
}
The transaction fields are only revealed for CONFIRMED/FAILED transactions in order to ensure the privacy of pending and rejected transactions.
Example of an endpointMsg response:
{
"error": "error message",
// the fields below are only available for txs forwarded to MEV-Share or MEV-Blocker
"maxBlockNumber": "1230",
"fastMode": true,
"seenInMempool": false,
"shared": true,
"backruns": 0,
"referrer": null,
"refundRecipient": null,
"refund": 0
}

Fetching Transactions By OriginID

You can retrieve the entire history of your transactions using your originID on the following URL:
https://rpc.blocknative.com/boost/txs?originID=Donquixote
query param
type
default
limit
integer
100
The maximum number of transaction entries to return. If the value exceeds the maximum (100), then the maximum value will be used.
page
integer
1
The page number of transactions to retrieve.

Understanding RPC responses

When an RPC receives the transaction, the RPC responds in one of two ways:

Without Error

{
"jsonrpc": "2.0",
"id": 1,
"result": "0xa129dc71038c20bd5cc58f08836c8616d2201581f203691d888878c734da189b"
}

With Error

{
"id": 1,
"error": {
"code": -32603,
"message": "invalid nonce"
},
"jsonrpc": "2.0"
}
Transaction Boost takes these responses and provides a human-readable status for each endpoint:

Endpoint Status

Status
Definition
RECEIVED
RPC acknowledged the receipt of the transaction either without an error or with an error as per above. If there is an error message, you can find it in endpointMsg.
NOT RECEIVED
RPC did not acknowledge the receipt of the transaction.

Transaction Status

Status
Definition
PENDING
At least one endpoint received the transaction and none of the endpoints that received the transaction responded with an error message.
CONFIRMED
The transaction was detected on-chain.
FAILED
The transaction was detected on-chain and it failed.
REJECTED
All endpoint statuses show NOT RECEIVED OR one of the endpoint's nodes rejected the transaction with an error (invalid nonce, invalid sender, underpriced replacement...).