ERC-20 é a interface padrão para tokens fungíveis no Ethereum, definida no EIP-20 por Fabian Vogelsteller e Vitalik Buterin em 19 de novembro de 2015: seis funções obrigatórias, três opcionais e dois eventos que todo contrato de token expõe da mesma forma. O WETH é o exemplo clássico, porque o contrato WETH9 implementa as nove funções e os dois eventos à vista de todos, enquanto o ETH nativo não implementa nenhum deles. A regra que decorre disso: qualquer contrato capaz de lidar com um token ERC-20 consegue lidar com o WETH, e nenhum consegue lidar diretamente com o ETH.

Pontos-chave
  • A interface: totalSupply, balanceOf, transfer, transferFrom, approve e allowance são obrigatórias; name, symbol e decimals são opcionais; Transfer e Approval são os eventos (EIP-20, Final).
  • O ETH veio primeiro: a mainnet do Ethereum foi lançada em 30 de julho de 2015 e o EIP-20 foi criado 112 dias depois, e é por isso que o ETH não tem contrato ERC-20 e o WETH existe.
  • Fornecimento igual à reserva: a totalSupply() do WETH9 retorna o próprio saldo de ETH do contrato, 2.175.140,76 em 21 de novembro de 2026 (Ethereum RPC, bloco 26.464.782).
  • Tokens perdidos: pelo menos US$ 83.656.418 em tokens ERC-20 tinham sido perdidos até 20 de junho de 2024 por terem sido enviados a contratos que não sabem lidar com eles (ethereum.org).

O que é ERC-20

ERC-20 é uma lista de funções e eventos que um contrato de token precisa expor para que carteiras, exchanges e outros contratos possam trabalhar com ele sem código sob medida. O ethereum.org descreve os tokens que o padrão abrange como fungíveis: cada unidade é idêntica a qualquer outra em tipo e valor. O padrão não define quanto um token vale nem quem o emite; ele define como os saldos são lidos e movimentados.

ERC significa Ethereum Request for Comments. Fabian Vogelsteller propôs o ERC-20 em novembro de 2015, e o texto foi publicado como EIP-20, cujo status é Final (eips.ethereum.org). Como a interface é fixa, uma carteira mostra qualquer saldo ERC-20 chamando balanceOf(), e uma DEX negocia qualquer token ERC-20 pela mesma chamada transferFrom().

As nove funções e os dois eventos do ERC-20

A interface ERC-20 tem nove funções e dois eventos, e o WETH9 implementa todos eles. A tabela lista cada um, o que ele faz e como o WETH responde na mainnet do Ethereum (código-fonte verificado no Sourcify e no Etherscan, valores lidos em 21 de novembro de 2026).

Função ou evento Obrigatório O que faz No WETH9
name() Opcional Nome legível “Wrapped Ether”
symbol() Opcional Ticker “WETH”
decimals() Opcional Casas depois da vírgula 18
totalSupply() Sim Tokens existentes Retorna o saldo de ETH do contrato
balanceOf(owner) Sim Saldo de um endereço Mapping público
transfer(to, value) Sim Envia tokens de quem chama Chama transferFrom() com quem chama como remetente
transferFrom(from, to, value) Sim Move tokens em nome de outra pessoa Verifica e reduz o limite
approve(spender, value) Sim Permite que outro endereço gaste até um limite Define o limite, emite Approval
allowance(owner, spender) Sim Quantia aprovada restante Mapping público
Evento Transfer Sim Registrado a cada movimentação Emitido por transferFrom()
Evento Approval Sim Registrado a cada approve Emitido por approve()

O EIP-20 marca name, symbol e decimals como opcionais e diz que outros contratos não devem contar com eles. Na prática, quase todo token os define, porque as carteiras precisam deles para exibir um saldo.

Por que o ETH não é um token ERC-20

O ETH não é um token ERC-20 porque é a moeda nativa da rede, e não o estado de um contrato. Os saldos de ether ficam nos registros de contas do próprio Ethereum, são movimentados por transações simples e pagam o gas; não existe um contrato de ETH em que se possa chamar balanceOf() ou approve(). A mainnet do Ethereum entrou no ar em 30 de julho de 2015 (ethereum.org), e o EIP-20 foi criado em 19 de novembro de 2015, 112 dias depois.

Essa diferença de datas é a razão de ser do WETH. Um pool de DEX ou um mercado de empréstimos é escrito para a interface ERC-20 e movimenta fundos com transferFrom(); o ETH nativo não tem essa função, então o contrato não consegue puxá-lo. Empacotar coloca o ETH atrás da interface na mesma rede (por que WETH existe): o ETH não sai do Ethereum, ele muda de padrão.

Como o WETH implementa o ERC-20

