@trufflesuite/uws-js-unofficial

:construction: This is a fork!

This is a fork of the original uWebSockets.js by @alexhultman. This fork adds unofficial support for Electron builds (Electron version 8, 9, 10, 11, and 12) by changing the build pipeline to use node-gyp instead of a custom C++ build script which allows us to use electron-rebuild as well as introducing a Typescript fallback for nodejs runtimes and architectures not supported by the included binaries. This repo is mainly for internal use to support Truffle Suite's Ganache UI Electron application.

NOTE: These binaries do not support SSL or Compression. They were not necessary for our uses, and we had issues getting those to compile with the Electron headers.

Creating a release

This is an internal fork used primarily in Ganache. There are no tests (might be a good idea to add some!) so testing must be done via Ganache and/or manually.

Update the version

The npm build script attempts to build the native binaries (but will fail unless the git submodules are checked out - see .gitmodules which defines the submodule uWebSockets which points to the uNetworking/uWebSockets native project). This is not necessary for packaging a release. The GitHub action aggregate_binaries will checkout the submodules, build the binaries and commit them to /binaries which are then included in the npm package.

This will update the version of the package, and create commit these changes to git.

First, find the current version of the package:

npm view . version
> 20.4.0-unofficial.4

For local changes only, you will only want to increment the pre-release identifier (as the version core tracks the upstream uWebSockets version), by using npm-version (this will commit the changes, tagged with the commit - remember to push this!) ie:

npm version 20.4.0-unofficial.5 --git-tag-version false
> v20.4.0-unofficial.5

Build the package

Create the package using npm-pack, which will build the project, and output trufflesuite-uws-js-unofficial-<version>.tgz. There will likely be a number of clang: error:s ouput, which you can safely ignore.

This file trufflesuite-uws-js-unofficial-<version>.tgz is what will be published to npm, and will be served to clients from npm via npm install.

Test the package in Ganache

This can be installed directly to a local nodejs project via npm install <path-to-trufflesuite-uws-js-unofficial-<version>.tgz>. In order to test the package within Ganache, @trufflesuite/uws-js-unofficial will need to be installed into a number of sub-packages:

• src/chains/ethereum/ethereum
• src/chains/filecoin/filecoin
• src/chains/tezos/tezos
• src/packages/core
• src/packages/utils

Navigate to each of the following package roots (found by searching for package.json files containing @trufflesuite/uws-js-unofficial), and install the local @trufflesuite/uws-js-unofficial package directly:

 npm install <path-to-trufflesuite-uws-js-unofficial-[version].tgz>

Run the Ganache test suite (this will exercise both the native uWS, and Typescript fallback versions) from the root of the Ganache repository:

 npm run test

Note: if testing externally to Ganache, the Typescript fallback can be forced by setting the UWS_USE_FALLBACK environment variable to true.

Publish the updated package

Run npm-publish to publish the package to npm (you will need to be authenticated with a user who has appropriate permissions to publish the package - see npm-adduser):

 npm publish <path-to-trufflesuite-uws-js-unofficial-[version].tgz>

:handshake: Permissively licensed by uNetworking AB

Intellectual property and all rights reserved by uNetworking. The license in this repository is the one kept from the original repository.

Where such explicit notice is given, source code is licensed Apache License 2.0 which is a permissive OSI-approved license with very few limitations. Modified "forks" should be of nothing but licensed source code, and be made available under another product name. If you're uncertain about any of this, please ask before assuming.