Send crypto with phone numbers. No wallet addresses needed.
A modern crypto wallet application built on Arbitrum that simplifies Web3 transactions by mapping phone numbers to wallet addresses. Making crypto payments as intuitive as traditional messaging apps.
Saku eliminates the complexity of cryptocurrency transfers. Instead of copying long wallet addresses, users simply send crypto to phone numbers. Behind the scenes, phone numbers are cryptographically mapped to on-chain wallet addresses through the Saku Registry smart contract.
Phone-Based Transfers - Send cryptocurrency using phone numbers instead of complex wallet addresses
Easy Top-Up - Add funds through deposit or top-up
Split Bills - Divide payments among multiple recipients effortlessly
QR Payments - Generate and scan QR codes for instant transactions
Packet System - Send and receive gift packets with crypto
Transaction History - Track all crypto activities in one place
Smart Contract Integration - Interacts with Saku Registry on Arbitrum Sepolia for phone-to-address mapping
Secure Authentication - JWT-based system with OTP verification via WhatsApp
Real-Time Updates - Supabase-powered database with instant balance and transaction updates
Farcaster Integration - Built as a mini-app for social crypto payments
- Node.js 18+ and pnpm
- A Supabase project
- Arbitrum Sepolia RPC endpoint
# Clone the repository
git clone https://github.com/riyqnn/saku.git
cd saku
# Install dependencies
pnpm install
# Configure environment variables
cp .env.local.example .env
# Edit .env with your configuration
# Run development server
pnpm devOpen http://localhost:3000 to view the application.
# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
# Blockchain Configuration
NEXT_PUBLIC_RPC_URL=https://sepolia-rollup.arbitrum.io/rpc
NEXT_PUBLIC_SAKU_REGISTRY_ADDRESS=0xFf3157D1BE69e88F40eb105d222344b10Caa25A1
NEXT_PUBLIC_IDRX_ADDRESS=your_idrx_token_address
ADMIN_PRIVATE_KEY=your_admin_private_keysaku/
├── app/
│ ├── api/ # API routes (auth, transfers, payments, packets, staking)
│ ├── home/ # Main dashboard
│ ├── deposit/ # Deposit funds
│ ├── withdraw/ # Withdraw funds
│ ├── topup/ # Top-up functionality
│ ├── transfer/ # Send crypto
│ ├── pay/ # Payment interface
│ ├── split-bill/ # Bill splitting
│ ├── packet/ # Packet system (create, claim)
│ ├── staking/ # Staking interface
│ ├── transactions/ # Transaction history
│ ├── profile/ # User settings
│ └── notifications/ # Notifications center
├── components/ # Reusable UI components
├── lib/
│ ├── config.ts # Network & contract config
│ ├── supabase/ # Database client
│ └── utils/ # Helper functions
└── contracts/ # Smart contract artifacts
| Component | Description |
|---|---|
| SakuRegistry | Maps phone numbers to wallet addresses on-chain |
| Packet System | Send and receive gift packets with crypto |
| Wallet SDK | Ethers.js for blockchain interactions |
| Auth System | JWT + OTP verification via WhatsApp |
| Staking System | Earn rewards through staking |
graph LR
A[User] --> B[Phone Number]
B --> C[Hash Function]
C --> D[Saku Registry]
D --> E[Wallet Address]
E --> F[Blockchain Transfer]
| Technology | Purpose |
|---|---|
| Next.js 16 | React framework with App Router |
| TypeScript | Type-safe JavaScript |
| Tailwind CSS | Utility-first styling |
| Radix UI | Accessible component primitives |
| Lucide Icons | Beautiful icon set |
| Technology | Purpose |
|---|---|
| Supabase | PostgreSQL database & auth |
| Next.js API Routes | Serverless endpoints |
| Firebase Admin | Push notifications |
| Technology | Purpose |
|---|---|
| Ethers.js v6 | Web3 interactions |
| Arbitrum Sepolia | Testnet deployment |
| QRCode.react | QR code generation |
- Farcaster Mini-App SDK - Social integration
- Recharts - Data visualization
- AOS - Scroll animations
- Zod - Schema validation
| Route | Description |
|---|---|
/ |
Landing page |
/get-started |
Onboarding flow |
/home |
Main dashboard |
/deposit |
Deposit funds into wallet |
/withdraw |
Withdraw funds from wallet |
/topup |
Top-up functionality |
/transfer |
Send to phone number or address |
/pay |
Payment interface |
/split-bill |
Split payments with others |
/split-bill/details/[id] |
View split bill details |
/split-bill/history |
Split bill history |
/split-bill/edit/[id] |
Edit split bill |
/packet/create |
Create new packets |
/packet/claim/[code] |
Claim packets with code |
/staking |
Staking interface |
/transactions |
Transaction history |
/profile |
User settings |
/notifications |
Notifications center |
Default network is Arbitrum Sepolia (Chain ID: 421614). Configure in lib/config.ts:
export const NETWORK_CONFIG = {
chainId: 421614,
name: "Arbitrum Sepolia",
rpcUrl: "https://sepolia-rollup.arbitrum.io/rpc",
blockExplorer: "https://sepolia.arbiscan.io",
};SakuRegistry deployed at: 0xeB94353ccdD59f491262059039B7Fb7A91CBD3226
// contracts/saku.sol
contract SakuRegistry {
mapping(address => string) public addressToPhone;
mapping(string => address) public phoneToAddress;
}For smart contract source code and deployment details, visit the Smart Contract Repository.
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.