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 restituisce un risultato solo dopo che la transazione è stata replicata nella maggior parte dei validator della rete o fino a quando la richiesta non ha esito negativo.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint a cui inviare la transazione. 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 
{
  "serializedSignedTransaction": string
}
Campi
serializedSignedTransaction

string (bytes format)

Obbligatorio. Un SignedTransaction serializzato protobuf da inviare al ledger. L'utilizzo di un formato serializzato garantisce che tutti i validator calcolino lo stesso ID transazione del 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 client 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.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa endpoint:

  • universalledger.endpoints.submit

Per saperne di più, consulta la documentazione di IAM.