Chilundika/SmartProtocol-Zambia

A transformative infrastructure layer for agricultural and aid distribution, moving the sector from a vulnerable "trust-based" model to an immutable "code-verified" model. # PROJECT NAME: SMART PROTOCOL ZAMBIA # Accessible at (Click this --->): SmartProtocol-Zm **A Decentralized Escrow and Milestone Verification Protocol on the Stellar Testnet** SmartProtocol Zambia is a Web3 application designed to bring cryptographically secure, milestone-based funding to agricultural and service subsidies. Developed as an official MVP, this platform utilizes Soroban Smart Contracts to ensure that locked funds are only released to vendors once beneficiaries provide verifiable cryptographic proof of receipt. --- ## Architecture & Tech Stack This project is a full-stack decentralized application (dApp) split into a Rust-based smart contract layer and a modern React frontend. * **Frontend:** Next.js 15 (App Router), React, TypeScript. * **Styling:** Tailwind CSS v4. * **Blockchain Layer:** `@stellar/stellar-sdk` for RPC communication and XDR transaction assembly. * **Smart Contracts:** Soroban / Rust (compiled to WebAssembly). * **Wallet Integration:** Freighter Browser Extension. * **Package Manager:** Yarn (Required for cross-platform Rust binary compilation in Tailwind v4). --- ## Tester's Guide (How to Use the Live App) To interact with the live Testnet environment, users do not need traditional accounts or passwords. Instead, you must use a Stellar-compatible browser wallet. **1. Install & Configure Freighter** * Download the Freighter Browser Extension. * Open the extension, navigate to **Settings (Gear Icon) -> Preferences -> Network**, and select **Testnet**. **2. Fund Your Test Wallet** * Copy your Freighter public key (starts with `G...`). * Visit the Stellar Laboratory Friendbot to instantly fund your wallet with 10,000 free Testnet XLM. **3. Execution Lifecycle** 1. **Funder:** Connect to `/funder`, initialize an escrow with a Vendor and Beneficiary address, and deposit Native XLM. The state moves to `Pending`. 2. **Beneficiary:** Connect to `/beneficiary` and submit the cryptographic Proof Hash to confirm receipt of goods/s …