Links

BSC Bundle Submission

Submit a BSC bundle to the Cloud-API, which validates and forwards the bundle to MEV Relays directly connected to BSC validators participating in our MEV solution program.

Implementation

The MEV Relay builds blocks based on MEV bundles and mempool transactions with the highest possible validator reward. It then sends these blocks to the current proposer.
Assuming one of the proposed blocks has a higher reward than any other block the validator has (i.e. a locally produced block or a block received from another MEV Relay), the validator will seal and commit the proposed block including the MEV bundles.

Payout/Profit Sharing

The mechanism described works well when all parties benefit. Hence, you are expected to share profit both with the validator and with bloXroute.
  • Payment to the validator must be done through the gas fee of one of the transactions in the bundle, which, in BSC, is how validators collect their reward. Since you are submitting your transaction in a bundle, you can have a high gas price transaction after a low gas price which allows for backrunning or sandwich bundles.
  • bloXroute fixed service fee must be paid as part of the bundle, sent to the bloXroute wallet address. Most users use an internal transaction for this fee payment. The bloXroute address should be taken from the blxr_info endpoint (currently 0x965Df5Ff6116C395187E288e5C87fb96CfB8141c). The bloXroute fixed service fee structure is documented in the table below.
Profit sharing summary table
Stakeholders
Comment
Searcher
You can decide how much to keep for yourself based on the competition
Validator
You can decide how much to pay the validator based on the competition. If others offer higher reward to the validator competing over the same opportunity, your bundle will not be selected
bloXroute
Bundle prices can be queried with bsc_get_bundle_price endpoint. Current price for different tiers is available in Rate Limit and Restriction table.

REQUEST

Method: blxr_submit_bundle
Parameters
Parameters
Descriptions
transaction
A list of raw transaction bytes without a 0x prefix, seperated by a comma.
blockchain_network
Blockchain network name. Must be BSC-Mainnet.
block_number
Block number of a future block to include this bundle in, in hex value.
min_timestamp
[Optional] The minimum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
max_timestamp
[Optional] The maximum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
reverting_hashes
[Optional] A list of transaction hashes within the bundle that are allowed to revert. Default is empty list: the whole bundle would be excluded if any transaction reverts.

Examples (Cloud API)

HTTPS POST
wscat
curl https://mev.api.blxrbdn.com \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
-d '{
"id": "1",
"method": "blxr_submit_bundle",
"params": {
"transaction": ["ab..ab", "cd..cd"],
"blockchain_network": "BSC-Mainnet",
"block_number": "0xa11446"
}
}'
wscat -c wss://mev.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {"id": "1", "method": "blxr_submit_bundle", "params": {"transaction": ["ab..ab", "cd..cd"], "blockchain_network": "BSC-Mainnet", "block_number": "0xa11446"}}

Rate Limit and Restriction

Plan
Submission and Simulation Rate Limit
Transaction Count Restriction and Bundle Price
Ultra
Unlimited
  • Bundle Price: 0 BNB -- Transaction count: 1-2
  • Bundle Price: 0.002 BNB -- Transaction count: 3 or more
Enterprise-Elite
Unlimited
  • Bundle Price: 0 BNB -- Transaction count: 1-2
  • Bundle Price: 0.002 BNB -- Transaction count: 3-10
  • Bundle Price: 0.004 BNB -- Transaction count: 11-20
  • Bundle Price: 0.006 BNB -- Transaction count: 21-30
Enterprise
  • 12 bundle requests every block number
  • 4 bundle requests every second
  • Bundle Price: 0.0004 BNB -- Transaction count: 1-2
  • Bundle Price: 0.004 BNB -- Transaction count: 3-5
  • Bundle Price: 0.008 BNB -- Transaction count: 6-10
  • Bundle Price: 0.012 BNB -- Transaction count: 11-15
Professional
  • 4 bundle requests every block number
  • 2 bundle requests every second
  • Bundle Price: 0.0004 BNB -- Transaction count: 1-2
  • Bundle Price: 0.004 BNB -- Transaction count: 3
  • Bundle Price: 0.008 BNB -- Transaction count: 4-6
  • Bundle Price: 0.012 BNB -- Transaction count: 7-9
Introductory
  • 2 bundle requests every block number
  • 1 bundle request every second
  • Bundle Price: 0.0004 BNB -- Transaction count: 1-2
  • Bundle Price: 0.004 BNB -- Transaction count: 3
  • Bundle Price: 0.008 BNB -- Transaction count: 4-6
  • Bundle Price: 0.012 BNB -- Transaction count: 7-9