https://github.com/adityatote/bonk-bot
https://github.com/adityatote/bonk-bot
cloudflare-workers drizzle hono solana sqlite tanstack-start turso
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/adityatote/bonk-bot
- Owner: AdityaTote
- Created: 2025-08-24T18:53:11.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-08-28T22:58:24.000Z (9 months ago)
- Last Synced: 2025-08-29T03:54:44.845Z (9 months ago)
- Topics: cloudflare-workers, drizzle, hono, solana, sqlite, tanstack-start, turso
- Language: TypeScript
- Homepage:
- Size: 172 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🤖 Bonk Bot
🚀 A Powerful Solana Wallet Management & Transaction Bot
Seamlessly manage crypto wallets with automated features and secure blockchain integration
---
## ✨ Features
### 🔐 **Automatic Wallet Creation**
On signup, a secure Solana wallet (public/private key pair) is generated and stored safely with enterprise-grade encryption.
### ⛓️ **Blockchain Integration**
Powered by Solana Web3.js for fast and reliable on-chain transactions with minimal fees and lightning-fast confirmations.
### 🚀 **Backend APIs**
Built with Hono and deployed on Cloudflare Workers for unmatched scalability, performance, and global edge distribution.
### 🗄️ **Database Layer**
Uses Turso + SQLite + Drizzle ORM for secure key management, transaction tracking, and data persistence.
### 🎨 **Modern Frontend**
Developed with TanStack Start for a responsive, smooth, and delightful user experience.
---
## 🛠️ Tech Stack
Frontend
🔥 TanStack Start + React + TypeScript
Backend
⚡ Hono (Cloudflare Workers)
Database
🗃️ Turso (SQLite + Drizzle ORM)
Blockchain
🌐 Solana Web3.js
Styling
🎨 TailwindCSS + Radix UI
State Management
🐻 Zustand + TanStack Query
Authentication
🔒 JWT + bcryptjs
Validation
✅ Zod
---
## 📁 Project Structure
```
bonk-bot/
├── 📱 apps/
│ ├── 🖥️ web/ # Frontend application
│ │ ├── src/
│ │ │ ├── components/ # UI components
│ │ │ ├── routes/ # Page routes
│ │ │ ├── hooks/ # Custom hooks
│ │ │ ├── store/ # State management
│ │ │ └── lib/ # Utilities & API
│ │ └── package.json
│ └── 🔧 server/ # Backend API
│ ├── src/
│ │ ├── routes/ # API endpoints
│ │ ├── services/ # Business logic
│ │ ├── middlewares/ # Custom middleware
│ │ ├── lib/ # Database & utilities
│ │ └── types/ # Type definitions
│ └── package.json
├── 📦 package.json # Root configuration
└── 🔧 turbo.json # Turborepo config
```
---
## 🚀 Quick Start
### Prerequisites
- 📋 **Node.js** >= 18
- 🧊 **Bun** >= 1.2.18
- 🔑 **Cloudflare Account** (for deployment)
- 🗄️ **Turso Database** (for production)
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/AdityaTote/bonk-bot.git
cd bonk-bot
```
2. **Install dependencies**
```bash
bun install
```
3. **Set up environment variables**
```bash
# Copy environment files
cp apps/server/.env.example apps/server/.env
cp apps/web/.env.example apps/web/.env
```
4. **Configure your environment**
- Add your database connection string
- Set up Solana RPC endpoints
- Configure JWT secrets
### Development
```bash
# 🔥 Start all applications in development mode
bun run dev
# 🎯 Start specific application
bun run dev --filter=web # Frontend only
bun run dev --filter=server # Backend only
```
### Building
```bash
# 🏗️ Build all applications
bun run build
# 🎯 Build specific application
bun run build --filter=web
bun run build --filter=server
```
---
## 🔧 Configuration
### Database Setup
1. **Generate database migrations**
```bash
cd apps/server
bun run drizzle:generate
```
2. **Apply migrations**
```bash
bun run drizzle:migrate
```
### Deployment
#### Backend (Cloudflare Workers)
```bash
cd apps/server
bun run deploy
```
#### Frontend (Cloudflare Pages)
```bash
cd apps/web
bun run build
bun run deploy
```
---
## 🎯 API Endpoints
### Authentication
- `POST /api/v1/auth/signup` - Create new account with wallet
- `POST /api/v1/auth/signin` - User authentication
- `GET /api/v1/auth/me` - Get user profile
### Transactions
- `POST /api/v1/transactions/send` - Send SOL tokens
- `GET /api/v1/transactions/history` - Transaction history
---
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
---
## 🙏 Acknowledgments
- 🌐 [Solana](https://solana.com/) for the blazing-fast blockchain
- ⚡ [Hono](https://hono.dev/) for the lightweight web framework
- 🔥 [TanStack](https://tanstack.com/) for amazing React tools
- ☁️ [Cloudflare](https://cloudflare.com/) for edge computing
- 🗄️ [Turso](https://turso.tech/) for the distributed SQLite
---