HarvestChain🐟

Financial inclusion for Filipino Fisherfolk

Introduction

This project is a demo platform of our solution HarvestChain for the APRU Tech Policy Hackathon 2025.
HarvestChain is a blockchain-based digital platform that creates financial inclusion for marginalized Filipino fisherfolk by addressing systemic economic barriers such as lack of national identification, middleman exploitation and volatile income.

Barrier	Consequence
Lack of National Identification	Unable to access formal banking services or government subsidies
Middleman Exploitation	Fisherfolk receive only 30-50% of actual market value, losing significant income to intermediaries
Volatile Income	Monthly income fluctuations up to 70%, making financial planning impossible and trapping families in debt cycles

For the demo, HarvestChain was simplified to present a proof of concept. The demo has 2 main users, Fishermen and Buyers, who are able to create sell and buy smart-contracts to transact on the platform. The platform also offers AI credit scoring, AI smart-contract price helping and pooled lending or insurance services to fishermen.

With its features, HarvestChain aims to break the chains of poverty by providing fisherfolk with verifiable identities, stable incomes, and an escape from predatory lending.

Features

Core Demo platform features

• Self Sovereign Identity(SSI): a blockchain-based verifiable credential that allows financial data collection on fishermen for access of formal financial services in the future
• Micro-Futures Smart Contracts: contracts on a futures market that let fisherfolk lock in prices today for tomorrow's catch, eliminating income volatility and middleman exploitation
• AI Credit Scoring: AI-driven financial profiling that turns fishing history into collateral, making formal loans accessible for the first time
• AI Pricing Helper: Real-time market intelligence that ensures fair valuation and prevents price manipulation by buyers and informational asymmetry
• Pooled Lending and Insurance: Risk-sharing collectives where fisherfolk access affordable credit and protection by leveraging group reliability instead of individual collateral

Technologies

Frontend

Backend

Database

Blockchain & Web3

Setup

In git bash or other terminal:

1. Clone the repository:

   git clone https://github.com/kyashp/harvestchain.git
   

2. Navigate to the project directory:

   cd harvestchain
   

3. Set up the Python virtual environment and install dependencies:

   python -m venv venv
   venv\Scripts\activate   # On Windows
   # or
   source venv/bin/activate  # On macOS/Linux
   pip install -r requirements.txt
   

4. Install Node.js dependencies:

   npm install
   

5. Create a .env.local file in the root directory and add your Openrouter API key:

   VITE_OPENAI_API_KEY=your_openai_api_key_here
   

6. Run the development server:

   npm run dev
   

Smart contracts (Hardhat)

The escrow/oracle contracts live in backend/contracts/, separate from the root workspace.

1. Install and compile:

   cd backend/contracts
   npm install
   npm run build
   

2. Run the local end-to-end simulation (no keys or funds needed, uses Hardhat's in-memory chain):

   npx hardhat run script/smoke.ts
   

3. To deploy to a live testnet, create a .env in backend/contracts/ (gitignored) with:

   SEPOLIA_RPC_URL=your_rpc_url_here
   DEPLOYER_PRIVATE_KEY=your_test_wallet_private_key_here
   

   then run:

   npm run deploy:sepolia
   

Live deployment (Sepolia testnet)

Contract	Address
HarvestChainEscrowAI	0xd26316E6810b5c8528c2c6293740216afc95D8fb
SSIRegistry	0x6C3D495B33DF7D5E269CFC68d8A51d31B3804F30
CreditScoreOracle	0x6De32E91488b6F719f4c56a9755181974A007568
MockAIOracle	0x3E77ba8b720Cf48dD3BCe3f2Ab36141Ab167Fb43
MockDeliveryOracle	0xEfdb0Aaf0f690eA3183Ce072Eb207069600b15aB

Authors

• @kyashp
• @sanjey99
• @ongxinchun
• @thecalebloo
• @leejiajunisaac