ETH Private Transactions

Send private transactions on Ethereum Mainnet to protect your transaction from frontrunning bots.

Ethereum Mainnet

The blxr_private_tx endpoint allows users to send a single transaction that is added directly to the blocks generated by block builders.

Pricing: Private txs no longer require extra payments to bloXroute and can be used by all tiers (similar to blxr_tx) for free. In addition, private txs are automatically enrolled in the BackRunMe service and will pay back searchers 40% of the profit.

REQUEST

Method: blxr_private_tx

Method
DNS
Request Type

blxr_private_tx

api.blxrbdn.com

HTTPS POST, WSS

Parameters

Parameter
Description

transaction

[Mandatory] Raw transaction bytes without 0x prefix.

timeout

[Optional] An integer value that represents the time, in seconds, needed to wait for a Private Transaction to be included in a block. If omitted, it defaults to 0. If timeout is not 0 and the transaction is not mined after the timeout value, it will be sent publicly. If the timeout is 0, no public transaction will be sent.

mev_builders

[Optional, default: bloxroute builder] A dictionary of MEV builders that should receive the private transaction. Please provide empty string as signature for each builder. Possible MEV builders are:

  • bloxroute: bloXroute internal builder

  • flashbots: flashbots builder

  • all: all builders

node_validation

[Optional, default: false] Transaction would be validated by a blockchain node, and Cloud-API returns an error message (e.g. "invalid sender" or "nonce too low") in case the raw transaction byte fails validation check.

[Optional, default: False] A boolean flag indicating if the bundle should be sent just to a single block builder who is participating in the priority fee refund program. Please refer to Priority Fee Refund for details of the priority fee refund program.

refund_recipient

[Optional] A string representing the wallet address to receive refund when priority_fee_refund flag is enabled.

Examples (Cloud API)

curl https://api.blxrbdn.com \
    --insecure \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{
         "id": "1", 
         "method": "blxr_private_tx", 
         "params": {
            "transaction": "f86b0184...e0b58219",
            "mev_builders": {
                "bloxroute": "",
                "flashbots": "",
                "beaverbuild": "",
                "all": ""
	     }
          }
        }'

RESPONSE

Result Fields

Result Field

Description

tx_hash

Transaction hash

Examples

{
    "jsonrpc": "2.0", 
    "id": "1", 
    "result": "0xffd59870844e5...bfa54a69"        
}    

Last updated