Skip to content

Repository files navigation

Paper Wallet

Bitcoin · Gifts — turn your Passport Prime into a printing press for bitcoin gifts.

Paper Wallet generates engraved bearer-note gift wallets entirely offline. Each bill carries a brand-new private key born in the device's hardware random-number generator — never derived from your wallet seed, so a gifted bill can never endanger your own funds. The app renders the key onto print-ready artwork with two QR codes, and exports a PNG plus a backup file to wherever you want to print from.

Bills are fully compatible with the bitcoin-gift-paper-wallet web app: recipients sweep with the same guided flow, and givers recover unswept gifts with the same recovery page.

Home — gift style picker   Preview — deposit and sweep QRs   Backup key reveal for gift recovery

The bill

A print-ready 1843×784 PNG. The left QR is the deposit address — load and verify the gift. The right QR is a sweep link that opens the web app's guided sweep flow with everything pre-filled. The private key is printed on the top strip, the address on the bottom band, and the generation timestamp runs up the right edge.

Taproot + backup bill
Bill artwork drawn for this app — guilloche engraving generated from hypotrochoid curves. Two more designs ship alongside it.

This sample bill is rendered from publicly known test keys — do not send funds to it. The app-screen captures likewise show throwaway simulator keys that never held funds.

Features

  • Three gift stylesSegWit (bc1q…, sweeps in any wallet), Taproot (bc1p…, modern and wallet-importable), and the flagship Taproot + backup: the recipient sweeps with the key on the bill, while you keep a separate backup spend path to recover an unswept gift.
  • Backup keys that survive anything — the giver's backup keys are derived from the device master seed. A factory reset plus seed-phrase restore re-derives every backup key; the gift keys themselves stay pure hardware randomness, invisible to anyone restoring the phrase.
  • Design your own bill — the engraved note is just the default; two more designs ship with it, and the whole thing is a template format. Export the built-in design kit, restyle it in any image editor, and the app validates and renders your design through the same engine as the original.
  • Save it your way — a full save-as browser across Internal, Airlock, and USB with folder creation, custom filenames, and overwrite protection (a bill names a unique key — the app won't let two collide).
  • A gift ledger without secrets — the saved-gifts list keeps each gift's address, type, and creation date with no private keys stored; the backup key is re-derived and shown only on demand, exactly when recovery needs it.
  • Offline by design — Prime has no network stack. Sweeping, balance checks, and broadcast intentionally stay in the companion web app.

Install on your Passport Prime

Grab prime-paper-wallet.app from the latest release, copy it to a USB drive or the Airlock, and install it from Settings > Apps > Install App (KeyOS 1.4 or later).

The first ByteApps app you install also needs our publisher certificate trusted once: download byteapps.crt (also attached to every release), copy it over the same way, and add it under Settings > Apps > Allowed Publishers. Before trusting it, check that its fingerprint matches the one published at byteapps.com:

1bca27c8e765a77fd44922bc058b815b46e627d68f2996e8c38ca6997b6be6f9

Get it running

With the Foundation SDK installed, build and launch in the simulator with:

foundation sim

Learn more

  • THIRD-PARTY.md — libraries, fonts, and artwork this app is built on

Support

If this app is useful to you, a small bitcoin donation is always appreciated — entirely optional.

Donate bitcoin

bc1qkmg7qek6vuuw6hqp9sm06krzcr7pwd5jhcr43f

Donations help cover development costs and keep more open-source bitcoin tools coming. No VC funding, no ads, no tracking.

License & disclaimer

Licensed under the GNU General Public License v3.0 or later — see COPYING. Sections 15–17 of that license disclaim all warranty and limit liability; the notes below restate that in plain language.

The wallet-core/ library inside this repository carries its own, more permissive terms: MIT OR Apache-2.0, see wallet-core/LICENSE-MIT and wallet-core/LICENSE-APACHE. It holds key generation, address/WIF encoding, and bill composition, and the split is deliberate — other projects, including non-GPL peers of this app, are meant to build on that crate. The GPL above covers the application around it.

This is experimental software and it has not been independently audited. It is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.

Use it at your own risk. To the maximum extent permitted by law, in no event shall the authors, copyright holders, or contributors be liable for any claim, damages, or other liability — including, without limitation, loss of bitcoin or other funds, loss of keys or seeds, or loss of data — whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with this software or its use.

Nothing in this project is financial, investment, legal, or tax advice. You are solely responsible for verifying addresses, amounts, fees, and backups before moving funds, and for complying with the laws of your jurisdiction. Test on test networks, or with amounts you can afford to lose, first.

A paper wallet is a bearer instrument: anyone who holds the bill — or a photo, scan, or copy of it — can take the funds. A lost or destroyed bill with no backup key is unrecoverable. Nobody can reverse a bitcoin transaction or restore keys for you.

About

Paper Wallet for Passport Prime — offline bitcoin gift bills with hardware-random keys, printable PNGs, and seed-recoverable backup keys

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages