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. Below is the dynamic service fee approach for sharing the profits:

Dynamic service fee [payment to validator and bloXroute with a single BNB transfer]:

Payment to both validator and bloXroute can be done through a single transfer of BNB to address 0x74c5F8C6ffe41AD4789602BDB9a48E6Cad623520. The transfer can be either an internal transaction transfer (which may require a custom smart contract), or an extra regular transaction added to the bundle. When using this approach, searchers don’t need to send additional bundle service fee to bloXroute address (currently 0x965Df5Ff6116C395187E288e5C87fb96CfB8141c)

Priority fee refund [refund of the payment from bloXroute back to searcher]:

Searcher may provide their destination address with refund_recipient field. In that case dynamic service fee would be considered as maximum applicable bribe. bloXroute will consider that searcher sends bloXroute the bundle exclusively. bloXroute BSC builder will try to minimize the bundle bribe down to probable winning on the in turn validator. After that builder will refund what is left (minus bloXroute fee) back to the address searcher has provided. In case of a duplicate opportunity (conflicting target transaction) from other searcher, bloXroute BSC builder will organize the internal auction, and will still try to partially refund to the winner.

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.
mev_builders	[Optional, default: all builder] A dictionary of MEV builders that should receive the bundle. For each MEV builder, a signature (which can be an empty string) is required. Possible MEV builders are: bloxroute: bloXroute internal builder (always enabled for all MEV bundle submission requests) all: all builders
avoid_mixed_bundles	[Optional, default: False] A boolean indicating whether it is okay to mix the bundle with other bundles and transactions. If false, then there might be other transactions inserted into the bundle assuming the original transactions in the bundle don't revert.
refund_recipient	[Optional] Address to accept the possible partial payment refund.

Examples (Cloud API)

HTTPS POST

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",
            "mev_builders": {
                "all": ""
            }
          }
        }'

wscat

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", "mev_builders": {"all": ""}}}

Rate Limit and Restriction

Plan	Submission and Simulation Rate Limit
Ultra	Unlimited
Enterprise-Elite	Unlimited
Enterprise	12 bundle requests every block number 4 bundle requests every second
Professional	4 bundle requests every block number 2 bundle requests every second
Introductory	2 bundle requests every block number 1 bundle request every second