Sheikah is a Witnet compatible desktop wallet, data requests and smart contracts development environment.

Current status

Sheikah is still a Technology Preview. If you run it, you will find:

• Features that work: wallets creation, seed phrase export, addresses generation and addresses listing.
• Features that are partially implemented: transactions listing, data requests listing and smart contracts listing.
• Features that are mocked for demo purposes: data requests editor, smart contracts editor, Sheikah Marketplace.
• Features that are still missing: data requests deployment, smart contracts deployment and selection of full node to use as backend.

All of these features will be made available along the first Witnet testnet during 2019 Q1.

Installation

From Github Releases

Go to releases section and download the binary suitable for your system.

From Source

To install from source follow this instructions in a terminal:

git clone https://github.com/witnet/sheikah.git
cd sheikah
yarn
yarn package

Then, copy the appropriate binary written in release directory. Just click the file to open Sheikah.

Logs

We are using Electron Log library and we log to both, console and the file in the following location:

• on Linux: ~/.config/Sheikah/log.log
• on MacOS: ~/Library/Logs/Sheikah/log.log
• on Windows: %USERPROFILE%\AppData\Roaming\Sheikah\log.log

Development

When running in development the log level is set to debug, debug, info, warn, and error messages will be logger.

Production

When running in production the log level is set to warn, only warn and error messages will be logged.

Sheikah Development

This is a Web/Desktop application built with Electron and uses the electron-react-typescript template as its base.

For developing we recommend you use yarn instead of npm.

When developing Sheikah, we support Node versions: 8, 9 and 10. It might work with another version but we do not guarantee it will do in the future.

Quickstart

# clone the repository
git clone [email protected]:witnet/sheikah.git

# cd into the cloned repository
cd sheikah

# install application dependencies
yarn

# launch development application
yarn electron:serve

Formatter

• Verify files are correctly formatted with yarn lint
• Repair lint errors with (this operation modifies your files!) yarn lint!

Test

We use Jest for testing. All test commands are a thin wrapper around jest so with any of them you can use Jest's CLI options

# run unit/integration tests
yarn test

# run end-to-end tests
yarn test:e2e

# run unit tests 
yarn test:unit

To run specific tests you can use jest directly:

# run test specified with a pattern or filename
yarn jest my-test #or
yarn jest path/to/my-test.js

# run tests related to changed files based on hg/git (uncommitted files)
yarn jest -o

# run tests related to path/to/fileA.js and path/to/fileB.js
yarn jest --findRelatedTests path/to/fileA.js path/to/fileB.js

# run tests that match this spec name (match against the name in describe or test, basically).
yarn jest -t name-of-spec

# run tests in watch mode
yarn jest --watch #runs jest -o by default
yarn jest --watchAll #runs all tests

Build

Production

To build the application run: yarn electron:build, the build files are written to dist directory.

Contributing

You can read the contributing guide

Travis (continuous integration)

When opening a pull request a job in Travis will be fired off to check the changes. To avoid wasting time waiting for Travis output we provide the command yarn travis that will perform almost the same checks but it'll run in your computer.

Troubleshooting

• Use yarn clean to remove the contents of the build directory (dist_electron)
• Use yarn clean-deps to remove all installed dependencies
• Use yarn reinstall to remove all installed dependencies and install them again

If the application doesn't boot correctly and no error is reported in the terminal, try running yarn reinstall and try again.