kida21/SafeDeal

SafeDeal is a hybrid escrow platform that combines the regulatory compliance of online payment systems with the transparency of blockchain technology. The system uses Chapa for Ethiopian Birr (ETB) transactions while leveraging Ethereum to maintain an immutable, auditable record of transaction states. # SafeDeal - Blockchain-Powered Escrow System ## Table of Contents - Description - Features - Architecture Overview - Technology Stack - Getting Started ## Description SafeDeal is a hybrid escrow platform that combines the regulatory compliance of online payment systems with the transparency of blockchain technology. The system uses Chapa for Ethiopian Birr (ETB) transactions while leveraging Ethereum to maintain an immutable, auditable record of transaction states. This approach provides users with the familiarity of local payment methods and the security benefits of decentralized verification. ## Features - **Hybrid Payment Model**: ETB transactions through Chapa with blockchain state logging - **User Wallet Management**: Auto-generated Ethereum wallets with secure private key encryption - **On-chain State Verification**: Immutable tracking of escrow status (AWAITING_PAYMENT → ACTIVE → CLOSED) - **Event-Driven Architecture**: RabbitMQ for asynchronous communication between services - **Secure Authentication**: JWT-based auth with session revocation and refresh token rotation - **Multi-Service Architecture**: Microservices for user management, payments, escrow, and blockchain interaction - **Webhook Integration**: Secure handling of Chapa payment confirmations - **Consul Service Discovery**: Dynamic service registration and discovery - **Dockerized Deployment**: Containerized services with Docker Compose ## Architecture Overview SafeDeal implements a **hybrid escrow architecture** that strategically separates financial operations from state management: ### Core Design Principles 1. **Regulatory Compliance**: All ETB funds flow through Chapa's regulated payment system 2. **Blockchain Transparency**: Ethereum smart contracts maintain an immutable record of transaction states 3. **Decoupled Services**: Microservices communicate via gRPC and RabbitMQ 4. **User-Centric Design**: Wallet creation is opt-in, ensuring user consent ### Workflow 1. **Escr …