Conversor de endereço checksum Ethereum

Converta endereços Ethereum para o formato checksum EIP-55 no seu navegador. Cole um endereço ou uma lista, veja quais letras ficam maiúsculas a partir do Keccak-256 do texto hex e, se precisar, aplique um chain id EIP-1191. Um endereço misto que não coincide é marcado como erro de digitação.

Endereços Ethereum

Um endereço por linha, ou vários separados por espaços ou vírgulas. O prefixo 0x é opcional.

Deixe em branco para o checksum EIP-55 que as carteiras esperam. Um número ativa o EIP-1191.

Endereços com checksum

Checksum adicionado

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed

Por que cada caractere tem esta caixa

Uma letra fica maiúscula quando o nibble do hash é 8–f. Dígitos não mudam.

Keccak-256 do texto hex: d385650ce8fdc6db7ee3a091d34814dbc4ce18219ffae52182efff4034d707e5

5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed

Convertido no seu navegador. O endereço não é enviado.

O que é um endereço Ethereum com checksum

Um endereço Ethereum tem 20 bytes, escritos como 40 caracteres hex com um 0x opcional. As letras hex não têm caixa própria, então 0x5aae… e 0x5AAE… são a mesma conta. O EIP-55 usa as maiúsculas como checksum: uma carteira pode rejeitar o endereço se um caractere foi digitado errado. O checksum não muda a conta que você paga. Só torna um erro visível. Endereços só em minúsculas ou só em maiúsculas continuam sendo contas válidas; eles apenas não trazem a verificação. Um endereço com maiúsculas e minúsculas misturadas ou está exatamente certo, ou deve ser tratado como um erro de digitação.

Como o checksum EIP-55 é calculado

Remova o 0x e passe os 40 caracteres hex para minúsculas. Faça o hash dessa string de 40 caracteres com Keccak-256 — o texto hex, não os 20 bytes brutos. Percorra o endereço e o hash juntos. Quando o nibble do hash nessa posição for 8, 9, a, b, c, d, e ou f, escreva a letra em maiúscula. Caso contrário, deixe em minúscula. Dígitos não mudam. Se você também informar um chain id, o hash é Keccak-256 do chain id decimal colado na frente do hex (EIP-1191). Deixe o chain id em branco para o checksum que MetaMask, ethers e viem usam no Ethereum. Hashear os 20 bytes brutos em vez do texto hex produz um checksum diferente e errado.

Exemplos EIP-55

  1. Um endereço em minúsculas recebe o checksum

    Entrada: 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed. Sem chain id.

    O Keccak-256 da string de 40 caracteres começa com d385650c…. As primeiras letras são decididas pelos nibbles 3, 8 e 5: 3 deixa o a minúsculo, 8 põe o a seguinte em maiúscula e 5 deixa o e minúsculo. O endereço começa com 0x5aAe.

    0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed

  2. O mesmo endereço, já com checksum

    Entrada: 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed

    A caixa mista coincide caractere a caractere com o resultado EIP-55, então nada é reescrito.

    Checksum já correto. O mesmo endereço: 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed

  3. Uma letra trocada é um checksum ruim

    Entrada: 0x5aaeb6053F3E94C9b9A09f33669435E7Ef1BeAed — o terceiro caractere hex está minúsculo e as letras seguintes estão misturadas.

    O terceiro caractere correto é A, porque o nibble 8 do hash é pelo menos 8. Esta entrada mistura caixa e não coincide, então é um checksum falho, não uma codificação nova.

    Rejeitado. A forma EIP-55 continua 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed.

  4. Hashear os bytes brutos dá o endereço errado

    O mesmo endereço em minúsculas, mas com Keccak-256 dos 20 bytes brutos em vez do texto hex.

    O hash dos bytes começa com 793f8874… e capitaliza outro conjunto de letras. Essa string não coincide com ethers nem com a MetaMask.

    Resultado errado: 0x5AaEB6053F3E94c9b9a09F33669435E7ef1beAED. O EIP-55 é 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed.

  5. Um chain id muda as letras

    O mesmo endereço com chain id EIP-1191 30 e depois com chain id 1.

    A chain 30 hasheia 30 mais o hex em minúsculas. A chain 1 hasheia 1 mais o hex. Nenhuma é o checksum do Ethereum com o campo vazio.

    Chain 30: 0x5aaEb6053f3e94C9B9A09f33669435E7Ef1beaEd. Chain 1: 0x5AAeB6053f3E94c9B9A09f33669435E7EF1bEaeD. Ethereum: 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed.

Perguntas sobre endereços checksum Ethereum

O que é um endereço checksum EIP-55?
É o mesmo endereço Ethereum de 20 bytes com algumas letras hex em maiúscula. As maiúsculas vêm do Keccak-256 do texto hex em minúsculas, então um caractere errado costuma quebrar o padrão e a carteira pode avisar.
O checksum muda a conta?
Não. 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed e 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed são a mesma conta. Só muda a grafia das letras.
Endereços só em minúsculas são inválidos?
Não. O EIP-55 diz que um endereço só em minúsculas ou só em maiúsculas não tem checksum para conferir, então as carteiras aceitam. Alguns endereços continuam em minúsculas depois do checksum porque cada nibble relevante do hash era menor que 8. 0xde709f2102306220921060314715629080e2fb77 é um deles.
Devo informar o chain id 1 para o Ethereum?
Não. Deixe o chain id em branco. O endereço que as ferramentas do Ethereum esperam não inclui o chain id no hash. Digitar 1 produz outra grafia EIP-1191 que ethers e viem rejeitam.
O que é EIP-1191?
EIP-1191 é um checksum opcional que prefixa o chain id decimal antes do hash, então a mesma conta pode ter maiúsculas diferentes em outra chain. Use só quando as ferramentas dessa chain pedirem.
É o mesmo que um endereço ICAP?
Não. ICAP é uma codificação parecida com IBAN. O EIP-55 mantém a forma hex 0x normal e só muda a caixa das letras.
O endereço é enviado?
Não. O Keccak-256 roda no seu navegador. Não cole aqui uma chave privada nem uma seed phrase: esta ferramenta é só para endereços públicos.

Ferramentas de desenvolvedor relacionadas

Como funciona

  • Cole um ou mais endereços Ethereum de 20 bytes. O prefixo 0x é opcional.
  • Deixe o chain id em branco para o checksum EIP-55 que as carteiras esperam, ou informe um chain id para EIP-1191.
  • O checksum é o Keccak-256 do texto hex em minúsculas, calculado no seu navegador. Um endereço misto que não coincide é marcado como erro.

Apenas para fins educacionais — não é aconselhamento financeiro. O desempenho passado não garante resultados futuros.