https://github.com/nummusbtc/nummus-wallet
A Simple Bitcoin wallet for everyday transactions and secure self-custody
https://github.com/nummusbtc/nummus-wallet
bitcoin btc crypto crypto-wallet expo lightning-network mobile-app mobile-wallet react-native typescript wallet
Last synced: about 1 year ago
JSON representation
A Simple Bitcoin wallet for everyday transactions and secure self-custody
- Host: GitHub
- URL: https://github.com/nummusbtc/nummus-wallet
- Owner: NummusBTC
- License: apache-2.0
- Created: 2025-02-25T20:29:16.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-23T20:44:25.000Z (about 1 year ago)
- Last Synced: 2025-04-24T03:11:57.569Z (about 1 year ago)
- Topics: bitcoin, btc, crypto, crypto-wallet, expo, lightning-network, mobile-app, mobile-wallet, react-native, typescript, wallet
- Language: TypeScript
- Homepage: https://numm.us
- Size: 1.73 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 60
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nummus Wallet
[](https://discord.gg/ESu8yjhuGn)
[](https://www.twitch.tv/tristanBietsch)
[](https://www.youtube.com/@TristanBietsch)
[](https://twitter.com/NummusBTC)
[](LICENSE)
[](https://github.com/NummusBTC/nummus-wallet)
[](https://github.com/NummusBTC/nummus-wallet/issues)
[](https://github.com/NummusBTC/nummus-wallet/stargazers)
Nummus is a non-custodial Bitcoin wallet focused on providing users with full control over their Bitcoin transactions on the base layer. Our primary goal is to create a secure, user-friendly, and fully non-custodial wallet for managing Bitcoin.
## Features
- Bitcoin transaction management
- Secure non-custodial architecture
- Real-time price tracking
- Secure wallet creation and backup
- Transaction history
- QR code sending and receiving
- Fee estimation
- Biometric authentication
## Tech Stack
Nummus is built using the following technologies:
- **React Native** - Cross-platform mobile app framework
- **Expo** - React Native development platform
- **TypeScript** - Statically typed JavaScript
- **NativeWind/Tailwind CSS** - Utility-first CSS framework
- **Gluestack UI** - UI component library
- **Supabase** - Backend as a service platform
- **Mempool.space API** - Bitcoin mempool data and fee estimation
- **Bitcoin Development Kit (BDK)** - For Bitcoin wallet functionality
- **Secure storage** - For sensitive wallet data
- **Jest** - Testing framework
## Getting Started
### Prerequisites
- Node.js (v16 or later)
- npm or yarn
- Expo CLI
### Installation
1. Clone the repository:
```
git clone https://github.com/nummusBtc/nummus-wallet.git
cd nummus-wallet
```
2. Install dependencies:
```
npm install
```
3. Start the development server:
```
npm start
```
## Usage
[Include basic usage instructions here]
## Testing
Our project uses Jest as the testing framework. You can run tests using the following commands:
```bash
# Run tests in watch mode (default)
npm test
# or with yarn
yarn test
```
The test files are located in the `/tests` directory and use the `.test.tsx` extension. We utilize the following testing tools:
- Jest with jest-expo preset
- @testing-library/react-native for component testing
- @testing-library/react-hooks for testing hooks
When adding new features, please ensure you include appropriate tests to maintain code quality.
## Contributing
We welcome contributions to Nummus Wallet! Please read our contribution guidelines before submitting a pull request.
## Contact
- Twitter: [@NummusBTC](https://twitter.com/NummusBTC)
- Twitch: [tristanBietsch](https://www.twitch.tv/tristanBietsch)
- YouTube: [Tristan Bietsch](https://www.youtube.com/@TristanBietsch)