bombora

named for the bombora — submerged reef formations that shape powerful, rolling waves. we build the deep structure beneath the surface.

rpc.bombora.build

Documentation

Submit bundles and private transactions directly to bombora.

Getting Started

Point your client at the RPC endpoint to submit bundles and private transactions.

RPC Endpoint

https://rpc.bombora.build

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..."],
      "blockNumber": "0x1234567",
      "minTimestamp": 1234567890,
      "maxTimestamp": 1234567899,
      "revertingTxHashes": ["0x..."],
      "droppingTxHashes": ["0x..."],
      "replacementUuid": "uuid-string",
      "refundPercent": 50,
      "refundRecipient": "0x...",
      "refundTxHashes": ["0x..."]
    }
  ]
}

txsArray of signed transactions to execute atomically (RLP-encoded hex).

blockNumberBlock number for which this bundle is valid (hex). Optional.

minTimestampMinimum unix timestamp for bundle validity. Optional.

maxTimestampMaximum unix timestamp for bundle validity. Optional.

revertingTxHashesTx hashes allowed to revert without failing the bundle. Optional.

droppingTxHashesTx hashes that may be discarded but must not revert. Optional.

replacementUuidUUID for cancelling or replacing this bundle. Optional.

refundPercentPercentage (0–99) of bundle ETH reward to refund. Optional.

refundRecipientAddress receiving the refund. Defaults to first tx sender. Optional.

refundTxHashesTx hashes used to determine the refund (max 1). Optional.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "bundleHash": "0x..."
  }
}

eth_cancelBundle

Cancel a pending bundle via its replacement UUID.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_cancelBundle",
  "params": [
    {
      "replacementUuid": "uuid-string"
    }
  ]
}

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

eth_sendRawTransaction

Submit a single private transaction.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendRawTransaction",
  "params": ["0x..."]
}

eth_sendPrivateTransaction

Submit a single private transaction with an optional block number ceiling.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendPrivateTransaction",
  "params": [
    {
      "tx": "0x...",
      "maxBlockNumber": "0x1234567"
    }
  ]
}

txSigned raw transaction (RLP-encoded hex).

maxBlockNumberLast block in which the tx should be included (hex). Optional.