Genesis block configuration

The genesis block begins the blockchain and controls who can join the chain without being asked any questions. It also defines some configuration information for the blockchain such as the ordering mode. 

Certificates need to be provided for components in BOTH the canJoin and canChangeConfig sections. All certificates need to be signed by the machine intermediate certificate of the blockchain network. The machine intermediate must be signed by the Gospel Root CA.

To configure the genesis block, go to, Dashboard > Settings >Genesis block config


SettingsDescription
ChannelEnter a name for the channel
Ordering mode

Select an ordering mode from the drop-down list. The list displays the orderers that are available on the network.

  • single: This mode has only a single ordering node, and therefore is not fault tolerant. 
  • kafka: This mode is a CFT implementation that uses a “leader and follower” node configuration, in which transactions are replicated from the leader node to the follower nodes. In the event the leader node fails, one of the followers becomes the leader and ordering can continue, ensuring fault tolerance.
  • gospelTBFT: is an implementation of a BFT ordering service. 

Root certificate

  • Certificate type

Enter a name for the certificate type

Add Certificate

You can modify the certificate by selecting the  option. The Manage Cert box displays. Paste your certificate and click Save to apply the changes. The following details of the certificate are displayed.

  • Company and Username The details of the company and username provided when creating the certificate
  • Valid from and Valid until: The current certificate validity period 

Join Channel

Choose fileClick Choose file to find and locate the file.
  • Create config (and download)
Click to create and download the file containing the configuration.
  • Download current config
Click to download the current configuration.
  • Propose changes

Once you have made all the changes, you can propose the changes so it can be sent for approval. 

Your private key is not sent to the server and the signing is done in the browser.

Apply the key using which the proposal is signed. The options are:

  • Use my current Gospel login (user@gospel.tech / GospelTest): Select to sign the selected transaction with your current Gospel certificate and key.
  • Use this certificate and key: Select to provide the certificate and private key using to be used to sign the transaction.

  • Revert to saved
Click Revert changes to undo the current changes and revert to the last saved version.

Who can change config 

  • config type

Select one of the options to determine the number of certificates required to change the configuration.

anyOf: Requires approval from any of the certificates 

nOf: Requires a specific number of certificates to approve. Enter the number of required approvals in the Number of certificates needed option.

allOf: Requires approval from all the certificates

  • Certificates

Click  to add a certificate to the group.

  • Enter a name in the Certificate type field and provide a certificate.
  • Click Add Certificate to paste the certificate in the Manage Cert window. 
  • Click Save to save the changes.

Who can join

  • config type

Select one of the options to determine the number of certificates required to change the configuration.

anyOf: Requires approval from any of the certificates 

nOf: Requires a specific number of certificates to approve. Enter the number of required approvals in the Number of certificates needed option.

allOf: Requires approval from all the certificates

  • Certificates

Click  to add a certificate to the group.

  • Certificate type: Enter a name for the certificate.
  • Add Certificate: Click  to paste the certificate in the Manage Cert window. 

Click Save to save the changes.

Intermediate Certificates

Click  to add a certificate to the group.

  • Certificate type: Enter a name for the certificate.
  • Add Certificate: Click  to paste the certificate in the Manage Cert window. 

Click Save to save the changes.

Orderers

Click  to add details required to locate the ordering nodes you want to connect to.

Provide the hostnames and ports of all of the ordering nodes in the Gospel network that we want to connect to.

  • Host 
Enter the hostname 
  • Port
Enter the port number

Anchor peers

Click  to add details required to locate the anchoring peers you want to connect to. 

Provide the hostnames and ports of all of the anchor peer nodes in the Gospel network we want to connect to.

  • Host
Enter the hostname 
  • Port
Enter the port number