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

用於識別提交交易的專屬 ID。這是 serializedSignedTransaction 的 SHA-256 摘要十六進位表示法。提供這個交易 ID 後，用戶端就能追蹤交易，不必自行實作雜湊邏輯。這個 ID 可直接用於後續的 API 呼叫，例如查詢交易狀態。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

需要 endpoint 資源的下列 IAM 權限：

  • universalledger.endpoints.submit

詳情請參閱 IAM 說明文件。