Hamza Market
Joined the team after MVP launch to support ongoing development, feature optimization, and team coordination for a decentralized e-commerce platform bridging Web2 retail with Web3 payments.
The Problem
Post-MVP Challenges
After the MVP launch, the platform needed optimization and scaling support. Critical issues were emerging—checkout errors blocking users, merchant onboarding bottlenecks, and team coordination gaps that were slowing feature development.
Technical Debt & Complexity
The existing system struggled with synchronizing traditional e-commerce databases (MedusaJS) with blockchain states (EVM/Bitcoin). Complex state management issues, multi-chain support challenges, and real-time transaction polling needed refinement and optimization.
User Experience Issues
Critical bugs were impacting user experience—mobile white screen errors and race conditions in the checkout process were blocking users from completing purchases. The hybrid Web2/Web3 flows needed stabilization and optimization.
Constraints & Considerations
- Multi-chain Support — Supporting Polygon, Mantle, and Bitcoin required different payment flows and transaction confirmation mechanisms, each with unique timing and UX requirements.
- State Synchronization — Real-time blockchain polling was needed for transaction confirmation before finalizing orders, requiring an intermediate Payment Status page between Checkout and Thank You.
- Team Coordination — Bridging technical requirements with the design team to ensure Web3 flows were user-friendly, translating backend limitations into frontend requirements and design specifications.
- Bulk Operations — High-volume merchants like BigWater and DePIN required efficient data pipelines for bulk product management, CSV import/export, and inventory synchronization.
Approach & Execution
Joined the team to help optimize existing systems, develop new features, and coordinate ongoing development efforts. Focused on improving merchant onboarding workflows, stabilizing checkout flows, enhancing developer experience, and bridging communication between technical and design teams.
Seller Admin & Data Engineering
Developed robust data pipelines to support high-volume merchant onboarding. Built a CSV import/export system for bulk product management, supporting multi-dimensional variants, inventory synchronization, and multi-currency pricing (USDC/USDT/ETH). Refactored existing architecture by separating CsvUploadService from ProductService to improve modularity and maintainability. Enhanced validation layers to prevent data corruption during bulk updates.
Storefront & Web3 Integration
Developed the Payment Status Page as an intermediate state between Checkout and Thank You, which polls the blockchain for transaction confirmation before finalizing orders. Enhanced multi-chain support including Polygon, Mantle, and a manual flow for Bitcoin payments with QR code generation and timer-based expiration. Built the Release Escrow utility allowing buyers to verify orders on-chain and release funds to sellers.
Checkout Stabilization
Diagnosed and fixed critical white screen errors on mobile devices caused by wallet connection states during checkout. Resolved race conditions involving the clearCart() function that was causing checkout hangs and data inconsistencies. Refactored Shipping Address logic to ensure persistence and proper validation throughout the checkout flow.
Team Leadership & UI/UX Coordination
Served as the bridge between technical requirements and design team, translating backend limitations into frontend requirements. Defined specific states (waiting, received, in_escrow) required for the Payment Status page. Coordinated with designers on "Pay with Crypto" button terminology, mobile search UI improvements, and Thank You page layout for multi-vendor order splitting. Authored Frontend Standard Operating Procedures (SOP) defining best practices for Tanstack Query, Mutations, and Zustand state management.
DevOps & Developer Experience
Created and maintained project setup scripts (HamzaSetup) allowing new developers to spin up the complex Web2/Web3 environment quickly. Implemented and documented Cypress (E2E) and Jest (Unit) test suites to ensure API reliability and frontend stability. Migrated transaction email system from AWS SES to SMTP2GO to resolve delivery reliability issues for digital products like gift cards.
Outcome & Impact
Platform Stability Improvements
Resolved critical checkout issues that were blocking users, enabling seamless mobile commerce. Fixed white screen errors and race conditions, resulting in successful transaction completion rates across all supported chains. The improvements significantly reduced checkout abandonment.
Merchant Onboarding Optimization
Developed bulk data pipelines that streamlined onboarding for high-volume sellers like BigWater and DePIN. The CSV import/export system reduced product setup time from days to hours, enabling merchants to manage complex variant structures and multi-currency pricing efficiently.
Team Development & Coordination
Standardized setup scripts and testing infrastructure improved overall team velocity. Created Frontend SOP documentation and implemented automated test suites (Cypress, Jest) that reduced onboarding time for new developers and improved code quality through better testing coverage.
Enhanced Payment Infrastructure
Improved multi-chain support expanded payment options, enabling customers to pay with Polygon, Mantle, or Bitcoin. The Payment Status Page architecture ensured reliable order fulfillment with blockchain verification, while the escrow logic provided security for both buyers and sellers.
In hybrid Web2/Web3 systems, technical complexity must be abstracted into intuitive user experiences. The challenge isn't just building the bridge between databases and blockchains—it's making that bridge invisible to users.