bananabuilddocumentation

Getting Started

Submit bundles directly to banana build's RPC endpoint.

RPC Endpoint:

https://rpc.bananabuild.org

eth_sendBundle

Submit a bundle of transactions for atomic execution within a block.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendBundle",
  "params": [
    {
      "txs": ["0x...", "0x..."],        // Array[String] - A list of signed transactions to execute in an atomic bundle (RLP-encoded hex).
      "blockNumber": "0x1234567",       // (Optional) String - Block number for which this bundle is valid (hex-encoded).
      "minTimestamp": 1234567890,       // (Optional) Number - The minimum timestamp for which this bundle is valid, in seconds since the unix epoch.
      "maxTimestamp": 1234567899,       // (Optional) Number - The maximum timestamp for which this bundle is valid, in seconds since the unix epoch.
      "revertingTxHashes": ["0x..."],   // (Optional) Array[String] - A list of tx hashes that are allowed to revert.
      "droppingTxHashes": ["0x..."],    // (Optional) Array[String] - A list of tx hashes that are allowed to be discarded, but must not revert.
      "replacementUuid": "uuid-string", // (Optional) String - UUID that can be used to cancel/replace this bundle.
      "refundPercent": 50,              // (Optional) Number - The percentage (from 0 to 99) of full bundle ETH reward that should be passed back to the user (refundRecipient) at the end of the bundle.
      "refundRecipient": "0x...",       // (Optional) String - Address that will receive the ETH refund. Default: sender of the first transaction in the bundle.
      "refundTxHashes": ["0x..."]       // (Optional) Array[String] - Max length 1. An array of transaction hashes used to determine the refund. If not provided or left empty, the refund will be based on the final transaction in the bundle.
    }
  ]
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "bundleHash": "0x..."               // String - Hash of the submitted bundle.
  }
}

eth_cancelBundle

Cancel a pending bundle submission via its unique replacement UUID.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_cancelBundle",
  "params": [
    {
      "replacementUuid": "uuid-string"  // String - The replacement UUID that was used when submitting the bundle.
    }
  ]
}

Note: Cancellation cannot be guaranteed close to the final relay submission (~4 sec).

eth_sendRawTransaction

Submit a single private transaction.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendRawTransaction",
  "params": ["0x..."]                   // String - Signed raw transaction (RLP-encoded hex).
}

eth_sendPrivateTransaction

Submit a single private transaction.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendPrivateTransaction",
  "params": [
    {
      "tx": "0x...",                    // String - Signed raw transaction (RLP-encoded hex).
      "maxBlockNumber": "0x1234567"     // (Optional) String - A hex-encoded string representing the block number of the last block in which the transaction should be included.
    }
  ]
}