CropChain: Blockchain-Powered Agricultural Traceability

CropChain is a full-stack blockchain application demonstrating an agricultural product traceability solution using a hybrid approach. It leverages Hyperledger Fabric for an immutable audit trail, MySQL for scalable off-chain data storage, and IPFS for decentralized file storage.

📸 Application Screenshots

Dashboard View

Main dashboard showing product overview and blockchain connectivity status.

Product Management Interface

Product management interface for creating, shipping, and tracking agricultural products.

🌟 Features

✅ Immutable Product Tracking - Track agricultural products on the blockchain
📊 Complete History - View full product lifecycle and ownership changes
📦 Supply Chain Management - Ship and receive products between parties
🔐 Decentralized Storage - Upload certificates and documents to IPFS
📱 QR Code Generation - Generate QR codes for product traceability
🎨 Modern UI - React-based responsive user interface with Tailwind CSS
🔗 Hybrid Architecture - Combines blockchain immutability with database scalability

🏗️ Architecture

┌─────────────────┐
│   React UI      │
│  (Port 3000)    │
└────────┬────────┘
         │
┌────────▼────────────────────────────────────┐
│         Node.js/Express Backend             │
│  • REST API                                 │
│  • Fabric Gateway SDK                       │
│  • MySQL Connection Pool                    │
│  • IPFS Client                              │
└───┬─────────┬────────────┬──────────────────┘
    │         │            │
    │    ┌────▼─────┐  ┌───▼──────┐
    │    │  MySQL   │  │   IPFS   │
    │    │  (3306)  │  │  (5001)  │
    │    └──────────┘  └──────────┘
    │
┌───▼─────────────────────────────────────────┐
│      Hyperledger Fabric Network             │
│  • Orderer (7050)                           │
│  • Peer (7051)                              │
│  • CA (7054)                                │
│  • Chaincode (Go)                           │
└─────────────────────────────────────────────┘

🚀 Core Technologies

Component	Technology	Version
Blockchain	Hyperledger Fabric	2.2.0
Backend	Node.js + Express.js	18.x
Frontend	React + Tailwind CSS	18.2.0
Database	MySQL	8.0
File Storage	IPFS	Latest
Containerization	Docker + Docker Compose	Latest
Smart Contract	Go (Golang)	1.x

📁 Project Structure

cropchain-project/
├── app.js                      # Main Express application
├── package.json                # Backend dependencies
├── Dockerfile                  # Application container
├── docker-compose.yml          # Multi-container orchestration
├── start-network.ps1           # Windows startup script
├── start-network.sh            # Linux/Mac startup script
├── TROUBLESHOOTING.md          # Detailed troubleshooting guide
│
├── chaincode/                  # Hyperledger Fabric Smart Contract
│   ├── cropchain.go           # Go chaincode implementation
│   └── go.mod                 # Go module dependencies
│
├── fabric-network/            # Fabric network configuration
│   ├── configtx.yaml         # Channel configuration
│   ├── crypto-config.yaml    # Crypto material configuration
│   ├── connection-org1.yaml  # Fabric SDK connection profile
│   ├── crypto-config/        # Generated certificates and keys
│   └── channel-artifacts/    # Channel configuration files
│
├── scripts/                   # Setup and deployment scripts
│   ├── setup-fabric.sh       # Network initialization
│   ├── setup-channel.sh      # Channel setup
│   ├── deploy-chaincode.sh   # Chaincode deployment
│   └── generate-artifacts.sh # Crypto material generation
│
├── ui/                        # React frontend
│   ├── src/
│   │   ├── App.jsx           # Main React component
│   │   ├── main.jsx          # React entry point
│   │   └── index.css         # Tailwind CSS styles
│   ├── vite.config.js        # Vite build configuration
│   ├── tailwind.config.js    # Tailwind configuration
│   └── package.json          # Frontend dependencies
│
├── db/
│   └── init.sql              # MySQL database initialization
│
├── bin/                       # Fabric binaries
│   ├── cryptogen             # Certificate generator
│   ├── configtxgen           # Configuration generator
│   └── peer                  # Peer CLI tool
│
└── wallet/                    # Fabric identity wallet (generated)

🔧 Prerequisites

Docker Desktop (Windows/Mac) or Docker Engine (Linux)
Git Bash or WSL (for Windows users)
8GB RAM minimum
20GB free disk space

🚀 Quick Start (Windows)

Step 1: Start the Blockchain Network

.\start-network.ps1

This script will:

Stop and clean existing containers
Start orderer, peer, and CA services
Create the channel cropchainchannel
Join the peer to the channel

Step 2: Deploy the Chaincode

# Use Git Bash or WSL
bash scripts/deploy-chaincode.sh

Or manually:

# Package chaincode
docker exec cli peer lifecycle chaincode package cropchain.tar.gz --path /opt/gopath/src/github.com/hyperledger/fabric/peer/chaincode --lang golang --label cropchain_1

# Install chaincode
docker exec cli peer lifecycle chaincode install cropchain.tar.gz

