---

Vipr-Wallet

Vipr-Wallet is a modern Progressive Web App (PWA) that serves as an ecash wallet for Fedimint. It runs seamlessly on both mobile and desktop devices, enabling private and instant lightning transactions wherever you are.

⚠️ Disclaimer

This software is experimental and comes with risks:

• Current version is in beta stage with incomplete features and potential bugs
• NO BACKUP FUNCTIONALITY implemented yet - funds could be lost permanently
• DO NOT USE with significant amounts of ecash or in production environments

By using this wallet, you acknowledge and accept these risks.

A demo version of the wallet is available at beta.vipr.cash

📱 App Screenshots

✨ Features

General

• lightning send
• receive tokens by paying a lightning invoice
• pay lightning invoice using nostr wallet connect
• lnurl-p support
• lightning address support
• pay to Nostr contacts
• export ecash
• import ecash
• backup wallet
• restore wallet

Federations

• join multiple federations
• Discover federations using nostr
• show guardian health
• show nostr votes for federation

🐳 Deployment

Docker Image

If you want to host the wallet yourself, you can use the Docker image on Docker Hub.

docker pull ngutech21/vipr-wallet:latest

Quick Start

Run the latest container from dockerhub locally:

docker run -d \
  -p 8080:80 \
  --name vipr-wallet \
  ngutech21/vipr-wallet:latest

Run the container locally using docker-compose:

docker compose up -d

The wallet will be available at http://localhost:8080

🚀 Getting Started

Development Environment

• This project uses Vue 3 with TypeScript
• Quasar Framework provides the UI components
• Pinia is used for state management
• Fedimint-Web-SDK is used for interacting with the fedimint

Prerequisites

Make sure you have the following installed:

• Node.js 20+
• pnpm 10+

Installation

1. Clone the repository

git clone https://github.com/ngutech21/vipr-wallet.git
cd vipr-wallet

2. Install pnpm

npm install -g pnpm@latest-10

3. Install the dependencies

pnpm install

4. Start the app in development mode (hot-code reloading, error reporting, etc.)

pnpm dev

🛠️ Development

Command	Description
pnpm dev	Start development server with hot reload
pnpm build	Build for production
pnpm lint	Run ESLint on source files
pnpm format	Format code with Prettier
pnpm test	Run unit tests