BackRunMe: Bundle Simulation

REQUEST

Method: simulate_arb_only_bundle

Simulate the execution of an MEV bundle that uses private transactions from the arbOnlyMev transactions stream.

The simulate_arb_only_bundle is a cloud-api request and it is only available at a single cloud api pointed by DNS name backrunme.blxrbdn.com .

Follow the BackRunMe program rules for the arbitrage profit distribution guidelines.

Parameters

Parameter

Description

transaction_hash

Trigger private transaction hash.

transaction

A list of raw transaction bytes without a 0x prefix that are meant to immediately follow the trigger private transaction.

block_number

Block number of a future block to include this bundle in, in hex value.

state_block_number

[Optional] Block number used as the base state to run a simulation on. Valid inputs include hex value of block number, or tags like β€œlatest” and β€œpending”. Default value is β€œlatest”.

timestamp

[Optional] Simulation timestamp, an integer in unix epoch format. Default value is None.

Example

curl https://backrunme.blxrbdn.com \
    --insecure \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{"method": "simulate_arb_only_bundle", 
         "id": "1", 
         "params": {
            "transaction_hash": "ab..ab"
            "transaction": ["cd..cd", "ef..ef"],
            "block_number": "0xba10d0",
            "state_block_number": "latest",
            "timestamp": 1617806320
         }
        }'
     

RESPONSE

Example

{
    "jsonrpc": "2.0",
    "id": "1",
    "result": {
        "bloxrouteDiff": "10000",
        "bundleGasPrice": "20000000000",
        "bundleHash": "0x11aa...",
        "ethSentToCoinbase": "150000000000000000",
        "gasFees": "840000000000000",
        "minerDiff": "100000",
        "results": [
            {
                "gasUsed": 21000,
                "txHash": "0xaac...",
                "value": "0x..."
            },
            {
                "gasUsed": 21000,
                "txHash": "0xaad...",
                "value": "0x..."
            },
            {
                "gasUsed": 21000,
                "txHash": "0x123...",
                "value": "0x..."
            }
        ],
        "senderDiff": "50000",
        "stateBlockNumber": 12188038,
        "totalGasUsed": 42000,
        "status": good  // indicates that the profit distribution is acceptable
    }
}

Last updated