bombora_getBundleStats

Check what happened to a bundle you submitted to Bombora. Returns whether the bundle passed simulation, whether it was included in a block we built, the builder payment we saw, and any errors.

Stats are available four blocks (≈48 seconds) after Bombora receives the bundle. Earlier calls return a normal result with status: "Pending".

We follow the layout from Titan's bundle-tracing API. titan_getBundleStats is accepted as an alias.

Endpoint

Bundle stats are served from a separate host from the bundle-submission RPC (Getting Started):

https://stats.bombora.buildClick to copy

Request

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

Parameters

Parameter	Required	Description
`bundleHash`	Yes	The 32-byte bundle hash returned by `eth_sendBundle`.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "IncludedInBlock",
    "builderPayment": "13618000000000",
    "builderPaymentWhenIncluded": "13618000000000",
    "error": ""
  }
}

Field	Description
`status`	What we currently know about the bundle. See Status Values.
`builderPayment`	Builder payment we observed on the bundle's entry simulation (the simulation Bombora runs when it first receives the bundle), in wei, truncated to whole gwei. Empty when the bundle failed simulation.
`builderPaymentWhenIncluded`	Builder payment observed when the bundle was used in a build attempt, in wei, truncated to whole gwei (same rounding as `builderPayment`). Populated when `status` is `IncludedInBlock` or `Submitted`; empty otherwise.
`error`	Free-text, human-readable reason when the bundle failed simulation in a way callers can act on. Empty otherwise.

Status Values

Status	Meaning
`NotFound`	Bombora has no record of this bundle: wrong hash, never submitted to us, or its data is no longer retained.
`Pending`	The bundle was received within the last four blocks and its outcome is still settling.
`Received`	The bundle was seen but has no simulation outcome to report.
`SimulationFail`	The bundle was rejected during simulation. `error` may carry more details.
`SimulationPass`	The bundle passed simulation on entry.
`IncludedInBlock`	The bundle was used in at least one block Bombora attempted to build. `builderPaymentWhenIncluded` reflects the payment from that build.
`Submitted`	Bombora submitted a block containing the bundle to at least one relay.