Purro

🧠 Project Name

Purro Wallet

🔍 Description

Purro is the purr-fect wallet extension designed specifically for the Hyperliquid ecosystem. It eliminates complexity with clean UX, lightning-fast performance, and enterprise-grade security. No switching tabs, no missing fees - just all your assets in one seamless view with advanced features like gasless swaps, NFT identity, and smart wallet capabilities.

Key Technical Highlights:

⚡ Lightning Fast Performance

• Sub-100ms Response Times: Optimized caching system with 30-second cache duration and 300ms debounced API calls
• Smart Incremental Fetching: 5-minute fresh data guarantee with storage-efficient 5000 transaction limit per chain
• Real-time Portfolio Synchronization: Cross-chain data caching across Ethereum, Arbitrum, Base, and HyperEVM
• Performance Tracking: Built-in loading time metrics and error handling with graceful degradation

🔒 Bank-Level Security

• Non-custodial Design: "Your keys, your crypto" - wallet never stores private keys on servers
• Enterprise-grade Encryption: AES-256 encryption with secure key derivation and password protection
• Comprehensive Security Testing: 100+ security tests with encryption validation and memory management
• Auto-lock System: Configurable inactivity timeout with secure session management
• Secure Key Management: Offscreen document for cryptographic operations with Manifest V3 compliance

Advanced Wallet Features

• In-App Swap Execution: Complete HyperEVM token swapping with LiquidSwap integration
• Advanced Gas Optimization: EIP-1559 support with 20% safety buffers and L1/L2 optimized pricing
• Real-time Price Feeds: GeckoTerminal API integration for live token pricing
• WRAP/UNWRAP Support: Seamless HYPE ↔ WHYPE token conversion
• Smart Token Discovery: Infinite scroll token search with comprehensive HyperEVM database

Multi-Chain Excellence:

• Native Hyperliquid Support: HyperCore spot & perpetuals trading with real-time portfolio tracking
• HyperEVM Integration: Full EVM compatibility with chainId 0x3e7 (999) support
• Multi-Network Portfolio: Ethereum (0x1), Arbitrum (0xa4b1), Base (0x2105) with unified asset management
• Cross-chain Asset Management: Single interface for all supported networks

Developer-First Infrastructure:

• EIP Standards Compliance: Full EIP-1193, EIP-6963, EIP-712 support for dApp integration
• Comprehensive Provider API: PurroEVMProvider class with complete Ethereum provider interface
• Modular Architecture: Clean separation of concerns with background scripts, handlers, and UI components
• TypeScript-First: Full type safety with 5.8.3 TypeScript implementation
• Testing Framework: Unit tests, security tests, and handler validation with full coverage

Unique Differentiators:

• First Hyperliquid-Native Chrome Extension: Purpose-built for Hyperliquid ecosystem
• 11+ Curated dApp Directory: Direct integration with Hyperliquid ecosystem projects
• Advanced Caching System: Multi-chain cache support with intelligent data management
• Developer Mode: Testnet support with custom token management
• Modern Tech Stack: React 19.1.0, Vite 6.3.5, Tailwind CSS 4.1.8, TanStack Query 5.80.7

💻 Demo

Live Extension: https://purro.xyz/install (v0.6.9 Beta)
Production: https://chromewebstore.google.com/detail/ehfplamebglaemcflkgjlomdbbpmehof (v0.6.7 Beta)

📂 Project Links

• Live Extension: https://purro.xyz/install (v0.6.9 Beta - Manual installation available) 
• Official Website: https://purro.xyz (Complete feature overview) 
• Comprehensive Documentation: https://docs.purro.xyz (Technical guides, API docs, integration examples) 
• Demo Videos: https://drive.google.com/drive/folders/1YVDBbu3ZVqB3AvuRFQsAiZB0hkIZ1W_E?usp=sharing
• Pitch Desk: https://www.canva.com/design/DAGwbH7BQPc/8yA3_8V2L27yQeznl-k9lg/view?utm_content=DAGwbH7BQPc&utm_campaign=designshare&utm_medium=link2&utm_source=uniquelinks&utlId=h4708de7fbd
• Chrome Web Store: https://chromewebstore.google.com/detail/ehfplamebglaemcflkgjlomdbbpmehof
• Github Org: https://github.com/orgs/PurroWallet
• Linkedin: https://www.linkedin.com/company/purrowallet
• X: https://x.com/purro_xyz

Technical Resources:

• GitHub Repository: Open-source components and SDK documentation
• API Documentation: Complete EIP-1193/6963/712 implementation guides
• Integration Examples: dApp integration patterns and best practices
• Security Audit: Comprehensive security testing framework and results

👥 Team

Core Development Team:

• Terran (@terrancrypt) - Founder & Lead Developer
  • https://terrancrypt.com/
  • https://x.com/terrancrypt
• ThwnDC (@thwndc) - UI/UX Designer
• Phoebe Duong (@baovyduong) - Marketing & Community Manager
  • https://www.linkedin.com/in/baovyduong/
