Glow is a reference client library for interacting with Zax, a NaCl-based Cryptographic Relay. You can read the full technical specification here. This reference implementation is in CoffeeScript. We will add links to other implementations in different languages as they become available.
Version 4.0 Update
Glow powers a test Dashboard app to provide user-friendly access point to given relay internal mailboxes. We maintain live Test Server that runs our latest build. For testing purposes expiration on that relay is set for 30 minutes.
Glow can be easily installed via
npm, which is included when you install Node.js.
In a terminal, navigate to the directory in which you'd like to install Glow and type the following:
npm install theglow
The built version of Glow will be available in
dist subdirectory, along with the minified copy.
NOTE: if you're going to use Glow in CLI mode, consider installing it globally:
npm install -g theglow.
To see commands that Glow utility provides, type in the terminal
./bin/glow.js (or just
glow if you've installed it globally).
Currently supported commands are:
glow clean <relay_url> <guest_public_key> delete all files in mailbox on the relay glow count <relay_url> <guest_public_key> [options] show number of pending files on the relay glow download <relay_url> <guest_public_key> [options] download file(s) from the relay glow key [options] show public key or h2(pk), set/update private key glow upload <relay_url> <guest_public_key> <file_url> upload file to the relay glow help [cmd] display help for [cmd]
glow help [cmd] to learn more about supported options for each command. Note that private key must be set with
glow key prior to any relay requests.
Running the tests
By default, unit tests connect to a local Zax Cryptographic Relay Server on
You may also run tests on our maintained test server by modifying the code in tests/helper.coffee#L37, or set your own remote relay URL in tests/helper.coffee#L42:
To create a build and run the tests, navigate to the glow directory and type the following in a terminal:
Note that if you have Gulp installed globally, you can also simply type
Note that only one instance of tests can be run at the same time, since test keys are derived from the same seeds. Running multiple instances simultaneously may cause unpredicted behavior.
By default, the build generates source maps and places them in the
If you are new to using source maps to debug, here's an overview:
Chrome: Source Maps on Chrome
Safari: Source Maps on Safari
Firefox: Source Maps on Firefox
Running the tests at the command line
To run the command line tests, navigate to the glow directory and type the following in a terminal:
Generate production-ready build via the command line:
This will create the appropriate files in the following directory:
Glow is released under the MIT License.
Exporting/importing and/or use of strong cryptography software, providing cryptography hooks, or even just communicating technical details about cryptography software is illegal in some parts of the world. If you import this software to your country, re-distribute it from there or even just email technical suggestions or provide source patches to the authors or other people you are strongly advised to pay close attention to any laws or regulations which apply to you. The authors of this software are not liable for any violations you make - it is your responsibility to be aware of and comply with any laws or regulations which apply to you.