eureka_getBundleStats

Retrieve inclusion statistics and simulation details for a previously submitted bundle, identified by its bundle hash.

Parameters

Either a plain bundleHash string, or an object:

Field	Type	Required	Description
bundleHash	string	Yes	The 0x-prefixed bundle hash returned by eth_sendBundle
accessToken	string	No	Optional access token for retrieving additional private details

Shorthand form (string only):

"params": ["0xabcdef..."]

Object form:

"params": [{ "bundleHash": "0xabcdef...", "accessToken": "your-token" }]

Request

{
  "jsonrpc": "2.0",
  "method": "eureka_getBundleStats",
  "params": [{ "bundleHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890" }],
  "id": 1
}

Response

{
  "jsonrpc": "2.0",
  "result": {
    "bundleHash": "0xabcdef...",
    "replacementUuid": "550e8400-e29b-41d4-a716-446655440000",
    "submittedAt": "2024-01-15T12:00:00Z",
    "status": "included",
    "canonicalStatus": "included",
    "builderPayment": "15000000000000000",
    "error": "",
    "timeline": [
      { "event": "received", "timestamp": "2024-01-15T12:00:00.100Z" },
      { "event": "simulated", "timestamp": "2024-01-15T12:00:00.150Z" },
      { "event": "included", "timestamp": "2024-01-15T12:00:12.000Z" }
    ],
    "targetBlock": 20000000,
    "simValue": "15000000000000000",
    "bundleTxs": [
      { "txHash": "0x1234..." },
      { "txHash": "0x5678..." }
    ],
    "refundRecipient": "0xabc...",
    "isExclusive": false,
    "competingBundleCount": 3,
    "blockWinningPayment": "120000000000000000"
  },
  "id": 1
}

Response Fields

Field	Type	Description
bundleHash	string	The bundle hash
replacementUuid	string | null	Replacement UUID if one was provided at submission
submittedAt	string	ISO 8601 timestamp of when the bundle was received
status	string	Current bundle status (e.g. received, simulated, included, failed, expired)
canonicalStatus	string	Canonical status after on-chain confirmation
builderPayment	string	Builder payment in wei (as decimal string)
error	string	Error message if the bundle failed simulation or inclusion
timeline	object[]	List of timestamped events in the bundle's lifecycle
targetBlock	number | null	The block number the bundle targeted
simValue	string | null	Simulated value in wei
bundleTxs	object[] | null	Transaction hashes in the bundle
refundRecipient	string | null	Address receiving refunds, if configured
isExclusive	boolean | null	Whether the bundle had exclusive access to the block
competingBundleCount	number | null	Number of competing bundles targeting the same block
blockWinningPayment	string | null	The winning payment for the block, in wei

Notes

• Bundle stats are retained for approximately 7 days.

• Rate limit: 50 requests per second.