A Hedera vai descontinuar o AccountBalanceQuery até julho de 2026, incentivando os desenvolvedores a utilizarem a API REST do Mirror Node, à medida que os limites de throttling diminuem a partir de maio de 2026. Veja as mudanças.
A Hedera está a eliminar o AccountBalanceQuery. A rede confirmou que a funcionalidade será totalmente removida com a versão 0.75 do nó de consenso de julho de 2026. Os desenvolvedores que ainda não começaram a migrar já estão sem tempo.
A questão principal não é a complexidade técnica. Cada chamada de AccountBalanceQuery acede diretamente aos nós de consenso. Isso os afasta do processamento de transações e do alcance de um acordo, que é a sua função principal. À medida que a rede cresce, essa troca de recursos deixa de fazer sentido.
Como @hedera_devs publicou no X, os limites de throttling começarão a diminuir bem antes do prazo de julho. Atualmente, a consulta funciona a 40.000 pedidos por segundo. Isso mantém-se até abril de 2026. Em maio, cai para 20.000 rps. Em junho, chega a 10.000 rps. Depois, em julho, todas as solicitações falham.
Aplicações de alto volume sentirão primeiro o impacto em maio. Esse é o ponto de inflexão.
A rede não está a remover esta funcionalidade sem oferecer uma alternativa melhor. Os Mirror Nodes foram criados exatamente para este tipo de consulta de dados. Eles suportam alta taxa de transferência sem prejudicar o consenso. O Mirror Node hospedado pela Hedera oferece acesso gratuito com limites próprios de throttling, e fornecedores comerciais oferecem volumes maiores em planos pagos.
Leitura obrigatória: Hedera ativa transferências cross-chain sem interrupções via Axelar
O endpoint de substituição já está ativo. Os desenvolvedores trocam o AccountBalanceQuery por uma chamada REST à API do Mirror Node da Hedera no endpoint de saldos, passando o ID da conta. Segundo o guia oficial de migração da Hedera, os saldos de tokens funcionam através de um endpoint separado de tokens de contas. Ambos já estão prontos para produção.
O guia de migração descreve cinco passos. Primeiro, procurar no código por AccountBalanceQuery e chamadas .getAccountBalance(). Segundo, escolher a API REST do Mirror Node como caminho de substituição. Terceiro, testar tudo no testnet. Quarto, implementar antes de maio. Quinto, eliminar completamente as referências obsoletas.
O quarto passo é o mais importante. Estar ativo antes de maio evita problemas com limites de taxa.
Também pode interessar: HBAR junta-se ao DMI enquanto a política e infraestrutura global de criptomoedas se consolidam
Há outra opção no horizonte. Os Block Nodes, baseados no HIP-1056 e HIP-1081, oferecerão atualizações de saldo baseadas em eventos através de Block Streams. Esse sistema unifica os dados de eventos, registos e sidecars da Hedera em um fluxo verificável. Os desenvolvedores podem subscrever e filtrar apenas os dados necessários.
Os Block Nodes ainda estão em desenvolvimento ativo. Ainda não estão disponíveis para esta janela de migração. A API REST do Mirror Node é o caminho atual.
A descontinuação aplica-se igualmente ao mainnet, testnet e previewnet. Nenhum ambiente tem um cronograma diferente.
Leitura adicional: Geórgia faz parceria com a Hedera para explorar registro de terras na blockchain
Não se trata apenas de uma limpeza. A arquitetura da Hedera está a ser reorganizada com uma separação clara. Os nós de consenso lidam com o consenso. Infraestruturas específicas lidam com os dados. O AccountBalanceQuery estava na categoria errada do ponto de vista de escalabilidade, e será eliminado por isso.
O movimento mais amplo também é visível em outros aspetos. A Hedera tem expandido parcerias empresariais, participado em órgãos de política e aumentado a compatibilidade com EVM. Remover a carga de consultas dos nós de consenso segue essa direção: construir uma rede que realmente possa escalar.
Como a equipa @hedera_devs confirmou diretamente no X, os limites de throttling começam a diminuir em maio de 2026. Maio e junho servem como período de testes. Julho não deixa margem de manobra.
Recursos de migração podem ser encontrados em docs.hedera.com e nos canais de desenvolvedores do Discord da Hedera.