Zelcore

Arquitetura ERC-4337: EntryPoint, Bundlers e Paymasters sem complicação

10 min de leitura
Arquitetura ERC-4337: EntryPoint, Bundlers e Paymasters sem complicação

A abstração de contas na Ethereum tem dois endereços canônicos que vale a pena memorizar. O EntryPoint v0.6 fica em 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789. O EntryPoint v0.7, implantado no início de 2024, fica em 0x0000000071727De22E5E9d8BAf0edAc6f37da032. Todas as transações ERC-4337 na mainnet, Arbitrum, Optimism, Base, Polygon e na maioria das outras redes EVM passam por um desses dois contratos singleton. Se você entende o que esses contratos fazem e quais são as outras cinco funções ao redor deles, entende o ERC-4337.

Esta é a parte 2 da nossa série sobre Smart Accounts. A parte 1 explicou por que as EOAs são uma opção padrão ruim. Aqui, vamos aos bastidores: as seis funções, a estrutura UserOperation, o que acontece de fato quando você troca um token de uma carteira inteligente, as mudanças da v0.6 para a v0.7, os paymasters, os alt-mempools públicos e os bundlers privados, além do custo adicional esperado.

As seis funções em um diagrama

O ERC-4337 divide em seis participantes que cooperam o que uma EOA faz em uma única etapa. Nenhum deles exigiu um hard fork da Ethereum: todo o sistema é composto por contratos e infraestrutura off-chain.

Tenha essas funções em mente. O restante do artigo mostra apenas como elas interagem.

A estrutura UserOperation

Uma UserOperation é um conjunto de campos compatível com JSON-RPC que, depois de assinado, expressa uma intenção sem ainda registrá-la na L1. O formato da v0.7 tem 11 campos lógicos:

O esquema de assinatura fica a critério da carteira. ECDSA sobre secp256k1 é comum, mas a verificação P-256/passkey, o multisig, os limites para recuperação social e os signatários com chave de sessão também funcionam por trás da mesma interface. Essa flexibilidade é justamente o objetivo.

Do início ao fim: o que acontece quando uma carteira inteligente troca USDC por ETH

Acompanhe uma troca real para ver as funções entrarem em ação na ordem.

  1. O usuário toca em “Trocar” na interface da carteira. A carteira monta uma UserOperation: sender = 0xUserSafe, callData = swapUSDCforETH(amount) direcionados à Uniswap.
  2. Estimativa de gas. A carteira chama eth_estimateUserOperationGas em um RPC de bundler. O bundler simula a operação no EntryPoint e retorna os três limites de gas.
  3. O usuário assina. A carteira calcula o hash da UserOp com o endereço do EntryPoint e o ID da rede, solicita a assinatura do usuário (passkey, chave de hardware ou outro método) e a anexa.
  4. Envio. A UserOp assinada é enviada via eth_sendUserOperation para um ou mais bundlers. Ela entra no alt-mempool, uma rede P2P separada do mempool de transações comum da Ethereum.
  5. Simulação pelo bundler. O bundler simula novamente usando eth_call contra simulateValidation. Ele verifica as regras de acesso ao armazenamento do ERC-7562: durante a validação, uma UserOp só pode acessar o próprio armazenamento; caso contrário, o bundler corre o risco de sofrer um ataque de griefing.
  6. Agrupamento. O bundler reúne esta UserOp com até ~10 outras em uma única chamada handleOps([...userOps], beneficiary) ao EntryPoint.
  7. Execução on-chain. O EntryPoint percorre o pacote: para cada operação, chama validateUserOp no remetente, desconta o valor pré-financiado e, em seguida, executa callData. A troca na Uniswap é feita pela carteira inteligente.
  8. Reembolso. O EntryPoint devolve ao remetente (ou paymaster) o valor do gas não utilizado e paga ao endereço beneficiário do bundler.

Se a etapa 5 falhar, o bundler descarta a operação e o usuário vê um código de erro AAxx. Os mais comuns são AA21 (não pagou o valor pré-financiado), AA23 (erro de assinatura), AA25 (nonce inválido), AA33 (reversão do paymaster) e AA40 (limite de gas de verificação excedido). Memorize essa lista — você vai encontrá-los.

EntryPoint v0.6 e v0.7

A v0.6 foi lançada em março de 2023 em 0x5FF1…2789. Funcionava, mas tinha três problemas persistentes: um único bloco paymasterAndData que misturava três dimensões de gas, uma estrutura initCode pouco prática e um cálculo de gas que cobrava demais dos remetentes. A v0.7 corrigiu os três.

Principais mudanças da v0.7 que vale a pena conhecer:

A v0.6 continua ativa e em uso — muitas carteiras só lançaram um módulo compatível com a v0.7 bem depois de 2024. A maioria das redes mantém as duas versões do EntryPoint em paralelo por anos.

Paymasters: quem paga o gas

Um paymaster é um contrato que mantém uma participação em ETH junto ao EntryPoint e concorda em cobrir o gas das UserOps que atendem à sua política. Três tipos são predominantes:

