Inspiration

Across Africa, Bitcoin is already how people save and get paid. But the wallets most people meet are custodial, confusing, or built for traders — not for a market seller who just wants to be paid for 2 kilos of rice. KudiWallet is a wallet you can explain in one minute: it works on a cheap phone, shows prices in naira, and treats a Lightning invoice like a paper receipt.

What it does

KudiWallet is a Bitcoin and Lightning testnet wallet for everyday Africans. It runs entirely in the browser, with no account and no custody — your keys never leave the browser.

  • Create a wallet: click “Create new wallet” and a 12-word recovery phrase appears. The phrase is stored in a vault encrypted with a passphrase you choose.
  • Receive: the wallet shows a real testnet address (tb1q…) and a QR code to share to get paid. Balance and history come live from the testnet network, and the price is shown in naira and dollars.
  • Demo mode: switch it on (top right) and you get a simulated 50,000 sats, so every flow works with no faucet coins.
  • Send: paste an address, enter an amount (for example 10,000 sats), pick a fee speed, and click Send. The app builds a real P2WPKH transaction, signs it in your browser, and broadcasts it — an explorer link appears when it lands.
  • Lightning: create an invoice — for example 1,000 sats for “2 kg of rice” — and the invoice and QR code appear. You can also inspect (decode and verify) any testnet BOLT11 invoice.

How we built it

Pure, browser-safe JavaScript: BIP39 mnemonics, BIP32/BIP84 derivation, bech32 addresses, bitcoinjs-lib and the bolt11 package. A small Node server only proxies public blockchain data (mempool.space testnet and CoinGecko) — it never sees a recovery phrase. The cryptography is cross-validated against bitcoinjs-lib: npm test runs 5 checks, all passing.

What is real, and what is simulated — honestly

  • Real: the cryptography (BIP39, BIP84, P2WPKH signing, BOLT11) and on-chain sends.
  • Simulated: Lightning settlement. This MVP has no live Lightning node, so paying an invoice is simulated and labelled “DEMO” in the UI. Invoice encoding is real — a signed BOLT11 invoice that any Lightning wallet can decode — but settlement needs a node. Demo-mode balances are simulated too.

What's next

Connect a real Lightning node so invoices actually settle, add change-address rotation, and keep the bundle small enough for a cheap phone on a slow connection.

Try it yourself

Live demo: https://dakar-bitcoin-hack.vercel.app — switch on Demo mode to try every flow with no setup. To try it on real testnet, import the public demo wallet (testnet only, no real funds — the phrase is published in the repo on purpose): either immune work wonder grace pilot front staff goat market turtle rice, address tb1qnu5satta8cgpyv4wsftfmvgp7vs32hdwc6gvzj, funded free at https://mempool.space/testnet/faucet.

Built by Joshua Owoade (jozzy001mail), Nigeria. Built with Muse.

Built With

Share this project:

Updates

Submission history