Troubleshooting

Ledger is unreachable Check: host, ledgerPort, TLS settings, token expiry, and grpcAuthority when routing through nginx or a tunnel.

Admin checks show skip Check: adminPort and adminGrpcAuthority. A skipped Admin check means STANDARD mode can still work, but FULL-only balance details are unavailable.

Vetting check is unavailable Check: httpHost and httpPort for JSON Ledger API fallback. Set synchronizerId if vetting checks are skipped or warn.

PERMISSION_DENIED during prepare Check: the JWT user, userId, actAs, and readAs values. The profiler reports the failure; party rights are managed outside the profiler.

balance returns unavailable Check: whether Admin traffic state is reachable. If no balance source is available, use inspect and estimate for the remaining readiness and cost checks.

Scan returns 403 or times out Check: whether a validator scan-proxy URL is available. Otherwise configure fallbackUsdPerCc or fallbackUsdPerMb for offline estimates.