supawallet

Problem Statement

What is SupaWallet?SupaWallet is a revolutionary Web3 wallet that makes cryptocurrency as easy as Venmo while providing comprehensive DeFi functionality. Built for the Unite DeFi Hackathon 2025, it eliminates seed phrases, adds GIF-powered payments, and integrates advanced DeFi operations—all in one delightful app.The ProblemTraditional crypto wallets are intimidating: seed phrases to memorize, complex interfaces, fragmented DeFi tools across multiple apps, and zero social features. This complexity prevents mainstream adoption and makes crypto feel technical rather than fun.Our SolutionSupaWallet reimagines the entire crypto experience by combining:Passwordless authentication (no seed phrases ever)Venmo-style UX with GIF-powered payment requestsComplete DeFi hub for swapping, bridging, and yield farmingSocial features to follow friends and discover strategiesBeautiful, personalized AI-generated themesCore FeaturesNo More Seed PhrasesPowered by Porto SDK for passwordless wallet creationSocial recovery through friends instead of 24-word mnemonicsTrue self-custody without the complexityGIF-Powered PaymentsAttach GIFs to payment requests (Tenor API integration)Share payment links like VenmoSupport for multiple cryptocurrenciesMake crypto transactions fun and personalAll-in-One DeFi Platform (1inch Integration)Swapping: Best rates across 260+ liquidity sourcesBridging: Move assets between chains seamlesslyYield Farming: Discover and enter high-APY poolsPortfolio Tracking: Real-time prices and P&L analyticsSocial LayerFollow other wallets and tradersSee what others are buying/sellingShare your portfolio and strategiesLearn from the communityDelightful UXAI-generated color themes based on your promptsBeautiful animations and transitionsTransaction simulation before executionMobile-responsive designTechnical StackFrontend: Next.js 15, React 19, TailwindCSS v4, Wagmi v2, Framer Motion Backend: tRPC v11, PostgreSQL (Neon), Drizzle ORM, Better Auth Blockchain: Base/Base Sepolia, Porto SDK, 1inch Protocol Suite APIs: Tenor (GIFs), Resend (email), 1inch (DeFi operations)How It WorksFor New Users:Connect: One-click wallet creation with Porto (no seed phrases)Verify: Secure your account with emailPersonalize: Choose or generate an AI themeStart: Send crypto with GIFs, swap tokens, or explore DeFiDaily Usage:Send Money: Create GIF-powered payment requestsManage Portfolio: Track all your tokens and positionsDeFi Operations: Swap, bridge, or farm with one clickSocial Discovery: Follow successful traders and friendsWhat Makes SupaWallet SpecialFirst GIF-integrated crypto wallet - Making transactions fun and personalNo technical barriers - Anyone can start using crypto immediatelyComplete DeFi suite - No need for multiple appsSocial investing - Learn from and share with the communityTrue self-custody - Security without complexityTarget UsersCrypto Newcomers: Want easy entry without technical knowledgeSocial Traders: Value community and shared strategiesDeFi Users: Need all tools in one placeVenmo/CashApp Users: Ready to upgrade to cryptoUse CasesSplitting bills with friends in cryptoCollecting payments with personalized GIF requestsDiscovering and investing in DeFi opportunitiesFollowing successful traders' strategiesManaging portfolios across multiple chainsSecurity & TrustPorto's enterprise-grade passwordless technologySocial recovery options (no lost funds from forgotten seeds)Transaction preview and simulationComplete audit trail of all activitiesNon-custodial architecture (you control your keys)Vision & ImpactSupaWallet bridges the gap between traditional finance apps and DeFi, making crypto accessible to millions who find current wallets too complex. By removing seed phrases, adding social features, and making transactions fun with GIFs, we're creating the wallet that will onboard the next generation to Web3.In essence: SupaWallet is where Venmo meets DeFi—simple enough for your parents, powerful enough for DeFi pros, and fun enough to share with friends.

Solution

