Method: projects.locations.endpoints.submitTransaction

Sendet eine Transaktion an das Netzwerk. Die Anfrage wird zuerst auf grundlegende Korrektheit geprüft. Wenn die Validierung fehlschlägt, schlägt die Anfrage sofort fehl. Wenn die Validierung erfolgreich ist, gibt diese Methode erst dann eine Antwort zurück, wenn die Transaktion auf die Mehrheit der Validatoren im Netzwerk repliziert wurde oder die Anfrage fehlgeschlagen ist.

HTTP-Anfrage


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

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
endpoint

string

Erforderlich. Der Endpunkt, an den die Transaktion gesendet werden soll. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Standort ist eine Region.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "serializedSignedTransaction": string
}
Felder
serializedSignedTransaction

string (bytes format)

Erforderlich. Eine als Protobuf serialisierte SignedTransaction, die an das Ledger gesendet werden soll. Durch die Verwendung eines serialisierten Formats wird sichergestellt, dass alle Validatoren dieselbe Transaktions-ID als SHA-256-Digest der serialisierten Bytes berechnen.

Ein base64-codierter String.

Antworttext

Antwortnachricht für endpoints.submitTransaction.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "transactionDigestHex": string
}
Felder
transactionDigestHex

string

Kennung, die die gesendete Transaktion eindeutig darstellt. Sie ist die hexadezimale Darstellung des SHA-256-Digest der serializedSignedTransaction. Diese Transaktions-ID wird bereitgestellt, damit ein Client die Transaktion verfolgen kann, ohne die Hashing-Logik selbst implementieren zu müssen. Die Kennung kann direkt in nachfolgenden API-Aufrufen verwendet werden, z. B. um den Transaktionsstatus abzufragen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.