Utiliterian/Agropush-backend

Amana backend (Node.js/TypeScript API) - split from AgroPush monorepo # 🌾 Amana Backend Service The official Node.js/TypeScript backend for **Amana**, a decentralized escrow protocol designed to secure agricultural trade across different regions. Amana eliminates the "Trust Gap" between buyers and sellers using Soroban Smart Contracts on the Stellar network, ensuring fair trade even when parties are hundreds of miles apart. ## About Amana **Amana** provides a programmable safety net for regional commodity trading: - **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) for handling transit accidents - **Proof-of-Delivery (PoD)**: Mandatory video-based verification involving buyer and driver - **Automated Settlement**: Flat 1% platform fee deducted upon successful trade completion - **Volatility Protection**: Stellar Path Payments allow users to pay in local currency (NGN) while locking value in cNGN ## Backend Responsibilities This service provides the API and infrastructure integration layer for the Amana escrow protocol. It handles trade orchestration, Supabase metadata, IPFS/Pinata uploads, Stellar payment bridging, and OpenTelemetry tracing. ## Features - Node.js + TypeScript backend service - Express API server - Prisma ORM for database access - Supabase integration for off-chain metadata - Pinata SDK for IPFS uploads - Stellar SDK for transaction and wallet interactions - OpenTelemetry tracing with Jaeger/Prometheus/Zipkin exporters - Jest test suite for backend behavior ## Getting Started ### Prerequisites - Node.js 20+ / npm - Access to required environment variables - Supabase database and/or Redis as required by your environment ### Install dependencies ```bash cd backend npm install ``` ### Environment Copy the example env files and configure your secrets: ```bash cp .env.example .env cp .env.tracing.example .env.tracing ``` ### Run in development ```bash npm run dev ``` ### Build ```bash npm r …