O WETH implementa o ERC-20 com duas funções extras que o ligam ao ETH nativo. deposit() recebe o ETH enviado com a chamada e credita a mesma quantia de WETH a quem enviou; withdraw() queima WETH e devolve a mesma quantia de ETH. As duas emitem eventos próprios, Deposit e Withdrawal, ao lado dos eventos padrão Transfer e Approval. Como empacotar e desempacotar aparecem do lado do usuário está na seção o que é WETH.

Três detalhes do código-fonte do WETH9, compilado com solc 0.4.19 e verificado no Etherscan desde dezembro de 2017, fazem dele a implementação de referência que todos citam:

  • Fornecimento igual à reserva: a totalSupply() não conta nada; ela retorna o saldo de ETH do contrato, 2.175.140,76 em 21 de novembro de 2026, então fornecimento e lastro não têm como se descolar.
  • Sem proprietário: não há função de administrador, nem pausa, nem caminho de atualização; nenhum endereço consegue emitir WETH sem depositar ETH nem congelar um saldo.
  • Aprovação ilimitada: quando um limite é definido no valor máximo (uint(-1)), a transferFrom() pula a redução, então um gastador aprovado pelo máximo nunca fica sem limite.

Na carteira, o resultado são dois saldos separados no mesmo endereço: o ETH nativo e o token WETH. Uma carteira de autocustódia que suporta várias redes, como a WETH Wallet, mostra o WETH no Ethereum e o WETH na Base como dois ativos separados, porque cada um é um contrato ERC-20 diferente.

Decimais: como as quantias ERC-20 são armazenadas

Os contratos ERC-20 armazenam toda quantia como um número inteiro de unidades básicas e usam decimals() para dizer onde fica a vírgula. O EIP-20 dá o exemplo de 8 casas decimais: divida o número armazenado por 100.000.000 para obter a quantia que o usuário vê. A tabela compara três tokens lidos na mainnet do Ethereum em 21 de novembro de 2026.

Token decimals() Unidades básicas em 1 token Equivale a
WETH 18 10^18 1 ETH em wei
WBTC 8 10^8 1 BTC em satoshis
USDC 6 10^6 Um dólar em milionésimos

O WETH corresponde exatamente ao ETH: 18 casas decimais, então 1 WETH equivale a 10^18 unidades básicas, assim como 1 ETH equivale a 10^18 wei, e empacotar nunca arredonda. Tokens que representam outros ativos adotam a precisão desse ativo; o WBTC segue as 8 do Bitcoin (WETH vs WBTC compara os dois wrappers).

Approve e transferFrom: por que os apps pedem permissão

Um app pede que você aprove um token porque o ERC-20 não dá a um contrato nenhuma forma de pegar tokens sem que o dono deles tenha definido um limite antes. O fluxo tem duas etapas: approve(spender, amount) registra o limite, e o contrato do app depois chama transferFrom() para movimentar até essa quantia. É por isso que o primeiro swap de um token em uma DEX começa com uma transação de aprovação separada.

O EIP-20 aponta uma fraqueza conhecida: mudar um limite de um valor diferente de zero para outro pode permitir que o gastador use as duas quantias se agir entre uma e outra, então as interfaces devem zerar o limite primeiro. Os limites continuam valendo até serem alterados, e é por isso que revogar os que não estão em uso é importante; os detalhes estão em aprovações e limites de WETH.

O que o ERC-20 não consegue fazer

  • Não paga gas: as taxas de rede são pagas em ETH, nunca em um token ERC-20, nem mesmo em WETH; uma carteira que só tem tokens não consegue enviá-los.
  • Não avisa um contrato de que ele recebeu tokens: um transfer() simples para um contrato que não tem como movimentar tokens para fora deixa esses tokens presos; pelo menos US$ 83.656.418 foram perdidos dessa forma até 20 de junho de 2024 (ethereum.org), e padrões como o ERC-223 e o ERC-1363 foram propostos para resolver isso.
  • Não prova que um token é legítimo: qualquer contrato pode retornar o nome “Wrapped Ether”; só o endereço identifica o WETH verdadeiro, listado na seção de endereços de contrato.
  • Não move tokens entre redes: o WETH no Ethereum e o WETH no Arbitrum são dois contratos ERC-20 com fornecimentos separados; passar de um para o outro é uma operação de ponte.
  • Não abrange NFTs: tokens únicos seguem outros padrões, como o ERC-721; o ERC-20 abrange apenas unidades intercambiáveis.

FAQ sobre ERC-20

Não. O ETH é a moeda nativa do Ethereum e não tem contrato de token; ele entrou no ar em 30 de julho de 2015, antes de o padrão ERC-20 existir. O WETH é a forma ERC-20 do ETH.