Skip to content

Latest commit

 

History

History
814 lines (481 loc) · 35.4 KB

API.md

File metadata and controls

814 lines (481 loc) · 35.4 KB
Raw

API Reference

Constructs

HyperledgerFabricNetwork

Creates a Hyperledger Fabric network on Amazon Managed Blockchain.

Initializers 

import { HyperledgerFabricNetwork } from 'cdk-hyperledger-fabric-network'

new HyperledgerFabricNetwork(scope: Construct, id: string, props: HyperledgerFabricNetworkProps)
Name Type Description
scope* constructs.Construct No description.
id* string No description.
props* cdk-hyperledger-fabric-network.HyperledgerFabricNetworkProps No description.
scopeRequired
idRequired
  • Type: string
propsRequired

Properties

Name Type Description
adminPasswordSecret* aws-cdk-lib.aws_secretsmanager.Secret Secret ARN for the Hyperledger Fabric admin password.
adminPrivateKeySecret* aws-cdk-lib.aws_secretsmanager.Secret Secret for Hyperledger Fabric admin private key.
adminSignedCertSecret* aws-cdk-lib.aws_secretsmanager.Secret Secret for Hyperledger Fabric admin signed certificate.
caEndpoint* string Managed Blockchain member CA endpoint.
frameworkVersion* cdk-hyperledger-fabric-network.FrameworkVersion Hyperledger Fabric framework version.
memberDescription* string Managed Blockchain member description.
memberId* string Managed Blockchain member identifier generated on construction.
memberName* string Managed Blockchain member name.
networkDescription* string Managed Blockchain network description.
networkEdition* cdk-hyperledger-fabric-network.NetworkEdition Managed Blockchain network edition.
networkId* string Managed Blockchain network identifier generated on construction.
networkName* string Managed Blockchain network name.
nodes* cdk-hyperledger-fabric-network.HyperledgerFabricNode[] List of nodes created in the network.
ordererEndpoint* string Managed Blockchain network ordering service endpoint.
proposalDurationInHours* number The duration from the time that a proposal is created until it expires.
thresholdComparator* cdk-hyperledger-fabric-network.ThresholdComparator Determines whether the yes votes must be greater than the threshold percentage or must be greater than or equal to the threhold percentage to be approved.
thresholdPercentage* number The percentage of votes among all members that must be yes for a proposal to be approved.
vpcEndpointServiceName* string Managed Blockchain network VPC endpoint service name.
adminPasswordSecretRequired 
public readonly adminPasswordSecret: Secret;

Secret ARN for the Hyperledger Fabric admin password.

adminPrivateKeySecretRequired 
public readonly adminPrivateKeySecret: Secret;

Secret for Hyperledger Fabric admin private key.

adminSignedCertSecretRequired 
public readonly adminSignedCertSecret: Secret;

Secret for Hyperledger Fabric admin signed certificate.

caEndpointRequired 
public readonly caEndpoint: string;
  • Type: string

Managed Blockchain member CA endpoint.

frameworkVersionRequired 
public readonly frameworkVersion: FrameworkVersion;

Hyperledger Fabric framework version.

memberDescriptionRequired 
public readonly memberDescription: string;
  • Type: string

Managed Blockchain member description.

memberIdRequired 
public readonly memberId: string;
  • Type: string

Managed Blockchain member identifier generated on construction.

memberNameRequired 
public readonly memberName: string;
  • Type: string

Managed Blockchain member name.

networkDescriptionRequired 
public readonly networkDescription: string;
  • Type: string

Managed Blockchain network description.

networkEditionRequired 
public readonly networkEdition: NetworkEdition;

Managed Blockchain network edition.

networkIdRequired 
public readonly networkId: string;
  • Type: string

Managed Blockchain network identifier generated on construction.

networkNameRequired 
public readonly networkName: string;
  • Type: string

Managed Blockchain network name.

nodesRequired 
public readonly nodes: HyperledgerFabricNode[];

List of nodes created in the network.

