Setup with Locally Built Weaver Components

In this document, we detail the steps using which you can bring up networks using the default configuration settings and by building Weaver interoperation modules, SDK libraries, and relay drivers locally from your Cacti clone. To customize these settings (e.g., hostnames, ports), refer to the Advanced Configuration page.

Follow the instructions below to build and run components followed by interoperation flows. These instructions have been tested on Ubuntu Linux (bash shell) and Mac OS. In general, they should work on any system and shell as long as the various dependenices have been installed and configured.

Prerequisites¶

Software¶

Before starting, make sure you have the following software installed on your host machine:

• OpenSSL: install using package manager, like apt on Debian/Ubuntu Linux (specifically packages openssl and libssl-dev)
• Curl: install using package manager, like apt on Debian/Ubuntu Linux
• Git: sample instructions
• Docker: sample instructions (Latest version)
• Docker-Compose: sample instructions (Version 2 or higher)
• Golang: sample instructions (Version 1.20 or higher)
• Java (JDK and JRE): sample instructions (Version 8)
• Node.js and NPM: sample instructions (Version 16 Supported)
• Yarn: sample instructions
• Rust: sample instructions
• Protoc (Protobuf compiler): Golang should already be installed and configured.
  • Default method: Run the following with sudo if necessary. This will install both the protobuf compiler and the Go code generator plugins.

    apt-get install protobuf-compiler
    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.4.0
    

  • If the above method installs an older version of protoc (check using protoc --version), say below 3.12.x, you should download pre-compiled binaries instead. (With an older version, you may see errors while attempting to launch and setup the Fabric networks).

    sudo apt-get remove protobuf-compiler
    curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v3.15.6/protoc-3.15.6-linux-x86_64.zip
    sudo apt-get install unzip
    unzip protoc-3.15.6-linux-x86_64.zip -d <some-folder-path>
    export PATH="$PATH:<some-folder-path>/bin"
    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.4.0
    

• SQLite3 Library:

  • Sample instruction for Ubuntu:

    apt-get install sqlite3 libsqlite3-dev
    

  Notes
  The latest version at present is 3.15.6, but you should check the above link to find the most current version before running the above steps.
  The latest version of protoc-gen-go-grpc that works with the Fabric test networks we will run below is v1.4.0, which is why that version is hardcoded here.

Credentials¶

Make sure you have an SSH or GPG key registered in https://github.com to allow seamless cloning of repositories (at present, various setup scripts clone repositories using the https:// prefix but this may change to git@ in the future).

Getting the Code and Documentation¶

Clone the cacti repository. The code to get a basic test network up and running and test data-sharing interoperation flows lies in the subfolder weaver/tests/network-setups, which should be your starting point, though the setups will rely on other parts of the repository, as you will find out in the instructions given on this page.

Common Structures¶

The weaver/common/protos folder contains structure definitions in the protobuf format that are used by all the different components. The various weaver/common/protos-* folders are meant to contain compiled protobufs (in different languages).

To compile the protobufs for JavaScript, do the following:

• Navigate to the weaver/common/protos-js folder.
• Run the following command:

  make build
  

To compile the protobufs for Golang, do the following:

• Navigate to the weaver/common/protos-go folder.
• Run the following command:

  make build
  

To compile the protobufs for Java and Kotlin, do the following:

• Navigate to the weaver/common/protos-java-kt folder.
• Run the following command:

  make build
  

To compile the protobufs for Solidity, do the following:

• Navigate to the weaver/common/protos-sol folder.
• Run the following command:

  make build
  

To compile the protobufs for Rust, do the following:

• Navigate to the weaver/common/protos-rs folder.
• Run the following command:

  make build
  

Securing Components¶

Hyperledger Fabric Components¶

Using the sequence of instructions below, you can start two separate Fabric networks, each with a single channel and application contract (chaincode). You can also start an interoperation contract, a relay, and a driver acting on behalf of each network. You can build a Fabric CLI tool with which you can initialize both networks' ledgers with access control policies, foreign networks' security groups (i.e., membership providers' certificate chains), and some sample key-value pairs that can be shared during subsequent interoperation flows.

Fabric Interoperation Node SDK¶

A client-layer library (companion to hyperledger/fabric-sdk-node) is defined in the weaver/sdks/fabric/interoperation-node-sdk folder. This contains functions for Fabric Gateway-based applications to exercise interoperation capabilities via relays and also several utility/helper functions. The Fabric-CLI tool, which we will use later, depends on this library.

To build the library, do the following:

• Navigate to the weaver/sdks/fabric/interoperation-node-sdk folder.
• Run the following command:

  make build-local
  

Fabric Network¶

The code for this lies in the weaver/tests/network-setups folder.

This folder contains code to create and launch networks network1 and network2 of identical specifications:

• Network: 1 peer, 1 peer CA, 1 ordering service node, 1 ordering service CA
• Single channel named mychannel
• One of the following contracts deployed on mychannel, the choice depending on the interoperability mode you wish to test:
  • simplestate (Data Sharing): supports simple transactions (Create, Read, Update, Delete) involving storage and lookup of pairs.
  • simplestatewithacl (Data Sharing): identical to simplestate but with extra security features to ensure that the Weaver infrastructure cannot be bypassed by a malicious client of the network.
  • simpleasset (Asset Exchange): supports creation, modification, transfer, and deletion, as well as locking, unlocking, and claiming, of simple bonds and tokens (examples of non-fungible and fungible assets respectively).
  • simpleassetandinterop (Asset Exchange): identical to simpleasset but where the locking, unlocking, and claiming logic is imported as a library in the chaincode rather than available in the common Fabric Interoperation Chaincode (a Weaver component).
  • simpleassettransfer (Asset Exchange or Asset Transfer): augmentation of simpleasset with asset pledging, claiming, and reclaiming features for cross-network transfers.

Follow the instructions below to build and launch the networks:

• Navigate to the weaver/tests/network-setups/fabric/dev folder.
• To spin up both network1 and network2 with the interoperation chaincode and the default simplestate chaincode installed, run:

  make start-interop-local
  

• To launch the networks with a different application chaincode from the above list, run:

  make start-interop-local CHAINCODE_NAME=<chaincode-name>
  

• To launch the networks with 2 organizations, each with a peer (this will enable more variation and experimentation, which you can attempt after testing interoperation protocols across basic network configurations), run:

  make start-interop-local PROFILE="2-nodes"
  

For more information, refer to the associated README.

Troubleshooting Tips:

• If you see any errors during the launches, re-check the prerequisites (software installations and credentials). Ensure your network connection is working. As a safe bet, you can retry after cleanup: kill and remove all Docker containers and associated volumes.
• If protoc or protoc-gen-go throws an error, reinstall protoc, protoc-gen-go, and protoc-gen-go-grpc using suggestions made in the Prerequisites section above.

Fabric Client (fabric-cli)¶

The CLI is used to interact with a Fabric network, configure it and run chaincode transactions to record data on the channel ledger or query data. It is also used to interact with remote networks through the relay to trigger an interoperation flow for data request and acceptance.

The fabric-cli Node.js source code is located in the weaver/samples/fabric/fabric-cli folder and the Golang source code in the weaver/samples/fabric/go-cli folder.

Prerequisites¶

If you are using a Linux system, make sure that lib64 is installed.

Installation¶

You can install fabric-cli as follows (for both the Node.js and Golang versions):

• Navigate to the weaver/samples/fabric/fabric-cli folder (for the Node.js version) or the weaver/samples/fabric/go-cli (for the Golang version) folder.
• Run the following to install dependencies (for the Node.js version) or the executable (for the Golang version):

  make build-local
  

• Use the fabric-cli executable in the bin folder for subsequent actions.

Fabric Relay¶

The relay is a module acting on behalf of a network, enabling interoperation flows with other networks by communicating with their relays. The code for this lies in the weaver/core/relay folder.

Building¶

Prerequisite: make sure Rust is already installed and that the cargo executable is in your system path (after installation of Rust, this should be available in $HOME/.cargo/bin); you can also ensure this by running source "$HOME/.cargo/env".

Build the generic (i.e., common to all DLTs) relay module as follows:

• Navigate to the weaver/core/relay folder.
• Run the following:

  make
  

• If you observe errors during the above compilation, update certain packages (on which the Weaver Relay is dependent) to their latest versions and recompile as follows:

  make update-pkgs
  make
  

Deployment¶

An instance or a relay can be run using a suitable configuration file. Samples are available in the weaver/core/relay/config folder.

Run a relay for network1 as follows:

• Navigate to the weaver/core/relay folder.
• To launch the server without TLS, leave the configuration file config/Fabric_Relay.toml in its default state. Otherwise, edit it to set TLS flags for this relay and the other relays and drivers it will connect to in this demonstration as follows:

  .
  .
  cert_path="credentials/fabric_cert.pem"
  key_path="credentials/fabric_key"
  tls=true
  .
  .
  [relays]
  [relays.Corda_Relay]
  hostname="localhost"
  port="9081"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Corda_Relay2]
  hostname="localhost"
  port="9082"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Fabric_Relay2]
  hostname="localhost"
  port="9083"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  [drivers]
  [drivers.Fabric]
  hostname="localhost"
  port="9090"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  