• David Nguyen (@nguyenvucongthang) - BD & Growth
  • https://www.linkedin.com/in/nguyenvucongthang/
• HighTran (@tranvanhai0504) - Web3 Developer
  • https://github.com/tranvanhai0504
• 0xboji - Backend & Cloud Engineer
  • https://github.com/0xBoji

Building the purr-fect bridge between traditional DeFi and Hyperliquid's next-generation trading infrastructure while fostering ecosystem growth through comprehensive, user-centric innovation.

📱 Roadmap: Multi-Platform Expansion

Phase 2: Mobile Wallet Development Following our successful Chrome extension launch, Purro will expand to become a true multi-platform solution:

• 🔄 Cross-Platform Sync: Seamless wallet synchronization between desktop extension and mobile app 
• 📲 Native Mobile Apps: iOS and Android applications with platform-optimized UX 
• 🎯 Mobile-First Features: QR code payments, NFC transactions, and mobile-specific security 
• 🌐 Universal Access: Same account, same features, anywhere you go

The mobile expansion will maintain Purro's core values of speed, security, and simplicity while adapting to mobile-native interaction patterns. This multi-platform approach positions Purro as the comprehensive Hyperliquid wallet solution for all user types.

Why Purro Wins: 

• ✅ First-to-Market: Only Hyperliquid-native Chrome extension wallet with 6 months of development 
• ✅ Technical Excellence: 100+ security tests, EIP standards compliance, advanced caching systems 
• ✅ Performance: Lightning-fast with sub-100ms response times and intelligent optimization 
• ✅ Innovation: Advanced features like adaptive gas pricing, HL Names integration, and LiquidSwap API 
• ✅ Ecosystem Impact: 11+ dApp integrations, comprehensive developer SDK, open-source components 
• ✅ Multi-Track Value: Addresses 7 tracks simultaneously with unique technical innovations backed by code evidence

🎯 Hackathon Track Submissions

Primary Tracks Targeted:

🛠️ Public Goods Track

Why Purro Qualifies as Essential Public Infrastructure:

✅ Open-Source SDK & Developer Tools:

• EVM Provider Implementation: Complete PurroEVMProvider class following EIP-1193 standards
• Reusable Components: Modular architecture with 40+ React components available for ecosystem developers
• Comprehensive Testing Framework: 100+ security tests and validation tools that other projects can adopt
• TypeScript Definitions: Full type safety with reusable interfaces and types for Hyperliquid development

✅ Documentation & Educational Materials:

• Complete API Documentation: EIP-1193, EIP-6963, EIP-712 implementation guides
• Integration Examples: Real-world dApp integration patterns and best practices
• Technical Architecture Guides: Detailed documentation of Hyperliquid-specific implementations
• Developer Resources: SDK usage examples and troubleshooting guides

✅ Ecosystem Infrastructure:

• First Hyperliquid Chrome Extension: Establishes foundational patterns for future wallet development
• Multi-Chain Support: Unified interface supporting 4 networks that other projects can build upon
• Gas Optimization Utilities: Reusable gas estimation and EIP-1559 implementation with safety buffers
• Caching Libraries: Advanced caching system (TokenMetadataCacheLib) optimized for multi-chain applications

🚀 Hyperliquid Frontier Track

Growing the Hyperliquid Ecosystem:

✅ Technical Innovation:

• Native HyperEVM Integration: First Chrome extension with built-in HyperEVM support (chainId 0x3e7)
• Dual-Chain Architecture: Seamless integration between HyperCore and HyperEVM in single interface
• Advanced Portfolio Management: Real-time spot & perpetuals tracking with optimized data fetching

✅ Ecosystem Growth Impact:

• 11+ dApp Integrations: Direct integration with Hyperliquid ecosystem projects including LiquidSwap, HyperSwap, Laminar
• Developer Onboarding: Familiar Chrome extension UX lowers barriers for traditional Web3 developers
• User Acquisition: Cat-themed branding with viral potential to attract mainstream users to Hyperliquid

✅ Cultural & Social Impact:

• Community Building: Watchlist system for favorite dApps encourages ecosystem exploration
• Educational Content: Curated dApp directory with categories (DeFi, Bridge, DEX, NFT, Staking)
• Meme Potential: Cat-themed wallet with "purr-fect" branding designed for social media virality

💧 Best Use of Liquid Labs

Advanced LiquidSwap Integration:

✅ Native API Integration:

• Complete LiquidSwap API: Full implementation of route finding, token fetching, and swap execution
• Multi-Hop Routing: Support for complex swap paths with multiHop parameter optimization
• Slippage Management: Advanced slippage control with user-configurable settings
• Fee Structure: Integrated fee recipient and basis points handling for protocol sustainability

✅ Advanced Features Beyond Basic Integration:

