Newer
Older
![Parity Fether](https://wiki.parity.io/images/logo-parity-fether.jpg)
# Parity Fether - a decentralised, light client-based wallet
## [» Download the latest release «](https://github.com/paritytech/fether/releases)
Parity Fether aims to be the lightest and simplest decentralized wallet. It supports Ether and ERC-20 tokens, and runs on top of [Parity Ethereum](https://github.com/paritytech/parity-ethereum) light client. This allows smooth synchronization and interaction with the Ethereum blockchain, in a decentralized manner.
By default, Parity Fether alpha runs on the Kovan test network. You can receive free Kovan Ether by posting your address in the [Kovan Faucet](https://gitter.im/kovan-testnet/faucet) Gitter channel. Fether will download and launch Parity Ethereum node at startup if it's not found on the computer. You can also separately launch your Ethereum client, Fether will automatically connect to it.
Parity Fether connects to the light node using [`@parity/light.js`](https://github.com/paritytech/js-libs/tree/master/packages/light.js), a Javascript library specifically crafted for wallets to connect with light clients.
Parity Fether is licensed under the BSD 3-Clause, and can be used for all your Ethereum needs.
If you run into problems while using Parity Fether, feel free to file an issue in this repository or hop on our [Gitter](https://gitter.im/paritytech/fether) or [Riot](https://riot.im/app/#/group/+parity:matrix.parity.io) chat room to ask a question. We are glad to help! **For security-critical issues**, please refer to the security policy outlined in [SECURITY.md](https://github.com/paritytech/parity/blob/master/SECURITY.md).
![Parity Fether](https://wiki.parity.io/images/fether-screenshot-0.jpg)
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
## Install dependencies
### MacOS
Install Xcode Command Line Tools, NVM, Node.js latest LTS, Yarn, and Git
```bash
xcode-select --install;
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash;
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
echo -e "Installing Node.js latest LTS version";
nvm install --lts
echo -e "Switching to use Node.js latest LTS version";
nvm use --lts;
brew install yarn --without-node;
brew install git --verbose;
brew upgrade git --verbose;
```
### Linux and Windows (Git Bash)
Install Node.js 10.x, Yarn, Git, and increase amount of inotify watchers
```bash
sudo apt update;
sudo apt install -y git nodejs npm curl;
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -;
apt-get install -y nodejs;
sudo ln -s /usr/bin/nodejs /usr/bin/node;
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -;
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list;
sudo apt-get update && sudo apt-get install yarn;
sudo ln -s /usr/bin/yarn /usr/local/bin/yarn;
```
## Install and start Parity Fether
### Linux
#### Using the AppImage (any distro)
- Download the [`.AppImage` file](https://github.com/paritytech/fether/releases).
- Make it executable `chmod +x /path/to/fether-x.x.x-x86_64.AppImage`.
- Launch it `/path/to/fether-x.x.x-x86_64.AppImage`.
#### Using the binary (any distro)
- Download the [`.tar.xz` file](https://github.com/paritytech/fether/releases).
- Unarchive it `tar xf fether-x.x.x.tar.xz`.
- Launch it `./fether-x.x.x/fether`.
#### Debian installer (Ubuntu, Linux Mint..)
- Download the [`.deb` file](https://github.com/paritytech/fether/releases).
- Download the [`.dmg` file](https://github.com/paritytech/fether/releases).
- Download the [`.exe` file](https://github.com/paritytech/fether/releases).
- Double click on it to install Fether.
- Fether will be added to the program menu.
### Passing config flags to the underlying Parity Ethereum node
You can pass specific flags for fether to launch the underlying Parity Ethereum with:
# Launching Parity Ethereum light client on Ropsten instead of Kovan (default) and connect Fether to it
You can also launch Parity Ethereum node before, with any flag you want:
# Launching Parity Ethereum light client on Ropsten instead of Kovan (default)
Make sure you have at least `yarn` version 1.4.2 and [Node.js >=10.10.0](https://nodejs.org/en/)
```bash
yarn --version // Should be at least 1.4.2
### Clone this repo
```bash
git clone https://github.com/paritytech/fether
cd ./fether
yarn install
```
Luke Schoen
committed
> Troubleshooting: If it hangs on a white screen in Electron even though it has compiled and has been syncing for a long time, then simply choose 'View > Reload' (CMD + R on macOS) from the Fether/Electron menu. If the Fether menu is not shown in the tray, then by clicking the Fether window and then holding down the ALT key to reveal it.
> Developer Tools: Open developer tools automatically by running `DEBUG=true yarn start` when not in the production environment
# Run without taskbar mode (no tray icon)
Luke Schoen
committed
```bash
Luke Schoen
committed
TASKBAR=false yarn start
Luke Schoen
committed
```
Luke Schoen
committed
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
# Production
## Build binaries for production
### General Notes:
1) Alternative to `yarn; yarn build; DEBUG=electron-builder yarn release --mac;` is to just run `yarn package` and then run the `open "./packages/fether-electron/dist/mac/Parity Fether.app"` (i.e. no need to install)
2) Publishing a new release to GitHub is performed by a maintainer of the repository. In this case you need to obtain the `GH_TOKEN` from GitHub settings and add it using `export GH_TOKEN="..."` to ~/.bashrc and then run `source ~/.bashrc`. If you get an error that the `GH_TOKEN` is missing and you are only building the binary but not publishing, then just ignore the error.
### macOS
Build and run binaries (i.e. .dmg) for production on macOS of a specific remote branch
```bash
git fetch origin INSERT_BRANCH_NAME:INSERT_BRANCH_NAME;
git checkout INSERT_BRANCH_NAME;
rm -rf ./packages/fether-electron/dist/
rm -rf /Applications/Parity\ Fether.app/
yarn; yarn build; DEBUG=electron-builder yarn release --mac;
open ./packages/fether-electron/dist/Parity\ Fether-0.3.0.dmg
```
### Linux
Build and run binaries (i.e. .deb) for production on Linux
> Note: If you want to save time building, then first edit electron-builder.json so that it only builds a single binary like .deb instead of all of them
Luke Schoen
committed
```bash
sudo rm -rf /opt/Parity\ Fether;
rm -rf ~/.config/Electron;
rm -rf ~/.config/fether;
rm -rf ./packages/fether-electron/dist/;
sudo rm /usr/local/bin/fether;
sudo apt remove -y fether;
yarn; yarn build; DEBUG=electron-builder yarn release --linux
sudo apt install -y ./packages/fether-electron/dist/fether_0.3.0_amd64.deb
fether
```
### Windows
Build and run binaries (i.e. .exe) binary for production on Windows
Luke Schoen
committed
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
```bash
rm -rf /packages/fether-electron/dist;
yarn; yarn build; DEBUG=electron-builder yarn release --win;
./packages/fether-electron/dist/Parity\ Fether-0.3.0.exe
```
## Debugging in production
Show terminal logs whilst running a binary executable.
### macOS
```
tail -f ~/Library/Application\ Support/fether/fether.log
```
### Linux
```
tail -f ~/.config/fether/fether.log
```
### Windows
```
tail -f ~/Application\ Data/fether/fether.log
```
Luke Schoen
committed
# Usage of taskbar mode
### macOS
Taskbar mode is `true` by default.
* Enabled `true`
Luke Schoen
committed
* Tray icon - Left-click or right-click the tray icon shows "tray context menu" containing just "Show/Hide Fether" and "Quit" options. "Show/Hide Fether" toggles the Fether window show/hide
* Dock icon - no action
* Fether window - frameless
Luke Schoen
committed
* Disabled `false`
Luke Schoen
committed
* Dock icon - toggles show/hide Fether window
* Fether window - frame (with close/minimise icons)
Luke Schoen
committed
* Always
Luke Schoen
committed
* Menubar - Fether menu shown by default
* Fether window - "window context menu" shown upon right-click in the Fether window
* Fether window - position is saved upon move, minimising, and close so it is restored in the same position.
Luke Schoen
committed
### Linux
Taskbar mode is `true` by default.
* Enabled `true`
Luke Schoen
committed
* Tray icon - Left-click or right-click the tray icon shows "tray context menu" containing just "Show/Hide Fether" and "Quit" options. "Show/Hide Fether" toggles the Fether window show/hide
* Dock icon - toggles show/hide Fether window
* Fether window - frameless
Luke Schoen
committed
* Disabled `false`
Luke Schoen
committed
* Dock icon - toggles show/hide Fether window
* Fether window - frame (with close/minimise icons)
* Menubar - Fether menu may not be not shown in the tray by default depending on whether `setMenuBarVisibility` has been set. Fether menu may be configured to automatically hide by setting `setAutoHideMenuBar`. Toggle show/hide the Fether menu in the frame by clicking the Fether window and then holding down the ALT key to reveal it, which only works if auto-hide menu bar is enabled.
Luke Schoen
committed
* Always
Luke Schoen
committed
* Fether window - "window context menu" shown upon right-click in the Fether window
* Fether window - position is saved upon move, minimising, and close so it is restored in the same position.
Luke Schoen
committed
Taskbar mode is `true` by default.
Luke Schoen
committed
* Enabled `true`
* Tray icon - Left-click toggles show/hide Fether window
* Tray icon - Right-click the tray icon shows "tray context menu" containing just "Show/Hide Fether" and "Quit" options. "Show/Hide Fether" toggles the Fether window show/hide
* Dock icon - toggles show/hide Fether window
* Fether window - frameless
Luke Schoen
committed
* Dock icon - toggles show/hide Fether window
* Fether window - frame (with close/minimise icons).
* Menubar - Fether menu may not be not shown in the tray by default depending on whether `setMenuBarVisibility` has been set. Fether menu may be configured to automatically hide by setting `setAutoHideMenuBar`. Toggle show/hide the Fether menu in the frame by clicking the Fether window and then holding down the ALT key to reveal it, which only works if auto-hide menu bar is enabled.
Luke Schoen
committed
* Fether window - "window context menu" shown upon right-click in the Fether window
* Fether window - position is saved upon move, minimising, and close so it is restored in the same position.
## Join the chat!
Get in touch with us on Gitter:
[![Gitter](https://img.shields.io/badge/Gitter-Fether-brightgreen.svg)](https://gitter.im/paritytech/fether)
Official website: https://parity.io | Be sure to check out [our Wiki](https://wiki.parity.io) for more information.