getBundleStatuses

getBundleStatuses

Returns bundle statuses for submitted bundle(s). The behavior is similar to the solana rpc method getSignatureStatuses. If the bundle_id is not found or if the bundle has not landed, we return null. If found and landed, we return the context information including the slot at which the request was made and result with the bundle_id(s) and the transactions with the slot and confirmation status.

Please note that we use getSignatureStatuses with the default value of searchTransactionHistory (false) to check the transaction statuses on chain. What this means is the rpc will only search it's recent history, including all recent slots, plus up to [MAX_RECENT_BLOCKHASHES] rooted slots for the transactions. currently MAX_RECENT_BLOCKHASHES = 300.

Parameters

  • <array[string]>: required An array of bundle ids to confirm, as base-58 encoded strings (up to a maximum of 5).

Result

An array of RpcResponse<object> consisting of either:

  • <null>: If the bundle is not found.

  • <object>: If the bundle is found, an array of objects with the following fields:

    • bundle_id: <String> Bundle id

    • transactions: <array[string]> - A list of base-58 encoded signatures applied by the bundle. The list will not be empty.

    • slot: <u64> The slot this bundle was processed in.

    • confirmationStatus: <string|null> - The bundle transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.

    • err: <object|null>: This will show any retryable or non-retryable error encountered when getting the bundle status. If retryable, please query again

Code sample

Request

curl https://mainnet.block-engine.jito.wtf/api/v1/bundles -X POST -H "Content-Type: application/json" -d '
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
      [
        "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
      ]
    ]
}
'

Response

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 242806119
    },
    "value": [
      {
        "bundle_id": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
        "transactions": [
          "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
          "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
        ],
        "slot": 242804011,
        "confirmation_status": "finalized",
        "err": {
          "Ok": null
        }
      }
    ]
  },
  "id": 1
}

Last updated