InvoiceF-Stellar

A decentralized harvest invoice financing protocol built on Stellar. InvoiceFi Stellar enables smallholder farmers to tokenize future crop yields as on-chain invoices and access instant working capital from DeFi liquidity providers via Soroban smart contracts.

The protocol transforms agricultural future yields into tradable financial assets, improving liquidity access for farmers while providing transparent yield-backed opportunities for investors.

---

website rediflow-stellar-capital.lovable.app

Features

Harvest Invoice Tokenization

• Mint crop yield invoices as NFTs
• Represent future harvests as on-chain assets
• Store invoice metadata and valuation data

Invoice Financing

• Discounted invoice financing mechanism
• Liquidity pool funding for invoices
• Instant working capital for farmers
• Risk-adjusted financing rates

Repayment & Settlement

• Yield-based repayment verification
• Automated smart contract settlement
• Transparent repayment tracking
• On-chain fund distribution

Multi-Token Support

• XLM
• USDC
• AQUA

Dashboards

• Farmer dashboard for invoice creation and tracking
• Investor dashboard for financing and portfolio management
• Real-time funding analytics

---

Stack

• Soroban (Rust smart contracts)
• Stellar Blockchain
• Next.js 14 (Frontend)
• NestJS (Backend API)
• PostgreSQL (Database)
• Prisma ORM

---

Architecture

Frontend (Next.js)
        |
        v
Backend API (NestJS)
        |
        v
PostgreSQL Database
        |
        v
Soroban Smart Contracts
        |
        v
Stellar Blockchain

---

Getting Started

Clone Repository

git clone https://github.com/Christopherdominic/InvoiceFi-Stellar.git
cd InvoiceFi-Stellar

Install Dependencies

npm install

Run Development Server

npm run dev

---

Docker – Local Development

Prerequisites

• Docker ≥ 24
• Docker Compose v2 (bundled with Docker Desktop)

Setup

# 1. Copy environment template
cp .env.example .env
# Edit .env with your secrets before proceeding

# 2. Start the full stack
docker compose up --build

Service	URL
Frontend (Next.js)	http://localhost:3000
Backend (NestJS)	http://localhost:4000
Horizon API	http://localhost:8000
Soroban RPC	http://localhost:8001
PostgreSQL	localhost:5432

# Stop containers (keep data volumes)
docker compose down

# Full teardown – removes containers AND volumes
docker compose down -v

Makefile shortcuts

make up       # docker compose up --build
make down     # docker compose down
make clean    # docker compose down -v
make logs     # tail all service logs
make ps       # show running containers
make staging  # start staging stack

Staging

docker compose -f docker-compose.yml -f docker-compose.staging.yml up --build

The staging override switches the Stellar node to testnet, sets NODE_ENV=staging, and removes host-port exposure for the database and Stellar services.

---

Smart Contract Modules

Invoice Contract

Handles:

• Invoice minting
• Metadata storage
• Ownership tracking

Financing Pool Contract

Handles:

• Liquidity provision
• Invoice funding
• Discount logic

Settlement Contract

Handles:

• Repayment processing
• Yield verification
• Fund distribution

---

Project Structure

AgroLedger/
├── contracts/
│   ├── invoice/
│   ├── financing-pool/
│   └── settlement/
│
├── frontend/
│   ├── app/
│   ├── components/
│   ├── hooks/
│   └── lib/
│
├── backend/
│   ├── src/
│   ├── modules/
│   ├── prisma/
│   └── queues/
│
└── README.md

---

Future Roadmap

• Oracle-based crop yield verification
• Insurance layer for harvest risk
• DAO governance for liquidity pools
• Cross-chain invoice financing
• AI-based credit risk scoring
• Mobile farmer onboarding application

---

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push and open a Pull Request

---

License

MIT License

---

Vision

InvoiceFi Stellar aims to unlock agricultural liquidity by transforming future harvests into verifiable on-chain financial instruments, connecting farmers to global decentralized capital markets.