feat: Create Cloud Function for pool creation via PoolFactory

[rafamiziara]

Description

Develop a Firebase Cloud Function that interfaces with the PoolFactory smart contract to handle pool creation requests from the mobile application.

Acceptance Criteria

• Create createPool Cloud Function endpoint
• Implement contract interaction logic with PoolFactory
• Add input validation and sanitization
• Implement proper error handling and logging
• Add transaction status tracking
• Integrate with multi-sig Safe for admin actions
• Add comprehensive unit tests

Technical Requirements

• Use existing Firebase Functions architecture
• Integrate with ethers.js for contract interaction
• Implement proper gas estimation and management
• Add transaction receipt verification
• Include retry logic for failed transactions
• Support both POL and ERC20 pool creation

Function Endpoints

• POST /createPool - Create new lending pool
• GET /poolStatus/:txHash - Check pool creation status
• GET /pools - List created pools

Input Validation

• Pool parameters validation (name, description, terms)
• Token address validation (for ERC20 pools)
• Creator authorization checks
• Duplicate pool name prevention

Integration Features

• PoolFactory contract interaction
• Safe wallet integration for admin functions
• Firestore integration for off-chain data
• Event listening for PoolCreated events

Definition of Done

• Cloud Function successfully creates pools via PoolFactory
• Proper error handling and user feedback
• Unit test coverage > 90%
• Integration tests with contract on Amoy
• API documentation complete

[rafamiziara]

✅ Issue #28 Completed Successfully

Summary

Implemented comprehensive Cloud Functions for pool creation via PoolFactory with enhanced Safe multi-sig integration.

What Was Delivered

Core Pool Management Functions

• ✅ - Direct pool creation with blockchain interaction
• ✅ - Transaction status monitoring with Firestore caching
• ✅ - Paginated pool listing with filtering and sorting

Safe Multi-Sig Admin Functions (Bonus Enhancement)

• ✅ - Prepare multi-sig transactions for pool creation
• ✅ - Collect signatures from Safe owners
• ✅ - Execute when signature threshold is met
• ✅ - Monitor and manage Safe transaction state

Supporting Infrastructure

• ✅ Comprehensive utility modules (blockchain, validation, error handling, multisig)
• ✅ Contract ABIs for PoolFactory and LendingPool interactions
• ✅ Complete unit test suite with 65+ test cases
• ✅ Detailed API documentation (875+ lines in POOLS_API.md & SAFE_ADMIN_API.md)
• ✅ TypeScript compilation with ES2017 compatibility
• ✅ Support for both Polygon Amoy testnet and mainnet

Technical Achievements

• 23 files changed (4,475+ lines of code)
• 8 new Cloud Functions ready for deployment
• 100% TypeScript compilation success
• Comprehensive error handling with Firebase integration
• Multi-signature security for admin operations

Commit

• Branch:
• Commit: - feat(backend): implement comprehensive Cloud Functions for pool creation via PoolFactory
• Status: Ready for Firebase deployment

All acceptance criteria met and exceeded with additional security enhancements through Safe multi-sig integration.