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.
- Remetente (a carteira inteligente): uma carteira em forma de contrato que guarda seus ativos e implementa
validateUserOp. Do ponto de vista de qualquer DApp com que interage, ela é omsg.sender. Exemplos: Safe, Kernel, Biconomy Nexus, Coinbase Smart Wallet e Light Account, da Alchemy. - UserOperation: uma estrutura semelhante a uma transação (mas que não é uma transação real da Ethereum) e descreve o que o remetente quer fazer. Os usuários assinam UserOps, não transações.
- Bundler: um nó off-chain que coleta UserOps de um mempool, simula as operações, agrupa tudo em uma única chamada
handleOpse paga o gas da L1. Os bundlers ficam com a diferença entre o valor reembolsado pelo remetente (ou paymaster) e o que pagam ao validador. - EntryPoint: o contrato singleton confiável que percorre o pacote, chama o
validateUserOpde cada remetente, executa os dados da chamada e processa reembolsos e reversões. Há exatamente um EntryPoint por versão em cada rede. - Paymaster (opcional): um contrato que se compromete a pagar o gas em nome de um remetente, seja patrocinando o custo (sem custo para o usuário), seja em troca de um token ERC-20, como USDC.
- Agregador (opcional): um contrato que valida várias UserOps com uma única verificação de assinatura — útil para esquemas BLS ou provas zk. Hoje, raramente é implantado em produção.
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:
sender— o endereço da carteira inteligente.nonce— um valor de 256 bits, em que os 192 bits superiores formam uma chave (faixa de nonce paralela) e os 64 bits inferiores indicam uma sequência. É assim que o ERC-4337 permite nonces paralelos, ao contrário das EOAs, que serializam tudo.factoryefactoryData— usados na implantação inicial via CREATE2; ficam nulos após a implantação.callData— a chamada que a carteira inteligente deve fazer após a validação.callGasLimit,verificationGasLimit,preVerificationGas— três limites de gas separados.maxFeePerGas,maxPriorityFeePerGas— seguem a mesma semântica EIP-1559 de uma transação comum.paymasterAndData(v0.6) dividido empaymaster,paymasterVerificationGasLimit,paymasterPostOpGasLimit,paymasterData(v0.7).signature— bytes opacos que a carteira inteligente interpreta conforme seu própriovalidateUserOp.
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.
- O usuário toca em “Trocar” na interface da carteira. A carteira monta uma UserOperation:
sender = 0xUserSafe,callData = swapUSDCforETH(amount)direcionados à Uniswap. - Estimativa de gas. A carteira chama
eth_estimateUserOperationGasem um RPC de bundler. O bundler simula a operação no EntryPoint e retorna os três limites de gas. - 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.
- Envio. A UserOp assinada é enviada via
eth_sendUserOperationpara um ou mais bundlers. Ela entra no alt-mempool, uma rede P2P separada do mempool de transações comum da Ethereum. - Simulação pelo bundler. O bundler simula novamente usando
eth_callcontrasimulateValidation. 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. - Agrupamento. O bundler reúne esta UserOp com até ~10 outras em uma única chamada
handleOps([...userOps], beneficiary)ao EntryPoint. - Execução on-chain. O EntryPoint percorre o pacote: para cada operação, chama
validateUserOpno remetente, desconta o valor pré-financiado e, em seguida, executacallData. A troca na Uniswap é feita pela carteira inteligente. - 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:
- Endereço:
0x0000000071727De22E5E9d8BAf0edAc6f37da032(observe os zeros à esquerda: é um endereço escolhido por mineração de vaidade para reduzir o custo de gas dos dados da chamada, já que cada byte zero custa 4 unidades de gas, contra 16 para um byte diferente de zero). - Campos do paymaster separados:
paymaster,paymasterVerificationGasLimit,paymasterPostOpGasLimit,paymasterDataagora são campos distintos. Fica mais fácil estimar e mais difícil esquecer algum limite. - Separação da factory: a mesma ideia —
factoryefactoryDataagora são campos distintos, em vez de uminitCodeagrupado. - Penalidade por gas não utilizado: os remetentes pagam 10% do
callGasLimit/paymasterPostOpGasLimitnão utilizado, o que desestimula estimativas muito acima do necessário. - Compatibilidade com EIP-7702: a v0.7 adicionou a infraestrutura que permite a uma EOA comum delegar temporariamente para uma implementação de carteira inteligente, servindo de base para o caminho de atualização EIP-7702 lançado na Pectra.
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:
- Paymaster de verificação (patrocinado). Um servidor assina uma aprovação off-chain; o paymaster verifica a assinatura on-chain e paga. É usado por aplicativos que querem oferecer integração sem custo de gas — Coinbase Smart Wallet, Farcaster Frames e a maioria das emissões de NFT.
- Paymaster ERC-20. O usuário paga em USDC, USDT ou DAI; o paymaster troca os tokens por ETH nos bastidores (ou mantém reservas de ETH). Pimlico, Biconomy e Stackup oferecem versões públicas.
- Paymaster de token com permit. Usa o permit EIP-2612 para que o usuário assine a UserOp e a aprovação do token em uma única assinatura.
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.



