supawallet

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 Problem

Traditional 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 Solution

SupaWallet reimagines the entire crypto experience by combining:

• Passwordless authentication (no seed phrases ever)
• Venmo-style UX with GIF-powered payment requests
• Complete DeFi hub for swapping, bridging, and yield farming
• Social features to follow friends and discover strategies
• Beautiful, personalized AI-generated themes

Core Features

1. No More Seed Phrases

• Powered by Porto SDK for passwordless wallet creation
• Social recovery through friends instead of 24-word mnemonics
• True self-custody without the complexity

1. GIF-Powered Payments

• Attach GIFs to payment requests (Tenor API integration)
• Share payment links like Venmo
• Support for multiple cryptocurrencies
• Make crypto transactions fun and personal

1. All-in-One DeFi Platform (1inch Integration)

• Swapping: Best rates across 260+ liquidity sources
• Bridging: Move assets between chains seamlessly
• Yield Farming: Discover and enter high-APY pools
• Portfolio Tracking: Real-time prices and P&L analytics

1. Social Layer

• Follow other wallets and traders
• See what others are buying/selling
• Share your portfolio and strategies
• Learn from the community

1. Delightful UX

• AI-generated color themes based on your prompts
• Beautiful animations and transitions
• Transaction simulation before execution
• Mobile-responsive design

Technical Stack

Frontend: 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 Works

For New Users:

1. Connect: One-click wallet creation with Porto (no seed phrases)
2. Verify: Secure your account with email
3. Personalize: Choose or generate an AI theme
4. Start: Send crypto with GIFs, swap tokens, or explore DeFi

Daily Usage:

• Send Money: Create GIF-powered payment requests
• Manage Portfolio: Track all your tokens and positions
• DeFi Operations: Swap, bridge, or farm with one click
• Social Discovery: Follow successful traders and friends

What Makes SupaWallet Special

1. First GIF-integrated crypto wallet - Making transactions fun and personal
2. No technical barriers - Anyone can start using crypto immediately
3. Complete DeFi suite - No need for multiple apps
4. Social investing - Learn from and share with the community
5. True self-custody - Security without complexity

Target Users

• Crypto Newcomers: Want easy entry without technical knowledge
• Social Traders: Value community and shared strategies
• DeFi Users: Need all tools in one place
• Venmo/CashApp Users: Ready to upgrade to crypto

Use Cases

• Splitting bills with friends in crypto
• Collecting payments with personalized GIF requests
• Discovering and investing in DeFi opportunities
• Following successful traders' strategies
• Managing portfolios across multiple chains

Security & Trust

• Porto's enterprise-grade passwordless technology
• Social recovery options (no lost funds from forgotten seeds)
• Transaction preview and simulation
• Complete audit trail of all activities
• Non-custodial architecture (you control your keys)

Vision & Impact

SupaWallet 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.

Core Architecture

We 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 Features

Deep Integration with 1inch Network

1inch is the backbone of SupaWallet's DeFi functionality. We integrated four different 1inch APIs to provide users with comprehensive DeFi capabilities:

1. 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 seconds
• Slippage protection with customizable tolerance (0.5%, 1%, 3%)
• Gas optimization through 1inch's CHI gas token integration
• Support for complex routing across multiple liquidity pools

1. 1inch 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 optimization
• Support for 10+ chains including Base (our primary chain)
• Real-time bridge fee comparison
• Estimated arrival times for cross-chain transfers

1. 1inch 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 request
• Historical price data for portfolio performance charts
• Price change alerts and notifications
• Currency conversion support (USD, EUR, GBP, etc.)

1. 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 aggregation
• DeFi position tracking (Uniswap, Curve, Balancer pools)
• Yield farming APY calculations
• Impermanent loss tracking for liquidity providers

Notable 1inch Implementation Details

Auto-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 data
• Stale-while-revalidate pattern for price updates

Rate Limit Management: We built a sophisticated rate limiting system that:

• Batches requests to maximize efficiency
• Implements exponential backoff for retries
• Distributes load across multiple API keys
• Prioritizes critical user actions

Other Partner Technology Integrations

Porto SDK: Revolutionizing Wallet UX

Porto'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 Fun

We 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 Choice

We 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 Achievements

AI Theme Generation

We 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 Updates

Our portfolio system uses a hybrid approach:

• Initial Load: Cached data for instant page loads
• Background Refresh: Automatic updates from 1inch APIs
• Smart Invalidation: Updates triggered by user actions

Stateless Payment Links

We 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 & Solutions

Multi-Chain Balance Aggregation

Fetching 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 Reliability

Web3 APIs can be unstable. We implemented:

• Automatic failover between multiple RPC providers
• Circuit breakers for failing endpoints
• Graceful degradation when services are down
• Local caching to maintain functionality during outages

Type Safety in Web3

We 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 Optimizations

• Edge Functions: API routes run on Vercel Edge for global low latency
• Optimistic Updates: UI updates immediately while transactions process
• Smart Prefetching: Predictive data loading based on user behavior
• Bundle Splitting: DeFi features load on-demand to reduce initial bundle size

The Web3 Stack That Powers SupaWallet

• Wagmi v2: Premier React hooks library for Ethereum
• Viem: Type-safe, performant Ethereum library
• Porto SDK: Passwordless Web3 authentication
• 1inch Network Suite: Complete DeFi infrastructure
• Base Network: Fast, affordable L2 for transactions
• Better Auth + SIWE: Web3-native authentication
• Vercel: Edge deployment for global performance

This 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.