Recovery Kit

Recovery Kit

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

If you are unsure which variant to use, start with recovery_kit.bundle.html (lean).

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).

Simple Usage Pattern

1. Open kit file offline.
2. Import one backup set only.
3. Recover and validate output.
4. If it fails, clear state and retry with clean input sources.

Related

• Recovery Workflow
• Security and Trust Model
• Troubleshooting