🌐 Live Demo

Transparent Agricultural Payment Network built on Stellar

A production-ready agricultural payment platform that enables transparent, escrow-backed, blockchain-verifiable transactions between farmers and buyers using the Stellar Testnet.

🌐 Live Demo

📖 Overview

TaniChain is a modern full-stack web platform that digitizes agricultural transactions by integrating traditional marketplace workflows with blockchain-backed payment verification.

Instead of relying on manual payment confirmation and opaque transaction records, TaniChain records payment commitments and settlement metadata on the Stellar Testnet, providing transparency, traceability, and trust for both farmers and buyers.

The platform combines a responsive Next.js frontend, an Express.js REST API, PostgreSQL database, Docker-based deployment, Nginx reverse proxy, HTTPS encryption via Let's Encrypt, and Cloudflare DNS/CDN for production-grade hosting.

✨ Key Features

🌱 Farmer product marketplace
💳 Escrow-inspired payment workflow
⛓️ Stellar Testnet transaction recording
🔐 JWT Authentication & Role-Based Access Control (RBAC)
👤 Buyer, Farmer, and Administrator roles
📦 Order management system
💼 Wallet management
📈 Analytics dashboard
📜 Activity logging
🔔 Notification system
📑 Interactive Swagger API Documentation
🐳 Dockerized deployment
🌍 HTTPS production deployment using Nginx + Let's Encrypt + Cloudflare

🛠 Tech Stack

Frontend

Next.js 15
React
TypeScript
Tailwind CSS
Axios

Backend

Express.js
TypeScript
Prisma ORM
JWT Authentication
Swagger OpenAPI
Helmet
Rate Limiter

Database

PostgreSQL 16

Blockchain

Stellar SDK
Stellar Testnet
Horizon API

Infrastructure

Docker
Docker Compose
Nginx Reverse Proxy
Let's Encrypt SSL
Cloudflare DNS & CDN
Ubuntu Server

📂 Project Structure

tanichain/
├── backend/
│   ├── prisma/schema.prisma
│   ├── src/
│   │   ├── config/         # env, database client
│   │   ├── middleware/      # auth, validation, rate limiting, error handling
│   │   ├── modules/
│   │   │   ├── auth/        # register, login, profile
│   │   │   ├── user/        # profile update, change password
│   │   │   ├── wallet/      # Stellar keypair, Friendbot, wallet service, QR codes
│   │   │   ├── escrow/      # platform escrow wallet
│   │   │   ├── product/     # farmer CRUD, buyer browsing
│   │   │   ├── order/       # order lifecycle
│   │   │   ├── payment/     # Payment Commitment + Escrow workflow
│   │   │   ├── transaction/ # transaction history, CSV export
│   │   │   ├── invoice/     # PDF invoice generation
│   │   │   ├── export/      # CSV export helpers
│   │   │   ├── notification/
│   │   │   ├── analytics/   # role-aware + platform-wide analytics
│   │   │   ├── activity/    # audit log
│   │   │   └── admin/       # admin-only management endpoints
│   │   ├── utils/           # jwt, crypto, logger, AppError
│   │   └── swagger/
│   └── Dockerfile
├── frontend/
│   ├── src/
│   │   ├── app/
│   │   │   ├── (landing, /login, /register)
│   │   │   ├── products/, products/[id]/       # marketplace
│   │   │   └── dashboard/
│   │   │       ├── products/, orders/          # farmer/buyer workflows
│   │   │       ├── transactions/, profile/
│   │   │       └── admin/                      # overview, users, products, orders, transactions, wallets, activity
│   │   ├── components/ui/   # shadcn-style primitives
│   │   ├── components/layout/  # DashboardHeader, AdminNav
│   │   ├── components/products/ # ProductForm
│   │   ├── lib/             # api client, formatting, utils
│   │   └── store/           # zustand auth store
│   └── Dockerfile
├── docker/nginx/
├── docs/
├── docker-compose.yml
└── .env.example

