⚠️ 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-4023

InvalidStateFileFormatSoloError — Validation

InvalidStateFileFormatSoloError

CodeSOLO-4023
CategoryValidation
OwnershipUser
RetryableNo

Description

Thrown when a state file is not a .zip; the message names the path. solo expects saved state as a zip archive, so this means a non-zip file was supplied.

Troubleshooting Steps

  1. Use a state file ending in .zip with –state-file <stateFile.zip>
  2. Download a valid state file first: solo consensus state download
  3. If passing a directory instead, Solo will select node-specific state files from /states//.