Web browser API implementation

Signed-off-by: Mark S. Lewis <[email protected]>

Author: bestbeforetoday

.github/workflows/build-docs.yml

@@ -40,6 +40,22 @@ jobs:
           name: java-doc
           path: java/target/reports/apidocs/
 
+  web:
+    runs-on: ubuntu-22.04
+    name: Web documentation
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "lts/*"
+      - name: Generate documentation
+        run: make generate-docs-web
+      - name: Upload documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: web-doc
+          path: web/apidocs/
+
   site:
     runs-on: ubuntu-24.04
     name: Documentation site

.github/workflows/test.yml

@@ -207,3 +207,20 @@ jobs:
         run: make pull-docker-images
       - name: Run scenario tests
         run: make scenario-test-java
+
+  web_unit:
+    needs: verify-versions
+    runs-on: ubuntu-22.04
+    name: Unit test Web
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Run unit tests
+        run: make unit-test-web
+      - name: Upload bundle
+        uses: actions/upload-artifact@v4
+        with:
+          name: web-bundle
+          path: web/fabric-gateway-web.js

Makefile

@@ -9,6 +9,7 @@ base_dir := $(patsubst %/,%,$(dir $(realpath $(lastword $(MAKEFILE_LIST)))))
 go_dir := $(base_dir)/pkg
 node_dir := $(base_dir)/node
 java_dir := $(base_dir)/java
+web_dir := $(base_dir)/web
 scenario_dir := $(base_dir)/scenario
 
 go_bin_dir := $(shell go env GOPATH)/bin
@@ -48,6 +49,12 @@ build-java:
 	cd '$(java_dir)' && \
 		mvn -DskipTests install
 
+.PHONY: build-web
+build-web:
+	cd "$(web_dir)" && \
+		npm install && \
+		npm run build
+
 .PHONY: unit-test
 unit-test: generate lint unit-test-go unit-test-node unit-test-java
 
@@ -71,6 +78,11 @@ unit-test-java:
 	cd '$(java_dir)' && \
 		mvn test jacoco:report
 
+.PHONY: unit-test-web
+unit-test-web: build-web
+	cd "$(web_dir)" && \
+		npm test
+
 .PHONY: lint
 lint: staticcheck golangci-lint
 
@@ -233,6 +245,12 @@ generate-docs-java:
 	cd '$(java_dir)' && \
 		mvn javadoc:javadoc
 
+.PHONY: generate-docs-web
+generate-docs-web:
+	cd "$(web_dir)" && \
+		npm install && \
+		npm run generate-apidoc
+
 .PHONY: test
 test: shellcheck unit-test scenario-test
 

README.md

@@ -60,6 +60,7 @@ The following Makefile targets are available:
 - `make unit-test-go-pkcs11` - run unit tests for the Go client API, including HSM tests
 - `make unit-test-node` - run unit tests for the Node client API
 - `make unit-test-java` - run unit tests for the Java client API
+- `make unit-test-web` - run unit tests for the Web client API
 - `make unit-test` - run unit tests for all client language implementations
 - `make scenario-test-go` - run the scenario (end to end integration) tests for Go client API, including HSM tests
 - `make scenario-test-go-no-hsm` - run the scenario (end to end integration) tests for Go client API, excluding HSM tests

node/src/signingidentity.ts

@@ -14,7 +14,7 @@ import { Signer } from './identity/signer';
 export const undefinedSignerMessage = 'No signing implementation';
 
 const undefinedSigner: Signer = () => {
-    throw new Error(undefinedSignerMessage);
+    return Promise.reject(new Error(undefinedSignerMessage));
 };
 
 type SigningIdentityOptions = Pick<ConnectOptions, 'identity' | 'signer' | 'hash'>;
@@ -55,7 +55,7 @@ export class SigningIdentity {
         return this.#hash(message);
     }
 
-    async sign(digest: Uint8Array): Promise<Uint8Array> {
+    sign(digest: Uint8Array): Promise<Uint8Array> {
         return this.#sign(digest);
     }
 }

scenario/fixtures/rest/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+coverage/
+package-lock.json

scenario/fixtures/rest/package.json

@@ -0,0 +1,33 @@
+{
+    "name": "fabric-gateway-rest",
+    "version": "0.0.1",
+    "description": "REST server for fabric-gateway-web clients",
+    "main": "dist/index.js",
+    "engines": {
+        "node": ">=18.12.0"
+    },
+    "scripts": {
+        "format": "prettier '**/*.{ts,js}' --check",
+        "format:fix": "prettier '**/*.{ts,js}' --write",
+        "lint": "eslint .",
+        "postinstall": "tsc",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "license": "Apache-2.0",
+    "dependencies": {
+        "@grpc/grpc-js": "^1.10.4",
+        "@hyperledger/fabric-gateway": "file:../../../node/fabric-gateway-dev.tgz",
+        "express": "^4.19.2"
+    },
+    "devDependencies": {
+        "@tsconfig/node18": "^18.2.2",
+        "@types/express": "^4.17.21",
+        "@types/node": "^18.19.22",
+        "@typescript-eslint/eslint-plugin": "~7.3.1",
+        "@typescript-eslint/parser": "~7.3.1",
+        "eslint": "^8.57.0",
+        "eslint-config-prettier": "^9.1.0",
+        "prettier": "^3.2.5",
+        "typescript": "~5.4.2"
+    }
+}

scenario/fixtures/rest/src/gateway.ts

@@ -0,0 +1,37 @@
+import { Gateway } from '@hyperledger/fabric-gateway';
+import express, { Express } from 'express';
+import { Server } from './server';
+
+const REST_PORT = 3000;
+
+export interface GatewayServerOptions {
+    port: number;
+    gateway: Gateway;
+}
+
+export class GatewayServer {
+    #gateway: Gateway;
+    #server: Server;
+
+    constructor(options: GatewayServerOptions) {
+        this.#gateway = options.gateway;
+        this.#server = new Server({
+            port: options.port,
+            handlers: [this.#evaluate],
+        });
+    }
+
+    start(): Promise<void> {
+        return this.#server.start();
+    }
+
+    stop(): Promise<void> {
+        return this.#server.stop();
+    }
+
+    #evaluate(app: Express): void {
+        app.post('/evaluate', express.json(), (request, response) => {
+            request.body.proposal;
+        });
+    }
+}

scenario/fixtures/rest/src/index.ts

@@ -0,0 +1,28 @@
+import express, { Express } from 'express';
+import * as http from 'node:http';
+
+export interface ServerOptions {
+    port: number;
+    handlers: ((app: Express) => void)[];
+}
+
+export class Server {
+    readonly #app = express();
+    readonly #port: number;
+    #server?: http.Server;
+
+    constructor(options: ServerOptions) {
+        this.#port = options.port;
+        options.handlers.forEach((handler) => handler(this.#app));
+    }
+
+    start(): Promise<void> {
+        return new Promise((resolve) => {
+            this.#server = this.#app.listen(this.#port, resolve);
+        });
+    }
+
+    stop(): Promise<void> {
+        return new Promise((resolve, reject) => this.#server?.close((err) => (err ? resolve() : reject(err))));
+    }
+}