Method: projects.locations.endpoints.submitOperationalTransaction

Invia una transazione operativa alla rete. Questo metodo viene restituito solo dopo che la transazione è stata replicata nella maggior parte dei validatori della rete o se la transazione non va a buon fine.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint per gestire la richiesta. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La località è una regione.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "serializedSignedOperationalTransaction": string
}
Campi
serializedSignedOperationalTransaction

string (bytes format)

Obbligatorio. Un protobuf serializzato SignedTransaction da inviare al ledger. La transazione del cliente allegata deve essere una transazione operativa e il mittente deve essere l'operatore della piattaforma. L'utilizzo di un formato serializzato garantisce che tutti i validatori calcolino lo stesso ID transazione come digest SHA-256 dei byte serializzati.

Una stringa con codifica in base64.

Corpo della risposta

Messaggio di risposta per endpoints.submitOperationalTransaction.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "transactionDigestHex": string
}
Campi
transactionDigestHex

string

Identificatore che rappresenta in modo univoco la transazione operativa inviata. È la rappresentazione esadecimale del digest SHA-256 di serializedSignedOperationalTransaction. Questo ID transazione viene fornito in modo che un cliente possa monitorare la transazione senza dover implementare la logica di hashing. L'identificatore può essere utilizzato direttamente nelle chiamate API successive, ad esempio per eseguire query sullo stato della transazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.