/fabric: Fabric network v2.5 used as a test environment/chaincode: chaincode-related files/ccapi: chaincode REST API in Golang project
The cc-tools library has been tested in Fabric v2.2, v2.4 and v2.5 networks.
Dependencies for chaincode and chaincode API:
- Go 1.21 or higher
Dependencies for test environment:
- Docker 20.10.5 or higher
- Docker Compose 1.28.5 or higher
Intallation of the Chaincode API Go:
$ cd chaincode; go mod vendor; cd ..
$ cd ccapi; go mod vendor; cd ..After installing, use the script ./startDev.sh in the root folder to start the development environment. It will
start all components of the project with 3 organizations.
If you want to deploy with 1 organization, run the command ./startDev.sh -n 1.
To apply chaincode changes, run $ ./upgradeCC.sh <version> <sequence> with a version higher than the current one (starts with 0.1). Append -n 1 to the command if running with 1 organization.
To apply CC API changes, run $ ./scripts/reloadCCAPI.sh.
After installing, use the script ./startDev.sh -ccaas in the root folder to start the development environment. It will
start all components of the project with 3 organizations.
If you want to deploy with 1 organization, run the command ./startDev.sh -ccaas -n 1.
To apply chaincode changes, run $ ./upgradeCC.sh -ccaas <version> <sequence> with a version higher than the current one (starts with 0.1). Append -n 1 to the command if running with 1 organization.
To apply CC API changes, run $ ./scripts/reloadCCAPI.sh.
To test transactions after starting all components, run $ ./scripts/tryout.sh.
To test transactions using the godog tool, run $ ./scripts/godog.sh.
The generatePackage.sh script is available to generate a tar.gz archive of the chaincode.
By running $ ./generatePackage.sh without any option, the script generates a collections.json file for the private data on the chaincode with all the organizations defined on the readers section of private asset types, and then archives the code without the CCAPI.
By using the --org/-o option along the script, it's possible to specify the organizations to be considered when generating the collections.json file. This option may be used multiple times to add all the organizations, ex: $ ./generatePackage.sh -o org1MSP -o org2MSP.
By standard the archive is created using the project name with 1.0 label, to change it the --name/-n and --label/-l flags may be used. Example: $ ./generatePackage.sh -n my-project -l 2.0
You can reach GoLedger developers and cc-tools maintainers at our Discord - Join us!
More documentation and details on cc-tools can be found at https://goledger-cc-tools.readthedocs.io/en/latest/
For production deployment please consider using GoFabric - https://gofabric.io