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。