Method: projects.locations.endpoints.submitTransaction

Envia uma transação para a rede. A solicitação é validada primeiro para verificar se está correta. Se a validação falhar, a solicitação vai falhar imediatamente. Se a validação for bem-sucedida, esse método só será retornado depois que a transação for replicada na maioria dos validadores da rede ou até que a solicitação falhe.

Solicitação HTTP


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

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
endpoint

string

Obrigatório. O endpoint para enviar a transação. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} O local é uma região.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "serializedSignedTransaction": string
}
Campos
serializedSignedTransaction

string (bytes format)

Obrigatório. Um SignedTransaction serializado do protobuf para enviar ao livro-razão. O uso de um formato serializado garante que todos os validadores calculem o mesmo ID de transação como o resumo SHA-256 dos bytes serializados.

Uma string codificada em base64.

Corpo da resposta

Mensagem de resposta para endpoints.submitTransaction.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "transactionDigestHex": string
}
Campos
transactionDigestHex

string

Identificador que representa exclusivamente a transação enviada. É a representação hexadecimal do resumo SHA-256 da serializedSignedTransaction. Esse ID de transação é fornecido para que um cliente possa rastrear a transação sem precisar implementar a lógica de hash. O identificador pode ser usado diretamente em chamadas de API subsequentes, por exemplo, para consultar o estado da transação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.