simulateBundle Solana RPC 方法

POST

simulateBundle

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "simulateBundle",
  "params": [
    {
      "encodedTransactions": [
        "5rqF8aHfs9JyEtKTvND6z8RgBtYxQwZLndS1kzHxV7D3kWm9VoYRzFtsP3qra5bM8rGhC v82LYo8fZpQoyQmtN1D9vxG2uEsMhV7jB4KdADRgxMXn5kRJzLZPt2LrPSmcUhfEmeQa7X rKeR9FHdKcXxZ1Hdq68oBr2AaPpTMuL85KDCt",
        "5rqF8aHfs9JyEtKTvND6z8RgBtYxQwZLndS1kzHxV7D3kWm9VoYRzFtsP3qra5bM8rGhC v82LYo8fZpQoyQmtN1D9vxG2uEsMhV7jB4KdADRgxMXn5kRJzLZPt2LrPSmcUhfEmeQa7X rKeR9FHdKcXxZ1Hdq68oBr2AaPpTMuL85KDCt"
      ]
    },
    {
      "preExecutionAccountsConfigs": [
        {
          "addresses": [
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "encoding": "base64"
        },
        null
      ],
      "postExecutionAccountsConfigs": [
        {
          "addresses": [
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "encoding": "base64"
        },
        null
      ],
      "skipSigVerify": true,
      "simulationBank": {
        "commitment": {
          "commitment": "processed"
        }
      },
      "transactionEncoding": "base64",
      "replaceRecentBlockhash": false
    }
  ]
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": {
      "apiVersion": "2.30.10",
      "slot": 373999891
    },
    "value": {
      "summary": "成功",
      "transactionResults": [
        {
          "err": null,
          "logs": [
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 11111111111111111111111111111111 调用 [1]",
            "程序 11111111111111111111111111111111 成功"
          ],
          "preExecutionAccounts": [
            {
              "data": [
                "",
                "base64"
              ],
              "executable": true,
              "lamports": 5299606121,
              "owner": "BPFLoader2111111111111111111111111111111111",
              "rentEpoch": 324,
              "space": 134080
            }
          ],
          "postExecutionAccounts": [
            {
              "data": [
                "",
                "base64"
              ],
              "executable": true,
              "lamports": 5299606121,
              "owner": "BPFLoader2111111111111111111111111111111111",
              "rentEpoch": 324,
              "space": 134080
            }
          ],
          "returnData": {
            "programId": "Fx9Hp1gLzYj6Ryc4GaVoq2v6t4NxWg3GT1kP7quzZbVQ",
            "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASjD8="
          },
          "unitsConsumed": 450
        },
        {
          "err": null,
          "logs": [
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 11111111111111111111111111111111 调用 [1]",
            "程序 11111111111111111111111111111111 成功"
          ],
          "postExecutionAccounts": null,
          "preExecutionAccounts": null,
          "returnData": null,
          "unitsConsumed": 450
        }
      ]
    }
  }
}

Authorizations

api-key

string

query

required

您的 Helius API 密钥。您可以在仪表板中免费获取一个。

Body

application/json

jsonrpc

enum<string>

default:2.0

JSON-RPC 协议版本。

可用选项:

2.0

Example:

"2.0"

string

default:1

请求的唯一标识符。

Example:

"1"

method

enum<string>

default:simulateBundle

要调用的 RPC 方法名称。

可用选项:

simulateBundle

Example:

"simulateBundle"

params

object[]

用于模拟 JITO 包的参数。

显示子属性

params.params[0]

object

required

第一个配置对象。包含用于模拟的编码交易。

显示子属性

params.params[0].encodedTransactions

string[]

用于模拟的编码、序列化交易数组。编码由 transactionEncoding 字段决定（默认为 base-64）。

编码的序列化交易。

params.params[1]

object

第二个配置对象。可选。

显示子属性

params.params[1].preExecutionAccountsConfigs

(object | null)[]

required

指定在模拟期间要捕获的账户。

这会捕获交易执行之前的账户状态。

数组中某个索引处的元素配置与包中相同索引处的交易。

对于包中的每个交易：

如果不希望返回任何账户状态，请传递 null。
或者，提供一个对象描述要返回的账户。

数组长度必须等于包中交易的数量。

