Emergency Password / PIN

BitBanana v0.9.7 or newer is required

An emergency password or PIN is designed for situations where you are being forced to unlock your wallet by someone else. If you enter this emergency password or PIN instead of your regular one, BitBanana will appear to unlock normally while quietly performing additional protective actions. Depending on your chosen emergency mode, it may erase all your connections or show only a wallet with a small amount of funds.

When the app is unlocked with an emergency password or PIN, the Settings → App Lock screen will show as if no emergency unlock is configured. This is intentional to ensure an attacker cannot detect if you have set up an emergency unlock.

It’s a good idea to make a backup and test it once or twice after setup so you’re comfortable using it.

Emergency Modes

Erase all

In this mode, the emergency unlock will delete all connections and contacts, making the app look like a fresh install. Keep in mind that if the person forcing you to unlock the app knows you have funds, they may become upset or suspicious when they see everything wiped. If you use this method, it's a good idea to create backups regularly so you can easily restore them later if needed.

Show selected wallet only

This mode is designed for users who have multiple node or wallet connections in BitBanana. When using the emergency unlock, BitBanana will show only the specific connection you’ve selected in the settings while hiding all other connections and all your contacts. A good practice is to have a connection to a hosted wallet with just a small amount of sats. This way, you can provide the attacker with a minimal balance while keeping your other connections/wallets hidden.

If you change or remove your password, PIN, emergency password or emergency PIN while the app is unlocked using this emergency method, all contacts and all connections except the one used for display will be deleted. This ensures that an attacker cannot simply remove the PIN and gain access to all your connections.