ordererEndpointRequired 
public readonly ordererEndpoint: string;
  • Type: string

Managed Blockchain network ordering service endpoint.

proposalDurationInHoursRequired 
public readonly proposalDurationInHours: number;
  • Type: number

The duration from the time that a proposal is created until it expires.

thresholdComparatorRequired 
public readonly thresholdComparator: ThresholdComparator;

Determines whether the yes votes must be greater than the threshold percentage or must be greater than or equal to the threhold percentage to be approved.

thresholdPercentageRequired 
public readonly thresholdPercentage: number;
  • Type: number

The percentage of votes among all members that must be yes for a proposal to be approved.

vpcEndpointServiceNameRequired 
public readonly vpcEndpointServiceName: string;
  • Type: string

Managed Blockchain network VPC endpoint service name.

HyperledgerFabricNode

Creates a Hyperledger Fabric node on an Amazon Managed Blockchain network.

Initializers 

import { HyperledgerFabricNode } from 'cdk-hyperledger-fabric-network'

new HyperledgerFabricNode(scope: HyperledgerFabricNetwork, id: string, props?: HyperledgerFabricNodeProps)
Name Type Description
scope* cdk-hyperledger-fabric-network.HyperledgerFabricNetwork No description.
id* string No description.
props cdk-hyperledger-fabric-network.HyperledgerFabricNodeProps No description.
scopeRequired
idRequired
  • Type: string
propsOptional

Methods

Name Description
fetchData No description.
fetchData 
public fetchData(dataSdkCallPolicy: AwsCustomResourcePolicy)
dataSdkCallPolicyRequired

Static Functions

Name Description
constructNodes No description.
constructNodes 
import { HyperledgerFabricNode } from 'cdk-hyperledger-fabric-network'

HyperledgerFabricNode.constructNodes(scope: HyperledgerFabricNetwork, nodeProps?: HyperledgerFabricNodeProps[])
scopeRequired
nodePropsOptional

Properties

Name Type Description
availabilityZone* string The Availability Zone in which the node exists.
instanceType* cdk-hyperledger-fabric-network.InstanceType The Amazon Managed Blockchain instance type for the node.
memberId* string Managed Blockchain member identifier.
networkId* string Managed Blockchain network identifier.
nodeId* string Managed Blockchain node identifier generated on construction.
endpoint* string No description.
eventEndpoint* string No description.
availabilityZoneRequired 
public readonly availabilityZone: string;
  • Type: string

The Availability Zone in which the node exists.

instanceTypeRequired 
public readonly instanceType: InstanceType;

The Amazon Managed Blockchain instance type for the node.

memberIdRequired 
public readonly memberId: string;
  • Type: string

Managed Blockchain member identifier.

networkIdRequired 
public readonly networkId: string;
  • Type: string

Managed Blockchain network identifier.

nodeIdRequired 
public readonly nodeId: string;
  • Type: string

Managed Blockchain node identifier generated on construction.

endpointRequired 
public readonly endpoint: string;
  • Type: string
eventEndpointRequired 
public readonly eventEndpoint: string;
  • Type: string

Structs

HyperledgerFabricNetworkProps

Construct properties for HyperledgerFabricNetwork.

Initializer 

import { HyperledgerFabricNetworkProps } from 'cdk-hyperledger-fabric-network'

const hyperledgerFabricNetworkProps: HyperledgerFabricNetworkProps = { ... }

Properties

Name Type Description
memberName* string Managed Blockchain member name.
networkName* string Managed Blockchain network name.
frameworkVersion cdk-hyperledger-fabric-network.FrameworkVersion Hyperledger Fabric framework version.
memberDescription string Managed Blockchain member description.
networkDescription string Managed Blockchain network description.
networkEdition cdk-hyperledger-fabric-network.NetworkEdition Managed Blockchain network edition.
nodes cdk-hyperledger-fabric-network.HyperledgerFabricNodeProps[] List of nodes to create on the network.
proposalDurationInHours number The duration from the time that a proposal is created until it expires.
thresholdComparator cdk-hyperledger-fabric-network.ThresholdComparator Determines whether the yes votes must be greater than the threshold percentage or must be greater than or equal to the threhold percentage to be approved.
thresholdPercentage number The percentage of votes among all members that must be yes for a proposal to be approved.
memberNameRequired 
public readonly memberName: string;
  • Type: string