显示子属性

params.params[1].preExecutionAccountsConfigs.addresses

string[]

required

将捕获其状态的 base-58 编码账户地址列表。

base-58 编码的账户地址。

params.params[1].preExecutionAccountsConfigs.encoding

enum<string>

default:base64

返回捕获的账户数据的编码。

可用选项:

binary,

base58,

base64,

jsonParsed,

base64+zstd

Example:

"base64"

params.params[1].postExecutionAccountsConfigs

(object | null)[]

required

指定在模拟期间要捕获的账户。

这会捕获交易执行后*的账户状态。

数组中某个索引的元素配置与捆绑包中相同索引的交易。

对于捆绑包中的每个交易：

如果不希望返回任何账户状态，请传递 null。
或者，提供一个对象描述要返回的账户。

数组长度必须等于捆绑包中的交易数量。

显示子属性

params.params[1].postExecutionAccountsConfigs.addresses

string[]

required

将捕获其状态的 base-58 编码账户地址列表。

base-58 编码账户地址。

params.params[1].postExecutionAccountsConfigs.encoding

enum<string>

default:base64

返回捕获的账户数据的编码格式。

可用选项:

binary,

base58,

base64,

jsonParsed,

base64+zstd

Example:

"base64"

params.params[1].transactionEncoding

enum<string>

default:base64

在 encodedTransactions 中使用的交易编码。

可用选项:

base64,

base58

params.params[1].simulationBank

指定要运行模拟的银行。可以是 tip、一个 slot 或一个承诺级别。

Example:

"tip"

params.params[1].skipSigVerify

boolean

default:false

是否在模拟之前跳过签名验证。

params.params[1].replaceRecentBlockhash

boolean

default:false

是否用最新的区块哈希替换模拟交易的最近区块哈希。

Response

成功模拟了捆绑。

jsonrpc

enum<string>

JSON-RPC协议版本。

可用选项:

2.0

Example:

"2.0"

string

与请求匹配的标识符。

Example:

"1"

result

object

模拟包的结果。

显示子属性

result.context

object

模拟响应的上下文。

显示子属性

result.context.apiVersion

string

API版本。

Example:

"2.30.10"

result.context.slot

integer

数据处理的槽位。

Example:

373999891

result.value

object

模拟捆绑结果的详细信息。

显示子属性

result.value.summary

捆绑模拟结果的摘要。

如果模拟成功，此值设置为 "succeeded"。

如果模拟失败，此值设置为一个包含单个字段 failed 的对象，其中包含有关该失败的详细信息。

Example:

"succeeded"

result.value.transactionResults

object[]

每个捆绑交易结果的数组。如果出现错误，可能为空。

显示子属性

result.value.transactionResults.err

object

如果交易失败则为错误，成功则为null。

result.value.transactionResults.logs

string[] | null

来自交易执行的日志消息数组。

result.value.transactionResults.preExecutionAccounts

object[] | null

交易执行前的账户状态。

显示子属性

result.value.transactionResults.preExecutionAccounts.data

string

与账户关联的数据。

result.value.transactionResults.preExecutionAccounts.executable

boolean

账户是否包含程序。

Example:

false

result.value.transactionResults.preExecutionAccounts.lamports

integer

分配给此账户的 lamports 数量。

Example:

1500000000

result.value.transactionResults.preExecutionAccounts.owner

string

拥有此账户的程序的地址。

Example:

"4Nd1mFvxhG1DQMLUKhMzrZ7yG1UrjC9xXH6kvvZtcg9R"

result.value.transactionResults.preExecutionAccounts.rentEpoch

integer

此账户下次需要支付租金的纪元。

Example:

324

result.value.transactionResults.preExecutionAccounts.space

integer

账户的数据大小。

Example:

1024

result.value.transactionResults.postExecutionAccounts

object[] | null

交易执行后的账户状态。

显示子属性

result.value.transactionResults.postExecutionAccounts.data

string

与账户关联的数据。

result.value.transactionResults.postExecutionAccounts.executable

boolean

账户是否包含程序。

Example:

false

result.value.transactionResults.postExecutionAccounts.lamports

integer

分配给此账户的 lamports 数量。

Example:

1500000000

result.value.transactionResults.postExecutionAccounts.owner

