Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Codificação ABI de Parâmetros

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.

Codificação ABI de parâmetros é a convenção que empacota os argumentos de uma chamada de contrato em blocos de tamanho fixo dentro do dado da transação, permitindo reconstruí-los depois sem ambiguidade.

No campo input de uma transação, os 8 primeiros caracteres hexadecimais depois do 0x formam o Method ID, que diz qual função do contrato foi chamada. Tudo o que vem depois são os parâmetros dessa chamada, lado a lado, cada um ocupando um bloco de 32 bytes. Não há separadores nem nomes de campos: o formato compacto economiza espaço na rede, e quem lê precisa saber, pela assinatura do método, quantos blocos esperar e de que tipo é cada um. Por isso a codificação é a segunda etapa da Decodificação de Transações, sempre depois de identificar o método.

Leitura manual em blocos de 32 bytes

O procedimento manual tem três passos. Retira-se o prefixo 0x e o identificador do método. O restante é fatiado em blocos de 32 bytes, um por parâmetro, na mesma ordem em que os tipos aparecem na assinatura. Cada bloco é então interpretado segundo seu tipo.

Um parâmetro bytes32, como um hash, ocupa o bloco inteiro e já pode ser lido como está. Um parâmetro numérico, como um uint256, aparece no bloco em hexadecimal e precisa ser convertido para decimal para revelar o valor real. A ordem importa porque é ela que associa bloco a parâmetro: trocar a ordem dos tipos na leitura faz um prazo ser lido como hash e vice-versa, sem nenhum erro aparente.

Exemplo com os métodos de uma pesquisa

O método de criação de pesquisa do contrato do SurveyChain recebe dois parâmetros, um bytes32 com o hash que identifica a pesquisa e um uint256 com o prazo limite. O input da transação traz, depois do identificador, exatamente dois blocos de 32 bytes: o primeiro é o hash, legível diretamente, e o segundo é o prazo em hexadecimal, que convertido para decimal mostra o valor passado pelo back-end.

O método de resposta é ainda mais simples, com um único bloco bytes32. Esse bloco carrega um hash que o back-end monta a partir dos dados da resposta, somados a valores extras para torná-lo único. O decode recupera o hash fielmente, mas não o conteúdo que o originou, e é isso que mantém a resposta anônima mesmo com a transação pública.

Deixar a biblioteca fazer o decode

Em Java, a biblioteca Web3j automatiza a leitura: basta declarar a lista de tipos do método, como bytes32 e uint256, e entregar o input bruto. Ela fatia os blocos, converte cada valor para o tipo correspondente e devolve uma lista com um item por parâmetro, que a aplicação transforma em texto, número ou o que precisar. Tipos que não são de tamanho fixo, como string, entram na mesma lista, com o tipo equivalente da biblioteca, e o fatiamento correto fica a cargo dela.

Entenda à mão antes de automatizar

O código de decode com a biblioteca parece obscuro até que se tenha feito o processo manual uma vez. Com o fatiamento em blocos e a conversão hexadecimal entendidos, cada classe de decode se resume a declarar a assinatura e os tipos do método.

É esse mecanismo que o Transaction Consumer usa para gravar em banco relacional os valores já legíveis de cada transação.