EPIC: Pool Creation Feature Implementation

[rafamiziara]

Epic: Pool Creation Feature Implementation

Overview

This epic encompasses the complete implementation of pool creation functionality for SuperPool, from smart contract development to user interface, enabling users to create and manage lending pools with comprehensive validation and monitoring.

Scope

Implementation of end-to-end pool creation feature including:

• Smart contract modifications for simplified MVP flow
• Backend services for immediate and scheduled event indexing
• Mobile app with MobX stores, React hooks, and comprehensive UI
• Transaction monitoring and pending state management
• Event synchronization and blockchain state indexing

Child Issues

Phase 1: Smart Contract Infrastructure (Issues 22-27) ✅ COMPLETED

Priority: Core contracts and deployment pipeline

• feat: Set up Hardhat development environment for contracts #22 - Set up Hardhat development environment for contracts ✅
• feat: Develop PoolFactory.sol smart contract #23 - Develop PoolFactory.sol smart contract ✅
• feat: Develop LendingPool.sol implementation contract #24 - Develop LendingPool.sol implementation contract ✅
• feat: Create deployment scripts for Polygon Amoy #25 - Create deployment scripts for Polygon Amoy ✅
• feat: Add contract verification automation #26 - Add contract verification automation ✅
• feat: Transfer PoolFactory ownership to multi-sig Safe #27 - Transfer PoolFactory ownership to multi-sig Safe ✅

Phase 2: Backend Services (Issues 28-30) ✅ COMPLETED

Priority: Contract integration and event monitoring

• feat: Create Cloud Function for pool creation via PoolFactory #28 - Create Cloud Function for pool creation via PoolFactory ✅
• feat: Add contract interaction service for Safe integration #29 - Add contract interaction service for Safe integration ✅
• feat: Set up event listeners for pool creation events #30 - Set up event listeners for pool creation events ✅

Phase 3: Contract Modifications for MVP (Issue 68)

Priority: Simplify pool creation for MVP

• refactor(contracts): Modify PoolFactory for MVP - Remove poolOwner parameter #68 - Modify PoolFactory to auto-assign poolOwner (remove parameter)

Phase 4: Backend Pool Indexing (Issues 69-72)

Priority: Event indexing infrastructure

• feat(backend): Implement event indexing service for pool creation #69 - Implement event indexing service for pool creation
• feat(backend): Create immediate indexing callable function #70 - Create immediate indexing callable function
• feat(backend): Create scheduled pool event indexing function #71 - Create scheduled pool event indexing function
• chore(backend): Configure environment and constants for pool indexing #72 - Configure backend environment and constants

Phase 5: Mobile State Management (Issues 73-74)

Priority: Core MobX stores

• feat(mobile): Create PoolManagementStore with MobX #73 - Create PoolManagementStore with MobX
• feat(mobile): Create PendingTransactionsStore with AsyncStorage persistence #74 - Create PendingTransactionsStore with AsyncStorage

Phase 6: Mobile Business Logic (Issues 75-76)

Priority: React hooks for pool operations

• feat(mobile): Implement pool creation hook with Wagmi integration #75 - Implement pool creation hook with Wagmi integration
• feat(mobile): Implement transaction monitoring and indexing hooks #76 - Implement transaction monitoring and indexing hooks

Phase 7: Mobile User Interface (Issues 77-80)

Priority: Complete user-facing flow

• feat(mobile): Create pool creation form with Zod validation #77 - Create pool creation form with Zod validation
• feat(mobile): Create pool creation screen with pre-flight checks #78 - Create pool creation screen with pre-flight checks
• feat(mobile): Update pools list with pending state support #79 - Update pools list with pending state support
• feat(mobile): Create transaction status UI components #80 - Create transaction status UI components

Phase 8: Configuration & Testing (Issues 81-82)

Priority: Infrastructure and quality assurance

• chore: Configure environment and Firestore for pool creation #81 - Configure environment and Firestore for pool creation
• test: Add comprehensive tests for pool creation flow #82 - Add comprehensive tests for pool creation flow

Technical Architecture

• Smart Contracts: PoolFactory + LendingPool with upgradeable proxy pattern ✅ COMPLETED
• Multi-sig: Safe wallet integration for admin control ✅ COMPLETED
• Backend: Firebase Cloud Functions with immediate + scheduled indexing
• Frontend: React Native with MobX stores, Wagmi hooks, and NativeWind styling
• State Management: Reactive MobX stores with AsyncStorage persistence
• Deployment: Automated deployment to Polygon Amoy testnet ✅ COMPLETED

Development Sequence

1. Smart Contract Phase (Issues 22-27): Deploy contract infrastructure ✅ COMPLETED
2. Backend Phase (Issues 28-30): Build contract integration services ✅ COMPLETED
3. MVP Preparation (Issue 68): Simplify contract for MVP
4. Backend Indexing (Issues 69-72): Implement event indexing
5. Mobile Stores (Issues 73-74): Build reactive state management
6. Mobile Hooks (Issues 75-76): Create business logic layer
7. Mobile UI (Issues 77-80): Complete user interface
8. Testing & Config (Issues 81-82): Finalize and validate

Progress Update

Epic Progress: 9/24 issues completed (37.5%)

Smart Contract Phase: 6/6 complete (100%) ✅ COMPLETED

• ✅ All contracts developed, deployed, and verified on Polygon Amoy
• ✅ Multi-sig Safe ownership transfer completed
• ✅ Comprehensive security testing implemented

Backend Phase: 3/3 complete (100%) ✅ COMPLETED

• ✅ Pool creation Cloud Function implemented
• ✅ Safe integration service completed
• ✅ Event listeners for pool creation active

MVP Preparation: 0/1 complete (0%)

• Ready to start contract simplification

Backend Indexing: 0/4 complete (0%)

• Depends on contract modifications

Mobile Implementation: 0/8 complete (0%)

• Ready to start with MobX foundation

Configuration & Testing: 0/2 complete (0%)

• Will be done throughout implementation

Acceptance Criteria

• ✅ Smart contracts deployed and verified on Polygon Amoy
• ✅ PoolFactory ownership transferred to multi-sig Safe
• ✅ Backend handles pool creation through Safe transactions
• Contract simplified for MVP (auto-assign poolOwner)
• Backend indexes pools immediately after creation
• Scheduled indexing catches missed pools
• Mobile app stores manage pool and transaction state
• UI allows users to create pools with full validation
• Pending transactions persist across app restarts
• End-to-end pool creation workflow functional
• Test coverage above 95% with comprehensive edge cases

Definition of Done

• All child issues completed and closed
• ✅ Smart contracts deployed and ownership transferred to Safe
• ✅ Project structure organized for professional development
• ✅ Backend services completed for pool creation
• Contract modifications deployed and tested
• Event indexing (immediate + scheduled) functional
• Mobile app with complete pool creation flow
• Pool creation tested end-to-end on Amoy testnet
• Comprehensive validation on both client and server
• Documentation updated for pool creation workflow
• Integration tests pass for complete flow

Dependencies

• Multi-sig Safe contracts (deployed) ✅
• Firebase Cloud Functions infrastructure ✅
• Polygon Amoy testnet access ✅
• Wallet authentication system (from previous epic EPIC: Implement User Onboarding & Wallet Connection #17) ✅
• MobX state management foundation ✅
• Reown AppKit + Wagmi integration ✅

Related Issues

• Builds upon: EPIC: Implement User Onboarding & Wallet Connection #17 (Wallet Authentication & Firebase Integration) ✅
• Foundation for: Future pool management and lending features