Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Decodificação de Transações

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Decodificação de transações é transformar o dado bruto de uma transação de contrato inteligente de volta em nome de função e valores de parâmetros legíveis.

Em uma rede usada para aplicações, quase toda transação de escrita é a execução de um método de um contrato inteligente. O que fica registrado não é o texto da chamada, e sim o campo input (também chamado de raw input): uma sequência hexadecimal compacta que junta a identificação do método e os argumentos passados. Esse dado não é criptografado, apenas codificado. A blockchain é pública e auditável por definição, e a codificação existe para economizar espaço e reduzir o volume trafegado. O input só é pouco legível para humanos.

Decodificar é o caminho inverso, necessário sempre que se quer consultar o histórico, montar um extrato ou ler o resultado de uma transação. A privacidade de quem transaciona não vem da codificação, e sim da ausência de ligação direta entre a carteira e a identidade civil do dono.

Fluxo completo sobre o input bruto

  1. Obter o input bruto da transação, seja pelo explorador de blocos, seja pela base que espelha a rede.
  2. Separar o identificador do método. Logo depois do prefixo 0x vêm 8 caracteres hexadecimais que formam o Method ID. Os 10 primeiros caracteres (0x mais o identificador) são a assinatura; o restante é o dado dos parâmetros.
  3. Mapear contra as assinaturas conhecidas. Sem o contrato em mãos, ou ao menos a lista de assinaturas dos seus métodos, não há como saber qual função foi chamada.
  4. Remontar os valores. Com os tipos esperados de cada parâmetro, o dado restante é lido segundo a Codificação ABI de Parâmetros e convertido de volta em texto, números ou endereços.

Métodos sem parâmetros, como fechar ou cancelar uma pesquisa, geram um input curto, só com o identificador. Uma transação com input vazio costuma ser uma transferência simples, sem chamada de função. Métodos de leitura não geram transação nem input.

Um decodificador para cada método

A decodificação depende do contrato e do método: cada método tem sua própria lista de tipos, então cada um precisa de um decodificador que saiba o que esperar. A organização prática é manter uma tabela de funções de contrato conhecidas, que associa cada assinatura a um código, e esse código aponta para a classe de decode correspondente.

O processo roda em duas etapas sobre a base preenchida pelo Transaction Consumer: primeiro a transação bruta é capturada e gravada, depois é decodificada em dado refinado. É o dado refinado que alimenta, por exemplo, o extrato de um usuário sem voltar à rede a cada consulta.

Quando uma assinatura não tem método cadastrado, o decodificador devolve nulo e informa que não existe função para ela, em vez de falhar. O caso típico é a transação de deploy do contrato, cujo input é bem mais longo porque carrega os dados da própria implantação.

Implementação em Java com Web3j

Em Java, o decode se apoia na biblioteca Web3j; um exemplo didático cabe em um projeto Spring Boot enxuto. Para um método que recebe um único parâmetro string, o decodificador declara a lista de tipos esperados, usando o tipo de string UTF-8 da biblioteca, equivalente ao string do Solidity. Essa lista e o dado bruto sem os 10 primeiros caracteres vão para o FunctionReturnDecoder, que devolve a lista de valores decodificados. Como o método tem um só atributo, uma lista de tamanho diferente de um sinaliza erro. Antes do corte, o input é limpo de qualquer caractere fora do alfabeto hexadecimal.

Suportar um novo método exige três passos: criar um decodificador análogo trocando os tipos esperados (address no lugar de string, por exemplo, ou bytes32 e uint256), registrá-lo no seletor de decodificadores e gravar na tabela a assinatura e o código do método.

Demonstração mínima

Um contrato de votação de cerca de 70 linhas, implantado em uma blockchain local, recebeu dois votos em candidatos diferentes. O decodificador recuperou o nome votado a partir do input de cada transação e retornou nulo para a transação de deploy.