通过 Helius 发送捆绑包

这是基础捆绑路径——一个直接的 Jito 代理，每次发送计费，最适合需要原子执行但无延迟要求的情况。如果您是需要低延迟和优先提示缓冲的交易者，请改用 Sender Max 捆绑包。

基础捆绑包为您提供最多 5 个交易的原子性全或无执行，直接代理到 Jito。每次 sendBundle 提交计为从您的计划中扣除1 个信用。

支持的方法

方法	描述	速率限制
`sendBundle`	提交捆绑包	每个项目 5 RPS
`simulateBundle`	模拟捆绑包但不提交	一般 RPC 速率限制

需要更高的速率限制？联系我们的销售团队。

发送捆绑包

提交一个已签名的交易列表作为一个原子捆绑包。如果捆绑包被接受，返回 bundle_id（交易签名的 SHA-256 哈希）。这并不保证捆绑包会在链上实现。请在链上检查交易确认以验证。需要提示。至少一个交易必须将 SOL 转入 Helius 提示账户。如果提示过低，捆绑包可能不会被选中。

请求

参数	类型	描述
`params[0]`	`array[string]`	必需。最多 5 个完全签名的交易，base64 编码。
`params[1].encoding`	`string`	可选。建议使用 `base64` 或 `base58`。默认：`base58`。

示例

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"
      }
    ]
  }'

响应

{
  "jsonrpc": "2.0",
  "result": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
  "id": 1
}

result 是包 ID — 使用它与 getBundleStatuses 跟踪着陆。

getBundleStatuses

返回提交包的状态。如果包未着陆或未找到，它返回 null。

请求

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

示例

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"
      ]
    ]
  }'

响应

{
  "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`	全球（地理路由）

区域示例

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"
      }
    ]
  }'

提示账户

您的包中至少有一笔交易必须包含向其中一个提示账户的 SOL 转账。随机选择一个以减少争用。

4ACfpUFoaSD9bfPdeu6DBt89gB6ENTeHBXCAi87NhDEE
D2L6yPZ2FmmmTKPgzaMKdhu6EWZcTpLy1Vhx8uvZe7NZ
9bnz4RShgq1hAnLnZbP8kbgBg1kEmcJBYQq3gQbmnSta
5VY91ws6B2hMmBFRsXkoAAdsPHBJwRfBht4DXox3xkwn
2nyhqdwKcJZR2vcqCyrYsaPVdAnFoJjiksCXJ7hfEYgD
2q5pghRs6arqVjRvT5gfgWfWcHWmw1ZuCzphgd5KfWGJ
wyvPkWjVZz1M8fHQnMMCDTQDbkManefNNhweYk5WkcF
3KCKozbAaF75qEU33jtzozcJ29yJuaLJTy2jFdzUY8bT
4vieeGHPYPG2MmyPRcYjdiDmmhN3ww7hsFNap8pVN3Ey
4TQLFNWK8AovT1gFvda5jfw2oJeRMKEmw7aH6MGBJ3or

最低提示为 5,000 lamports。

包要求

每个包最多 5 笔交易
所有交易必须 完全签名
使用 base64 编码（推荐优于 base58 的性能）
至少一个交易必须包含小费
交易按顺序执行 —— tx2 可以依赖于 tx1 的状态变化

模拟捆绑（可选）

在提交之前，可以选择模拟您的捆绑以检查错误：

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

另请参阅

MEV Protect

绕过与夹心攻击统计相关的验证者。

Transaction Rebates

选择单次sendTransaction调用，以获得您创建的MEV份额，以SOL支付。

入门指南

数据流与事件监听

数据 API 与 RPC

交易

发送交易

Wallet-as-a-Service

指南

资源

通过 Helius 发送捆绑包

支持的方法

发送捆绑包

请求

示例

响应

getBundleStatuses

请求

示例

响应

区域路由

区域示例

提示账户

包要求

模拟捆绑（可选）

防范夹心攻击

另请参阅

MEV Protect

Transaction Rebates

​支持的方法

​发送捆绑包

​请求

​示例

​响应

​getBundleStatuses

​请求

​示例

​响应

​区域路由

​区域示例

​提示账户

​包要求

​模拟捆绑（可选）

​防范夹心攻击

​另请参阅

MEV Protect

Transaction Rebates

支持的方法

发送捆绑包

请求

示例

响应

getBundleStatuses

请求

示例

响应

区域路由

区域示例

提示账户

包要求

模拟捆绑（可选）

防范夹心攻击

另请参阅