Hedwig is a secure, multi-chain freelance payment platform that revolutionizes how freelancers and clients handle project payments through smart contracts and escrow services.
Hedwig is an AI-powered Telegram bot and web platform that simplifies freelance payments by:
- Smart Contract Escrow: Automatically securing payments in blockchain escrow until milestones are completed
- Multi-Chain Support: Supporting payments on Base (USDC) and Celo (cUSD) networks
- Milestone Management: Breaking projects into trackable milestones with automatic payment releases
- Legal Contract Generation: Creating comprehensive legal agreements for all projects
- Invoice & Payment Links: Generate professional invoices and shareable payment links for instant payments
- Proposal Creation: AI-powered proposal generation for winning more clients
- Token Offramping: Convert crypto earnings to local currency with integrated offramp solutions
- Telegram Integration: Managing everything through an intuitive Telegram bot interface
- Natural language contract creation
- Automated milestone tracking
- Real-time payment notifications
- Invoice and proposal generation
- Smart payment link creation
- Instant crypto-to-fiat conversion
- Smart contract escrow protection
- Stablecoin support (Base USDC, Celo cUSD)
- Automatic milestone-based releases
- Cross-chain compatibility between Base and Celo
- Instant payment links for quick settlements
- Integrated offramp to local currencies
- Milestone-based project structure
- Progress tracking and notifications
- Client approval workflows
- Freelancer work submission system
- Professional invoice generation
- AI-powered proposal creation
- Invoice Generation: Create professional, branded invoices with crypto payment options
- Payment Links: Generate shareable links for instant crypto payments
- Proposal Builder: AI-assisted proposal creation to win more clients
- Offramp Solutions: Convert earned tokens to local currency through integrated partners
- Reown AppKit (WalletConnect) integration
- Support for 300+ wallets
- MetaMask, Coinbase Wallet, and more
- Seamless multi-chain switching
- Start a chat with @HedwigBot on Telegram
- Create professional proposals with
/proposalto win new clients - Generate invoices with
/invoicefor one-time payments - Create payment links with
/paymentfor instant crypto settlements - Set up milestone contracts with
/contractfor larger projects - Get paid automatically as you complete work
- Convert earnings to local currency using integrated offramp solutions
- Receive contract approval link via email
- Review project details and milestones
- Approve the contract to fund the escrow
- Track progress and approve completed milestones
- Payments are automatically released to the freelancer
| Network | Chain ID | Supported Token | Status |
|---|---|---|---|
| Base | 8453 | USDC | ✅ Primary |
| Celo | 42220 | cUSD | ✅ Supported |
- Node.js 18+ and npm
- Supabase account and database
- WalletConnect Project ID
- Telegram Bot Token
# Clone the repository
git clone https://github.com/your-org/hedwig.git
cd hedwig
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env.local
# Configure your environment variables
# Edit .env.local with your API keys and database URLs
# Run the development server
npm run dev# Database
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
# Wallet Integration
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id
# Telegram Bot
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
# Email Service
RESEND_API_KEY=your_resend_api_key
# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000
HEDWIG_API_KEY=your_internal_api_key- Next.js 14: React framework with App Router
- TypeScript: Type-safe development
- Tailwind CSS: Utility-first styling
- Reown AppKit: Multi-wallet connectivity
- Supabase: PostgreSQL database and authentication
- Telegram Bot API: Bot integration
- Resend: Email service
- Smart Contracts: Solidity contracts for escrow
- Wagmi: React hooks for Ethereum
- Viem: TypeScript Ethereum library
- Multi-chain: Support for Base and Celo networks
POST /api/contracts/generate- Create new contractPOST /api/contracts/approve- Approve contractGET /api/contracts/[id]- Get contract details
POST /api/contracts/milestone/start- Start milestone workPOST /api/contracts/milestone/submit- Submit completed workPOST /api/contracts/milestone/approve- Approve and release payment
POST /api/payment/process- Process crypto paymentsGET /api/payment/status- Check payment status
POST /api/invoices/generate- Create professional invoicesGET /api/invoices/[id]- View invoice detailsPOST /api/invoices/pay- Process invoice payments
POST /api/payment-links/create- Generate shareable payment linksGET /api/payment-links/[id]- Access payment link pagePOST /api/payment-links/process- Handle payment link transactions
POST /api/proposals/generate- Create AI-powered proposalsGET /api/proposals/[id]- View proposal detailsPOST /api/proposals/accept- Accept proposal and convert to contract
POST /api/offramp/initiate- Start crypto-to-fiat conversionGET /api/offramp/rates- Get current exchange ratesGET /api/offramp/status/[id]- Check offramp transaction status
- Fork the repository
- Create a 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
- Smart contracts audited for security vulnerabilities
- Private keys never stored or transmitted
- Secure RPC endpoints and API key management
- Regular security updates and monitoring
- Documentation: docs.hedwigbot.xyz
- Telegram: @HedwigBot
- Email: support@hedwigbot.xyz
- Discord: Join our community
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for the freelance community