Puntos clave de la noticia:
- Hedera presentó MirrorNodeAccountBalanceQuery como reemplazo SDK-native de AccountBalanceQuery, permitiendo consultar balances HBAR desde Mirror Nodes sin construir llamadas REST manuales.
- La nueva query está disponible en JavaScript, Java y Go, admite formatos de account ID, no requiere pagos en HBAR e incluye reintentos automáticos ante errores.
- La migración es obligatoria para aplicaciones que usan AccountBalanceQuery, porque su endpoint de node está limitado a cero en testnet y mainnet desde v0.77.
Hedera presentó MirrorNodeAccountBalanceQuery, un reemplazo SDK-native de AccountBalanceQuery que permite consultar balances de HBAR desde Mirror Node de forma directa. En el anuncio oficial, Hedera explicó que el método está disponible en los SDK Hiero de JavaScript, Java y Go. MirrorNodeAccountBalanceQuery convierte una ruta basada en REST en un flujo nativo del SDK, manteniendo un resultado similar al de AccountBalanceQuery.
Hedera traslada las consultas de balances HBAR a Mirror Nodes
MirrorNodeAccountBalanceQuery obtiene el balance HBAR desde el endpoint GET /api/v1/balances de Mirror Node. El método es gratuito, no requiere pagar la query y reintenta errores 5xx o fallos de red mediante exponential backoff. También acepta identificadores como shard.realm.num, direcciones EVM, aliases de claves públicas y contract IDs. Esa flexibilidad integra la resolución de Mirror Node, ampliando la estrategia de herramientas para desarrolladores sin exigir lógica REST personalizada.
La migración es sencilla. En JavaScript, los desarrolladores sustituyen el import de AccountBalanceQuery por MirrorNodeAccountBalanceQuery y mantienen el patrón con setAccountId y execute. Java y Go siguen flujos similares. Las aplicaciones en Rust, Swift y C++ pueden acceder a los mismos datos mediante el endpoint REST de Mirror Node. El cambio reduce la fricción de migración y alinea las consultas de balances con la arquitectura de Mirror Node, dentro del ecosistema open source de SDK de Hedera.
El cambio es obligatorio para aplicaciones que dependen de AccountBalanceQuery. Hedera indicó que el endpoint de consensus node detrás de esa query está limitado a cero en testnet y mainnet desde Consensus Node v0.77. Los desarrolladores deben actualizar a una versión reciente del SDK y sustituir la query deprecada. Las aplicaciones que no usan AccountBalanceQuery no se ven afectadas. La deprecación convierte la migración hacia Mirror Node en un requisito operativo y no en una optimización opcional, reforzando el papel de la infraestructura Mirror Node.
Existe una consideración de timing. Los Mirror Nodes reciben datos desde los consensus nodes tras la propagación, un proceso que puede tardar varios segundos. Hedera recomienda añadir un retry o polling al consultar un balance justo después de enviar una transacción, o apoyarse en el transaction receipt. También aconseja probar MirrorNodeAccountBalanceQuery con una cuenta de testnet antes del deployment. El nuevo método ofrece una ruta de migración soportada mientras mantiene las consultas de balances dentro de la experiencia nativa del SDK de Hedera.
