⚠️ Homebrew support is being deprecated. Solo will stop publishing updates to Homebrew after August 31, 2026. Install via npm install -g @hiero-ledger/solo@latest instead. See System Readiness for full install instructions.

SOLO-3093

NodeKeyLoadFailedSoloError — Component

NodeKeyLoadFailedSoloError

CodeSOLO-3093
CategoryComponent
OwnershipUser
RetryableNo

Description

Thrown when solo cannot load a consensus node key or certificate from its PEM file; the underlying failure is wrapped in cause and the message names the offending file. solo reads the gossip and gRPC TLS PEM files back from disk before using them, so this means the file is missing, truncated, or not valid PEM content — regenerating the keys replaces the corrupt files.

Troubleshooting Steps

  1. Verify the file exists and contains valid PEM content:
  2. Regenerate the node keys: solo keys consensus generate –deployment –generate-gossip-keys –generate-tls-keys
  3. Check solo logs: tail -n 100 ~/.solo/logs/solo.log