Glow

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.

Test Dashboard

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.

Installation

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.

Running the tests

By default, the unit tests connect to known Zax Cryptographic Relay Servers. You may change this by modifying the code in tests/helper.coffee#L57

host: 'https://zax_test.vault12.com'

To create a build and run the tests, navigate to the glow directory and type the following in a terminal:

node_modules/gulp/bin/gulp.js

Note that if you have Gulp installed globally, you can also simply type gulp.

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.

Source maps

By default, the build generates source maps and places them in the build directory.

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:

node_modules/gulp/bin/gulp.js test

Release Builds

Generate production-ready build via the command line:

node_modules/gulp/bin/gulp.js dist

This will create the appropriate files in the following directory: dist

Demo

To see Glow and Zax in action, check out the Live Demo. This is a test project included in Zax called Zax-Dash.

Contributing

We encourage you to contribute to Glow using pull requests! Please check out the Contributing to Glow Guide for guidelines about how to proceed.

Slack Community

We've set up a public slack community Vault12 Dwellers. Request an invite by clicking here.

License

Glow is released under the MIT License.

Legal Reminder

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.