• To launch the server, simply run the following:

  RELAY_CONFIG=config/Fabric_Relay.toml cargo run --bin server
  

Run a relay for network2 as follows (do this only if you have launched both Fabric networks network1 and network2 and wish to test interoperation between them)

• Navigate to the weaver/core/relay folder.
• To launch the server without TLS, leave the configuration file config/Fabric_Relay2.toml in its default state. Otherwise, edit it to set TLS flags for this relay and the other relays and drivers it will connect to in this demonstration as follows:

  .
  .
  cert_path="credentials/fabric_cert.pem"
  key_path="credentials/fabric_key"
  tls=true
  .
  .
  [relays]
  [relays.Corda_Relay]
  hostname="localhost"
  port="9081"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Corda_Relay2]
  hostname="localhost"
  port="9082"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Fabric_Relay]
  hostname="localhost"
  port="9080"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  [drivers]
  [drivers.Fabric]
  hostname="localhost"
  port="9095"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  

• To launch the server, simply run the following:

  RELAY_CONFIG=config/Fabric_Relay2.toml cargo run --bin server
  

For more information, see the relay README.

Fabric Driver¶

A driver is a DLT-specific plugin invoked by the relay while conveying external data queries to the local peer network and collecting a response with proofs. The Fabric driver is built as a Fabric client application on the fabric-network NPM package. The code for this lies in the weaver/core/drivers/fabric-driver folder.

Configuring¶

In the weaver/core/drivers/fabric-driver folder, copy .env.template to .env and update CONNECTION_PROFILE to point to the connection profile of the Fabric network (e.g. <PATH-TO-WEAVER>/tests/network-setups/fabric/shared/network1/peerOrganizations/org1.network1.com/connection-org1.json)

Configure fabric-driver for network1 as follows:

• Navigate to the weaver/core/drivers/fabric-driver folder.
• Create a .env file by copying .env.template and setting suitable parameter values:
  • The CONNECTION_PROFILE should point to the absolute path of the connection profile for network1.
    • For this exercise, specify the path <PATH-TO-WEAVER>/tests/network-setups/fabric/shared/network1/peerOrganizations/org1.network1.com/connection-org1.json (you must specify the full absolute path here).
    • <PATH-TO-WEAVER> here is the absolute path of the weaver folder within your Cacti repository clone.
  • If you wish to start the driver without TLS, set the following parameter values:

    RELAY_TLS=false
    RELAY_TLSCA_CERT_PATH=
    DRIVER_TLS=false
    DRIVER_TLS_CERT_PATH=
    DRIVER_TLS_KEY_PATH=
    

    Otherwise, if you wish to start the driver with TLS enabled, set the following parameter values (replace <PATH-TO-WEAVER> with the absolute path of the weaver folder within your Cacti repository clone):

    RELAY_TLS=true
    RELAY_TLSCA_CERT_PATH=<PATH-TO-WEAVER>/core/relay/credentials/fabric_ca_cert.pem
    DRIVER_TLS=true
    DRIVER_TLS_CERT_PATH=<PATH-TO-WEAVER>/core/relay/credentials/fabric_cert.pem
    DRIVER_TLS_KEY_PATH=<PATH-TO-WEAVER>/core/relay/credentials/fabric_key
    

  • Leave the default values unchanged for the other parameters. The relay and driver endpoints as well as the network name are already specified in the template.

Building¶

Build the Fabric driver module as follows:

• Navigate to the weaver/core/drivers/fabric-driver folder.
• Run the following:

  make build-local
  

Running¶

Run a Fabric driver for network1 as follows:

• Navigate to the weaver/core/drivers/fabric-driver folder.
• Run the following:

  npm run dev
  

Run a Fabric driver for network2 as follows (do this only if you wish to test interoperation between the two Fabric networks network1 and network2)

