Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What’s new

Release highlights for both surfaces. The authoritative changelogs are the GitHub release notes — CLI and SPA — this page is a hand-curated narrative view.

CLI (bee-check)

v0.5.0 — cold-content end-to-end probe

  • New --cold flag streams GET /bytes/{ref} from each --bee and GET /bzz/{ref}/ from each --gateway, recording bytes downloaded and full-transfer latency. Complements stewardship by exercising the HTTP body transport, catching cases where the chunk graph walks fine but bytes don’t actually flow.
  • Spec adds cold_downloads: ColdDownloadResult[] (additive on spec_version 1).
  • See the stewardship chapter.

v0.4.0 — chunk timing + target-overlay

  • New ChunkStats roll-up: per-vantage and per-neighborhood found/missing counts + p50/p95/max latency, computed in pure-Rust post-processing over the chunks[] array.
  • New --target-overlay HEX flag sorts vantages closest-first to a target overlay and tags each with target_proximity. Useful for “from a user near neighborhood X” framings.
  • Both additive on spec_version 1.

v0.3.0 — gateways + feeds

  • New --gateway flag (repeatable) HEAD-probes a public Swarm gateway. Default: api.gateway.ethswarm.org (which returns proper 404s, unlike the apex gateway.ethswarm.org static landing page). --no-gateway opts out.
  • Positional input now accepts feed:OWNER:TOPIC (or feed:OWNER/TOPIC); resolved via GET /feeds/{owner}/{topic} on the first --bee. resolution field records the original handle.
  • Aggregate status now unions vantages + gateways.

v0.2.0 — perception parity (“which neighborhood?”)

  • Per-vantage overlay (from GET /addresses) and bee_version (from GET /health).
  • Per-vantage proximity_to_root — PO between probe’s overlay and the reference.
  • Per-chunk proximity when --per-chunk is used.
  • --reseed gained a stamp pre-flight via GET /stamps/{id}, surfacing exists/usable/TTL warnings before firing the upload.

v0.1.0 — initial

  • Multi-vantage GET /stewardship/{ref} probe; aggregate status.
  • Optional --per-chunk manifest walk + chunk probes.
  • Optional --reseed --stamp <id> re-upload via PUT /stewardship/{ref}.
  • --output text (human) / --output json (spec_version 1).

Web UI (bee-check-web)

v0.5.0 — CLI parity

  • Per-chunk drill-down in the browser — checkbox enables BFS manifest walk via MantarayNode.unmarshal, probes every chunk on every vantage. Same per-vantage + per-neighborhood roll-ups as the CLI. Per-chunk matrix table rendered inline.
  • Re-seed flow — expandable panel with getPostageBatch pre-flight and reuploadPinnedData execution. “Re-seed now” button disabled until pre-flight reports healthy.
  • Live “Probing chunks N/M…” progress while drilling.

v0.4.0 — chunk-stats tables + target-overlay

  • New tables: chunk stats per vantage, per neighborhood (slowest first, top 10).
  • Target-overlay input re-sorts vantages closest-first.

v0.3.0 — gateway + feed support

  • Gateway URL textarea + per-gateway result row.
  • feed:OWNER:TOPIC resolution before probing.

v0.2.0 — neighborhood / proximity rendering

  • Per-vantage row gained overlay (truncated, hover for full), neighborhood badge, PO-to-root badge, Bee version.

v0.1.0 — initial scaffold

  • Multi-vantage stewardship probe from the browser.
  • Drag-and-drop JSON visualization.
  • Shareable URLs (?ref=…&bee=…) and LocalStorage for Bee URLs.