Jito Bundles

Backpac provides functionality for interacting with Jito using your existing load balanced Backpac RPC endpoint. Backpac automatically forwards JSON-RPC Jito bundles request to Jito URL path /api/v1/transactions. Just send your JSON-RPC requests to your Backpac RPC endpoint with your API Key and Backpac handles the rest.

For detailed information about Jito Transactions (sendTransaction), please see Jito Transactions.

What are Bundles?

Jito offers Solana MEV users enhanced transaction execution with fast landing, MEV protection, and revert protection.

Bundles are groups of transactions (max 5) bundled together
The transactions are executed sequentially and atomically meaning all-or-nothing
Bundles enable complex MEV strategies like atomic arbitrage
Bundles compete against other bundles on tips to the validator

Endpoint

URL: `https://solana-mainnet.backpac.xyz/{YOUR_API_KEY}`

Method: `POST`

Bundles

get_inflight_bundle_statuses: Retrieve the status of in-flight bundles.
get_bundle_statuses: Fetch the statuses of submitted bundles.
get_tip_accounts: Get accounts eligible for tips.
send_bundle: Submit bundles to the Jito Block Engine.

sendBundle

Submits a bundled list of signed transactions to the cluster for processing. The transactions are atomically processed in order, meaning if any transaction fails, the entire bundle is rejected (all or nothing).

If the bundle is set to expire after the next Jito-Solana leader, this method immediately returns a success response with a bundle_id, indicating the bundle has been received. However, this does not guarantee the bundle will be processed or land on-chain. To check the bundle status, use getBundleStatuses with the bundle_id.

A tip is necessary for the bundle to be considered. The tip can be any instruction, top-level or CPI, that transfers SOL to one of the 8 tip accounts. Clients should ensure they have sufficient balance and state assertions to allow the tip to go through conditionally, especially if tipping as a separate transaction. If the tip is too low, the bundle might not be selected during the auction. Use getTipAccounts to retrieve the tip accounts. Ideally, select one of the accounts at random to reduce contention.

Request Parameters

Parameter	Type	Description
`params`	array[string]	REQUIRED: Fully-signed transactions, as base58 (slow, DEPRECATED) or base64 encoded strings. Maximum of 5 transactions.
`encoding`	string	OPTIONAL: Encoding used for the transaction data. Values: `base58` (slow, DEPRECATED) or `base64`. Default: `base58`.

Request Example (Base64)

bash

curl https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} -X POST -H "Content-Type: application/json" -d '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sendBundle",
  "params": [
    [
      "AbKi19sammgVRlYLdvIwJ8DGEBCk5TmwgRmwWw+IAlkmIqvIXBfY/qYxrFwQGJZq4UvBXDAqmCTkDvQueLsJGAUBAAECZAJMcn3luKBgXdzj8FTKBu8ndFClGLdh/38acclb7JwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM5VmqzBOi86PgXATWyyLk9tLPT8SstEH1LaVXnHY/BoAQECAAAMAgAAAAAAAAAAAAAA"
    ],
    {
      "encoding": "base64"
    }
  ]
}'

Response Example

json

{
    "jsonrpc": "2.0",
    "result": "2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8rkxwPYPe8cSwE5GzhEgJA2y8fVjDEo6iR6ykBvDxrTQrtpb",
    "id": 1
}

getBundleStatuses

The getBundleStatuses method returns the status of one or more submitted bundles. It is similar to the Solana RPC method getSignatureStatuses. If a bundle_id is not found or has not landed, it will return null. If the bundle is found and processed, it will return contextual information, including the slot in which the bundle was processed, as well as the confirmation status of each transaction within the bundle.

Request Parameters

Parameter	Type	Description
`params`	array[string]	REQUIRED: An array of `bundle_id` values to confirm (maximum of 5). Each `bundle_id` is a string representing a unique bundle.

Request Example

bash

curl https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} -X POST -H "Content-Type: application/json" -d '
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
        [
            "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
        ]
    ]
}
'

Response Properties

Field	Type	Description
`bundle_id`	string	The unique `bundle_id` associated with the submitted bundle.
`transactions`	array	A list of base-58 encoded transaction signatures applied by the bundle.
`slot`	u64	The Solana slot at which the bundle was processed.
`confirmationStatus`	string	The confirmation status of the transactions in the bundle. Possible values: `processed`, `confirmed`, `finalized`.
`err`	object	Any retryable or non-retryable error encountered during the status retrieval. If no error occurred, this will be `null`.

Response Example

