zeroclaw-labs/zeroclaw · error · anyhow::Error

SHA256SUMS fetch returned

Error message

SHA256SUMS fetch returned {}

What it means

Fires in verify_download_checksum when the SHA256SUMS file fetch returns a non-success HTTP status. Checksum verification is mandatory before the downloaded artifact is written, so a failed sums fetch aborts the install rather than falling back to an unverified binary. The faulting input is the SHA256SUMS URL for the release. Retry, or check that the release still publishes a SHA256SUMS asset.

Solutions

  1. Check connectivity to the release host serving SHA256SUMS and retry.
  2. If the release lacks a SHA256SUMS file, update to a release that publishes checksums or verify manually.
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at src/commands/update.rs:515 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/ca817fdbaed37e2b. Report an issue: GitHub.

Appendix: source

Thrown at src/commands/update.rs:515

    Ok(())
}

async fn verify_download_checksum(
    bytes: &[u8],
    asset_url: &str,
    sha256sums_url: &str,
    client: &reqwest::Client,
) -> Result<()> {
    let asset_name = asset_name_from_url(asset_url)
        .context("cannot derive release asset filename from download URL")?;

    let sums_resp = client
        .get(sha256sums_url)
        .send()
        .await
        .context("failed to fetch SHA256SUMS")?;
    if !sums_resp.status().is_success() {
        bail!("SHA256SUMS fetch returned {}", sums_resp.status());
    }

    let sums_text = sums_resp
        .text()
        .await
        .context("failed to read SHA256SUMS body")?;
    verify_checksum_bytes(bytes, &asset_name, &sums_text)?;

    ::zeroclaw_log::record!(
        INFO,
        ::zeroclaw_log::Event::new(module_path!(), ::zeroclaw_log::Action::Note)
            .with_outcome(::zeroclaw_log::EventOutcome::Success)
            .with_attrs(::serde_json::json!({"asset": asset_name})),
        "Update download checksum verified"
    );
    Ok(())
}

View on GitHub (pinned to 88bb9c8533)