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 編碼字串。

回應主體

端點的 submitOperationalTransaction 回應訊息。

如果成功,回應主體會含有以下結構的資料:

JSON 表示法
{
  "transactionDigestHex": string
}
欄位
transactionDigestHex

string

可明確代表所提交作業交易的 ID。這是 serializedSignedOperationalTransaction 的 SHA-256 摘要十六進位表示法。提供這項交易 ID,方便用戶端追蹤交易,不必自行實作雜湊邏輯。這個 ID 可直接用於後續的 API 呼叫,例如查詢交易狀態。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview