> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过 Helius 发送 Jito Bundles

> 通过您的 Helius RPC 端点发送 [Jito](https://docs.jito.wtf/lowlatencytxnsend) bundles。原子性，最多可执行 5 个交易的全有或全无执行。

## 支持的方法

| 方法                  | 描述                                                                      | 速率限制        |
| ------------------- | ----------------------------------------------------------------------- | ----------- |
| `sendBundle`        | 提交一个 [Jito bundle](https://docs.jito.wtf/lowlatencytxnsend/#sendbundle) | 每个项目 5 RPS  |
| `getBundleStatuses` | 检查已提交的 bundles 的状态                                                      | 一般 RPC 速率限制 |
| `simulateBundle`    | 模拟而不提交 bundle                                                           | 一般 RPC 速率限制 |

<Tip>
  需要更高的速率限制？[联系我们的销售团队](https://www.helius.dev/contact)。
</Tip>

## sendBundle

提交一组签名交易作为原子 bundle。如果 bundle 被接受，将返回一个 `bundle_id`（交易签名的 SHA-256 哈希）。这并不保证 bundle 会上链——使用 `getBundleStatuses` 检查。

需要支付小费。至少一个交易必须向 [Jito 小费账户](#tip-accounts) 转账 SOL。如果小费过低，bundle 可能在拍卖中未被选中。

### 请求

| 参数                   | 类型              | 描述                                     |
| -------------------- | --------------- | -------------------------------------- |
| `params[0]`          | `array[string]` | **必需。** 最多 5 个完全签名的交易，base64 编码。       |
| `params[1].encoding` | `string`        | 可选。`base64`（推荐）或 `base58`。默认：`base58`。 |

### 示例

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

### 响应

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
  "id": 1
}
```

`result` 是 bundle ID——使用它与 `getBundleStatuses` 跟踪上链。

## getBundleStatuses

返回已提交 bundles 的状态。如果某个 bundle 未上链或未找到，则返回 `null`。

### 请求

| 参数          | 类型              | 描述                        |
| ----------- | --------------- | ------------------------- |
| `params[0]` | `array[string]` | **必需。** 最多 5 个 bundle ID。 |

### 示例

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBundleStatuses",
    "params": [
      [
        "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"
      ]
    ]
  }'
```

### 响应

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

对于未找到的捆绑包，在数组中返回 `null`。

## 区域路由

默认情况下，Helius 将您的捆绑包路由到 Jito 的全球端点（`mainnet.block-engine.jito.wtf`），该端点会自动地理路由到最近的 Block Engine。

要定位特定区域，请设置 `jito-region` HTTP 头：

| 头值        | Block Engine 区域 |
| --------- | --------------- |
| `ams`     | 阿姆斯特丹           |
| `dub`     | 都柏林             |
| `fra`     | 法兰克福            |
| `lon`     | 伦敦              |
| `nyc`     | 纽约              |
| `slc`     | 盐湖城             |
| `sgp`     | 新加坡             |
| `tyo`     | 东京              |
| `mainnet` | 全球（地理路由）        |

### 带区域的示例

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "jito-region: nyc" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      [
        "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
        "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
      ],
      {
        "encoding": "base64"
      }
    ]
  }'
```

<Note>
  如果省略 `jito-region` 头，捆绑包将发送到 Jito 的全球端点，它会自动路由到最近的 Block Engine。对大多数用户来说，这是最佳默认设置。
</Note>

## 小费账户

您的捆绑包中至少一个交易必须包括向这些小费账户之一的 SOL 转账。随机选择一个以减少争用。

```text theme={"system"}
3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT
HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe
Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY
DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh
ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt
DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL
96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5
ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49
```

最低小费为 1,000 lamports，但在拥塞期间实际上会更高。参见 [Jito 小费指南](https://docs.jito.wtf/lowlatencytxnsend/#tips) 以获取当前推荐。

## 捆绑要求

* 每个捆绑包最多 **5 笔交易**
* 所有交易必须 **完全签名**
* 使用 **base64** 编码（推荐超过 base58 用于性能）
* 至少一笔交易必须包含 **小费**
* 交易 **按顺序** 执行 — tx2 可以依赖于 tx1 的状态变化
* 如果任何交易失败，**整个捆绑包被拒绝**

## simulateBundle（可选）

您可以在提交前模拟您的捆绑包以检查错误：

```bash theme={"system"}
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "simulateBundle",
    "params": [
      {
        "encodedTransactions": [
          "AT2AqtlokikUWgGNnSX5xrmdvBjSaiIPxvFz6zc5Abn5Z0CPFW5GO+Y3rXceLnqLgQFnGw0yTk3NtJdFNsbrwwQBAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAwOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA==",
          "AS6fOZuGDsmyYdd+RC0fiFUgNe1BYTOYT+1hkRXHAeroC8R60h3g34EPF5Ys8sGzVBMP9MDSTVgy1/SSTqpCtA4BAAIEsXPDJ9cMVbpFQYClVM7PGLh8JOfCD6E2vz5VNmBCF+p4Uhyxec67hYm1VqLV7JTSSYaC/fm7KvWtZOSRzEFT2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1i3Wzl2VfewCI8oYXParnP78725sKFzYheTEn8v865YQIDABhqaXRvIGJ1bmRsZSAxOiBqaXRvIHRlc3QCAgABDAIAAACghgEAAAAAAA=="
        ]
      }
    ]
  }'
```