DeWrap

Demo

About

**DeWrap** is a Web3-native payment platform designed specifically for builders, creators, agencies, and freelancers who want to accept cryptocurrency payments with maximum flexibility and automation. The platform solves the fundamental problem of crypto payment fragmentation by providing a unified solution for cross-chain, multi-token payments with intelligent automation. ### Core Problem & Solution **Problem**: Traditional crypto payment solutions are limited by: - Single-chain restrictions - Manual token conversion processes - Complex cross-chain payment handling - Lack of automated investment strategies - Fragmented payment tracking across networks **Solution**: DeWrap provides a complete payment infrastructure that: - Accepts payments in ANY ERC-20 token or native tokens across multiple blockchain networks - Automatically converts tokens using 1inch's cross-chain DEX aggregation - Provides intelligent invoicing with flexible payment preferences - Offers automated investment and dollar-cost averaging (DCA) capabilities [COMING SOON] - Maintains comprehensive payment tracking and analytics ### Key Features & Capabilities **1. Multi-Token Payment Acceptance** - Support for any ERC-20 token across all EVM chains that are supported by 1inch Protocol - Native token support (ETH, MATIC, etc.) - Automatic payment validation and processing **2. Cross-Chain Infrastructure** - Powered by 1inch's Fusion Plus cross-chain API - Seamless token bridging and swapping across networks - Real-time quote generation for optimal swap routes - Automated transaction execution with MEV protection **3. Smart Invoicing System** - Create professional invoices with flexible payment options - Set preferred tokens and chains for each invoice - Real-time payment status tracking - Automated payment matching and processing **4. Automated Token Management** [COMING SOON] - Auto-swap functionality to convert received tokens to preferred tokens - Dollar-cost averaging (DCA) for systematic investment - Investment portfolio tracking and analytics - Scheduled swap execution via cron jobs **5. User Management & Analytics** - Secure authentication via Clerk - Comprehensive user profiles with payment preferences - Real-time balance tracking across all supported networks [USING 1INCH API] - Detailed transaction history and analytics [USING 1INCH API] - Performance metrics and insights ### Technical Architecture **Frontend (Next.js 15)** - Modern React 19 with TypeScript - Tailwind CSS 4 for responsive design - Radix UI for accessible components - Wagmi + AppKit for Web3 integration - Real-time data fetching with TanStack Query **Smart Contracts (Solidity 0.8.27)** - `DeWrap.sol`: Core contract managing users, invoices, and payouts - `DewrapPaymentCollector.sol`: Payment collection and processing - `PaymentCollectorFactory.sol`: Factory pattern for scalable deployment - OpenZeppelin contracts for security and best practices **Backend Infrastructure** - PostgreSQL database with Prisma ORM - **1inch Cross-Chain API** integration - Viem for Ethereum interactions - Zod for runtime validation - Comprehensive API endpoints for all operations **Key API Endpoints** - `/api/user` - User management and profiles - `/api/invoice` - Invoice creation and management - `/api/payment` - Payment processing and tracking - `/api/quote` - Real-time token price quotes - `/api/execute` - Cross-chain transaction execution - `/api/supported-network` - Network and token information - `/api/token` - Descriptive detail regarding token ### Target Users & Use Cases **Primary Users**: - **Freelancers**: Accept payments in any token, automatically convert to preferred tokens - **Agencies**: Manage multiple client payments across different networks - **Content Creators**: Monetize with crypto while maintaining payment flexibility - **Web3 Builders**: Integrate DeWrap for project funding and revenue collection **Use Cases**: - Invoice-based payment collection with automatic token conversion - Cross-chain payment processing for international clients - Automated investment strategies for received payments - Portfolio diversification across multiple blockchain networks - Systematic DCA for long-term investment goals ### Competitive Advantages 1. **True Cross-Chain Support**: Unlike competitors limited to single chains, DeWrap operates seamlessly across 9+ major networks 2. **1inch Integration**: Leverages the most advanced DEX aggregator for optimal swap routes and MEV protection 3. **Automation-First**: Built-in auto-swap and DCA capabilities reduce manual intervention 4. **Developer-Friendly**: Comprehensive API and smart contract architecture for easy integration 5. **User Experience**: Modern, intuitive interface that abstracts away blockchain complexity ### Business Model & Revenue Streams - Transaction fees on cross-chain swaps - Premium features for advanced users - API access for enterprise integrations - White-label solutions for businesses DeWrap essentially transforms the fragmented crypto payment landscape into a unified, automated, and user-friendly experience, making it as simple to accept crypto payments as traditional fiat payments while providing advanced features that only blockchain technology can enable.

