Method: projects.locations.endpoints.submitTransaction

Invia una transazione alla rete. La richiesta viene prima convalidata per verificarne la correttezza di base. Se la convalida non va a buon fine, la richiesta non andrà a buon fine immediatamente. Se la convalida ha esito positivo, questo metodo viene restituito solo dopo che la transazione è stata replicata nella maggior parte dei nodi di convalida della rete o fino al mancato completamento della richiesta.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint a cui inviare la transazione. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La posizione è una regione.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "serializedSignedTransaction": string
}
Campi
serializedSignedTransaction

string (bytes format)

Obbligatorio. Un protobuf serializzato SignedTransaction da inviare al ledger. 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.submitTransaction.

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 inviata. È la rappresentazione esadecimale del digest SHA-256 di serializedSignedTransaction. 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.