string

拥有此账户的程序的地址。

Example:

"4Nd1mFvxhG1DQMLUKhMzrZ7yG1UrjC9xXH6kvvZtcg9R"

result.value.transactionResults.postExecutionAccounts.rentEpoch

integer

此账户下次需要支付租金的纪元。

Example:

324

result.value.transactionResults.postExecutionAccounts.space

integer

账户的数据大小。

Example:

1024

result.value.transactionResults.unitsConsumed

integer

处理期间消耗的计算预算单位数量。

Example:

200000

result.value.transactionResults.returnData

object

指令生成的最新返回数据。

显示子属性

result.value.transactionResults.returnData.programId

string

生成返回数据的程序。

Example:

"Fx9Hp1gLzYj6Ryc4GaVoq2v6t4NxWg3GT1kP7quzZbVQ"

result.value.transactionResults.returnData.data

string

以 base-64 编码的二进制数据形式返回的数据。

Example:

"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASjD8="

simulateTransaction模拟发送交易。

⌘I

simulateBundle

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "simulateBundle",
  "params": [
    {
      "encodedTransactions": [
        "5rqF8aHfs9JyEtKTvND6z8RgBtYxQwZLndS1kzHxV7D3kWm9VoYRzFtsP3qra5bM8rGhC v82LYo8fZpQoyQmtN1D9vxG2uEsMhV7jB4KdADRgxMXn5kRJzLZPt2LrPSmcUhfEmeQa7X rKeR9FHdKcXxZ1Hdq68oBr2AaPpTMuL85KDCt",
        "5rqF8aHfs9JyEtKTvND6z8RgBtYxQwZLndS1kzHxV7D3kWm9VoYRzFtsP3qra5bM8rGhC v82LYo8fZpQoyQmtN1D9vxG2uEsMhV7jB4KdADRgxMXn5kRJzLZPt2LrPSmcUhfEmeQa7X rKeR9FHdKcXxZ1Hdq68oBr2AaPpTMuL85KDCt"
      ]
    },
    {
      "preExecutionAccountsConfigs": [
        {
          "addresses": [
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "encoding": "base64"
        },
        null
      ],
      "postExecutionAccountsConfigs": [
        {
          "addresses": [
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "encoding": "base64"
        },
        null
      ],
      "skipSigVerify": true,
      "simulationBank": {
        "commitment": {
          "commitment": "processed"
        }
      },
      "transactionEncoding": "base64",
      "replaceRecentBlockhash": false
    }
  ]
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": {
      "apiVersion": "2.30.10",
      "slot": 373999891
    },
    "value": {
      "summary": "成功",
      "transactionResults": [
        {
          "err": null,
          "logs": [
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 11111111111111111111111111111111 调用 [1]",
            "程序 11111111111111111111111111111111 成功"
          ],
          "preExecutionAccounts": [
            {
              "data": [
                "",
                "base64"
              ],
              "executable": true,
              "lamports": 5299606121,
              "owner": "BPFLoader2111111111111111111111111111111111",
              "rentEpoch": 324,
              "space": 134080
            }
          ],
          "postExecutionAccounts": [
            {
              "data": [
                "",
                "base64"
              ],
              "executable": true,
              "lamports": 5299606121,
              "owner": "BPFLoader2111111111111111111111111111111111",
              "rentEpoch": 324,
              "space": 134080
            }
          ],
          "returnData": {
            "programId": "Fx9Hp1gLzYj6Ryc4GaVoq2v6t4NxWg3GT1kP7quzZbVQ",
            "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASjD8="
          },
          "unitsConsumed": 450
        },
        {
          "err": null,
          "logs": [
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 ComputeBudget111111111111111111111111111111 调用 [1]",
            "程序 ComputeBudget111111111111111111111111111111 成功",
            "程序 11111111111111111111111111111111 调用 [1]",
            "程序 11111111111111111111111111111111 成功"
          ],
          "postExecutionAccounts": null,
          "preExecutionAccounts": null,
          "returnData": null,
          "unitsConsumed": 450
        }
      ]
    }
  }
}

API 参考

Solana RPC API

Solana API

数据流 API

事件监听 API

已弃用的 API

simulateBundle

Authorizations

Body

Response