Method: projects.locations.endpoints.submitOperationalTransaction

Sendet eine betriebliche Transaktion an das Netzwerk. Diese Methode gibt erst dann eine Antwort zurück, wenn die Transaktion auf die 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. Eine als Protobuf serialisierte SignedTransaction, die an das Ledger gesendet werden soll. Die eingeschlossene Clienttransaktion muss eine betriebliche 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

Kennung, die die gesendete betriebliche Transaktion eindeutig darstellt. Sie ist die hexadezimale Darstellung des SHA-256-Digest von 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.