> ## 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 経由でのバンドル

> Helius RPC エンドポイントを通じて基本的なバンドルを送信します。最大 5 つのトランザクションを Jito に直接プロキシする、アトミックなオールオアナッシング実行。

<Tip>
  これは **基本的な** バンドルパスです — 直接 Jito プロキシで、送信ごとに請求され、レイテンシー要件がない場合にアトミック実行が必要なときに最適です。低レイテンシーと優先ヒントバッファが必要なトレーダーの方は、代わりに [Sender Max バンドル](/ja/sending-transactions/sender-max#bundles) を使用してください。
</Tip>

基本的なバンドルは、最大 5 つのトランザクションを Jito に直接プロキシし、アトミックなオールオアナッシング実行を提供します。各 `sendBundle` の送信は、プランから **1 クレジット** として請求されます。

## 対応するメソッド

| メソッド             | 説明               | レート制限           |
| ---------------- | ---------------- | --------------- |
| `sendBundle`     | バンドルを送信          | プロジェクトごとに 5 RPS |
| `simulateBundle` | 提出せずにバンドルをシミュレート | 一般的な RPC レート制限  |

<Tip>
  より高いレート制限が必要ですか？ [営業チームに
  連絡してください](https://www.helius.dev/contact)。
</Tip>

## sendBundle

署名済みトランザクションのリストをアトミックバンドルとして送信します。バンドルが受け入れられると、`bundle_id` （トランザクション署名の SHA-256 ハッシュ）を返します。これによりバンドルがオンチェーンに載ることは保証されません。確認するには、チェーン上でトランザクションの確認を行ってください。

チップは必須です。少なくとも 1 つのトランザクションが [Helius チップアカウント](#tip-accounts) への SOL 転送を含む必要があります。チップが少なすぎる場合、バンドルは選択されないことがあります。

### リクエスト

| パラメータ                | タイプ             | 説明                                              |
| -------------------- | --------------- | ----------------------------------------------- |
| `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` はバンドルIDです — `getBundleStatuses` を使って上場を追跡します。

## getBundleStatuses

送信されたバンドルのステータスを返します。バンドルが上場していないか見つからない場合、`null` を返します。

### リクエスト

| パラメータ       | タイプ             | 説明                     |
| ----------- | --------------- | ---------------------- |
| `params[0]` | `array[string]` | **必須。** 最大 5 つのバンドル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
}
```

見つからないバンドルに対して、`value` 配列に `null` を返します。

## リージョンルーティング

デフォルトで、Helius はあなたのバンドルを Jito のグローバルエンドポイント (`mainnet.block-engine.jito.wtf`) にルーティングし、最寄りのブロックエンジンに自動的にジオルーティングします。

特定のリージョンをターゲットにするには、`jito-region` HTTP ヘッダーを設定してください:

| ヘッダー値     | ブロックエンジンリージョン    |
| --------- | ---------------- |
| `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"
      }
    ]
  }'
```

## チップアカウント

バンドル内の少なくとも 1 つのトランザクションに、これらのチップアカウントのいずれかへの SOL 転送を含める必要があります。競合を減らすためにランダムに選択してください。

```text theme={"system"}
4ACfpUFoaSD9bfPdeu6DBt89gB6ENTeHBXCAi87NhDEE
D2L6yPZ2FmmmTKPgzaMKdhu6EWZcTpLy1Vhx8uvZe7NZ
9bnz4RShgq1hAnLnZbP8kbgBg1kEmcJBYQq3gQbmnSta
5VY91ws6B2hMmBFRsXkoAAdsPHBJwRfBht4DXox3xkwn
2nyhqdwKcJZR2vcqCyrYsaPVdAnFoJjiksCXJ7hfEYgD
2q5pghRs6arqVjRvT5gfgWfWcHWmw1ZuCzphgd5KfWGJ
wyvPkWjVZz1M8fHQnMMCDTQDbkManefNNhweYk5WkcF
3KCKozbAaF75qEU33jtzozcJ29yJuaLJTy2jFdzUY8bT
4vieeGHPYPG2MmyPRcYjdiDmmhN3ww7hsFNap8pVN3Ey
4TQLFNWK8AovT1gFvda5jfw2oJeRMKEmw7aH6MGBJ3or
```

最小チップは 5,000 ランプポーツです。

## バンドル要件

* バンドルごとに最大 5 つのトランザクション
* すべてのトランザクションは **完全に署名** される必要があります
* **base64** エンコーディングを使用（パフォーマンスのために base58 より推奨）
* 少なくとも 1 つのトランザクションに **チップ** を含める必要があります
* トランザクションは **順次実行** されます — 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=="
        ]
      }
    ]
  }'
```

## サンドイッチ攻撃からの保護

統計的にサンドイッチ攻撃に関連するバリデータからバンドルをルートするには、RPC URL に `mev-protect=true` クエリパラメータを追加してください — バンドルに変更はありません：

```
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY&mev-protect=true
```

## 参照

<CardGroup cols={2}>
  <Card title="MEV Protect" icon="shield-halved" href="/ja/sending-transactions/mev-protect">
    統計的にサンドイッチ攻撃に関連するバリデータを避けるルートです。
  </Card>

  <Card title="トランザクションリベート" icon="coins" href="/ja/sending-transactions/backrun-rebates">
    作成した MEV のシェアを SOL で受け取るように、単一の `sendTransaction` コールでオプトインします。
  </Card>
</CardGroup>