cdk-hyperledger-fabric-network

Hyperledger Fabric on Amazon Managed Blockchain

This repository contains an L2 CDK construct to deploy a Hyperledger Fabric network running on Amazon Managed Blockchain. It currently builds out a member and its nodes, but the following enhanced functionality is planned for future releases:

• Support for other languages (e.g. Python)
• Enable CA, node, and chaincode logging
• Enroll users, storing their credentials in Secrets Manager
• Create channels on nodes
• Instantiate chaincode on nodes
• Set up a VPC and associated endpoint for accessing the network

Installation

The construct can be installed in a CDK project with the following:

npm install --save cdk-hyperledger-fabric-network

Note that this construct requires AWS CDK v2.

Usage

A minimally complete deployment is shown below. By default, a standard network will be created running Hyperledger Fabric 1.4 with a single bc.t3.small node.

import * as cdk from 'aws-cdk-lib';
import * as constructs from 'constructs';
import * as hyperledger from 'cdk-hyperledger-fabric-network';

class MyStack extends cdk.Stack {
  constructor(scope: constructs.Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);
    new hyperledger.HyperledgerFabricNetwork(this, 'MyNetwork', {
      networkName: 'MyNetwork',
      memberName: 'MyMember',
    });
  });
}

The following is a more complex instantiation illustrating some of the options available.

new hyperledger.HyperledgerFabricNetwork(this, 'MyNetwork', {
  networkName: 'MyNetwork',
  networkDescription: 'This is my Hyperledger Fabric network',
  memberName: 'MyMember',
  networkDescription: 'This is my Hyperledger Fabric member',
  frameworkVersion: hyperledger.FrameworkVersion.VERSION_1_2,
  proposalDurationInHours: 48,
  thresholdPercentage: 75,
  nodes: [
    {
      availabilityZone: 'us-east-1a',
      instanceType: hyperledger.InstanceType.STANDARD5_LARGE,
    },
    {
      availabilityZone: 'us-east-1b',
      instanceType: hyperledger.InstanceType.STANDARD5_LARGE,
    },
  ],
});

See the API Documentation for details on all available input and output parameters.

References

• AWS CDK
• Amazon Managed Blockchain
• Hyperledger Fabric
• Node Fabric SDK
• Fabric Chaincode Node

Contributing

Pull requests are welcomed. Please review the Contributing Guidelines and the Code of Conduct.

Security

See CONTRIBUTING for more information.

Authors

• Jud Neer ([e-mail])

License

This project is licensed under the MIT-0 License. See the LICENSE file for details.