feat(copm): add fabric COPM implementation

Primary Change:
- add connectRPC cactus plugin for copm primitives

Secondary Changes:
- add common COPM prototypes
- add common weaver protos-js directory to enable
building under ci.yaml, which requires all local
dependencies to be present at build time
- remove incorrect 'main' declaration in protos-js
package file
- add separate tsconfig file to
/weaver/sdks/fabric/interoperation-node-sdk to
allow it to be built by ci.yaml
- update weaver fabric network makefile 'clean'
target to continue if some target files
were not generated by the make process

Co-authored-by: Peter Somogyvari <peter.somogyvari@accenture.com>

Signed-off-by: Jennifer Bell <jenniferlianne@gmail.com>
Signed-off-by: Peter Somogyvari <peter.somogyvari@accenture.com>

.cspell.json

@@ -43,6 +43,7 @@
     "commenceack",
     "configtx",
     "connectrpc",
+    "Copm",
     "Corda",
     "Cordapp",
     "couchdb",

.eslintignore

@@ -5,6 +5,7 @@ examples/cactus-example-carbon-accounting-frontend/www/
 examples/cactus-example-supply-chain-frontend/www/
 weaver/core/identity-management/iin-agent/out/
 weaver/common/protos-js/build/
+weaver/common/protos-js/**/*_pb.js
 
 **/src/main/typescript/generated/proto/**
 **/src/main/typescript/generated/wasm-pack/**
@@ -30,6 +31,7 @@ weaver/common/policy-dsl/parser/PolicyListener.js
 weaver/common/policy-dsl/parser/PolicyParser.js
 weaver/common/policy-dsl/test/MyErrorListener.js
 weaver/common/policy-dsl/test/MyParseTreeVisitor.js
+weaver/common/protos-js/driver/driver_grpc_pb.js
 weaver/core/drivers/fabric-driver/server/dbConnector.ts
 weaver/core/drivers/fabric-driver/server/events.ts
 weaver/core/drivers/fabric-driver/server/fabric-code.ts

.github/actions/copm_test/action.yaml

@@ -0,0 +1,36 @@
+name: 'Copm Test'
+description: "common setup steps for the weaver network needed to run copm tests"
+runs:
+  using: "composite"
+  steps:
+    - name: Use Node.js ${{ env.NODEJS_VERSION }}
+      uses: actions/setup-node@v4.0.2
+      with:
+        node-version: ${{ env.NODEJS_VERSION }}
+    - id: yarn-cache
+      name: Restore Yarn Cache
+      uses: actions/cache@v4.0.1
+      with:
+        key: ${{ runner.os }}-yarn-${{ hashFiles('./yarn.lock') }}
+        path: ./.yarn/
+        restore-keys: |
+          ${{ runner.os }}-yarn-${{ hashFiles('./yarn.lock') }}
+    - name: Get Latest Relay Dependencies
+      shell: bash
+      run: |
+        make protos-local
+        cargo update -p nom
+        cargo update -p lexical-core
+      working-directory: weaver/core/relay
+    - name: Use Protoc 3.15
+      shell: bash
+      run: |
+        curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v3.15.6/protoc-3.15.6-linux-x86_64.zip
+        unzip protoc-3.15.6-linux-x86_64.zip -d protoc
+        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
+      # PROTOS
+    - name: Build local weaver dependencies
+      run: make setup --trace
+      shell: bash
+      working-directory: packages/cacti-plugin-copm-fabric

.github/workflows/ci.yaml

@@ -64,6 +64,7 @@ jobs:
       plugin-htlc-coordinator-besu-changed: ${{ steps.changes.outputs.plugin-htlc-coordinator-besu-changed }}
       test-tooling-changed: ${{ steps.changes.outputs.test-tooling-changed }}
       ghcr-dev-container-vscode-changed: ${{ steps.changes.outputs.ghcr-dev-container-vscode-changed }}
+      plugin-copm-fabric-changed: ${{ steps.changes.outputs.plugin-copm-fabric-changed }}
     runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4.1.7
@@ -174,6 +175,10 @@ jobs:
               - './packages/cactus-plugin-keychain-memory/**'
               # - './.github/workflows/ci.yaml'
 
+            plugin-copm-fabric-changed:
+              - './packages/cacti-copm-common/**'
+              - './packages/cacti-plugin-copm-fabric/**'
+
   build-dev:
     needs: check-ci-skip
     continue-on-error: false
@@ -1462,6 +1467,14 @@ jobs:
           name: coverage-reports-27
           path: ./code-coverage-ts/**/
 
