Recovery Kit

Recovery Kit

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

Use it when the CLI is not your preferred recovery surface or when you want a self-contained HTML tool you can carry separately from the main repo.

If you are unsure, start with recovery_kit.bundle.html.

Variants

Ethernity ships two kit bundles:

• recovery_kit.bundle.html (lean)
  • smaller file size
  • no built-in camera scanner
• recovery_kit.scanner.bundle.html (scanner)
  • larger file size
  • includes camera scanning support

Practical rule:

• use lean unless you know you need browser camera scanning
• use scanner when camera support matters more than bundle size

Operator Usage Pattern

1. Open the kit in a controlled, preferably offline, environment.
2. Import one backup set only.
3. Complete recovery and validate the output.
4. If recovery fails, clear state and retry with clean inputs from the same set.

Safety Notes

• Treat browser online/offline status as a hint, not a guarantee.
• Prefer paste or file-based inputs when camera behavior is unreliable.
• Keep shard and auth inputs grouped by document id.

Common Failure Patterns

• camera permission denied: switch to paste-based input
• mixed backup sets: clear state and import one set only
• fallback parse errors: re-copy the source text exactly

Contributor Build Notes

The kit build requires libdeflate-gzip.

cd kit
npm ci
node build_kit.mjs

Build output targets:

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

Related

• Recovery Workflow
• Troubleshooting
• Security and Trust Model