EasyCC - Easy Chaincode CLI

Simplify Hyperledger Fabric development with an intuitive CLI

EasyCC is a Rust-based command-line tool that automates the setup, management, and testing of Hyperledger Fabric networks and java chaincodes for local development. Get a blockchain environment running in seconds.

Key Features

• Zero-config network setup - Running network in under 30 seconds
• Complete chaincode lifecycle - Build, deploy, and test with single commands
• CouchDB state database - Rich queries out of the box
• Testing integration - Built-in support for ChaincoderTestr
• Cross-platform - Works on macOS, Linux, and Windows

Quick Start

# Install EasyCC
cargo install easycc

# Create and start a network (you will be prompted for the configuration)
easycc init
easycc create
easycc start

# Deploy your chaincode
easycc deploy --chaincode-path ./chaincode

# Access CouchDB
open http://localhost:5984/_utils  # credentials: admin/adminpw

That's it! You now have a Fabric network with CouchDB running locally.

Documentation

Comprehensive documentation is available in the Wiki:

• Installation Guide - Platform-specific setup instructions
• Getting Started - Detailed tutorial for first-time users
• Command Reference - Complete command documentation
• Testing Guide - ChaincoderTestr integration

The code documentation is available here.

Prerequisites

• Docker (Desktop or Engine) - Container runtime

See Installation Guide for detailed setup instructions

Common Commands

# Initialize workspace
easycc init

# Create network artifacts
easycc create

# Start network
easycc start

# Deploy chaincode
easycc deploy --chaincode-path ./chaincode

# Run tests
easycc test --tester-path ./ChaincoderTestr \
            --test-suite-path ./tests.json \
            --org client

# Stop network
easycc stop

# Clean up
easycc clean --all

See Command Reference for all available commands and options.

Funding

This work was supported by the Fund for the Promotion of Joint International Research (Fostering Joint International Research (B)) of the Japan Society for the Promotion of Science (JSPS) under Grant Number 19KK0037.