Managed Blockchain member name.

networkNameRequired 
public readonly networkName: string;
  • Type: string

Managed Blockchain network name.

frameworkVersionOptional 
public readonly frameworkVersion: FrameworkVersion;

Hyperledger Fabric framework version.

memberDescriptionOptional 
public readonly memberDescription: string;
  • Type: string
  • Default: Set to match member name

Managed Blockchain member description.

networkDescriptionOptional 
public readonly networkDescription: string;
  • Type: string
  • Default: Set to match network name

Managed Blockchain network description.

networkEditionOptional 
public readonly networkEdition: NetworkEdition;

Managed Blockchain network edition.

nodesOptional 
public readonly nodes: HyperledgerFabricNodeProps[];

List of nodes to create on the network.

proposalDurationInHoursOptional 
public readonly proposalDurationInHours: number;
  • Type: number
  • Default: 24 hours

The duration from the time that a proposal is created until it expires.

thresholdComparatorOptional 
public readonly thresholdComparator: ThresholdComparator;

Determines whether the yes votes must be greater than the threshold percentage or must be greater than or equal to the threhold percentage to be approved.

thresholdPercentageOptional 
public readonly thresholdPercentage: number;
  • Type: number
  • Default: 50 percent

The percentage of votes among all members that must be yes for a proposal to be approved.

HyperledgerFabricNodeProps

Construct properties for HyperledgerFabricNode.

Initializer 

import { HyperledgerFabricNodeProps } from 'cdk-hyperledger-fabric-network'

const hyperledgerFabricNodeProps: HyperledgerFabricNodeProps = { ... }

Properties

Name Type Description
availabilityZone string The Availability Zone in which the node will be created.
instanceType cdk-hyperledger-fabric-network.InstanceType The Amazon Managed Blockchain instance type for the node.
availabilityZoneOptional 
public readonly availabilityZone: string;
  • Type: string
  • Default: The first AZ in the region

The Availability Zone in which the node will be created.

instanceTypeOptional 
public readonly instanceType: InstanceType;

The Amazon Managed Blockchain instance type for the node.

Enums

FrameworkVersion

Name Description
VERSION_1_2 No description.
VERSION_1_4 No description.

VERSION_1_2

VERSION_1_4

InstanceType

Name Description
BURSTABLE3_SMALL No description.
BURSTABLE3_MEDIUM No description.
BURSTABLE3_LARGE No description.
BURSTABLE3_XLARGE No description.
STANDARD5_LARGE No description.
STANDARD5_XLARGE No description.
STANDARD5_XLARGE2 No description.
STANDARD5_XLARGE4 No description.
COMPUTE5_LARGE No description.
COMPUTE5_XLARGE No description.
COMPUTE5_XLARGE2 No description.
COMPUTE5_XLARGE4 No description.

Supported instance types for Managed Blockchain nodes.

BURSTABLE3_SMALL

BURSTABLE3_MEDIUM

BURSTABLE3_LARGE

BURSTABLE3_XLARGE

STANDARD5_LARGE

STANDARD5_XLARGE

STANDARD5_XLARGE2

STANDARD5_XLARGE4

COMPUTE5_LARGE

COMPUTE5_XLARGE

COMPUTE5_XLARGE2

COMPUTE5_XLARGE4

NetworkEdition

Name Description
STARTER No description.
STANDARD No description.

STARTER

STANDARD

ThresholdComparator

Name Description
GREATER_THAN No description.
GREATER_THAN_OR_EQUAL_TO No description.

GREATER_THAN

GREATER_THAN_OR_EQUAL_TO