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 をご覧ください。

IAM 権限

endpoint リソースに対する次の IAM 権限が必要です。

  • universalledger.endpoints.submit

詳細については、IAM のドキュメントをご覧ください。