eureka_getBundleRefundInfo

Retrieve refund and kickback information for a submitted bundle. Use this to verify that refund parameters were applied correctly and to look up the refund payout transaction.

Parameters

Field	Type	Required	Description
bundleHash	string	Yes	The 0x-prefixed bundle hash returned by eth_sendBundle

Request

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

Response

{
  "jsonrpc": "2.0",
  "result": {
    "refundRecipient": "0xabc123...",
    "kickback": {
      "amount": "5000000000000000",
      "txHash": "0xdef456..."
    },
    "isExclusive": false,
    "payoutTxHash": "0xdef456..."
  },
  "id": 1
}

Response Fields

Field	Type	Description
refundRecipient	string | null	Address that receives the refund payment
kickback	object | null	Kickback details if a refund was paid out
kickback.amount	string	Refund amount in wei (decimal string)
kickback.txHash	string	Transaction hash of the refund payout
isExclusive	boolean | null	Whether the bundle had exclusive block access
payoutTxHash	string | null	On-chain transaction hash of the refund payment

Notes

• Returns null fields for bundles that did not include refund parameters.

• Rate limit: 50 requests per second.

• See eth_sendBundle for details on how to configure refundPercent and refundRecipient.