• Navigate to the weaver/core/drivers/fabric-driver folder.
• Run the following (replace <PATH-TO-WEAVER> with the absolute path of the weaver folder within your Cacti repository clone):

  CONNECTION_PROFILE=<PATH-TO-WEAVER>/tests/network-setups/fabric/shared/network2/peerOrganizations/org1.network2.com/connection-org1.json NETWORK_NAME=network2 RELAY_ENDPOINT=localhost:9083 DRIVER_ENDPOINT=localhost:9095 npm run dev
  

Fabric IIN Agent¶

IIN Agent is a client of a member of a DLT network or security domain with special permissions to update security domain identities and configurations on the ledger via the network's interoperation module. The code for this lies in the weaver/core/identity-management/iin-agent folder. Navigate to the weaver/core/identity-management/iin-agent folder.

Building¶

To build the IIN Agent, run:

make build-local

Configuration¶

Ledger config file specifies ledger specific IIN Agent details such as identity and which network and organization to connect to.

1. To create config file for Org1MSP's Fabric IIN Agent of network1, follow the steps:
   • Create copy of template config file for Fabric IIN Agent: src/fabric-ledger/config.json.template, say to location src/fabric-ledger/config-n1-org1.json.
   • Replace <path-to-connection-profile> with <PATH-TO-WEAVER>/tests/network-setups/fabric/shared/network1/peerOrganizations/org1.network1.com/connection-org1.json, where <PATH-TO-WEAVER> should be substituted with the absolute path of the weaver folder within your Cacti repository clone.
   • Set mspId as Org1MSP.
   • Set agent.affiliation as org1.department1.
2. To create config file for Org2MSP's Fabric IIN Agent of network1, repeat Step 1 with different name for config file, say src/fabric-ledger/config-n1-org2.json, and replace org1 with org2 and Org1MSP with Org2MSP.
3. To create config file for Org1MSP's Fabric IIN Agent of network2, repeat Step 1 with different name for config file, say src/fabric-ledger/config-n2-org1.json, and replace network1 with network2.
4. To create config file for Org2MSP's Fabric IIN Agent of network2, repeat Step 1 with different name for config file, say src/fabric-ledger/config-n2-org2.json, and replace network1 with network2, org1 with org2 and Org1MSP with Org2MSP.

Security Domain Configuration¶

Security Domain config file specifies the scope of security domain, which can be a channel in Fabric networks or list of nodes. File docker-testnet/configs/security-domain-config.json can be used for Weaver testnets.

DNS Configuration¶

To allow an IIN Agent's to be able to discover other IIN Agents, a config file for DNS is required. Create one dnsconfig.json by creating a copy of template dnsconfig.json.template, and replace the values with:

• If Fabric networks are started with 1 org, and IIN Agent are to be started without TLS, use following values:

  {
      "network1": {
          "Org1MSP": {
              "endpoint": "localhost:9500",
              "tls": false,
              "tlsCACertPath": ""
          }
      },
      "network2": {
          "Org1MSP": {
              "endpoint": "localhost:9501",
              "tls": false,
              "tlsCACertPath": ""
          }
      }
  }
  

• If Fabric networks are started with 1 org, and IIN Agent are to be started with TLS, use following values:

  {
      "network1": {
          "Org1MSP": {
              "endpoint": "localhost:9500",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          }
      },
      "network2": {
          "Org1MSP": {
              "endpoint": "localhost:9501",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          }
      }
  }
  

• If Fabric networks are started with 2 orgs, and IIN Agent are to be started without TLS, use following values:

  {
      "network1": {
          "Org1MSP": {
              "endpoint": "localhost:9500",
              "tls": false,
              "tlsCACertPath": ""
          },
          "Org2MSP": {
              "endpoint": "localhost:9510",
              "tls": false,
              "tlsCACertPath": ""
          }
      },
      "network2": {
          "Org1MSP": {
              "endpoint": "localhost:9501",
              "tls": false,
              "tlsCACertPath": ""
          },
          "Org2MSP": {
              "endpoint": "localhost:9511",
              "tls": false,
              "tlsCACertPath": ""
          }
      }
  }
  

