Method: projects.locations.endpoints.submitTransaction

トランザクションをネットワークに送信します。リクエストはまず、基本的な正しさについて検証されます。検証に失敗すると、リクエストは直ちに失敗します。検証に成功した場合、このメソッドは、トランザクションがネットワーク内の大部分のバリデータにレプリケートされた後、またはリクエストが失敗するまでのみ返されます。

HTTP リクエスト


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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
endpoint

string

必須。トランザクションの送信先のエンドポイント。形式: projects/{project}/locations/{location}/endpoints/{endpoint} ロケーションはリージョンです。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "serializedSignedTransaction": string
}
フィールド
serializedSignedTransaction

string (bytes format)

必須。台帳に送信する protobuf シリアル化された SignedTransaction。シリアル化された形式を使用すると、すべてのバリデータが、シリアル化されたバイトの SHA-256 ダイジェストと同じトランザクション ID を計算します。

Base64 でエンコードされた文字列。

レスポンスの本文

endpoints.submitTransaction に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "transactionDigestHex": string
}
フィールド
transactionDigestHex

string

送信されたトランザクションを一意に表す識別子。serializedSignedTransaction の SHA-256 ダイジェストを 16 進数で表したものです。このトランザクション ID は、クライアントがハッシュ ロジックを実装しなくてもトランザクションを追跡できるように提供されています。この識別子は、後続の API 呼び出しで直接使用できます（トランザクションの状態のクエリなど）。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、Authentication Overview をご覧ください。