Overview
Medusa Wallet allows you to create and manage multiple Lightning Network wallets within a single app. Each wallet operates independently with its own balance, transaction history, and credentials, giving you complete control over your Bitcoin funds.All wallets are custodial Lightning wallets powered by LNbits, providing instant payments and low fees.
Key Features
Multiple Wallets
Create unlimited wallets to organize your funds by purpose, project, or spending category
Custom Names & Colors
Personalize each wallet with custom names and gradient color themes for easy identification
Real-time Balances
View individual wallet balances and total portfolio value in both satoshis and your preferred fiat currency
Transaction History
Access complete transaction history for each wallet with timestamps and descriptions
Creating a New Wallet
Adding a new wallet to your Medusa account is straightforward:- From the main screen, tap the “New Wallet” button
- Enter a descriptive name for your wallet (e.g., “Savings”, “Daily Spending”, “Project Funds”)
- Choose a color gradient to visually distinguish this wallet
- Tap “Create” to complete the process
Each wallet has unique credentials (admin key and invoice key) that are securely stored on your device.
Wallet Card Display
Each wallet is represented by a colorful card showing:- Wallet Name: Your custom wallet name
- Balance: Current balance in your preferred Bitcoin unit (BTC, sats, or mBTC)
- Fiat Value: Equivalent value in your selected fiat currency (USD, EUR, etc.)
- Latest Transaction: Time since the most recent transaction
- Visual Theme: Your chosen gradient color scheme
Managing Wallets
Selecting a Wallet
Tap any wallet card to view its details, transaction history, and perform actions like sending or receiving payments.Renaming a Wallet
- Select the wallet you want to rename
- Tap the settings or edit icon
- Enter the new name
- Confirm the change
Changing Wallet Color
Customize your wallet’s appearance:- Open the wallet settings
- Select “Change Color”
- Choose from the available gradient color options
- The new color is applied instantly
Deleting a Wallet
To delete a wallet:- Navigate to the wallet’s settings
- Scroll to find the “Delete Wallet” option
- Confirm the deletion
- The wallet and its transaction history are removed
Total Balance View
Medusa automatically calculates and displays your total balance across all wallets:- Aggregate Balance: Sum of all wallet balances in satoshis
- Total Fiat Value: Combined value in your selected fiat currency
- Real-time Updates: Balance updates automatically when transactions are confirmed
Wallet Credentials
Each wallet has two types of keys:- Admin Key: Full control over the wallet, including sending payments and wallet management
- Invoice Key (Inkey): Read-only access for creating invoices and viewing transactions
Keys are stored securely in encrypted device storage and never transmitted without user action.
Best Practices
Organize by Purpose
Create separate wallets for different use cases:- A “Daily Spending” wallet for regular transactions
- A “Savings” wallet for long-term holdings
- Project-specific wallets for business or collaborative purposes
Use Descriptive Names
Choose clear, meaningful names that help you quickly identify each wallet’s purpose.Regular Backups
While Medusa securely stores your wallet credentials, consider:- Keeping records of important transaction details
- Noting down wallet admin keys in a secure location for recovery
- Regularly reviewing your wallet list and removing unused wallets
Technical Details
Wallets in Medusa are implemented using:- LNbits Backend: Industry-standard Lightning wallet infrastructure
- Zustand State Management: Efficient local state handling with persistence
- MMKV Storage: High-performance encrypted key-value storage for wallet data
- Real-time Synchronization: WebSocket connections for instant balance and payment updates
Next Steps
Make Payments
Learn how to send and receive Lightning payments
Swap to Bitcoin
Convert Lightning funds to on-chain Bitcoin