• If Fabric networks are started with 2 orgs, and IIN Agent are to be started with TLS, use following values:

  {
      "network1": {
          "Org1MSP": {
              "endpoint": "localhost:9500",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          },
          "Org2MSP": {
              "endpoint": "localhost:9510",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          }
      },
      "network2": {
          "Org1MSP": {
              "endpoint": "localhost:9501",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          },
          "Org2MSP": {
              "endpoint": "localhost:9511",
              "tls": true,
              "tlsCACertPath": "../../relay/credentials/fabric_ca_cert.pem"
          }
      }
  }
  

Environment Variables¶

To configure environment variables for Org1MSP's Fabric IIN Agent of network1, follow the steps:

1. Create a copy of .env.template as .env, and update following values based on previous configuration file paths:

   IIN_AGENT_ENDPOINT=localhost:9500
   MEMBER_ID=Org1MSP
   SECURITY_DOMAIN=network1
   DLT_TYPE=fabric
   CONFIG_PATH=./src/fabric-ledger/config-n1-org1.json
   DNS_CONFIG_PATH=./dnsconfig.json
   SECURITY_DOMAIN_CONFIG_PATH=./docker-testnet/configs/security-domain-config.json
   WEAVER_CONTRACT_ID=interop
   AUTO_SYNC=true
   

2. If IIN Agent has to be started with TLS enabled, also update following values:

   IIN_AGENT_TLS=true
   IIN_AGENT_TLS_CERT_PATH=../../relay/credentials/fabric_cert.pem
   IIN_AGENT_TLS_KEY_PATH=../../relay/credentials/fabric_key
   

Deployment¶

Use the following steps to run Fabric IIN Agents in host machine:

• To start IIN Agent for Org1MSP of network1, run:

  npm run dev
  

• To start IIN Agent for Org2MSP of network1 (only required if Fabric network was started with 2 orgs), run:

  IIN_AGENT_ENDPOINT=localhost:9510 MEMBER_ID=Org2MSP CONFIG_PATH=./src/fabric-ledger/config-n1-org2.json npm run dev
  

• To start IIN Agent for Org1MSP of network2, run:

  IIN_AGENT_ENDPOINT=localhost:9501 SECURITY_DOMAIN=network2 CONFIG_PATH=./src/fabric-ledger/config-n2-org1.json npm run dev
  

• To start IIN Agent for Org2MSP of network2 (only required if Fabric network was started with 2 orgs), run:

  IIN_AGENT_ENDPOINT=localhost:9511 MEMBER_ID=Org2MSP SECURITY_DOMAIN=network2 CONFIG_PATH=./src/fabric-ledger/config-n2-org2.json npm run dev
  

Corda Components¶

Using the sequence of instructions below, you can start a Corda network and run an application CorDapp on it. You can also run an interoperation CorDapp, a relay and a driver acting on behalf of the network. You can initialize the network's vault with access control policies, foreign networks' security groups (i.e., membership providers' certificate chains), and some sample state values that can be shared during subsequent interoperation flows.

Interoperation CorDapp¶

The interoperation CorDapp is deployed to run as part of any Corda application flow that involves cross-network interoperation.

Build the interoperation CorDapp as follows:

• Navigate to the weaver/core/network/corda-interop-app folder.
• Run the following to create the JAR files on which other Corda network components will depend on:

  make build-local
  

Corda Interoperation SDK¶

A client-layer library is defined in the weaver/sdks/corda folder. This contains functions for Corda based client applications to exercise interoperation capabilities via relays and also several utility/helper functions. The Corda Client tool, which we will use later, depends on this library.

To build the library, do the following:

• Navigate to the weaver/sdks/corda folder.
• Run the following command (make sure there is no github.properties file present in the directory):

  make build
  

Corda Simple Application and Client (Application)¶

This is a simple CorDapp that maintains a state of type SimpleState, which is a set of key-value pairs (of strings). The code for this lies in the weaver/samples/corda/corda-simple-application folder.

Build the corda-simple-application CorDapp as follows:

• Navigate to the weaver/samples/corda/corda-simple-application folder.
• Run the following:

  make build-local
  

Corda Network¶

The Corda networks' code lies in the weaver/tests/network-setups/corda folder. You can launch two separate Corda networks, namely Corda_Network and Corda_Network2. Each network runs the weaver/samples/corda/corda-simple-application CorDapp by default, which maintains a state named SimpleState containing a set of key-value pairs (of strings).

Follow the instructions below to build and launch both networks:

• Navigate to the weaver/tests/network-setups/corda folder.
• To spin up the Corda networks with the Interoperation CorDapps:
  • Each consisting of 1 node and a notary (for data-transfer), run:

    make start-local
    

  • Each consisting of 2 nodes and a notary (for asset-exchange/transfer), run:

    make start-local PROFILE="2-nodes"
    

  • Each consisting of 3 nodes and a notary (for asset-exchange/transfer), run:

    make start-local PROFILE="3-nodes"
    

You should see the following message in the terminal:

Waiting for network node services to start

PartyA node services started for network <network-name>
PartyB node services started for network <network-name>
PartyC node services started for network <network-name>
Notary node services started for network <network-name>

Corda Relay¶

The relay was built earlier, so you just need to use a different configuration file to start a relay for the Corda network.

Run a relay for Corda_Network as follows:

• Navigate to the weaver/core/relay folder.
• (Make sure you've already built the relay by running make.)
• To launch the server without TLS, leave the configuration file config/Corda_Relay.toml in its default state. Otherwise, edit it to set TLS flags for this relay and the other relays and drivers it will connect to in this demonstration as follows:

  .
  .
  cert_path="credentials/fabric_cert.pem"
  key_path="credentials/fabric_key"
  tls=true
  .
  .
  [relays]
  [relays.Fabric_Relay]
  hostname="localhost"
  port="9080"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Fabric_Relay2]
  hostname="localhost"
  port="9083"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Corda_Relay2]
  hostname="localhost"
  port="9082"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  [drivers]
  [drivers.Corda]
  hostname="localhost"
  port="9099"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  