json

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 242806119
    },
    "value": [
      {
        "bundle_id": "892b79ed...",
        "transactions": ["5j2d8b4...", "3b2z5f3..."],
        "slot": 242806119,
        "confirmationStatus": "processed",
        "err": null
      }
    ]
  }
}

getTipAccounts

Retrieves the tip accounts designated for tip payments for bundles. The tip accounts have remained constant and can also be found here.

Request Parameters

Parameter	Type	Description
None	None	None

Request Example

bash

curl https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} -X POST -H "Content-Type: application/json" -d '
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTipAccounts",
    "params": []
}
'

Response Properties

Field	Type	Description
`result`	array	Tip accounts as a list of strings.

Response Example

json

{    
    "jsonrpc": "2.0",
    "result": [
        "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
        "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
        "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
        "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
        "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
        "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
        "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
        "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"
    ],
    "id": 1
}

getInflightBundleStatuses

Returns the status of submitted bundles within the last five minutes, allowing up to five bundle IDs per request.

Statuses

Failed: Indicates that all regions have marked the bundle as failed, and it has not been forwarded.
Pending: Indicates the bundle has not failed, landed, or been deemed invalid.
Landed: Signifies the bundle has successfully landed on-chain, verified through RPC or the bundles_landed table.
Invalid: Means the bundle is no longer in the system.

Request Parameters

Parameter	Type	Description
`params`	array	REQUIRED: An array of bundle IDs to confirm (up to a maximum of 5).

Request Example

bash

curl https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} -X POST -H "Content-Type: application/json" -d '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getInflightBundleStatuses",
  "params": [
    [
      "b31e5fae4923f345218403ac1ab242b46a72d4f2a38d131f474255ae88f1ec9a",
      "e3c4d7933cf3210489b17307a14afbab2e4ae3c67c9e7157156f191f047aa6e8",
      "a7abecabd9a165bc73fd92c809da4dc25474e1227e61339f02b35ce91c9965e2",
      "e3934d2f81edbc161c2b8bb352523cc5f74d49e8d4db81b222c553de60a66514",
      "2cd515429ae99487dfac24b170248f6929e4fd849aa7957cccc1daf75f666b54" 
    ]
  ]
}
'

Response Properties

Field	Type	Description
`context`	object	Contains additional context for the response, such as the slot information.
`context.slot`	u64	The slot number associated with the current response.
`value`	array	An array of bundle status objects.

Object Fields

Field	Type	Description
`bundle_id`	string	The ID of the bundle.
`status`	string	The status of the bundle: `Invalid`, `Pending`, `Failed`, or `Landed`.
`landed_slot`	u64	The slot number where the bundle landed. `null` if the status is `Invalid`.

Response Example

json

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 280999028
    },
    "value": [
      {
        "bundle_id": "b31e5fae4923f345218403ac1ab242b46a72d4f2a38d131f474255ae88f1ec9a",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "e3c4d7933cf3210489b17307a14afbab2e4ae3c67c9e7157156f191f047aa6e8",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "a7abecabd9a165bc73fd92c809da4dc25474e1227e61339f02b35ce91c9965e2",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "e3934d2f81edbc161c2b8bb352523cc5f74d49e8d4db81b222c553de60a66514",
        "status": "Invalid",
        "landed_slot": null
      },
      {
        "bundle_id": "2cd515429ae99487dfac24b170248f6929e4fd849aa7957cccc1daf75f666b54",
        "status": "Invalid",
        "landed_slot": null
      }
    ]
  },
  "id": 1
}

Jito Bundles ​

What are Bundles? ​

Endpoint ​

URL: https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} ​

Method: POST ​

Bundles ​

sendBundle ​

Request Parameters ​

Request Example (Base64) ​

Response Example ​

getBundleStatuses ​

Request Parameters ​

Request Example ​

Response Properties ​

Response Example ​

getTipAccounts ​

Request Parameters ​

Request Example ​

Response Properties ​

Response Example ​

getInflightBundleStatuses ​

Statuses ​

Request Parameters ​

Request Example ​

Response Properties ​

Object Fields ​

Response Example ​

Jito Bundles

What are Bundles?

Endpoint

URL: `https://solana-mainnet.backpac.xyz/{YOUR_API_KEY}`

Method: `POST`

Bundles

sendBundle

Request Parameters

Request Example (Base64)

Response Example

getBundleStatuses

Request Parameters

Request Example

Response Properties

Response Example

getTipAccounts

Request Parameters

Request Example

Response Properties

Response Example

getInflightBundleStatuses

Statuses

Request Parameters

Request Example

Response Properties

Object Fields

Response Example