1

O que o botão MAX esconde: enviar o saldo inteiro em nove blockchains diferentes

Em uma carteira de cripto, o botão MAX parece a conta mais simples do mundo: saldo menos taxa. Trabalho em uma carteira não custodial, feita em Flutter, que envia em Bitcoin, Litecoin, Dogecoin, redes EVM (Ethereum, Base, Optimism, Arbitrum e outras), Solana, XRP, TRON, TON e Cardano. Em quase todas elas o "saldo menos taxa" deu errado pelo menos uma vez, sempre em envio de verdade, com dinheiro de verdade e com a rede recusando a transação.

Cada rede tem um detalhe que a conta simples não enxerga. Juntei aqui o que aprendemos, rede a rede, e como cada caso ficou resolvido.

Antes de tudo: o MAX aparece antes da taxa

No fluxo de envio, a pessoa digita o valor em uma tela e escolhe a velocidade da taxa na tela seguinte. Ou seja, o MAX é tocado antes de existir uma taxa escolhida.

O que fazemos:

  • Ao tocar no MAX, a carteira pede a estimativa de taxa na hora, usando o saldo inteiro como valor de sondagem. Nas redes de UTXO a taxa depende de quantas moedas a transação junta, e o saldo inteiro é o pior caso.
  • Se a pessoa depois troca a velocidade da taxa, o máximo é recalculado, mas só se o valor veio do MAX. Valor digitado à mão nunca é mexido.
  • Sem estimativa de taxa, a carteira não propõe número nenhum. Propor "saldo menos uma taxa chutada" dá um valor que a rede recusa, e calar é mais útil.

Base e Optimism: a taxa que fica fora do gas

Nas redes OP Stack, a taxa tem duas partes: o gas da própria rede e o custo de publicar a transação na Ethereum (o l1Fee). O detalhe é que o l1Fee não entra em gasLimit × maxFeePerGas. O nó soma por fora e, para aceitar a transação, exige saldo para valor + gas × preço + l1Fee.

Resultado: um MAX que desconta só o gas gasta o saldo inteiro e é sempre recusado, por menor que seja o l1Fee.

A solução foi perguntar ao oráculo de gas da própria rede (o contrato 0x420000000000000000000000000000000000000F, função getL1FeeUpperBound(uint256), que existe desde o upgrade Fjord) quanto custa publicar uma transação daquele tamanho, e somar isso à taxa.

Repare que pedimos o teto, não a estimativa exata. Esse número serve para reservar saldo: sobrar um resto mínimo na carteira é muito melhor do que a rede recusar o envio. Se o oráculo não responder, a taxa fica como a rede deu, sem inventar um valor.

Arbitrum: os 21.000 que não são 21.000

Todo mundo sabe que uma transferência simples custa 21.000 de gas. No Arbitrum, não: lá o custo de publicar na Ethereum entra dentro das unidades de gas. Em um teste, uma transferência simples pediu 21.337, e esse número sobe e desce com o gas da L1. Assinando com 21.000, a rede recusava com insufficient funds.

Tem uma segunda armadilha. Se você chama eth_estimateGas com o valor do MAX, a estimativa falha por falta de saldo, porque o nó orça o gas no limite do bloco. Por isso a estimativa da moeda nativa é feita sem valor e sem remetente, e o que passar de 21.000 leva 25% de folga. O gas que não é usado não é cobrado.

Tokens ERC-20: o primeiro saldo custa mais caro

Nos tokens, a estimativa precisa do remetente. Sem ele, o nó simula o envio a partir de uma carteira vazia, a simulação falha e o código caía em um valor fixo de 65.000.

O caso que nos ensinou isso: um envio de USDC para uma carteira que nunca tinha tido USDC gastou 64.578 dos 65.000, ficou sem gas e foi revertido. Precisava de 79.012. Gravar o primeiro saldo de uma carteira em um token custa mais do que atualizar um saldo que já existe.

Hoje a estimativa usa o remetente, leva 25% de folga e tem um piso mínimo.

Bitcoin, Litecoin e Dogecoin: a taxa depende de quantas moedas você junta

Nas redes de UTXO, a taxa é paga por byte, e o tamanho da transação depende de quantas entradas ela gasta:

  • SegWit nativo (P2WPKH, usado no BTC e no LTC): 11 + 68 × entradas + 31 × saídas vbytes;
  • endereço legado (P2PKH, usado no DOGE): 10 + 148 × entradas + 34 × saídas bytes.

Durante um tempo, a carteira media sempre uma entrada só. Um envio de LTC que juntava quatro moedas (uns 345 bytes) pagou a taxa de 141 bytes, a 1 por byte, e a rede recusou por estar abaixo do mínimo dela.

