A transparent agricultural supply chain platform
Batches registered on-chain with purchases via Stripe; a verifier account transfers ownership on-chain after payment.

The following technologies power FarmLedge, along with their icons and usage:

Frontend

Technology	Icon	Usage
React		Building interactive UI components and managing state.
Vite		Fast dev server & build tool with HMR.
TypeScript		Static typing for safer, scalable code.
Tailwind CSS		Utility-first CSS framework for rapid styling.
shadcn UI		Tailwind-based component library for consistent design.

Backend

Technology	Icon	Usage
Node.js		Server runtime for APIs and blockchain interactions.
Express		Web framework for RESTful endpoints.
Stripe		Payment processing and webhook handling.
Viem		Ethereum library for Arbitrum Sepolia interactions.

Smart Contract

Technology	Icon	Usage
Solidity		Writing AgriTruthChain smart contract.

Utilities & DevOps

Technology	Icon	Usage
npm		Dependency management and scripts.
GitHub Actions		CI/CD workflows for automated testing and deployment.
Docker (opt.)		Containerization for consistent environments.

🎯 Key Features

• INR-Only On-Chain Pricing
  Set farm-gate, distributor, and retailer prices in rupees—all stored on the blockchain.
• Off-Chain Payments with Stripe
  Secure checkout and webhooks trigger ownership transfers.
• Verifier-Based Transfers
  Only approved relayers can call transferOwnershipByVerifier.
• Lean Reads & Fast UI
  Recent batches timeline with search, skeleton loaders, and detail modals.
• Idempotent Webhooks
  Automatic duplicate-write protection (handles nonce errors).

� Verifier UX & Workflow (Latest)

• Themed Verify Modal
  Verifiers get a themed dialog to confirm and enter a passkey before marking a batch as Verified.
• Search & Sorting on Verifier Dashboard
  Quickly filter by ID, crop, or holder and sort by ID, quantity, or crop (asc/desc). Verified batches remain hidden.
• One-way Verification Rules
  Verified items cannot be edited; only allowed transitions between unverified and pending before final verify.
• i18n Coverage
  English, Tamil, Hindi, and Odia across Navigation, Hero, Login, Index, and Verifier flows.

�📦 Prerequisites

• Node.js ≥ 18
• npm
• Stripe test account (API keys)
• Arbitrum Sepolia RPC URL + funded relayer private key
• Deployed AgriTruthChain contract address

🔧 Local Setup

# Clone the repo
git clone https://github.com/blackscythe123/FarmLedge.git
cd FarmLedge

# Install dependencies
npm install
cd server && npm install && cd ..

# Configure environment
cp server/.env.example server/.env
# Populate server/.env:
# STRIPE_SECRET_KEY=sk_test_...
# STRIPE_WEBHOOK_SECRET=whsec_...
# PORT=3001
# AGRI_TRUTH_CHAIN_ADDRESS=0xYourDeployedContract
# RELAYER_PRIVATE_KEY=your_funded_sepolia_private_key
# OWNER_PRIVATE_KEY=optional_owner_key_for_verifier_setup
# ARB_SEPOLIA_RPC_URL=https://sepolia-rollup.arbitrum.io/rpc

# Start backend & frontend
npm run server:dev     # runs backend on port 3001
npm run dev            # runs frontend on port 8000

Open http://localhost:8000 in your browser.

🔑 One-Time Verifier Setup

curl -X POST http://localhost:3001/api/setup-relayer-as-verifier

or if native binary not working

Invoke-RestMethod -Method Post -Uri http://localhost:3001/api/setup-relayer-as-verifier | ConvertTo-Json -Depth 6

Response returns a transaction hash on success.

🔄 Core Flows

1. Register Batch
   POST /api/register-batch → writes batch + farmer price on-chain.
2. Purchase
   • Create Stripe session: POST /create-checkout-session
   • On webhook, server calls transferOwnershipByVerifier and optionally sets next price.
3. View Batches
   • GET /api/batches → list of batches with computed fallbacks & timestamps
   • GET /api/batch/:id → detailed batch info
4. Price Updates
   • Distributor: POST /api/set-price-by-distributor
   • Retailer: POST /api/set-price-by-retailer
5. Fallback
   POST /api/confirm-payment if webhook fails.

📑 API Endpoints

ℹ️ API Documentation Link

The footer "API Documentation" link points to this README’s API section on GitHub:
https://github.com/blackscythe123/FarmLedge#api-endpoints

🎨 Frontend Highlights

• Recent Batches Timeline
  Paginated view (3 per page), searchable by Batch ID on Index. Status badges (Unverified/Pending/Verified) visible.
• Verifier Dashboard
  Search + sort controls, themed verification modal with passkey, and strict one-way transitions.
• Footer Resources
  Includes a GitHub link to the repo and API Documentation linking back to this README’s API section.

🛠️ Scripts

// package.json (root)
{
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview",
    "server:dev": "node server/src/index.js",
    "server": "node server/src/index.js"
  }
}

// server/package.json
{
  "scripts": {
    "dev": "node --watch src/index.js",
    "start": "node src/index.js"
  }
}

⚠️ Troubleshooting

• Webhook Signature Errors
  Ensure STRIPE_WEBHOOK_SECRET matches your Stripe CLI/webhook config.
• Contract Address Issues
  Verify AGRI_TRUTH_CHAIN_ADDRESS points to your deployed contract (not an EOA).
• Relayer Setup
  Confirm RELAYER_PRIVATE_KEY has sufficient Sepolia ETH.
• Pricing Mismatch
  Stripe sends amounts in paise; contract stores rupees—convert appropriately.

🔒 Security & Data

• On-Chain: Public data (batch IDs, owners, INR prices)
• Off-Chain: Minimal session & role data; Stripe handles payment details
• Idempotency: Webhooks are idempotent to avoid duplicate blockchain writes