Method: projects.locations.endpoints.submitTransaction

向网络提交交易。系统首先会验证请求的基本正确性。如果验证失败，请求会立即失败。如果验证成功，则只有在交易已复制到网络中的大多数验证器中，或者请求失败后，此方法才会返回。

HTTP 请求

：


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:submitTransaction

网址使用 gRPC 转码 语法。

路径参数

参数
endpoint

string

必需。用于提交交易的端点。格式：projects/{project}/locations/{location}/endpoints/{endpoint}。位置是区域。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "serializedSignedTransaction": string
}
字段
serializedSignedTransaction

string (bytes format)

必需。要提交到账本的 protobuf 序列化 SignedTransaction。使用序列化格式可确保所有验证器计算的交易 ID 都与序列化字节的 SHA-256 摘要相同。

使用 base64 编码的字符串。

响应正文

针对 endpoints.submitTransaction 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "transactionDigestHex": string
}
字段
transactionDigestHex

string

唯一表示提交的交易的标识符。它是 serializedSignedTransaction 的 SHA-256 摘要的十六进制表示法。提供此交易 ID 的目的是让客户端能够跟踪交易，而无需自行实现哈希逻辑。该标识符可直接用于后续 API 调用，例如查询交易状态。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。