Hyperledger Fabric Chaincode Java

This is a Java based implementation of Hyprledger Fabric chaincode shim APIs, which enables development of smart contracts using the Java language.

This project creates fabric-chaincode-protos and fabric-chaincode-shim jar files for developers' consumption and the hyperledger/fabric-javaenv docker image to run Java chaincode.

Getting Started

Application developers interested in developing Java smart contracts for Hyperledger Fabric should read the JavaDoc which inludes download information, and links to documentation and samples.

Project structure

fabric-chaincode-protos

Contains the protobuf definition files used by Java shim to communicate with Fabric peers.

fabric-chaincode-shim

Contains the java shim classes that define Java chaincode API and way to communicate with Fabric peers.

fabric-chaincode-docker

Contains instructions to build the hyperledger/fabric-javaenv docker image.

fabric-chaincode-integration-test

Contains higher level tests for Java chaincode.

Note: in the future these should be replaced with a separate suite of Cucumber tests which run against all chaincode implementations.

fabric-chaincode-example-gradle

Contains an example java chaincode gradle project that includes sample chaincode and basic gradle build instructions.

Building and testing

Make sure you have the following prereqs installed:

Note: Java can be installed using sdkman.

Clone the repository if you haven't already.

git clone https://github.com/hyperledger/fabric-chaincode-java.git

Build java shim jars (proto and shim jars) and install them to local maven repository.

cd fabric-chaincode-java
./gradlew clean build install

Note: ./gradlew clean build classes can be used instead to reduce the binaries that are built. This should be sufficient for using the local repository.

Build javaenv docker image, to have it locally.

./gradlew buildImage

This work is licensed under a Creative Commons Attribution 4.0 International License

chakra-coder/fabric-chaincode-java