KingFRANKHOOD/Amana

Amana is a decentralized escrow protocol built on the Stellar Network. It facilitates secure, inter-regional agricultural trade by using Soroban Smart Contracts to act as a neutral third party. # 🌾 Amana: Trust as a Service for Agricultural Products -orange?style=for-the-badge>) **Amana** is a decentralized escrow protocol designed to secure agricultural trade across different regions. By leveraging **Soroban Smart Contracts**, Amana eliminates the "Trust Gap" between buyers and sellers, ensuring fair trade even when parties are hundreds of miles apart. This is the main repository containing the smart contracts and orchestration logic. Backend, frontend, and mobile applications are maintained in this monorepo for simpler development and unified deployment. --- ## 🚀 The Mission To provide a programmable safety net for regional commodity trading. Amana ensures that the risk of "sending first" is eliminated, replaced by a secure, neutral vault that only releases funds when delivery is verified. ## 🛠 Features - **Smart Escrow:** Secure funds holding using cNGN/stablecoins on the Stellar network. - **Dynamic Loss Sharing:** Negotiable risk-sharing ratios (e.g., 50/50, 70/30) hardcoded into every trade to handle transit accidents or theft. - **Proof-of-Delivery (PoD):** An optional video-based verification protocol involving the buyer and the driver to confirm the state of goods. Video evidence can be submitted and stored on IPFS for dispute resolution. - **Volatility Protection:** Utilizes Stellar Path Payments to allow users to pay in local currency (NGN) while locking value in cNGN. - **Automated Settlement:** A flat 1% platform fee is automatically deducted upon successful trade completion. ## 🏗 Technical Stack - **Frontend:** Next.js (App Router) - **Smart Contracts:** Soroban (Rust) - **Blockchain:** Stellar Network - **Wallet Connection:** Freighter / Albedo - **Storage:** IPFS (via Pinata) for decentralized storage of video evidence. - **Database:** Supabase (Off-chain metadata, driver logs, and user profiles). - **Observability:** OpenTelemetry distributed tracing with correlation IDs for end-to-end request tracking. ## 🧪 Local Environments …