• Real-time Route Optimization: Dynamic route finding based on liquidity conditions
• WRAP/UNWRAP Logic: Intelligent HYPE ↔ WHYPE conversion with unwrapWHYPE parameter
• DEX Exclusion: Configurable DEX routing with excludeDexes parameter for optimal execution
• Gas-Optimized Execution: Smart contract interaction with minimal gas overhead

✅ Wallet-Level Integration:

• In-App Swap Interface: Complete swap UI with token search, amount input, and confirmation flows
• Balance Validation: Real-time balance checking with insufficient funds prevention
• Transaction Tracking: Complete swap confirmation dialogs with success state management
• Error Handling: Robust error management with user-friendly fallback mechanisms

🏷️ Best Showcase of Identity with Hyperliquid Names 

Comprehensive .hl Names Integration:

✅ Native API Integration:

• Complete HL Names API: Full integration with Hyperliquid Names REST API
• Address Resolution: Seamless conversion between addresses and .hl names throughout wallet
• Profile Integration: Direct links to HL Names profiles with metadata display

✅ Wallet-Wide Identity Features:

• Transaction History: Human-readable .hl names displayed in all transaction records
• Send Interface: Support for sending tokens directly to .hl addresses with real-time resolution
• NFT Integration: Special handling for HL Names NFTs with profile linking (nft-instances-id-dialog.tsx)
• Contact Management: .hl names as primary identifiers in address book functionality

✅ Social Wallet Experience:

• Identity Display: .hl names prominently displayed throughout wallet interface
• Profile Linking: One-click access to HL Names profiles for social discovery
• NFT Showcase: Special treatment for HL Names NFTs with enhanced metadata display

⚡ Best Use of Alchemy

Enterprise-Grade Multi-Chain Infrastructure:

✅ Comprehensive Alchemy SDK Integration:

• Multi-Chain Support: Full Alchemy integration for Ethereum, Arbitrum, and Base networks
• Advanced Circuit Breaker: Sophisticated failure handling with 503 service unavailable detection and automatic recovery
• Token Metadata Caching: Intelligent caching system with TokenMetadataCacheLib for optimal performance
• Rate Limit Management: Smart request throttling with 330 req/sec optimization

✅ Advanced API Features:

• Enhanced Token Discovery: Comprehensive token balance fetching with metadata enrichment
• Performance Optimization: Circuit breaker with 8 failure threshold and 2-minute reset timeout
• Error Handling: Graceful degradation with fallback mechanisms for service availability
• Batch Processing: Efficient bulk token metadata fetching with cache optimization

✅ Smart Wallet Capabilities:

• Gas Optimization: Alchemy-powered gas estimation with EIP-1559 support
• Real-time Data: Live token balances and pricing with sub-second updates
• Cross-Chain Portfolio: Unified view across all Alchemy-supported networks

🔬 HyperEVM Transaction Simulator

Built-in Transaction Simulation Engine:

✅ Advanced Gas Estimation:

• EIP-1559 Optimization: Complete implementation of EIP-1559 fee structure with maxFeePerGas and maxPriorityFeePerGas
• 20% Safety Buffers: Built-in gas limit buffering for optimal transaction success rates
• L1/L2 Optimization: Specialized gas handling for different network types (Ethereum vs Arbitrum/Base/HyperEVM)
• Real-time Fee Data: Dynamic gas price fetching with fallback mechanisms

✅ Transaction Analysis & Insights:

• Pre-execution Validation: Complete transaction validation before broadcast
• Error Analysis: Comprehensive error detection with user-friendly messages
• Balance Verification: Real-time balance checking with insufficient funds detection
• Cost Calculation: USD cost estimation with live token pricing

✅ HyperEVM-Specific Features:

• Native HyperEVM Support: Optimized for HyperEVM's unique execution environment
• Low Latency: Sub-100ms response times optimized for high-speed trading
• Custom Gas Logic: HyperEVM-specific gas estimation with network-aware optimization

🧠 Advanced, Adaptive Execution Layer

Intelligent Market-Adaptive Trading:

✅ Dynamic Gas Optimization:

• Multi-Priority Gas Selection: 4-tier gas pricing (slow, standard, fast, rapid) with market-adaptive multipliers
• L1/L2 Optimization: Different buffer strategies for Ethereum L1 vs L2 networks (Arbitrum, Base, HyperEVM)
• Real-time Adjustment: Gas price adaptation based on network congestion and transaction urgency

✅ Market-Aware Execution:

• Volatility Detection: Smart execution speed adjustment based on market conditions
• Network-Specific Logic: Optimized execution parameters for different blockchain networks
• Safety Buffers: Dynamic safety margins (10% for L2, 15% for L1) based on network characteristics

✅ Advanced Strategy Integration:

• TWAP/VWAP Support: Time-weighted and volume-weighted average price execution strategies
• Slippage Management: Dynamic slippage adjustment based on market volatility
• MEV Protection: Advanced transaction timing to minimize MEV extraction