Method: projects.locations.endpoints.submitOperationalTransaction

向网络提交一项运营事务。只有在事务已在网络中的大多数验证器之间复制完毕,或者事务失败后,此方法才会返回。

HTTP 请求


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

网址使用 gRPC 转码 语法。

路径参数

参数
endpoint

string

必需。用于处理请求的端点。格式:projects/{project}/locations/{location}/endpoints/{endpoint}。位置是区域。

请求正文

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

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

string (bytes format)

必需。要提交到账本的 protobuf 序列化 SignedTransaction。封闭的客户端事务必须是运营事务,并且发送者必须是平台运营商。使用序列化格式可确保所有验证器计算的交易 ID 与序列化字节的 SHA-256 摘要相同。

使用 base64 编码的字符串。

响应正文

endpoints.submitOperationalTransaction 的响应消息。

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

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

string

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

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅 Authentication Overview