O que mudou:

  • A taxa agora é medida pelas moedas que a transação vai juntar de verdade, na mesma ordem em que o construtor da transação as junta.
  • Se o troco ficaria abaixo do limite de poeira (546 satoshis no SegWit), ele não vira saída: vai para a taxa. A carteira conta isso também, então a taxa que a tela mostra é a que a transação leva, ao satoshi.
  • O MAX é o caso "todas as entradas, uma saída, sem troco".

XRP: o saldo que não pode sair

No XRP Ledger, toda conta precisa manter uma reserva: uma base (1 XRP desde dezembro de 2024; antes eram 10) mais 0,2 XRP por objeto que a conta possui. Essa parte do saldo não pode ser enviada.

Dois cuidados:

  • A reserva é perguntada à rede (server_state → validated_ledger.reserve_base e reserve_inc), porque ela já mudou e pode mudar de novo. O número escrito no código é só o plano B.
  • Uma transação recusada por causa da reserva entra no ledger mesmo assim e cobra a taxa. Então a carteira confere a reserva e se o destino já existe antes de assinar, e não depois.

TRON: às vezes é grátis, às vezes queima 1 TRX

Durante um tempo, o código assumia "1 TRX de taxa em qualquer envio". Errado das duas maneiras: assusta quem não vai pagar nada e engana quem vai pagar mais.

O custo real depende de duas perguntas:

  • A conta de destino já existe? Se não existe, a rede queima 1 TRX para criá-la, mais 0,1 TRX de largura de banda. Os dois valores são parâmetros públicos da rede e são lidos de lá.
  • O remetente ainda tem largura de banda gratuita? Cada conta tem 600 por dia, e uma transferência gasta por volta de 270. Se cabe, o envio é grátis. Se não cabe, paga-se 1.000 sun por byte, e a rede não mistura: ou a transação cabe inteira na banda livre, ou é paga inteira.

Se a rede não responde, a carteira reserva o pior caso. É melhor guardar demais do que propor um MAX que não passa.

TON: a taxa que você não escolhe

Na TON a taxa não é escolhida: a rede calcula e desconta do saldo. E não dá para estimar o valor exato antes de montar e assinar o corpo da mensagem.

A solução foi uma reserva pequena e fixa só para o MAX deixar espaço (meio centésimo de TON). Para comparar, um envio real de 0,60 TON custou 0,000900566 TON. Os valores que estiveram no código antes (0,05, 0,02 e 0,01) vinham de medianas de chamadas a contratos, que são outra coisa, e eram altos demais para uma transferência simples. O valor exato aparece depois, no histórico, lido da própria blockchain.

Solana: o depósito que não é taxa

A taxa da Solana é previsível: 5.000 lamports por assinatura, mais a taxa de prioridade (usamos a mediana de getRecentPrioritizationFees).

O que pega é outra coisa: um token só chega a uma carteira se ela já tiver uma conta para aquele token. Na primeira vez, alguém paga a criação dessa conta, com um depósito de renda que não é taxa (volta para quem fechar a conta), mas sai do saldo.

Na primeira troca que fizemos na Solana, a tela anunciava só a taxa (0,000105 SOL), e saíram também 0,00148844 SOL de depósito. O número fixo que estava no código estava errado e nem era mostrado. Hoje o valor é perguntado à rede (getMinimumBalanceForRentExemption para os 165 bytes de uma conta de token) e aparece na tela.

Cardano: os tokens seguram ADA

Na Cardano, toda saída com tokens nativos precisa carregar um mínimo de ADA. Se a carteira tem tokens, eles voltam para ela no troco, e esse troco precisa do mínimo de ADA e dos bytes que a saída ocupa (cada byte paga taxa).

O MAX de ADA sem essa folga pedia exatamente o ADA que ia faltar ao troco, e a transação nem se montava. Hoje a reserva é calculada montando a saída com todos os tokens da carteira: minAda(saída) + minFeeA × bytes da saída. E a tela explica por que aquele ADA não pode sair.

O que ficou de regra geral

  1. O MAX é um número da rede, não da tela. Reservas, parâmetros e renda mudam; pergunte à rede e use constantes só como plano B.
  2. Para reservar, use o teto, não a estimativa. Sobrar um resto mínimo é melhor do que a rede recusar.
  3. Sem taxa conhecida, não proponha MAX. Um número errado é pior do que número nenhum.
  4. Teste com dinheiro de verdade, em valores pequenos. Praticamente todos esses casos apareceram assim, e não em testnet.

Se você já esbarrou em alguma dessas redes de outro jeito, ou conhece um caso que não está aqui, comenta aí. Ainda há redes em que a gente aprende alguma coisa a cada envio.

Carregando publicação patrocinada...