🏗 System Architecture

                              Users
                                │
                                │ HTTPS
                                ▼
                         Cloudflare CDN
                                │
                                ▼
                       Let's Encrypt SSL
                                │
                                ▼
                     Nginx Reverse Proxy
                      (HTTPS Termination)
                                │
                ┌───────────────┴───────────────┐
                │                               │
                ▼                               ▼
     Next.js Frontend                 Express Backend
   (React + TypeScript)             (REST API + Prisma)
                │                               │
                │         REST API              │
                └───────────────┬───────────────┘
                                │
                                ▼
                           PostgreSQL 16
                                │
                ┌───────────────┴───────────────┐
                │                               │
                ▼                               ▼
                  Stellar Horizon API      Swagger OpenAPI
                      (Blockchain)         Documentation

🌍 Production Deployment

                           Internet
                              │
                              ▼
                        Cloudflare DNS
                              │
                              ▼
                  tanichain.arvinlabs.tech
                              │
                         HTTPS (TLS)
                              │
                              ▼
                    Ubuntu Server (AWS EC2)
                              │
                        Docker Compose
                              │
                              ▼
        ┌─────────────────────────────────────────────┐
        │                    Nginx                    │
        │                                             │
        │  /           → Frontend (Next.js)           │
        │  /api/*      → Backend (Express.js)         │
        │  /api/docs   → Swagger UI                   │
        └─────────────────────────────────────────────┘
                              │
                              ▼
                     PostgreSQL Database

🔄 Application Flow

                         Buyer / Farmer
                               │
                               ▼
                      Frontend (Next.js)
                               │
                       REST API Request
                               │
                               ▼
                      Express.js Backend
                               │
                      JWT Authentication
                               │
                         Business Logic
                               │
                           Prisma ORM
                               │
                               ▼
                           PostgreSQL
                               │
                               ▼
                            Response
                               │
                               ▼
                     Frontend UI Update

⛓ Blockchain Payment Flow

                             Buyer
                               │
                        Creates Order
                               │
                               ▼
                    Payment Commitment
                               │
                               ▼
                     Backend Validation
                               │
                               ▼
                 Record Metadata to
                    Stellar Testnet
                               │
                               ▼
               Transaction Hash Stored
                      in Database
                               │
                               ▼
                   Farmer Verification
                               │
                               ▼
                     Payment Released

🐳 Docker Architecture

Docker Compose

├── nginx
│      │
│      ├── HTTPS Reverse Proxy
│      ├── SSL Termination
│      └── Route Requests
│
├── frontend
│      │
│      └── Next.js Production Server
│
├── backend
│      │
│      ├── Express API
│      ├── Prisma ORM
│      └── Swagger Docs
│
└── postgres
       │
       └── Persistent Database

🔐 Security Features

TaniChain is designed with security-first principles and includes multiple layers of protection.

Authentication

JWT Authentication
Secure password hashing
Role-Based Access Control (RBAC)
Protected API endpoints

API Security

Helmet Security Headers
Rate Limiting
Input Validation
Centralized Error Handling
CORS Protection

Infrastructure Security

HTTPS via Let's Encrypt
Cloudflare DNS & CDN
Nginx Reverse Proxy
Secure Docker Network
Environment Variable Management

🚀 Getting Started

Prerequisites

Before running TaniChain, make sure the following software is installed:

Docker
Docker Compose
Git
Node.js 20+ (optional for local development)
PostgreSQL 16 (optional for local development)

📥 Clone Repository

git clone https://github.com/ArvinFarrelP/tanichain.git

cd tanichain

⚙ Environment Variables

Copy the example environment file.

cp .env.example .env

Edit the configuration as needed.

Example:

POSTGRES_USER=tanichain
POSTGRES_PASSWORD=your_password
POSTGRES_DB=tanichain

JWT_SECRET=your_super_secret

WALLET_ENCRYPTION_KEY=your_encryption_key

STELLAR_NETWORK=TESTNET
STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org
STELLAR_FRIENDBOT_URL=https://friendbot.stellar.org

CORS_ORIGIN=https://tanichain.arvinlabs.tech

NEXT_PUBLIC_API_URL=https://tanichain.arvinlabs.tech/api

🐳 Docker Deployment (Recommended)

Build every container.

docker compose build

Run all services.

docker compose up -d

Check running containers.

docker ps

Expected containers:

tanichain-nginx
tanichain-frontend
tanichain-backend
tanichain-postgres

📊 Check Container Health

docker ps

Expected output:

STATUS

tanichain-nginx        healthy
tanichain-frontend     healthy
tanichain-backend      healthy
tanichain-postgres     healthy

🧪 Health Check API

Backend Health Endpoint

curl https://tanichain.arvinlabs.tech/api/health

Response

{
  "success": true,
  "message": "TaniChain API is healthy"
}

🌐 Production Deployment

TaniChain is deployed using Docker Compose on Ubuntu Server with Nginx Reverse Proxy and HTTPS.

Production URLs

Website

https://tanichain.arvinlabs.tech

Swagger Documentation

https://tanichain.arvinlabs.tech/api/docs

API Endpoint

https://tanichain.arvinlabs.tech/api

🔒 HTTPS Configuration

Production deployment includes:

Let's Encrypt SSL Certificate
Automatic HTTP → HTTPS Redirect
TLS 1.2 / TLS 1.3
Nginx Reverse Proxy
Cloudflare DNS
Dockerized Infrastructure

💻 Local Development

Backend

cd backend

npm install

npx prisma generate

npx prisma migrate dev

npm run dev

Backend runs on

http://localhost:4000

Frontend

cd frontend

npm install

npm run dev

Frontend runs on

http://localhost:3000

📖 API Documentation

Swagger UI

Production

https://tanichain.arvinlabs.tech/api/docs

Development

http://localhost:4000/api/docs

OpenAPI JSON

http://localhost:4000/api/docs.json

🛠 Useful Docker Commands

Build images

docker compose build

Start containers

docker compose up -d

Stop containers

docker compose down

Restart

docker compose restart

View logs

docker compose logs -f

Check running containers

docker ps

Open backend shell

docker compose exec backend sh

Open PostgreSQL

docker compose exec postgres psql -U tanichain

🚀 Detailed Features

👥 Multi-Role Authentication

TaniChain supports Role-Based Access Control (RBAC) with four different user roles.

Role	Permissions
👨‍🌾 Farmer	Manage products, receive orders, track payments
🛒 Buyer	Browse marketplace, purchase products, view transactions
🏢 Cooperative	Manage cooperative-related activities (future expansion)
👑 Administrator	Full platform management and analytics

Authentication features include:

JWT Authentication
Password Hashing (bcrypt)
Protected Routes
Role-Based Authorization (RBAC)
Secure Session Management

🌱 Marketplace

Farmers can publish agricultural products while buyers can browse available commodities in real time.

Farmer Features

Create Products
Update Products
Archive Products
Inventory Management
Product Categories
Stock Management

Buyer Features

Browse Marketplace
Product Detail
Search Products
Category Filtering
Pagination
Purchase Products

💳 Payment Commitment Workflow

Instead of relying on traditional payment confirmation, TaniChain introduces a transparent payment commitment process backed by Stellar Testnet transactions.

Workflow:

                           Buyer
                             │
                             ▼
                      Create Order
                             │
                             ▼
                   Payment Commitment
                             │
                             ▼
               Record Metadata to Stellar
                      Testnet Blockchain
                             │
                             ▼
                  Farmer Confirmation
                             │
                             ▼
                    Payment Released

This provides:

Transparent payments
Immutable transaction records
Verifiable blockchain history
Escrow-inspired settlement workflow

⛓️ Blockchain Integration

TaniChain integrates with the Stellar Testnet to provide secure and transparent payment verification.

Features include:

Automatic Wallet Creation
Friendbot Funding
Stellar SDK Integration
Horizon API
Transaction Explorer Links
Blockchain Transaction History
Wallet Balance Tracking

Every registered user automatically receives:

Stellar Wallet
Public Key
Encrypted Secret Key
Initial Testnet Balance

💼 Wallet Management

Each user owns a blockchain wallet.

Features include:

Wallet Address
Current Balance
QR Code Generation
Transaction History
Payment QR
Blockchain Explorer Link

📦 Order Management

Complete order lifecycle management.

Supported order states include:

Pending
Payment Committed
Paid
Processing
Delivered
Completed
Cancelled

Users can:

View Orders
Track Status
Search Orders
Filter Orders
Download Invoice

📑 PDF Invoice

Every completed order can generate a professional invoice.

Invoice includes:

Buyer Information
Farmer Information
Product Details
Quantity
Total Price
Payment Status
Blockchain Transaction Hash
Order Date

📤 CSV Export

Users can export data into CSV format.

Supported exports:

Transactions
Products
Orders

Administrator exports:

Users
Products
Orders
Transactions

📊 Analytics Dashboard

Interactive dashboards provide valuable insights into platform activities.

Dashboard Features

Revenue Summary
Monthly Revenue
Wallet Balance
Pending Orders
Completed Orders
Transaction Statistics
Charts & Graphs

Built using:

Recharts
React
TypeScript

👑 Administrator Features

Administrators have complete visibility over the platform.

Features include:

User Management
Product Management
Order Management
Transaction Management
Wallet Monitoring
Activity Logs
Platform Analytics

🔔 Notification System

Real-time notifications are generated for important events.

Notifications include:

New Order
Payment Committed
Payment Released
Delivery Confirmation
Transaction Updates

📜 Activity Logs

Every important action is recorded.

Examples:

User Login
Registration
Product Creation
Product Update
Order Creation
Payment Commitment
Transaction Completion

Administrators can monitor all platform activities.

⭐ Project Highlights

✔ Production-ready deployment

✔ Live production deployment on AWS EC2

✔ Custom domain with HTTPS

✔ Let's Encrypt SSL Certificate

✔ Cloudflare DNS & CDN integration

✔ Dockerized infrastructure

✔ Docker Compose deployment

✔ Nginx Reverse Proxy

✔ RESTful API architecture

✔ PostgreSQL database

✔ Swagger OpenAPI Documentation

✔ Role-Based Access Control (RBAC)

✔ Blockchain-powered payment verification

✔ Stellar Testnet integration

✔ Modern UI built with Next.js 15

✔ TypeScript across frontend and backend

✔ Responsive web application

✔ Interactive analytics dashboard

📸 Screenshots

Below are screenshots of the current TaniChain application.

🌐 Landing Page

🛒 Marketplace

📊 User Dashboard

💰 Payment Commitment

🌌 Stellar Testnet Explorer

TaniChain integrates with the Stellar Testnet using the Stellar SDK and Horizon API. Every registered user automatically receives a funded Stellar wallet, and payment transactions can be publicly verified through Stellar Expert.

Wallet Explorer

View the wallet on Stellar Expert:

https://stellar.expert/explorer/testnet/account/GD7ID4IKVS3ZYCBYMDZ2VWAB7YAINYF3BAIRGVUBEQX2Q4TBG535YVOV

Transaction History

Sample Transaction

View the transaction on Stellar Expert:

https://stellar.expert/explorer/testnet/tx/8df5a31782b1b3c244048519cb7aaa22faa1f6a6b3f348e5376ca3f349ad7e77

📖 Swagger API Documentation

📚 API Overview

Module	Description
Authentication	User registration & login
Products	Marketplace product management
Orders	Buyer & farmer order workflow
Transactions	Payment history
Wallet	Stellar wallet management
Analytics	Dashboard statistics
Notifications	User notifications
Activity	Audit logs
Administration	Platform management

⛓️ Stellar Integration

TaniChain integrates directly with the Stellar Testnet using the Stellar SDK and Horizon API.

Current implementation includes:

Automatic Stellar wallet creation
Friendbot wallet funding
Payment commitment recording
Transaction verification
Explorer transaction links

This project currently does not deploy a Soroban Smart Contract.

Instead, payment commitments are implemented through Stellar accounts and blockchain transaction verification.

Future releases will extend the payment workflow using Soroban Smart Contracts.

📂 Documentation

Additional project documentation is available inside the docs/ directory.

Document	Description
API.md	REST API Reference
DEPLOYMENT.md	Production Deployment Guide
SECURITY.md	Security Review
PROGRESS.md	Development Progress

🧪 Testing

Verify that all services are running correctly after deployment.

Start the Application

docker compose up --build -d

Check Running Containers

docker ps

Expected containers:

tanichain-nginx
tanichain-frontend
tanichain-backend
tanichain-postgres

Health Check

curl https://tanichain.arvinlabs.tech/api/health

Expected response:

{
  "success": true,
  "message": "TaniChain API is healthy"
}

Swagger Documentation

Open:

https://tanichain.arvinlabs.tech/api/docs

🛣️ Roadmap

Future improvements planned for TaniChain.

Blockchain

Soroban Smart Contract Escrow
Multi-Signature Wallet
Stellar Mainnet Deployment
Cross-border Payments

Marketplace

Product Images
Product Reviews
Wishlist
Shopping Cart
Farmer Verification Badge

Payments

QR Payment
Automatic Escrow
Partial Payments
Payment History Export

Infrastructure

CI/CD Pipeline
Kubernetes Deployment
Redis Cache
Prometheus Monitoring
Grafana Dashboard

Mobile

Android Application
iOS Application
Push Notifications

🤝 Contributing

Contributions are welcome!

Fork this repository
Create a new branch

git checkout -b feature/my-feature

Commit your changes

git commit -m "feat: add amazing feature"

Push your branch

git push origin feature/my-feature

Open a Pull Request

📄 License

This project is released under the MIT License.

See the LICENSE file for more information.

🙏 Acknowledgements

This project would not have been possible without these amazing technologies and communities.

Stellar Development Foundation
Stellar SDK
Horizon API
Next.js
Express.js
PostgreSQL
Prisma ORM
Docker
Nginx
Tailwind CSS
TypeScript
Swagger OpenAPI
Cloudflare
Let's Encrypt

🏆 APAC Stellar Hackathon 2026

Track

Local Finance & Real World Access

Project

TaniChain

Core Idea

TaniChain leverages Stellar to create a transparent agricultural payment network where payment commitments are securely recorded on-chain, enabling trusted transactions, reducing payment disputes, and improving financial accessibility for farmers and buyers.

👨‍💻 Author

Arvin Farrel Pramuditya

Backend Engineer • Blockchain Developer • Open Source Contributor

GitHub https://github.com/ArvinFarrelP

LinkedIn https://linkedin.com/in/ArvinFarrelP

📬 Project Contact

For questions, feedback, partnerships, or collaboration:

Email hello.tanichain@gmail.com

Project Repository https://github.com/ArvinFarrelP/tanichain

🌾 TaniChain

Transparent Agricultural Payment Network powered by Stellar

Built with ❤️ using

Next.js • Express.js • PostgreSQL • Docker • Nginx • Stellar Testnet

⭐ If you found this project interesting, consider giving it a star!

Name		Name	Last commit message	Last commit date
backend		backend
docker/nginx		docker/nginx
docs		docs
frontend		frontend
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml

Latest commit

History

Folders and files

Repository files navigation

🌐 Live Demo

Website

API Documentation

GitHub Repository

📖 Overview

✨ Key Features

🛠 Tech Stack

Frontend

Backend

Database

Blockchain

Infrastructure

📂 Project Structure

🏗 System Architecture

🌍 Production Deployment

🔄 Application Flow

⛓ Blockchain Payment Flow

🐳 Docker Architecture

🔐 Security Features

Authentication

API Security

Infrastructure Security

🚀 Getting Started

Prerequisites

📥 Clone Repository

⚙ Environment Variables

🐳 Docker Deployment (Recommended)

📊 Check Container Health

🧪 Health Check API

🌐 Production Deployment

Production URLs

🔒 HTTPS Configuration

💻 Local Development

Backend

Frontend

📖 API Documentation

🛠 Useful Docker Commands

🚀 Detailed Features

👥 Multi-Role Authentication

🌱 Marketplace

Farmer Features

Buyer Features

💳 Payment Commitment Workflow

⛓️ Blockchain Integration

💼 Wallet Management

📦 Order Management

📑 PDF Invoice

📤 CSV Export

📊 Analytics Dashboard

👑 Administrator Features

🔔 Notification System

📜 Activity Logs

⭐ Project Highlights

📸 Screenshots

🌐 Landing Page

🛒 Marketplace

📊 User Dashboard

💰 Payment Commitment

🌌 Stellar Testnet Explorer

Wallet Explorer

Transaction History

Sample Transaction

📖 Swagger API Documentation

📚 API Overview

⛓️ Stellar Integration

📂 Documentation

🧪 Testing

Start the Application

Check Running Containers

Health Check

Swagger Documentation

🛣️ Roadmap

Blockchain

Marketplace

Payments

Infrastructure