• To launch the server, simply run the following:

  RELAY_CONFIG=config/Corda_Relay.toml cargo run --bin server
  

If the relay starts up successfully, the following will be logged on your terminal:

Relay Name: "Corda_Relay"
RelayServer listening on [::1]:9081

Run a relay for Corda_Network2 as follows (do this only if you have launched both Corda networks Corda_Network and Corda_Network2 and wish to test interoperation between them)

• Navigate to the weaver/core/relay folder.
• To launch the server without TLS, leave the configuration file config/Corda_Relay2.toml in its default state. Otherwise, edit it to set TLS flags for this relay and the other relays and drivers it will connect to in this demonstration as follows:

  .
  .
  cert_path="credentials/fabric_cert.pem"
  key_path="credentials/fabric_key"
  tls=true
  .
  .
  [relays]
  [relays.Fabric_Relay]
  hostname="localhost"
  port="9080"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Fabric_Relay2]
  hostname="localhost"
  port="9083"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  [relays.Corda_Relay]
  hostname="localhost"
  port="9081"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  [drivers]
  [drivers.Corda]
  hostname="localhost"
  port="9098"
  tls=true
  tlsca_cert_path="credentials/fabric_ca_cert.pem"
  .
  .
  

• To launch the server, simply run the following:

  RELAY_CONFIG=config/Corda_Relay2.toml cargo run --bin server
  

If the relay starts up successfully, the following will be logged on your terminal:

Relay Name: "Corda2_Relay"
RelayServer listening on [::1]:9082

Corda Driver¶

The code for this lies in the weaver/core/drivers/corda-driver folder.

Building Corda Driver¶

Build the Corda driver module as follows:

• Navigate to the weaver/core/drivers/corda-driver folder.
• Run the following:

  make build-local
  

Configuring¶

Configure the drivers as follows (you can skip this if you wish to run the drivers without TLS):

• Navigate to the weaver/core/drivers/corda-driver folder and create a .env file.
• To run the drivers without TLS, set the following default values:

  RELAY_TLS=false
  RELAY_TLSCA_TRUST_STORE=
  RELAY_TLSCA_TRUST_STORE_PASSWORD=
  RELAY_TLSCA_CERT_PATHS=
  

• To run the drivers with TLS, set the following values (replace <PATH-TO-WEAVER> with the absolute path of the weaver folder within your Cacti repository clone):

  RELAY_TLS=true
  RELAY_TLSCA_TRUST_STORE=<PATH-TO-WEAVER>/core/relay/credentials/fabric_trust_store.jks
  RELAY_TLSCA_TRUST_STORE_PASSWORD=trelay
  RELAY_TLSCA_CERT_PATHS=<PATH-TO-WEAVER>/core/relay/credentials/fabric_ca_cert.pem
  

Running¶

Run a Corda driver as follows:

