🌐 Fedimint Web Wallet

Are you a privacy-conscious person who wants to custody Bitcoin in a decentralized way?
Fedimint Web Wallet is a browser-based Bitcoin wallet built on the Fedimint Web SDK.
It enables you to custody and transact Bitcoin using Chaumian Ecash in a *federated, *privacy-preserving way — all without installing extra software.

🔐 Custody Bitcoin with ease and privacy — you control your funds, your community, your future.

🏛 About Fedimint

Fedimint is a modular system for building federated applications, designed to be:

🛡 Trust-minimized – You control your funds with federation consensus.
🚫 Censorship-resistant – No single point of control.
👤 Private – Transactions can’t be linked back to you.

✨ Features

🔍 Discover & Join Federations
Join a federation using an invite code/QR or discover available federations instantly.
👁 Preview Before Joining
View full federation details, guardian info, and federation health.
💸 Multiple Payment Methods
- Lightning Network
- On-chain Bitcoin transactions
- Ecash transactions
📊 Comprehensive Federation Insights
See guardian availability, federation health, and service status.
🌐 Multi-Federation Support
Join and manage multiple federations at once.
📜 Transaction Management
View full transaction history, manage invoices (paid & pending), and export transactions.
♻ Backup & Recovery
Securely backup and restore your wallet.
🔗 NIP-47 Integration (Nostr Wallet Connect)
Connect your client to the wallet via NWC URI to send and receive payments.
⚙ Other useful features:
- Auto nostr payments, auto withdrawal to an external address
- Enabling GeoLocation, themes, developer mode according to preferences
- Change the display currency, export transactions, setting a invoice desription

🛠 Technical Stack

⚡ The project uses Vite + React + Typescript.
🏦 Fedimint-web-sdk is used for interacting with the fedimint.
🔌 NDK for NWC integeration
📦 Redux is used as the primary state management library and Context API is mainly used for Fedimint sdk and NDK management.

Structure

fedimint-web-wallet/
├── src
│   ├── assets/
│   ├── Components/
│   ├── context/
│   ├── hooks/
│   ├── pages/
│   ├── redux/
│   ├── services/
│   ├── style/
│   ├── utils/
│   ├── App.tsx
│   ├── Wallet.tsx

App.tsx: Root application component
Wallet.tsx: Core wallet UI logic
Components: The component folder contains all of the UI components(Activities,AddFederation,Header...)
Pages: The Pages folder contains all the of the pages and tabs of the main wallet(JoinFederation,Ecash,Settings...)
Redux: Redux files manages the fedimint web sdk and NDK initialization and thier working
- WalletManger manages the switching of the federations, loading wallet data, initializing of the wallet and giving wallet instance to their childrens and with some other functionalities
- Nostr context runs in the background without blocking the wallet functionalities or UI renderings like intializing NDK, connecting to relays, setting up subscriptions for the following nostr events(get_info, pay_invoice, make_invoice, get_balance, list_transactions, lookup_invoice, notifications, payment_sent, payment_received)
Services: The services folder contains the helper functions and the main fedimint web sdk rpc methods.

🚀 Running the application

Clone the repository

git clone https://github.com/Harshdev098/fedimint-web-wallet.git
Install the dependencies
```
  npm install
```
Start the app in development mode
```
  npm run dev
```

🤝 Contributions

Before contributing to the project please go through our contribution guidelines Contribution.md