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
- bitcoin
- javascript
- lightning-network
- node.js