Method: projects.locations.endpoints.submitOperationalTransaction

Sendet eine operative Transaktion an das Netzwerk. Diese Methode gibt erst dann ein Ergebnis zurück, wenn die Transaktion auf einer Mehrheit der Validatoren im Netzwerk repliziert wurde oder wenn die Transaktion fehlschlägt.

HTTP-Anfrage


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

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

Pfadparameter

Parameter
endpoint

string

Erforderlich. Der Endpunkt, der die Anfrage verarbeitet. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Standort ist eine Region.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string (bytes format)

Erforderlich. Ein protobuf-serialisiertes SignedTransaction, das an das Ledger gesendet werden soll. Die beigefügte Clienttransaktion muss eine operative Transaktion sein und der Absender muss der Plattformbetreiber sein. 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.submitOperationalTransaction.

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

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

string

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