Recovery Kit

Recovery Kit

The recovery kit is a browser helper for recovery when CLI-first workflows are not practical.

Variants

Ethernity currently ships two recovery kit bundles:

• recovery_kit.bundle.html (lean, default)
  • no built-in camera scanner fallback
  • smaller file, easier to distribute/store
• recovery_kit.scanner.bundle.html (scanner)
  • includes camera scanning support
  • larger file, but easier for scan-heavy workflows

Quick selection matrix:

Need	Recommended variant
Smallest artifact size	lean
Browser camera scanning	scanner
Mostly paste/text input workflows	lean
Unknown browser camera reliability	scanner

Safety Posture

• Use the kit offline.
• Treat browser "online/offline" status as a hint, not a hard guarantee.
• If possible, run recovery in a controlled environment with no network access.

Rebuilding the Kit (Contributors)

The kit build now requires libdeflate-gzip.

cd kit
npm ci
# Install libdeflate-gzip first (for example: apt install libdeflate-tools)
node build_kit.mjs

This emits both bundles into:

• kit/dist/
• src/ethernity/kit/

Operator Notes

• Pick lean when size and simplicity matter most.
• Pick scanner when camera scanning is important.
• Paste-based input is usually the most reliable fallback.

Common Failure Patterns

• Camera permission denied -> switch to paste-based input.
• Mixed backup sets -> clear state and import one set at a time.
• Fallback parse errors -> re-copy source text carefully (line wrapping often causes this).

Related

• Recovery Workflow
• Security and Trust Model
• Troubleshooting