Method: projects.locations.endpoints.submitTransaction

Sendet eine Transaktion an das Netzwerk. Die Anfrage wird zuerst auf grundlegende Richtigkeit geprüft. Wenn die Validierung fehlschlägt, schlägt die Anfrage sofort fehl. Wenn die Validierung erfolgreich ist, wird diese Methode erst zurückgegeben, nachdem die Transaktion auf einer Mehrheit der Validatoren im Netzwerk repliziert wurde oder bis die Anfrage fehlschlägt.

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. Ein protobuf-serialisiertes SignedTransaction, das 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

ID, die die eingereichte Transaktion eindeutig identifiziert. Es ist die hexadezimale Darstellung des SHA-256-Hashwerts des 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.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource endpoint:

  • universalledger.endpoints.submit

Weitere Informationen finden Sie in der IAM-Dokumentation.