encrypt-decrypt-backup
使用比特币备份 CLI 加密和解密 BSV 备份文件(.bep 格式)。支持所有备份类型(BAP 身份、钱包、序号、保险库)。使用 Flow 的 FLOW_BACKUP_PASSPHRASE 并按照 Flow 的 BSV 约定将文件存储在 /.flow/.bsv/ 中。
📖 中文导读:使用比特币备份 CLI 加密和解密 BSV 备份文件(.bep 格式)。支持所有备份类型(BAP 身份、钱包、序号、保险库)。使用 Flow 的 FLOW_BACKUP_PASSPHRASE 并按照 Flow 的 BSV 约定将文件存储在 /.flow/.bsv/ 中。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: encrypt-decrypt-backup description: Encrypt and decrypt BSV backup files (.bep format) using the bitcoin-backup CLI. Supports all backup types (BAP identity, wallet, ordinals, vault). Uses Flow's FLOW_BACKUP_PASSPHRASE and stores files in /.flow/.bsv/ following Flow's BSV convention. allowed-tools: "Bash(bun:*)"
Encrypt/Decrypt Backup
Encrypt and decrypt BSV backup files using the bitcoin-backup CLI (bbackup).
When to Use
- Encrypt wallet JSON to secure
.bepbackup file - Decrypt
.bepbackup to read wallet data - Create BAP identity backups
- Secure ordinals keys and payment keys
- Store sensitive BSV data encrypted at rest
Supported Backup Types
All backups use .bep format (AES-256-GCM encryption):
- BapMasterBackup - BAP identity (Type42 or Legacy)
- BapMemberBackup - Individual BAP member
- WifBackup - Single private key
- OneSatBackup - Ordinals + Payment + Identity keys
- VaultBackup - Encrypted vault
- YoursWalletBackup - Yours Wallet format
- YoursWalletZipBackup - Yours Wallet ZIP format
Usage
Run the encrypt or decrypt scripts:
# Encrypt a wallet JSON file
bun run /path/to/skills/encrypt-decrypt-backup/scripts/encrypt.ts wallet.json output.bep
# Decrypt a backup file
bun run /path/to/skills/encrypt-decrypt-backup/scripts/decrypt.ts backup.bep
# Decrypt to specific output file
bun run /path/to/skills/encrypt-decrypt-backup/scripts/decrypt.ts backup.bep wallet.json
Flow's BSV Convention
This skill follows Flow's BSV backup convention:
Storage Location: /.flow/.bsv/
backups/- Encrypted .bep filestemp/- Temporary decrypted files (auto-cleanup)config.json- Backup registry
Security:
- Uses
FLOW_BACKUP_PASSPHRASEenvironment variable - Never hardcodes passwords
- Auto-cleanup of temp files after operations
- 600k PBKDF2 iterations for strong encryption
Requirements
FLOW_BACKUP_PASSPHRASEenvironment variable must be setbbackupCLI installed globally:bun add -g bitcoin-backup
CLI Reference
The bitcoin-backup CLI provides three commands:
bbackup enc <input> -p <password> -o <output>- Encrypt JSON to .bepbbackup dec <input> -p <password> -o <output>- Decrypt .bep to JSONbbackup upg <input> -p <password> -o <output>- Upgrade legacy backups
Error Handling
- Password too short (min 8 chars) - Returns error
- Invalid backup structure - Validation error
- Wrong password - Decryption fails with error
- Auto-detects backup type and iteration count