Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Method ID

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.

Method ID é o identificador curto, derivado do hash da assinatura da função, que abre o dado de uma transação e diz qual função do contrato inteligente foi chamada.

Toda chamada de escrita a um contrato inteligente vira uma transação cujo campo input começa, logo depois do prefixo 0x, por esse identificador de 8 caracteres hexadecimais, ou seja, 4 bytes. Também é chamado de function selector, assinatura do método ou seletor. Ele existe para economizar espaço: em vez de gravar o nome da função e seus tipos por extenso a cada transação, a rede carrega só esse resumo fixo. É o primeiro passo da Decodificação de Transações, porque sem saber qual método gerou a transação não há como interpretar os parâmetros que vêm depois.

Como a assinatura textual vira o identificador

O cálculo parte da assinatura textual do método: o nome da função seguido, entre parênteses, dos tipos dos parâmetros separados por vírgula, sem os nomes dos parâmetros e sem nenhum espaço. Um método que cria uma pesquisa recebendo um hash e um prazo, por exemplo, é escrito como o nome da função com bytes32 e uint256 entre parênteses. Essa string passa pelo Keccak-256, a função de hash de mão única usada por redes compatíveis com Ethereum, e os 8 primeiros caracteres hexadecimais do resultado são o Method ID.

A conferência é direta: gera-se o hash da assinatura em qualquer calculadora de Keccak-256 e comparam-se os 8 primeiros caracteres com o início do input da transação. Se batem, aquele foi o método executado. Um explorador de blocos costuma exibir o identificador já separado, o que ajuda a validar o cálculo manual. Como o hash é determinístico, o mesmo valor aparece em toda transação que chamar aquele método, e ele funciona como uma assinatura reconhecível.

Um caractere muda tudo

Qualquer caractere a mais na string altera o hash por completo. Um espaço sobrando no começo da assinatura, ou o nome de um parâmetro esquecido entre os tipos, basta para o identificador calculado não bater com o da transação. Copiar a assinatura errada, de outra função do contrato, produz o mesmo sintoma.

O identificador exige conhecer o contrato de antemão

O hash só vai numa direção: do identificador não se chega à assinatura. Por isso a aplicação que decodifica precisa ter o contrato em mãos, ou ao menos a lista de assinaturas dos métodos que quer reconhecer, e calcular os identificadores antes. A solução prática é manter uma tabela que associa cada Method ID conhecido a um método e à classe de decode responsável por ele.

É assim que o Transaction Consumer trata as transações que espelha: para cada uma, lê os 8 primeiros dígitos do input e procura na tabela. Se o identificador não está cadastrado, a transação é marcada como não reconhecida, em vez de travar o processamento. A transação de deploy do contrato é o caso típico de identificador sem correspondência. O custo dessa abordagem é manual: cada método novo que se queira decodificar precisa ter seu identificador registrado e seu decodificador implementado.

Exemplos com contratos de pesquisa e votação

Em um contrato de votação com um único método de escrita, o identificador calculado para o método de voto começava com a90 e terminava com 2b, o mesmo valor exibido pelo explorador de blocos. No contrato de pesquisas do SurveyChain, dois métodos foram identificados pela mesma técnica: o de resposta a uma pesquisa, que recebe um bytes32, e o de criação de pesquisa, que recebe um bytes32 e um uint256. Identificado o método, o restante do input é lido conforme a Codificação ABI de Parâmetros, com os tipos que a própria assinatura declara.