SOLO-3021

AccountBalanceQueryFailedSoloError

Description

Thrown when solo cannot read an account’s HBAR balance from the network via the Hedera SDK; the message names the account and, when present, wraps the underlying cause. solo queries balances to verify funding and confirm operations, so this is raised when the balance query does not return — typically because the target consensus node is unreachable or not yet ACTIVE, or the SDK client is misconfigured. It is retryable, since a transient network or node-readiness issue often clears on a later attempt.

Troubleshooting Steps

1. Verify gossip endpoints and gRPC service endpoints are reachable from the network.
2. Confirm the account ID is valid and exists on the network.
3. Review solo logs: tail -n 100 ~/.solo/logs/solo.log