Simplestaking is Tezos focused wallet existing as web application and desktop electron based app with support for hardware Trezor device. Wallet is created using Angular framework and NgRx state management.
For bugs please create issue in the repository. Best is to attach console dump to issue description.
Clone repository locally and install dependencies
npm install
Start watch mode of Angular CLI with local server running on localhost:5200
npm start
Before commit run build in AOT mode to ensure that application can pass production build.
Unit tests are implemented using Angular TestBed and Karma test runner. In order to run tests use
npm test
In order to test the application you will need the Trezor Model T hardware wallet or to run the emulator.
Please note that Trezor One is not supporting Tezos currency.
Connection between application and Trezor is managed by Trezor Connect communication middleware which need to run locally.
Additionally if other browser then Chrome is used a Trezor Bridge needs to be installed on the machine. Chrome allows to skip this step as it implements WebUSB API which allows to directly comminicate with Trezor device.
Trezor Bridge is required in case of using emulator instead of physical device.
- Clone project
git clone https://github.com/trezor/connect.git
- Install dependencies
npm install
- Build project and run server
npm run dev
Trezor connect will create local server on https://localhost:8088 by default.
If port needs to be changed you can modify port in build configuration /webpack/constants.js
Recomended it to modify connection to insecure http for local development to avoid invalid certificates.
Do that in /webpack/config.dev.babel.js by changing devServer.https property to false.
This step is straightforward.
On Windows install the deamon and it will start service automatically.
On Linux you can use appropriate packages.
If this do not work, you can compile the project directly from source code following instruction at https://github.com/trezor/trezord-go.
In order to run Trezor Bridge with emulator you will have to disable USB detection in Trezor Bridge by running it with parameters as
trezord -e 21324 -u=false
In case you do not own physical device you can emulate one. This can be recently done only in Linux and Mac OS X operating systems. More details are available in repository - https://github.com/trezor/trezor-core/blob/master/docs/emulator.md
Short tutorial:
- Clone git project
git clone https://github.com/trezor/trezor-core.git
cd trezor-core
- Refresh submodules
make vendor
-
Install required dependencies See https://github.com/trezor/trezor-core/blob/master/docs/build.md as it depends on OS
-
Build
make build_unix
- Run the emulator
.\emu.sh
After starting the emulator you will need to either create new wallet or recover wallet using seed passphrases. Follow instruction on display of the device and visit https://trezor.io/start/
Before building desktop version of the application you need to install extra dependencies required for packaging with elektron.
- Change directory
cd electron
- Install required dependencies
npm i
Now we can proceed to building the application
- Build Angular application for electron release under project root
npm run build:electron
This creates folder with resulting Angular build in folder /electron/src/dist
- Change folder to electron and build electron application
cd electron
npm run build
You can find executables and installer in the release folder /electron/releae/