Checksum EIP-55 Ethereum

EIP-55: como o Ethereum transforma a caixa das letras em checksum

O EIP-55 é o esquema engenhoso que dá a um endereço Ethereum em hex 0x proteção contra erro de digitação sem acrescentar nenhum caractere. Ele faz isso decidindo, para cada letra a–f, se a imprime em maiúscula ou minúscula com base num hash do próprio endereço. Ferramentas que não entendem EIP-55 simplesmente ignoram a caixa e funcionam; as que entendem conseguem pegar endereços digitados errado. Esta página detecta e explica o checksum de um endereço.

O algoritmo, passo a passo

• 1. Pegue o corpo de 40 hex do endereço, em minúsculas, e calcule seu hash Keccak-256 (não SHA3-256 — o Ethereum usa o Keccak original).
• 2. Percorra os 40 caracteres. Para cada letra (a–f), olhe o nibble hex correspondente do hash.
• 3. Se esse nibble for ≥ 8, imprima a letra em maiúscula; senão, minúscula. Dígitos 0–9 não mudam.
• 4. A string de caixa mista resultante é o endereço com checksum; refazer o processo deve reproduzir exatamente a mesma caixa.

Lendo o resultado

• Tudo minúsculo / tudo maiúsculo: formato válido mas sem checksum aplicado — nada a verificar.
• Caixa mista: há um checksum EIP-55; a verificação completa significa recalcular o hash Keccak e bater a caixa de cada letra.
• Divergência: se a caixa de uma só letra estiver errada, o endereço é um erro e uma carteira estrita o rejeita.

Pegadinhas

• Keccak-256 ≠ SHA-3: o Ethereum congelou o padding pré-padrão do Keccak; usar o NIST SHA3-256 produz a caixa errada.
• Esta ferramenta sinaliza presença, não validade completa: uma checagem completa requer uma implementação de Keccak-256 no navegador.
• Não normalize a caixa: passar para minúsculo destrói o checksum do qual uma ferramenta seguinte pode depender.
• EIP-1191: algumas chains misturam o chain ID no hash; um endereço com checksum desse jeito não bate com o EIP-55 puro.

FAQ

Por que usar caixa em vez de dígitos extras? Mantém o endereço do mesmo comprimento e fica retrocompatível: ferramentas insensíveis a caixa ainda o tratam como o mesmo endereço.

Todo endereço tem checksum? Não — só os de caixa mista. Os todo-minúsculo são válidos mas desprotegidos.

O EIP-55 é igual no Polygon ou BNB Chain? O algoritmo base é idêntico; algumas redes adotam o EIP-1191, que inclui o chain ID e produz uma caixa diferente.