O validatePaymasterUserOp do paymaster é executado durante a fase de validação do EntryPoint. Se ele reverter, você recebe AA33. Se o paymaster ficar sem participação, o EntryPoint a confisca e o bundler arca com a perda — por isso, os bundlers mantêm listas de reputação dos paymasters. O ERC-7562 formaliza essas regras de reputação para que o mempool do bundler continue resistente a spam. Esses mesmos elementos explicam por que as boas práticas de aprovação de DeFi e multisig se aplicam tão bem ao universo 4337: as mesmas ameaças, com uma nova camada.

Mempool público alternativo vs. bundler privado

Há duas maneiras de colocar uma UserOp na blockchain.

Mempool público alternativo: bundlers compatíveis com ERC-7562 propagam UserOps por uma rede libp2p. Qualquer pessoa que opere um nó Pimlico, Stackup, Alchemy, Etherspot ou Voltaire pode receber a sua. Essa opção não exige permissão e é resistente à censura, mas expõe você aos mesmos riscos de MEV das transações comuns de Ethereum: os searchers podem ver sua operação antes da inclusão no bloco.

Bundler privado: você envia eth_sendUserOperation diretamente ao RPC de um provedor. Ele simula, agrupa e envia a operação de forma privada (muitas vezes via Flashbots). É mais rápido e protege contra MEV, mas você precisa confiar que o bundler não vai censurar nem antecipar sua transação. Em 2026, a maioria das carteiras voltadas ao consumidor usa bundlers privados por padrão.

Essa escolha reflete a diferença entre o mempool público e o Flashbots Protect para transações comuns. Se você ainda não conhece o ciclo de vida de uma transação desde a época da L1, esse guia introdutório explica o que muda quando o bundler entra em cena.

Agregadores, adoção e custos

Agregadores são contratos que validam lotes com uma única verificação de assinatura. O caso de uso clássico é o BLS: você reúne 50 UserOps assinadas com BLS, agrega as assinaturas em uma única verificação de emparelhamento e economiza cerca de 95% do gas gasto com assinaturas. A adoção tem sido lenta porque é difícil criar carteiras que assinem com BLS, e a economia de gas só compensa em alto volume. Em meados de 2026, menos de 1% das UserOps da mainnet usam agregadores.

Números de adoção (T1 de 2026, segundo bundlebear.com): cerca de 380 milhões de UserOps acumuladas em todas as chains, com Base, Polygon e Arbitrum respondendo pela maioria. A participação da mainnet é de cerca de 6–8%: a menor em volume, mas a maior em valor transferido. Coinbase Smart Wallet, Farcaster e Argent concentram a maior parte do uso por consumidores.

Custo adicional: uma UserOp v0.7 custa cerca de 30.000–40.000 gas a mais que a transação EOA equivalente — isso cobre o ciclo do EntryPoint, a validação e o processamento do lote. Na mainnet, a 20 gwei, isso representa uma fração de dólar por operação. A implantação de uma conta pela primeira vez via factoryData acrescenta cerca de 250.000 gas. Em L2s, onde os dados de chamada são o principal custo, o acréscimo percentual fica na casa de um dígito. UserOps patrocinadas transferem esse custo para o dApp; por isso, você vê transações gratuitas em apps para consumidores, mas não em DeFi de alto nível. O guia sobre taxas de transação explica como esse custo adicional aparece em diferentes mercados de taxas.

Em resumo: ERC-4337 reúne seis funções (remetente, UserOp, bundler, EntryPoint, paymaster e agregador), uma struct, dois endereços de EntryPoint que você deve memorizar e cerca de 30–40 mil gas de custo adicional. Em troca, oferece esquemas de assinatura arbitrários, patrocínio de gas, agrupamento e nonces paralelos. A parte 3 desta série aborda o EIP-7702: a via paralela do Pectra, que permite que sua EOA atual use essa mesma estrutura sem mudar de endereço.


Leia também

Carteiras, gás e aprovações: os três conceitos que todo usuário de DeFi precisa entender

Carteiras, gás e aprovações: os três conceitos que todo usuário de DeFi precisa entender

Antes de trocar tokens, emprestar ou fazer farming, você precisa entender os três elementos básicos dos quais toda interação com DeFi depende: sua carteira, o gás e as aprovações de tokens.

8 min de leitura
Contas, contratos e EVM: como o Ethereum realmente executa transações

Contas, contratos e EVM: como o Ethereum realmente executa transações

O Ethereum substitui a estrutura UTXO do Bitcoin por uma enorme tabela de contas e uma máquina de pilha que mede o consumo de gas. Veja como funcionam o estado, os opcodes e uma transferência ERC-20.

11 min de leitura
Ilustração quadrada sobre a mecânica do gas do Ethereum, com EIP-1559, taxas de prioridade e taxas de blob após Dencun

Mecânica do gas do Ethereum: EIP-1559, taxas de prioridade e taxas de blob após Dencun

Como as taxas de gas do Ethereum funcionam em 2026: o leilão da taxa-base do EIP-1559, as gorjetas de taxa de prioridade e o mercado independente de blobs criado em Dencun e ampliado por Pectra.

10 min de leitura

Assine nossa newsletter

Receba uma atualização amigável nossa uma vez por mês. Sem spam, só as novidades da Zelcore.

Assine nossa newsletter