# Approve chaincode (replace PACKAGE_ID with actual value from install output)
docker exec cli peer lifecycle chaincode approveformyorg -o orderer.example.com:7050 --channelID cropchainchannel --name cropchain --version 1.0 --package-id PACKAGE_ID --sequence 1

# Commit chaincode
docker exec cli peer lifecycle chaincode commit -o orderer.example.com:7050 --channelID cropchainchannel --name cropchain --version 1.0 --sequence 1 --peerAddresses peer0.org1.example.com:7051

Step 3: Start Application Services

docker-compose up -d app mysql ipfs

Step 4: Access the Application

Open your browser and navigate to: http://localhost:3000

🎯 Usage

1. Connect to Blockchain

Click the "Connect to Blockchain" button in the header to initialize the Fabric connection.

2. Create a Product

Navigate to the "Create Product" tab:

Enter Product ID (e.g., RICE001)
Select Product Type (Rice, Wheat, Coffee, etc.)
Enter Farmer Name
Add Description
Optionally upload a certificate to IPFS

3. Manage Products

Use the "Manage Products" tab to:

Ship products to a new owner
Receive products and update ownership

4. View History

Access the "View History" tab to:

Query product history by ID
See complete ownership and status changes
View timestamps and transaction IDs

5. Browse All Products

The "All Products" tab displays:

All products on the blockchain
Search and filter capabilities
Current product status

🔌 API Endpoints

Blockchain Connection

POST /api/connect-blockchain

Initialize connection to the Fabric network.

Product Management

POST /api/products
Content-Type: application/json

{
  "id": "RICE001",
  "type": "Rice",
  "farmerName": "John Farmer",
  "description": "Premium Basmati Rice",
  "ipfsHash": "QmXxx...",
  "fileName": "certificate.pdf"
}

Ship Product

POST /api/products/:id/ship
Content-Type: application/json

{
  "newOwner": "Distributor A"
}

Receive Product

POST /api/products/:id/receive
Content-Type: application/json

{
  "newOwner": "Retailer B"
}

Get Product History

GET /api/products/:id/history

Generate QR Code

GET /api/products/:id/qrcode

Query All Products

GET /api/products/queryAll

Upload to IPFS

POST /api/upload
Content-Type: multipart/form-data

document: [file]

🛠️ Common Commands

View Container Status

docker ps

Check Application Logs

docker logs cropchain_app --tail 50 -f

Check Peer Logs

docker logs peer0.org1.example.com --tail 50 -f

Query Chaincode Directly

docker exec cli peer chaincode query -C cropchainchannel -n cropchain -c '{"Args":["QueryAllProducts"]}'

Invoke Chaincode Directly

docker exec cli peer chaincode invoke -o orderer.example.com:7050 -C cropchainchannel -n cropchain -c '{"function":"CreateProduct","Args":["TEST001","Rice","TestFarmer","hash1","hash2"]}'

Stop All Services

docker-compose down

Clean Restart (Remove All Data)

docker-compose down -v
docker system prune -f
.\start-network.ps1
bash scripts/deploy-chaincode.sh
docker-compose up -d app mysql ipfs

🐛 Troubleshooting

For detailed troubleshooting, see TROUBLESHOOTING.md

Common Issues

Containers not starting:

docker-compose down -v
.\start-network.ps1

Blockchain connection fails:

Ensure all containers are running: docker ps
Check logs: docker logs cropchain_app
Click "Connect to Blockchain" in the UI

Chaincode errors:

Verify chaincode is committed: docker exec cli peer lifecycle chaincode querycommitted --channelID cropchainchannel
Check chaincode container: docker ps | grep dev-peer

📝 Key Fixes Applied

✅ Fixed CA container configuration
✅ Updated connection profile for container networking
✅ Changed to cryptogen-based admin identity
✅ Disabled discovery service for compatibility
✅ Fixed markdown linting issues
✅ Added comprehensive spell checker dictionary
✅ Simplified JavaScript code patterns

🎓 Learning Resources

📄 License

This project is created for educational purposes.

👥 Contributing

This is an educational project. Feel free to fork and experiment!

🙏 Acknowledgments

Hyperledger Fabric Community
Docker Community
IPFS Community

Built with ❤️ for Agricultural Supply Chain Traceability

Name		Name	Last commit message	Last commit date
.devcontainer		.devcontainer
bin		bin
chaincode		chaincode
config		config
db		db
fabric-network		fabric-network
scripts		scripts
ui		ui
.dockerignore		.dockerignore
.env		.env
.gitignore		.gitignore
.gitpod.yml		.gitpod.yml
Dashboard.png		Dashboard.png
Dockerfile		Dockerfile
Management.png		Management.png
README.md		README.md
TROUBLESHOOTING.md		TROUBLESHOOTING.md
app.js		app.js
docker-compose.yml		docker-compose.yml
hyperledger-fabric-linux-amd64-2.2.0.tar.gz		hyperledger-fabric-linux-amd64-2.2.0.tar.gz
install-fabric.sh		install-fabric.sh
package-lock.json		package-lock.json
package.json		package.json
start-network.ps1		start-network.ps1
start-network.sh		start-network.sh

Latest commit

History

Folders and files

Repository files navigation