+  copm-tests:
+    needs: 
+      - build-dev
+      - compute_changed_packages
+    if: needs.compute_changed_packages.outputs.plugin-copm-fabric-changed == 'true'
+    uses: ./.github/workflows/test_copm.yaml
+
+
   plc-fabric-0:
     needs:
       - build-dev

.github/workflows/test_copm.yaml

@@ -0,0 +1,69 @@
+on:
+    # Triggers the workflow on push or pull request events but only for the main branch
+    workflow_call:
+
+env:
+  NODEJS_VERSION: v18.18.2
+  RUN_TRIVY_SCAN: true
+  RUN_CODE_COVERAGE: true
+
+jobs:
+    copm-fabric-fabric-pledge-and-provestate:
+        continue-on-error: false
+        env:
+          CACTI_NPM_PACKAGE_NAME: "@hyperledger-cacti/cacti-plugin-copm-fabric"
+          HFC_LOGGING: '{"debug":"console","info":"console","warn": "console","error":"console"}'
+          FULL_BUILD_DISABLED: true
+          FREE_UP_GITHUB_RUNNER_DISK_SPACE_DISABLED: false
+          JEST_TEST_PATTERN: packages/cacti-plugin-copm-fabric/src/test/typescript/integration/test-copm-pledge-claim.test.ts packages/cacti-plugin-copm-fabric/src/test/typescript/integration/test-copm-getverifiedview.test.ts
+          JEST_TEST_RUNNER_DISABLED: false
+          JEST_TEST_COVERAGE_PATH: ./code-coverage-ts/plc-copm-fabric-fabric-pledge
+          JEST_TEST_CODE_COVERAGE_ENABLED: true
+          TAPE_TEST_PATTERN: ""
+          TAPE_TEST_RUNNER_DISABLED: true
+        runs-on: ubuntu-22.04
+        steps:
+          - uses: actions/checkout@v4.1.1
+          - uses: ./.github/actions/copm_test/
+          - name: Make the fabric network
+            run: make pledge-network --trace
+            working-directory: packages/cacti-plugin-copm-fabric
+          - name: show the running network
+            run: docker container ls
+          - run: ./tools/ci.sh
+          - name: Upload coverage reports as artifacts
+            if: ${{ env.RUN_CODE_COVERAGE == 'true' }}
+            uses: actions/upload-artifact@v4.3.3
+            with:
+              name: coverage-reports-copm-fabric
+              path: ./code-coverage-ts/**/
+
+    copm-fabric-fabric-lock:
+        continue-on-error: false
+        env:
+          CACTI_NPM_PACKAGE_NAME: "@hyperledger-cacti/cacti-plugin-copm-fabric"
+          HFC_LOGGING: '{"debug":"console","info":"console","warn": "console","error":"console"}'
+          FULL_BUILD_DISABLED: true
+          FREE_UP_GITHUB_RUNNER_DISK_SPACE_DISABLED: false
+          JEST_TEST_PATTERN: packages/cacti-plugin-copm-fabric/src/test/typescript/integration/test-copm-lock-claim.test.ts
+          JEST_TEST_RUNNER_DISABLED: false
+          JEST_TEST_COVERAGE_PATH: ./code-coverage-ts/plc-copm-fabric-fabric-lock
+          JEST_TEST_CODE_COVERAGE_ENABLED: true
+          TAPE_TEST_PATTERN: ""
+          TAPE_TEST_RUNNER_DISABLED: true
+        runs-on: ubuntu-22.04
+        steps:
+          - uses: actions/checkout@v4.1.1
+          - uses: ./.github/actions/copm_test/
+          - name: Make the fabric network
+            run: make lock-network --trace
+            working-directory: packages/cacti-plugin-copm-fabric
+          - name: show the running network
+            run: docker container ls
+          - run: ./tools/ci.sh
+          - name: Upload coverage reports as artifacts
+            if: ${{ env.RUN_CODE_COVERAGE == 'true' }}
+            uses: actions/upload-artifact@v4.3.3
+            with:
+              name: coverage-reports-copm-fabric-lock
+              path: ./code-coverage-ts/**/

.prettierignore

