Bundle Service for BSC blockchain

Overview

These APIs deliver improved privacy and atomicity for transactions on the BNB Smart Chain (BSC) network. By adopting the BEP322 standard, the following features are made available

Batch Transactions

The API enables combining multiple transactions into a single ‘bundle’, which can be submitted through one API call. The order of transactions within the bundle and the block is strictly maintained for consistent execution

Atomic Execution

Transactions within a bundle are either all included on-chain or none at all, ensuring that partial execution never occurs

Transaction Privacy

Transactions sent via this API are not propagated across the P2P network, keeping them hidden from third parties and protecting against sandwich attacks

Gas Efficiency

If any transaction in the bundle fails, the entire bundle will not be processed, preventing unnecessary gas expenditure

How to use

While the service is in beta testing status, the method is available without any subscription

API Methods list

eth_sendBundle

Can be used to send your bundles to the builder and get bundle hash

// request
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_sendBundle",
    "params": [
        {
            "txs": [
               // signed raw txs
               "0x...", 
               "0x..."
            ],
            "maxBlockNumber": 0,
            "minTimestamp": 1725148800,
            "maxTimestamp": 1725148800,
            "revertingTxHashes": null
        }
    ]
}

// response
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        // bundle hash
        "0x..."
    ]
}

// failed
{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "no valid sim result"
    }
}

eth_bundlePrice

Can be used to query the floor gas price for a bundle

// request
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_bundlePrice"
}

// response
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": 3000000000
}

API endpoints

Network

URL

BSC

Last updated 8 months ago