Step by step,
for everyone.

1. Create your wallet

1. Open the wallet

   On a computer, install BitLooper Desktop. On a phone, open the web wallet and choose "Add to Home Screen".

2. Tap Create wallet

   Choose a password of at least 10 characters. It unlocks the wallet on this device only. It's not sent anywhere, and nobody can reset it for you.

3. That's it

   You now have an address starting with 01. It's like your account number: share it to receive BitLooper.

2. Back it up (do this first)

1. Tap Backup → Download key file

   This file is your money. Anyone who has it can spend your coins.

2. Store it safely, offline

   Copy it to a USB stick kept somewhere safe, or print it. Don't email it or post it anywhere.

3. To use the same account on another device

   On the new device, tap Import a key file, choose the file, and set a password. The same address and balance appear.

3. Send and receive

1. To receive

   Tap Receive and share your address.

2. To send

   Tap Send, paste the address, enter the amount, then tap Review payment. Check the address and fee, then tap Confirm and send. It's final in about 2 seconds.

Amounts are in BLPR. 1 BLPR = 100,000,000 loops, so you can send tiny amounts too.

4. Protect it: vault, cancel key, guardians

1. Tap Protect

   Everything here is enforced by the whole network, not by an app or a company.

2. Tap Create a cancel key

   This downloads a second key file, your emergency brake. Keep it away from your phone: on paper or a USB stick in a drawer. Its address is filled in for you.

3. Set a daily limit

   For example 100 BLPR. Payments up to the limit go through instantly. Anything bigger waits 24 hours, so you can stop it.

4. Add guardians (optional but wise)

   Ask 3 people you trust (family, a friend, a lawyer) for their BitLooper addresses. Choose "2 needed". If you ever lose your wallet, any 2 of them can restore it.

5. Tap Save protection

   Done. From now on, changing these settings also waits for the delay, so a thief can't switch them off.

5. Stop a theft

1. Look at Delayed payments and changes

   Anything above your daily limit is listed there, with the time it will go through.

2. Tap Cancel

   If you still have your wallet, cancel it right there. The coins come back.

3. If the thief has your phone or password

   On any other device, open the wallet and tap Emergency: use my cancel key. Load your cancel key file, enter your account address, and cancel the payment. Then ask your guardians to move your account to a new key (guide 6).

A thief can take at most your daily limit. Keep the limit small and your cancel key offline.

6. You lost your phone (and have no backup)

1. On a new device, tap Recover my account

   Enter your old address (your guardians or your records have it) and choose a new password. The wallet makes a new key and a recovery request file.

2. Send the recovery request to your guardians

   Send it however is easiest: message, email or in person. It contains only your new public key, nothing secret.

3. Your guardians approve

   Each guardian follows guide 7. When enough of them approve, a waiting period starts (for example 48 hours). That's your protection against false recoveries.

4. Wait, then use your account

   After the waiting period your new key controls your original address and balance. Any delayed payments the old key started are cancelled automatically.

7. Help someone recover (you're a guardian)

1. Make sure it's really them

   Call them or meet them. Recovery requests can be faked by scammers; your check is what stops that.

2. Tap Help someone recover and load their recovery request file

   The wallet shows their account and whether a recovery is already in progress.

3. Tap Approve recovery

   The first guardian starts the recovery, and the others approve the same request. The wallet chooses the right action automatically.

8. Name your heirs

1. In Protect, add heirs

   Enter each heir's address and their percentage (the total must be 100). Choose how long the account must be silent first, for example 365 days.

2. Stay active

   Any payment you send resets the timer. If you don't send anything for a long time, tap I'm still here once in a while; it's free apart from a tiny fee.

3. Tell your heirs

   Give them your BitLooper address and a link to guide 9. They don't need your password or key.

9. Claim an inheritance

1. Tap Claim an inheritance

   Enter the address of the person who named you as an heir. The wallet shows the date after which the claim is possible.

2. Tap Claim

   The balance is split between all named heirs according to their percentages, automatically, in one step. Any heir can start it.

10. Earn by validating

1. Install BitLooper Desktop and open Earn

   Tap Become a testnet validator. The app creates your validator key, gets test coins, bonds them and starts voting on blocks.

2. Keep the computer on

   Every block your node signs is recorded publicly and earns rewards. On the testnet that record counts toward the mainnet airdrop, which is shared once at launch and capped at 100,000 BLPR per address.

Only validators earn rewards. A computer that only follows the chain helps keep it honest, but no network can prove its uptime, so it isn't paid. Delegating coins to a validator (coming soon) lets you earn without running anything.

11. Swap with Ethereum or Bitcoin

An atomic swap trades BitLooper for ETH or BTC directly with a market maker. Either both payments happen or neither does, and no one holds your coins in between. The Ethereum or Bitcoin side is protected by that chain's own signatures, not by BitLooper's post-quantum ones.

1. Tap Swap, then New swap

   Paste a market maker's offer. The wallet checks the maker's post-quantum signature and its timing rules before showing the price.

2. Buying BitLooper: Lock ETH and start

   Your Ethereum wallet asks you to lock the ETH. Only the maker can take it, and only by revealing a secret that this page keeps until the maker has locked your BitLooper. Send the ticket to the maker. The wallet claims your BitLooper automatically. If the maker never delivers, press Refund my ETH after the timeout.

3. Selling BitLooper: Create my request

   Send the request file to the maker. Load the ticket it sends back. The wallet checks the maker's ETH lock and only then locks your BitLooper. When the maker claims it, press Claim my ETH. Do it promptly: the ETH can only be claimed before its timeout.

4. Keep the page open until it says Done

   Or come back before the times shown. Download swap backup saves your swaps, including their secrets. Bitcoin swaps use the bitlooper-swap app. The rules and the risks are explained in docs/SWAPS.md in the source code.