bitcoin-backup

Encrypt and decrypt private key backups using AES-256-GCM with PBKDF2.

14|5|Updated Jun 3, 2025
One-click install
npx skills add https://github.com/b-open-io/prompts --skill bitcoin-backup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bitcoin-backup
Source: https://github.com/b-open-io/prompts/tree/main/user/.claude/skills/bitcoin-backup
Command: npx skills add https://github.com/b-open-io/prompts --skill bitcoin-backup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Encrypt and decrypt private key backups using AES-256-GCM with PBKDF2 iterations, to secure WIF keys, identities, and wallet data.

Core Features & Use Cases

  • AES-256-GCM encryption with PBKDF2 iterations (configurable)
  • Supported backup types: BapMasterBackup, BapMemberBackup, WifBackup, OneSatBackup, VaultBackup
  • Decryption and upgrade: Decrypt backups and upgrade legacy backups to current iteration settings

Quick Start

Install:

  • bun add -g bitcoin-backup @bsv/sdk

Encrypt JSON to .bep:

  • bbackup enc wallet.json -p "passphrase" -o wallet.bep

Decrypt .bep:

  • bbackup dec wallet.bep -p "passphrase" -o wallet.json

Upgrade legacy:

  • bbackup upg old.bep -p "passphrase" -o upgraded.bep

Frequently Asked Questions about bitcoin-backup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I encrypt private key backups with AES-256-GCM?

AES-256-GCM encryption secures private key backups using a 256-bit cipher with authenticated encryption. Use the bbackup CLI tool with your passphrase: `bbackup enc wallet.json -p "passphrase" -o wallet.bep`. The tool applies PBKDF2 key derivation (default 600,000 iterations) with random salt and IV for each backup.

What backup formats does this Skill support?

This Skill encrypts and decrypts BapMasterBackup, BapMemberBackup, WifBackup, OneSatBackup, and VaultBackup formats. It handles WIF keys, BAP identities, and wallet data across these formats, and creates encrypted .bep backup files compatible with all supported types.

How do I decrypt a .bep backup file?

Decrypt .bep backups by running `bbackup dec wallet.bep -p "passphrase" -o wallet.json`. Provide the same passphrase used during encryption. The tool validates the AES-256-GCM authentication tag and recovers the original backup data.

Can I upgrade legacy backups to current encryption settings?

Yes, legacy backups can be upgraded to current PBKDF2 iteration settings using `bbackup upg old.bep -p "passphrase" -o upgraded.bep`. This re-encrypts the backup with the default 600,000 iterations while maintaining compatibility with all supported backup formats.

What is PBKDF2 and why is it used in backup encryption?

PBKDF2 is a key derivation function that stretches your passphrase into a cryptographic key through repeated iterations. This Skill uses 600,000 iterations (configurable) to slow down brute-force attacks, making backups resistant to password guessing while maintaining usable performance.

Do I need a specific passphrase strength for secure backups?

While PBKDF2 iterations provide computational protection, a strong passphrase remains critical—weak passphrases are vulnerable to dictionary attacks even with high iteration counts. Use passphrases with adequate entropy; the encryption itself is AES-256-GCM, which is cryptographically secure.