Core ArchitectureWe built SupaWallet on a modern Web3 stack centered around Next.js 15 with the App Router, React 19, and tRPC v11 for end-to-end type safety. Our database layer uses Drizzle ORM with Neon's serverless PostgreSQL, providing the perfect balance of type safety and SQL flexibility for complex portfolio aggregations.The frontend leverages TailwindCSS v4 with Radix UI components for a polished interface, while Wagmi v2 handles all Web3 interactions. We use Better Auth with Sign-In With Ethereum (SIWE) for authentication, seamlessly integrated with Porto's passwordless wallet technology.1inch Integration: The Heart of Our DeFi FeaturesDeep Integration with 1inch Network1inch is the backbone of SupaWallet's DeFi functionality. We integrated four different 1inch APIs to provide users with comprehensive DeFi capabilities:1inch Aggregation Protocol v6 (Token Swapping)The Aggregation Protocol powers our token swap feature, giving users access to the best rates across 260+ liquidity sources. We fetch quotes in real-time, display gas estimates, and show users exactly how much they'll receive. The protocol's Pathfinder algorithm ensures optimal routing, often splitting trades across multiple DEXs to minimize slippage and maximize returns.Key Implementation Details:Real-time quote fetching with automatic refresh every 10 secondsSlippage protection with customizable tolerance (0.5%, 1%, 3%)Gas optimization through 1inch's CHI gas token integrationSupport for complex routing across multiple liquidity pools1inch Fusion+ (Cross-Chain Bridging)Fusion+ enables seamless cross-chain transfers within SupaWallet. Users can move assets between Base, Ethereum, Polygon, and other supported chains with just a few clicks. The Fusion+ protocol uses a unique Dutch auction mechanism that ensures users get the best possible rates for their cross-chain swaps.Integration Highlights:One-click bridging with automatic route optimizationSupport for 10+ chains including Base (our primary chain)Real-time bridge fee comparisonEstimated arrival times for cross-chain transfers1inch Spot Price API (Real-Time Pricing)The Spot Price API powers our entire portfolio valuation system. We fetch real-time prices for all tokens in user portfolios, calculate USD values, and track 24-hour price changes. This API is called millions of times daily to keep portfolio values accurate.Advanced Features:Batch price fetching for up to 100 tokens per requestHistorical price data for portfolio performance chartsPrice change alerts and notificationsCurrency conversion support (USD, EUR, GBP, etc.)1inch Portfolio API (Balance Tracking)The Portfolio API provides comprehensive balance data across multiple chains. We use this to aggregate user holdings, track DeFi positions, and identify yield farming opportunities. The API returns not just token balances but also liquidity pool positions, staking rewards, and pending transactions.Portfolio Features Powered by 1inch:Multi-chain balance aggregationDeFi position tracking (Uniswap, Curve, Balancer pools)Yield farming APY calculationsImpermanent loss tracking for liquidity providersNotable 1inch Implementation DetailsAuto-Generated TypeScript Clients: We used 1inch's OpenAPI specifications to auto-generate fully typed TypeScript clients. This ensures our integration stays up-to-date with API changes and provides excellent developer experience with full IntelliSense support.Smart Caching Strategy: To optimize API usage and improve performance, we implemented a multi-tier caching system:In-memory cache for frequently accessed data (5-minute TTL)Database cache for historical dataStale-while-revalidate pattern for price updatesRate Limit Management: We built a sophisticated rate limiting system that:Batches requests to maximize efficiencyImplements exponential backoff for retriesDistributes load across multiple API keysPrioritizes critical user actionsOther Partner Technology IntegrationsPorto SDK: Revolutionizing Wallet UXPorto's passwordless wallet technology is what makes SupaWallet accessible to mainstream users. Their SDK eliminates seed phrases entirely while maintaining true self-custody. Users can recover wallets through social recovery mechanisms, making lost funds a thing of the past.Tenor API: Making Crypto FunWe integrated Tenor's GIF API to add personality to payment requests. Users can search for and attach GIFs to their payment links, making crypto transactions as fun and personal as messaging apps.Base Network: Our Chain of ChoiceWe chose Base (Coinbase's L2) as our primary chain for its low fees and growing ecosystem. Base's integration with Coinbase's infrastructure provides excellent fiat on-ramp opportunities for future development.Notable Technical AchievementsAI Theme GenerationWe built an AI-powered theme generator that creates custom color schemes based on user prompts. Using Claude's API, users can type "sunset vibes" or "cyberpunk" and get a personalized wallet theme instantly.Real-Time Portfolio UpdatesOur portfolio system uses a hybrid approach:Initial Load: Cached data for instant page loadsBackground Refresh: Automatic updates from 1inch APIsSmart Invalidation: Updates triggered by user actionsStateless Payment LinksWe created shareable payment links using JWT tokens, allowing users to request payments without storing sensitive data. Links include recipient address, amount, token type, and optional GIF - all encoded in a secure, expiring token.Development Challenges & SolutionsMulti-Chain Balance AggregationFetching balances across multiple chains while respecting rate limits was challenging. We solved this with parallel processing, intelligent batching, and a tiered caching system that reduces API calls by 90%.API ReliabilityWeb3 APIs can be unstable. We implemented:Automatic failover between multiple RPC providersCircuit breakers for failing endpointsGraceful degradation when services are downLocal caching to maintain functionality during outagesType Safety in Web3We wrapped all Web3 interactions in type-safe abstractions, ensuring compile-time safety for blockchain interactions. This prevents common errors like sending transactions to invalid addresses or with incorrect parameters.Performance OptimizationsEdge Functions: API routes run on Vercel Edge for global low latencyOptimistic Updates: UI updates immediately while transactions processSmart Prefetching: Predictive data loading based on user behaviorBundle Splitting: DeFi features load on-demand to reduce initial bundle sizeThe Web3 Stack That Powers SupaWalletWagmi v2: Premier React hooks library for EthereumViem: Type-safe, performant Ethereum libraryPorto SDK: Passwordless Web3 authentication1inch Network Suite: Complete DeFi infrastructureBase Network: Fast, affordable L2 for transactionsBetter Auth + SIWE: Web3-native authenticationVercel: Edge deployment for global performanceThis architecture delivers a consumer-grade experience while maintaining the decentralization and self-custody that Web3 demands. By deeply integrating with 1inch's comprehensive API suite and leveraging Porto's innovative wallet technology, we've created a wallet that's both powerful for DeFi veterans and accessible for crypto newcomers.