README.md

Running WebAssembly (WASM) Tests

To run WASM tests, servers and gateways are run like normal, but the client is served by an HTTP server in the browser.

clientServer.go is a basic HTTP server used to serve the Javascript clients.

The clients directory contains various directories each containing a different example. Each example contains one or more cMix clients running in javascript. The assets directory contains files used by all the examples.

To run the network and client server, use the provided run.sh script.

$ ./run.sh

To run just the HTTP server, use the provided script.

$ ./runClientServer.sh

Navigate to http://localhost:9090 to see a list of files in the server and navigate to a .html file in any of the examples to open a client.

wasm_exec.js

wasm_exec.js is provided by Go and is used to import the WebAssembly module in the browser. It can be retrieved from Go using the following command.

$ cp "$(go env GOROOT)/misc/wasm/wasm_exec.js" test/assets/

Note that this repository makes edits to wasm_exec.js and you must either use the one in this repository or add the following lines in the go importObject on global.Go.

global.Go = class {
    constructor() {
        // ...
        this.importObject = {
            go: {
                // ...
                // func Throw(exception string, message string)
                'gitlab.com/elixxir/xxdk-wasm/utils.throw': (sp) => {
                    const exception = loadString(sp + 8)
                    const message = loadString(sp + 24)
                    throw globalThis[exception](message)
                },
            }
        }
    }
}