• Navigate to the weaver/core/drivers/corda-driver folder.
• Run the following to start Corda driver for Corda_Network:

  ./build/install/driver-corda/bin/driver-corda
  

  If the driver starts successfully, it should log the following message on your terminal:

  Corda driver gRPC server started. Listening on port 9099
  

• Run the following to start Corda driver for Corda_Network2:

  DRIVER_PORT=9098 ./build/install/driver-corda/bin/driver-corda
  

  If the driver starts successfully, it should log the following message on your terminal:

  Corda driver gRPC server started. Listening on port 9098
  

Hyperledger Besu Components¶

Using the sequence of instructions below, you can start two separate Besu networks, each with 4 validator nodes, and EthSigner and application contract. You can also install an interoperation contract in the network. You can build a Besu CLI tool with which you can initialize both networks' ledgers.

Prerequisites¶

• Java (JDK and JRE): sample instructions (Version 11) You need to run Besu instructions in a separate environment (separate terminal or machine) than Corda, as Corda requires Java 8. You can also use update-alternatives to switch between java versions.
• tmux: sudo apt install tmux
• Besu:
  • Download and unpack the latest https://github.com/hyperledger/besu/releases/latest. You will find it in the link of the form: https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/x.y.z/besu-x.y.z.zip with x.y.z replaced with the version number. For instance, run the following command after updating version number accordingly.

    wget https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.0/besu-21.7.0.zip
    

  • Add the path to besu-x.y.z/bin to your system PATH
• EthSigner:
  • Download and unpack the latest from https://cloudsmith.io/~consensys/repos/ethsigner/packages/?q=tag%3Alatest (Requires Java 11 or later)
  • Add the path to ethsigner-x.y.z/bin to your system PATH

Besu Interoperation Node SDK¶

A client-layer library is defined in the weaver/sdks/besu/interoperation-node-sdk folder. This contains functions for Besu web3JS based applications to exercise interoperation capabilities via several utility/helper functions. The Besu-CLI tool, which we will use later, depends on this library.

To build the library, do the following:

• Navigate to the weaver/sdks/besu/interoperation-node-sdk folder.
• Run the following command:

  make build-local
  

Besu Network¶

The code for this lies in the weaver/tests/network-setups/besu folder.

This folder contains code to create and launch networks Network1 and Network2 of identical specifications:

• Network: 4 validator nodes, 1 EthSigner node.
• Network1 uses 8545 port for EthSigner while Network2 uses 9544 port for EthSigner.

Follow the instructions below to build and launch the networks:

• Navigate to the weaver/tests/network-setups/besu folder.
• To spin up both Network1 and Network2, run:

  make start
  

For more information, refer to the associated README.

Contracts¶

• AssetExchangeContract must be deployed which is present in weaver/core/network/besu/contracts/interop/manageAssetAny.sol. This contract is deployed along with application contract.
• Application contract simpleasset, located in weaver/samples/besu/simpleasset directory (for Asset Exchange), which supports creation, modification, transfer, and deletion, as well as locking, unlocking, and claiming, of simple AliceERC20 and BobERC20 tokens (examples of fungible assets), or AliceERC721 and BobERC721 tokens (example of non-fungible assets), or AliceERC1155 and BobERC1155 tokens (example of hybrid assets).

To deploy simpleasset with AssetExchangeContract on both Besu networks, navigate to the weaver/samples/besu/simpleasset folder, and run:

make deploy-contracts

Besu Client (besu-cli)¶

The CLI is used to interact with a Besu network, configure it and run contract transactions to record data on the ledger or query data.

The besu-cli Node.js source code is located in the weaver/samples/besu/besu-cli folder.

Prerequisites¶

If you are using a Linux system, make sure that lib64 is installed.

Installation¶

You can install besu-cli as follows:

• Navigate to the weaver/samples/besu/besu-cli folder.
• Run the following to install dependencies:

  make build-local
  

• Use the besu-cli executable in the bin folder for subsequent actions.

Tear Down the Setup¶

Bring down the test network's components as follows:

• Simply terminate the various relays and drivers, which are running in the foreground in different terminals
• To bring down the running Corda network:
  • Navigate to the weaver/tests/network-setups/corda folder.
  • Run the following:

    make clean
    

• To bring down all the running Fabric networks:
  • Navigate to the weaver/tests/network-setups/fabric/dev folder.
  • Run the following:

    make clean
    

• To bring down all the running Besu networks:
  • Navigate to the weaver/tests/network-setups/besu folder.
  • Run the following:

    make clean