Corda Network Considerations

There is a set of network parameters that all nodes on the network must agree on in order to interoperate. For more information, see Network parameters.

Network parameters are distributed alongside the network map in a separate file stored locally by each node.

From time to time the Corda Network Operator (R3) will need to update parameters, for example if a new notary is added.

The current update process is a 3 step operation.

  • Day 1 Publicise the intended changes
  • Day 1-N Collect node acceptances
  • Day N* Update the central file and distribute

Most network parameter changes require that a node is stopped and restarted before the changes are accepted. The exception to this is when the network parameter changes only update notaries. Updates that have only changes to notaries can be accepted without a restart.

The Corda Network Operator will ensure customers are fully aware of impending and in-flight network parameter changes:

  • Forward Calendars

  • Publicise 12 month forward calendar and explanatory notes for next update:

  • Production calendar on https://corda.network

  • UAT calendar on https://docs.corda.net

  • Event Communications

  • Announcement day explanatory email to:

  • Customer node operators (contact email address as supplied in original Certificate Signing Request or as amended by email to doorman@r3.com or uatdoorman@r3.com.

  • Customer business operations contacts (advised during implementation projects)

  • Business network operator key contact (as defined in service agreement).

  • Pre-execution email to the same contacts 3 business days ahead of update to confirm go ahead.

  • Publicise on Support Service Desk and cascade to customer support contacts.

Segregated Zones

Detail on the thinking and concepts around what a segregated sub-zone is can be found here : https://groups.io/g/corda-network/topic/design_proposal_for/28792765?p=,,,20,0,0,0::recentpostdate%2Fsticky,,,20,2,0,28792765

Here are the basis goals of a Segregated Sub Zone:

  • The ability to hive off members of the business network into a private enclave

  • The ability to cloak the members of the business network

  • That is where the notary is not whitelisted globally and is operated to the standard deemed acceptable by the BNO, not the Zone operator and members (as per those in the global whitelist)

  • The ability to operate “private” notary service> That is where the notary can exist in the global whitelist but is restricted to notarisation of specific State types The ability to operate non whitelisted, “less universally trusted”, notaries. The ability to operate their own Compatibility Zone.

  • Segregated sub-zones only share the Identity Operator service. Each sub-zone therefore has its own independent network map and set of network parameters

  • Sub-zones allow more flexibility in setting network parameters as each zone is able to have its own settings

  • Sub-zones will be able to opt out of specific events* where:

  • The parameters are not used in their business network(s) e.g. for contract constraints or private notaries

  • Opting-out does not compromise the sub-zone’s long term plan to join the public zone

  • It should be noted however, the more sub-zones diverge in parameter settings over time the harder it will be to merge back in to the public zone in future

  • Segregated sub-zones capability is estimated to be available in Corda Network Q3 2018

  • Production will follow after successful customer test in UAT

The diagram below outlines the overview of SSZ.

  • Sub-Zones must be mergeable
  • No nodes (including notaries) can exist in more than one sub-zone
  • There must be no asymmetry of identification
  • The identity service for sub-zones must be managed by a single Doorman
  • Should require no changes to the Corda Node
  • Notaries will not exist in multiple sub-zones

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.