build: unpin OpenAPI specs from v2.0.0-alpha.2 URL refs, use REMOTE

On a high level this is a find & replace operation where the occurrences of the
first bullet point were replaced with the second bullet point:
* `"$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2`
* `"$ref": "../../../../..`

The firs bullet point above is called a URL reference while the second one is
called a REMOTE references (remote as in a different spec file on the file-system).

1. With this change, we unlock the release process being able to issue code that
is working on the latest OpenAPI specifications that we are cross-referencing
from one package to another.
2. Previously you had to manually update the references in about a hundred
and fifty locations to make sure that the versions are bumped but after this
change this happens automatically as the newly introduced bundling process
and the usage of the REMOTE references instead of URL references.
3. The problem so far with the release process was that with the URL references
we dependended on the existence of a pushed git tag for a successful release build.
But we cannot git push the tag before having performed a successful release build,
so this was a chicken-egg problem that had to be somehow untangled from its
circular dependency hell and this change is what makes it happen by no longer
depending on the git tags having been pushed to the upstream repository.

Related to, but does not yet fix: https://github.com/hyperledger/cacti/issues/2175

Depends on #3288

Signed-off-by: Peter Somogyvari <peter.somogyvari@accenture.com>

extensions/cactus-plugin-htlc-coordinator-besu/src/main/json/openapi.tpl.json

@@ -69,7 +69,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredential",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "inputAmount": {
@@ -147,7 +147,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredential",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "gas": {
@@ -186,7 +186,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredential",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "htlcId": {

extensions/cactus-plugin-object-store-ipfs/src/main/json/openapi.json

@@ -34,6 +34,7 @@
  "GetObjectRequestV1": {
  "type": "object",
  "required": ["key"],
+ "additionalProperties": false,
  "properties": {
  "key": {
  "type": "string",
@@ -67,6 +68,7 @@
  "SetObjectRequestV1": {
  "type": "object",
  "required": ["key", "value"],
+ "additionalProperties": false,
  "properties": {
  "key": {
  "type": "string",
@@ -100,6 +102,7 @@
  "HasObjectRequestV1": {
  "type": "object",
  "required": ["key"],
+ "additionalProperties": false,
  "properties": {
  "key": {
  "type": "string",

extensions/cactus-plugin-object-store-ipfs/src/main/json/openapi.tpl.json

@@ -47,11 +47,11 @@
  "summary": "Retrieves an object from the object store.",
  "parameters": [],
  "requestBody": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_get_object_v1_request_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_get_object_v1_request_body"
  },
  "responses": {
  "200": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_get_object_v1_response_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_get_object_v1_response_body"
  }
  }
  }
@@ -68,11 +68,11 @@
  "summary": "Sets an object in the object store under the specified key.",
  "parameters": [],
  "requestBody": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_set_object_v1_request_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_set_object_v1_request_body"
  },
  "responses": {
  "200": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_set_object_v1_response_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_set_object_v1_response_body"
  }
  }
  }
@@ -89,11 +89,11 @@
  "summary": "Checks the presence of an object in the object store.",
  "parameters": [],
  "requestBody": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_has_object_v1_request_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/requestBodies/object_store_has_object_v1_request_body"
  },
  "responses": {
  "200": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/4bf8038ea4c0c341cef3a63b59f77c12cec65a46/packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_has_object_v1_response_body"
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/responses/object_store_has_object_v1_response_body"
  }
  }
  }

packages/cactus-plugin-consortium-manual/src/main/json/openapi.tpl.json

@@ -17,7 +17,7 @@
  "properties": {
  "jws": {
  "description": "The JSON Web Signature of the Cactus node.",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-core-api/src/main/json/openapi.json#/components/schemas/JWSGeneral",
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/schemas/JWSGeneral",
  "nullable": false
  }
  }
@@ -28,7 +28,7 @@
  "properties": {
  "jws": {
  "description": "The JSON Web Signature of the Cactus consortium.",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-core-api/src/main/json/openapi.json#/components/schemas/JWSGeneral",
+ "$ref": "../../../../../packages/cactus-core-api/src/main/json/openapi.json#/components/schemas/JWSGeneral",
  "nullable": false,
  "format": "The general format which is a JSON object, not a string."
  }

packages/cactus-plugin-htlc-eth-besu-erc20/src/main/json/openapi.tpl.json

@@ -76,7 +76,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredentialType",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "connectorId": {
@@ -118,7 +118,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredentialType",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "connectorId": {
@@ -166,7 +166,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredentialType",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "connectorId": {
@@ -208,7 +208,7 @@
  }
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "connectorId": {
  "type": "string"
@@ -232,7 +232,7 @@
  "type": "string"
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "connectorId": {
  "type": "string"
@@ -269,7 +269,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredential",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "gas": {
@@ -333,7 +333,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/RunTransactionResponse"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/RunTransactionResponse"
  }
  }
  }
@@ -367,7 +367,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }
@@ -453,7 +453,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }
@@ -487,7 +487,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }

packages/cactus-plugin-htlc-eth-besu/src/main/json/openapi.tpl.json

@@ -59,7 +59,7 @@
  "nullable": false
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "keychainId": {
  "description": "keychainId for the keychian plugin",
@@ -94,7 +94,7 @@
  "nullable": false
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "connectorId": {
  "description": "connectorId for the connector besu plugin",
@@ -141,7 +141,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredentialType",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "connectorId": {
@@ -193,7 +193,7 @@
  },
  "web3SigningCredential": {
  "description": "Web3SigningCredential",
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential",
  "nullable": false
  },
  "gas": {
@@ -218,7 +218,7 @@
  }
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "connectorId": {
  "type": "string"
@@ -242,7 +242,7 @@
  "type": "string"
  },
  "web3SigningCredential": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/Web3SigningCredential"
  },
  "connectorId": {
  "type": "string"
@@ -306,7 +306,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }
@@ -338,7 +338,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }
@@ -371,7 +371,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/InvokeContractV1Response"
  }
  }
  }
@@ -455,7 +455,7 @@
  "content": {
  "application/json": {
  "schema": {
- "$ref": "https://raw.githubusercontent.com/hyperledger/cactus/v2.0.0-alpha.2/packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/RunTransactionResponse"
+ "$ref": "../../../../../packages/cactus-plugin-ledger-connector-besu/src/main/json/openapi.json#/components/schemas/RunTransactionResponse"
  }
  }
  }