Skip to content

code-flexing/Harvest-Finance

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

124 Commits
 
 
 
 
 
 

Repository files navigation

Harvest Finance Logo
🌾 Harvest Finance

Empowering smallholder farmers through blockchain-based supply chain financing on Stellar

License: MIT Stellar PRs Welcome Discord


🎯 The Vision

Harvest Finance addresses the $1.5 trillion trade finance gap for smallholder farmers. By leveraging the Stellar blockchain, we provide:

  • Pre-Funding: Upfront capital at 60-80% for confirmed orders.
  • Smart Escrow: Automated, trustless payments via Stellar Claimable Balances.
  • Zero Hidden Fees: Transaction costs under $0.00001 with 5s settlement.
  • Reputation Scoring: On-chain credit history built from real transaction data.

🏗️ Architecture Stack

Core Technology

  • Blockchain: Stellar Network (Smart contracts, Escrow, Payments)
  • Backend API: NestJS (Node.js, TypeScript, PostgreSQL, TypeORM, Redis)
  • Frontend: Next.js 15 (React, TailwindCSS, Framer Motion)
  • Wallet Integration: Freighter API & Stellar SDK

Repository Structure

harvest-finance/
├── backend/              # NestJS API & Database logic
├── frontend/             # Next.js Dashboard & Mobile interfaces
└── contracts/            # Smart contract logic & Soroban (Optional)

🚀 Quick Local Setup

Ready to contribute? Get the project running in under 5 minutes:

1. Prerequisites

  • Node.js 18+ & npm
  • PostgreSQL 14+
  • Redis 6+

2. Fast-Track Setup

# Clone the repository
git clone https://github.com/code-flexing/Harvest-Finance.git
cd Harvest-Finance

# Setup Backend
cd harvest-finance/backend
npm install && cp .env.example .env
npm run migration:run && npm run start:dev

# Setup Frontend (New Terminal)
cd harvest-finance/frontend
npm install && cp .env.example .env
npm run dev

Visit http://localhost:3000 🎉


📚 Resources & Support


🤝 Contributing

We welcome contributions of all sizes! Whether it's fixing a typo, optimizing a database query, or adding a new feature.

  1. Find an issue labeled good-first-issue.
  2. Comment to claim the task.
  3. Follow the Contribution Workflow.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ for farmers worldwide 🌾

About

Empowering smallholder farmers through blockchain-based supply chain financing on Stellar

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages