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

回應主體

端點的 submitTransaction 回應訊息。

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

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

string

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview