https://github.com/alicization-hub/space-wallet
This is a private, web-based Bitcoin wallet application built primarily with Next.js 15. It prioritizes user control and privacy, designed to run with own Bitcoin Core full node.
https://github.com/alicization-hub/space-wallet
bitcoin-wallet cryptographic docker drizzle-orm encryption nextjs15 postgresql rpc tor-network wsl2
Last synced: about 2 months ago
JSON representation
This is a private, web-based Bitcoin wallet application built primarily with Next.js 15. It prioritizes user control and privacy, designed to run with own Bitcoin Core full node.
- Host: GitHub
- URL: https://github.com/alicization-hub/space-wallet
- Owner: alicization-hub
- License: mit
- Created: 2025-07-12T08:50:43.000Z (11 months ago)
- Default Branch: canary
- Last Pushed: 2026-02-18T01:46:02.000Z (4 months ago)
- Last Synced: 2026-05-03T01:38:54.840Z (about 2 months ago)
- Topics: bitcoin-wallet, cryptographic, docker, drizzle-orm, encryption, nextjs15, postgresql, rpc, tor-network, wsl2
- Language: TypeScript
- Homepage:
- Size: 1.42 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Project Space - Bitcoin Wallet.
#### This is a private, web-based Bitcoin wallet application built primarily with Next.js 15. It prioritizes user control and privacy, designed to run with own **Bitcoin Core full node**.
_This project was developed through collaboration between developers and generative AI tools, including
`Grok AI`, `Gemini Pro`, `GitHub Copilot`, `ChatGPT`, `Claude AI`, `DeepSeek AI`, and `Windsurf`. I then
refined and optimized the code for enhanced performance._
### ✨ Features
Here are the initial features implemented, with more planned for future updates:
- **Secure Key Management**: Generate mnemonics, build custom derivation paths, and create `xpub` descriptors
only for wallet accounts.
- **Transaction History**: View a clear and concise history of your Bitcoin transactions.
- **Send/Receive Functionality**: Easily send and receive Bitcoin directly from wallet.
---
### ⚙️ Tech Stack
- **Framework:**
- [Next.js 16](https://nextjs.org/docs)
- Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
- **User Interface:**
- [HeroUI](https://www.heroui.com)
- [Tailwind CSS](https://tailwindcss.com)
- [Framer Motion](https://www.framer.com/motion)
- **Cryptographic Libraries:**
- `@noble/*` (e.g., `@noble/secp256k1`, `@noble/hashes`) for cryptographic operations.
- `@scure/*` (e.g., `@scure/bip39`) for BIP-39 mnemonic generation.
- `Argon2` for secure keys.
- **Database:**
- [DrizzleORM](https://orm.drizzle.team)
- `pg` (PostgreSQL) - running on WSL2 Ubuntu for locally.
- **Bitcoin Core Integration**: Connects to **Bitcoin Core Full Node** for direct interaction with the Bitcoin
network.
- **Privacy**: Integrated with **Tor** for enhanced privacy when communicating with **Bitcoin Core Full
Node**.
## 🧩 VS Code Extensions
- [React](https://marketplace.visualstudio.com/items?itemName=dsznajder.es7-react-js-snippets)
- [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
- [Tailwind CSS](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)
## 📋 Directory Structure
```
src # App entry point.
└─ app # App Router.
└─ components # Shared components.
└─ constants # Constant variable.
└─ hooks # Customs hooks.
└─ libs # Libraries, utilities.
└─ styles # Stylesheet.
└─ tasks # Tasks scheduler.
└─ types # TypeScript decorators.
```
## 🚀 Getting Started
More detailed setup instructions will be provided soon. In the meantime, here's a brief overview of what
you'll need:
1. **Bitcoin Core Full Node**: Ensure you have a synced _Bitcoin Core full node_ running, preferably
configured to accept connections over _Tor_.
2. **PostgreSQL Database**: Set up a PostgreSQL database instance. For locally use _WSL2 Ubuntu_.
3. **Dependencies**: Install project dependencies using your preferred package manager, use one of them
`yarn`, `pnpm`, `bun`, Example using `bun`:
```bash
bun install
```
4. **Environment Variables**: Configure your environment variables for database connection, Bitcoin Core RPC,
and Tor.
## 🚀 Compiles and hot-reloads for development
```bash
bun run start:dev --port 8338
```
Open [http://localhost:8338](http://localhost:8338) with your browser to see the result.
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically
optimize and load Inter, a custom Google Font.
### Setup pnpm (optional)
If you are using `pnpm`, you need to add the following code to your `.npmrc` file:
```bash
public-hoist-pattern[]=*@heroui/*
```
After modifying the `.npmrc` file, you need to run `pnpm install` again to ensure that the dependencies are
installed correctly.
## 📦 Compiles and minifies for production
```bash
bun run build
```
## 🛑 Disclaimer
This is a private project. If you encounter any issues, please fix them yourself. Once you've successfully
resolved something, do let me know!