Recovery Kit

Recovery Kit

The recovery kit is a browser-based offline recovery helper used for decryption and extraction.

Variants

Ethernity currently ships two recovery kit bundles:

• recovery_kit.bundle.html (lean, default)
  • no jsQR camera scanner fallback
  • smaller artifact for printing/embedding workflows
• recovery_kit.scanner.bundle.html (scanner)
  • includes jsQR camera scanning support
  • larger artifact, broader browser/OS camera compatibility

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.
• The kit warns when the browser reports an active network connection.
• The browser online/offline signal is a hint, not a guarantee.
• Treat online recovery as operator-risk behavior.

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

• Prefer the lean kit for archival/printed workflows unless camera support is required.
• Use the scanner kit when browser camera support is needed and artifact size is acceptable.
• Paste-based recovery remains the most broadly compatible input path.

Common Failure Patterns

• Camera permission denied: switch to paste-based payload input.
• Mixed document sets: clear state and re-import one set per run.
• Parser rejects fallback text: verify source line integrity and avoid wrapped clipboard text.

Related

• Recovery Workflow
• Security and Trust Model
• Troubleshooting