@@ -8,6 +8,7 @@ packages/core
 packages/connection-chain
 contribs/
 **/src/main/typescript/generated/**
+weaver/common/protos-js/**/*_pb.js
 
 # TODO: Send a PR that moves these generated code files under a sub-directory 
 # that is called "generated" so that the default ignore pattern above matches it

packages/cacti-copm-core/README.md

@@ -0,0 +1,27 @@
+# @hyperledger-cacti/cacti-copm-core
+
+This package defines the common types, interfaces, and endpoints for the
+COPM module to be used by Digital Ledger-specific implementations.
+
+These endpoints require specific chaincode and weaver relays to be deployed on the network.
+Please see https://hyperledger-cacti.github.io/cacti/weaver/introduction/.
+
+Endpoint documentation:
+https://jenniferlianne.github.io/cacti/references/openapi/cacti-copm-core_openapi/
+
+# Usage
+
+## Installation
+
+Yarn: 
+
+    yarn add --exact @hyperledger-cacti/cacti-copm-core
+
+
+# Development
+
+When implementing a new distributed ledger, the following interfaces must be implemented:
+
+- DLTransactionContext:  Implements running a transaction on the local network
+- DLRemoteTransactionContext: Uses the weaver relays to run a transaction on another network
+- DLTransactionContextFactory: Factory to return either local or remote context for the specific DLT.

packages/cacti-copm-core/buf.gen.yaml

@@ -0,0 +1,14 @@
+version: v1
+plugins:
+  # This will invoke protoc-gen-es and write output to src/gen
+  - plugin: es
+    out: src/main/typescript/generated
+    opt:
+      # Add more plugin options here
+      - target=ts
+  # This will invoke protoc-gen-connect-es
+  - plugin: connect-es
+    out: src/main/typescript/generated
+    opt:
+      # Add more plugin options here
+      - target=ts

packages/cacti-copm-core/openapitools.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "./node_modules/@openapitools/openapi-generator-cli/config.schema.json",
+  "spaces": 2,
+  "generator-cli": {
+    "version": "6.6.0"
+  }
+}

packages/cacti-copm-core/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@hyperledger-cacti/cacti-copm-core",
+  "version": "2.0.0",
+  "description": "Cacti Common Operators",
+  "homepage": "https://github.com/hyperledger-cacti/cacti#readme",
+  "bugs": {
+    "url": "https://github.com/hyperledger-cacti/cacti/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hyperledger-cacti/cacti.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Jennifer Bell",
+  "main": "dist/lib/main/typescript/index.js",
+  "module": "dist/lib/main/typescript/index.js",
+  "types": "dist/lib/main/typescript/index.d.ts",
+  "files": [
+    "dist/*"
+  ],
+  "scripts": {
+    "bundleopenapi": "yarn run --top-level tools:bundle-open-api-tpl-files",
+    "codegen": "yarn run --top-level run-s 'codegen:*'",
+    "codegen:proto": "yarn run proto:openapi; yarn run proto:connectrpc",
+    "dev:redo": "yarn run bundleopenapi; yarn run codegen:proto",
+    "proto:connectrpc": "yarn run buf generate --template=./buf.gen.yaml ./src/main/proto/generated/openapi",
+    "proto:openapi": "yarn run --top-level openapi-generator-cli generate -i ./src/main/json/openapi.json -g protobuf-schema --model-name-suffix=PB --language-specific-primitives=google.protobuf.Any --type-mappings=AnyType=google.protobuf.Any --type-mappings=object=google.protobuf.Any --additional-properties=packageName=org.hyperledger.cacti.plugin.cacti.plugin.copm.core -o ./src/main/proto/generated/openapi/ -t=./src/main/mustache/openapi-generator/templates/protobuf-schema/ --ignore-file-override ../../openapi-generator-ignore"
+  },
+  "dependencies": {
+    "@bufbuild/buf": "1.30.0",
+    "@bufbuild/protobuf": "1.10.0",
+    "@connectrpc/connect": "1.4.0",
+    "@hyperledger/cacti-weaver-sdk-fabric": "2.0.0",
+    "@hyperledger/cactus-common": "2.0.0"
+  },
+  "devDependencies": {
+    "@bufbuild/protoc-gen-es": "1.8.0",
+    "@connectrpc/connect-node": "1.4.0",
+    "@connectrpc/protoc-gen-connect-es": "1.4.0",
+    "@openapitools/openapi-generator-cli": "2.7.0"
+  }
+}