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.
- 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.