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ó vai retornar 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 em protobuf para enviar ao livro-razão. O uso de um formato serializado garante que todos os validadores calculem o mesmo ID da transação que 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 do serializedSignedTransaction. Esse ID da transação é fornecido para que um cliente possa acompanhar a transação sem precisar implementar a lógica de hash. O identificador pode ser usado diretamente nas próximas chamadas de API, 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.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso endpoint:

  • universalledger.endpoints.submit

Para mais informações, consulte a documentação do IAM.