For the complete documentation index, see llms.txt. This page is also available as Markdown.

Build a Network

The blockchain network is fully decentralized and can be managed by each member. However, there should be one organization that bootstraps the network.

To build a network, you should:

  1. Create an organization.

  2. Bootstrap the system channel (generate the genesis block for the system channel).

Create an Organization

Every organization should have its own CA(s), MSP definition, ordering service with ordering node(s), and peer set(s) with peer node(s).

Starting from Catalyst Blockchain Manager v2.3.0 you can onboard a new organization to a network even if it doesn't host any ordering node. See Joining a system channel with an external orderer for more.

1

Create a Certificate Authority (CA)

CA is the first entity to be created while bootstrapping a network. Each organization needs its own CA. A CA issues certificates to other entities on the network, which define the identity of an entity on the blockchain.

You can create a root (self-signed) CA, or create an intermediate CA and sign its certificate by any trusted CA.

See detailed information about how to create and sign a CA in the Certificate Authority section.

2

Create an Organization's MSP Definition

The Membership Service Provider (MSP) identifies which CAs are accepted to define the members of a trusted domain by listing their members' identities or identifying which CAs are authorized to issue their members' valid identities.

An ordering service and peer sets belong to your organization, so an organization's MSP must be created before the ordering service and peer sets. See MSP and Partners.

3

Create Ordering Set(s)

By creating an ordering set, you can standardize the desired configurations. Simply adding a new orderer to this ordering set lets you quickly create any number of orderers with the predefined set of configurations. See How to Create an Ordering Set.

4

Create Ordering Node(s)

Ordering nodes (orderers) are responsible for maintaining the system and application channels, ordering transactions, and packaging them into blocks.

See How to Create an Orderer.

5

Create Peer Set

Just like an ordering set for orderers, a peer set is a template for peers. See How to Create a Peer Set.

6

Create Peer Node(s)

Peers are nodes that host a copy of the distributed ledger and smart contracts. There is no limit on the number of peers. See How to Create a Peer.

Even though an organization was created, a network is not set up yet. You need to bootstrap a system channel or join one if it already exists.

Bootstrapping the System Channel (Generating the Genesis Block)

Every network begins with an ordering system channel. The policies in the ordering system channel configuration blocks govern the consensus used by the ordering service and define how new blocks are created.

The system channel also contains the organizations that are members of the ordering service (orderer organizations) and those allowed to create new channels (consortium organizations).

While creating a system channel you need to:

  1. Add orderer organizations.

  2. Create a consortium.

  3. Configure the system channel and Raft options.

Make sure that your organization is a member of orderer organizations and consortium. You can add other organizations as an orderer organization and a consortium member during this step or after the channel creation.

See How to Create a System Channel.

Last updated

Was this helpful?