How it's made

## How DeWrap Was Built: The Technical Deep Dive DeWrap is a sophisticated Web3 payment platform built with cutting-edge technologies and some clever architectural decisions. Here's the complete technical breakdown: ### **Monorepo Architecture with Turborepo** The project uses a **Turborepo monorepo** structure for optimal development experience: - **`apps/web`**: Next.js 15 frontend with React 19 - **`apps/contracts`**: Solidity smart contracts with Hardhat - **`apps/docs`**: Documentation site - **`packages/ui`**: Shared component library - **`packages/eslint-config`**: Unified linting rules - **`packages/typescript-config`**: Shared TypeScript configs This enables code sharing, consistent tooling, and parallel builds across the entire stack. ### **Frontend: Next.js 15 + React 19 + Modern Stack** **Core Technologies:** - **Next.js 15** with App Router for server-side rendering and API routes - **React 19** with concurrent features and improved performance - **TypeScript 5.8** for type safety across the entire application - **Tailwind CSS 4** with PostCSS for utility-first styling - **Radix UI** for accessible, unstyled components - **TanStack Query** for server state management and caching **Web3 Integration:** - **Wagmi v2** + **Reown's AppKit** for wallet connections and blockchain interactions - **Viem 2.x** for low-level Ethereum interactions - **Ethers.js 6.15** for smart contract interactions - Custom **AppKitProviderConnector** to bridge AppKit with 1inch Protocol ### **Smart Contracts: Solidity 0.8.27 + OpenZeppelin** **Core Contracts:** - **`DeWrap.sol`**: Main contract managing users, invoices, payouts, and investments - **`DewrapPaymentCollector.sol`**: Payment collection and processing logic - **`PaymentCollectorFactory.sol`**: Factory pattern for scalable deployment **Key Features:** - **ReentrancyGuard** for security against reentrancy attacks - **Ownable** pattern for administrative functions - **Event-driven architecture** for off-chain tracking - **Enum-based status management** for invoices and payouts - **Struct-based data organization** for complex relationships ### **Cross-Chain Infrastructure: 1inch Fusion Plus** This is where DeWrap gets really interesting. The platform leverages **1inch's Fusion Plus cross-chain API** for seamless token bridging and swapping: **Cross-Chain Flow:** 1. **Quote Generation**: Real-time pricing across 9+ networks 2. **Order Placement**: MEV-protected order submission 3. **Secret Management**: HashLock-based atomic swaps 4. **Fill Monitoring**: Automated secret submission for completed fills 5. **Status Tracking**: Real-time order status updates ### **Database: PostgreSQL + Prisma** **Schema Design:** - **User Management**: Clerk integration with custom user profiles - **Invoice System**: Flexible payment preferences and status tracking - **Payout Tracking**: Cross-chain transaction monitoring - **Metrics**: User performance and investment analytics **Key Features:** - **UUID-based primary keys** for security - **JSON metadata fields** for flexible data storage - **Indexed relationships** for performance - **Enum-based status tracking** for type safety **Webhook Integration:** - Real-time user synchronization - Secure webhook validation with Svix - Automatic profile updates ### **API Architecture: Next.js API Routes** **Key Endpoints:** - **`/api/quote`**: 1inch quote generation - **`/api/execute`**: Cross-chain transaction execution - **`/api/invoice`**: Invoice management - **`/api/payment`**: Payment processing - **`/api/cron/swap`**: Automated swap execution [COMING SOON]