Fether - Frequently Asked Questions - Wiki Parity Tech Documentation

How to fix a webcam error?

Accounts may be imported into Fether from Parity Signer if they were created for the chain that you are running with Fether (see FAQ How to launch Fether on a different network).

The webcam on your computer is required for the following reasons:

If you encounter a webcam error when using Fether, then try the following steps and try using Fether again:

macOS

When running Fether in the development environment on macOS Mojave, you need to allow the Terminal application to access your webcam. Try the following steps and try using Fether again:

Why does the sync starts back at 0% when I restart Fether?

The background process to synchronize the blockchain does not restart from scratch. The sync continues from the point it was left at the last time Fether was launched.

Why isn’t Fether syncing?

In this example we will assume that you have encountered the issue after:

You may encounter issues syncing Fether on any network. You know you have the issue due to a corrupt database when:

To resolve the issue simply delete the corrupted blockchain database for that network in the subdirectory where the light client blockchain database used by Fether is stored. Then restart Fether and it will start synchronizing with that network from scratch.

How to add my ERC-20 Token to Fether?

We use the following repository to get the token list: https://github.com/ethereum-lists/tokens. To see your token in Fether, you need first to open a pull request to this repository. Once it is merged it will be added in Fether’s next release.

Why doesn’t a token have an icon?

We use the following repository to get the token list: https://github.com/ethereum-lists/tokens. If you don’t see an image for a token in Fether, it means that the logo field for this token was left empty or the url given is not reachable. Either way, you need to open a pull request or an issue to this repository to fix it. Once it is merged it will be added in Fether’s next release.

Where are Fether accounts stored?

Keys for Fether accounts are stored in chain-specific subdirectories within the Parity Ethereum ‘keys’ folder. You will find them here:

How to delete an account in Fether?

We chose not to allow the deletion of accounts from the Fether user interface. In case you really know what you are doing and do not want an account to appear in Fether, you can locate and move the keystore file from the ‘keys’ folder. You will find them here: Where are Fether accounts stored errors.

Where is Fether installed?

Fether binary executable files are stored here:

Where is the light client blockchain database used by Fether stored?

Light client blockchain databases for Fether are stored in chain-specific subdirectories within the Parity Ethereum ‘chains_light’ folder. You will find them here:

Where are Fether logs stored?

Where is Parity Ethereum installed?

Note that with older versions of Fether (i.e. <0.3) or separately installed versions of Parity Ethereum then it may be installed at:

How to launch Fether on a different network?

You can pass specific flags (such as --chain) for Fether to launch the underlying Parity Ethereum on a specific network:

# Launching Fether with a Parity Ethereum light client node on Ropsten
$ /path/to/fether --chain ropsten --light

Fether only supports networks that are compatible with running a light client node using the --light option of the Fether CLI that is shown above, and as mentioned in the FAQ What networks are supported by Fether?.

What networks are supported by Fether?

Fether currently supports:

Görli Testnet support will be added soon.

Read here about how to launch Fether on a different network.

How to launch Fether with a separately launched Parity Ethereum node?

Fether will download and install Parity Ethereum if it is not already installed. Fether will run a Parity Ethereum light client node if Parity Ethereum has not already been launched separately.

1) Launch a Parity Ethereum node using any appropriate flags. Check what flags are available with parity --help).

# Launch a Parity Ethereum light client node on the Ropsten network instead of the Kovan (default) test network
$ parity --chain ropsten --light

2) Launch Fether (using the launcher menu or in a terminal session), it will automatically detect the local node and connect to it.

How to connect Fether to a Parity Ethereum full node?

Fether will automatically connect to any Parity Ethereum node that is already running (using WebSockets port 8546). To connect Fether to a full node:

1) Launch a Parity Ethereum full node using any appropriate flags. Check what flags are available with parity --help).

# Launch a Parity Ethereum full node on Ropsten test network
$ parity --chain ropsten

2) Launch Fether (from the application launcher menu or in a terminal session), it will automatically detect the local node and connect to it.

How to access logs to troubleshoot errors?

To help users understand what is going on if Fether crashes, it is essential to provide logs.

Logs for the user interface (UI) may be viewed as follows:

Logs related to the underlying Parity Ethereum node or the overall Fether application will only appear if you launch Fether using a terminal session.

Logs that are generated when running Fether are saved at locations mentioned in FAQ Where are Fether logs stored?. Please share the log file with us by uploading it when creating an Issue in the Fether GitHub repository or by clicking the ‘Feedback’ button on the Accounts page of the Fether window.

Tips

If you want the Developer Tools to automatically open each time you run Fether, see the FAQ “How to open Developer Tools automatically when Fether launches”.

Advanced

If you want to monitor the latest changes to the log file whilst running Fether in a terminal session then use the tail command (i.e. run tail -f ~/.config/fether/fether.log).

If you want to troubleshoot errors in the user interface (UI) whilst running Fether then add line-of-code breakpoints in Developer Tools by clicking the ‘Sources’ tab, choosing ‘Page > top > webpack-internal://’, and then setting line-of-code breakpoints.

What is “taskbar mode”?

Fether runs by default as a tray application that is frameless, so it doesn’t have any window decoration (basically a frame and the usual minimize/full screen/close buttons)

Below we describe whether Fether’s features that are ‘Always’ apparent, or only apparent depending on whether taskbar mode is ‘Enabled’ or ‘Disabled’, and depending on which operating system Fether is run on.

macOS

Taskbar mode is true by default.

Linux

Taskbar mode is true by default.

Windows

Taskbar mode is true by default.

How to run Fether without “taskbar mode”?

Development Environment

Disable the TASKBAR environment variable prior to launching Fether as follows:

TASKBAR=false yarn start

How to open Developer Tools automatically when Fether launches?

Development Environment

Open Developer Tools automatically by running Fether with the DEBUG environment variable set as follows:

DEBUG=true yarn start

What to do if the Fether window appears unresponsive or does not load?

Development Environment

If you run Fether with yarn start it is a known issue that the Fether window will hang with just a white/blank screen even after it has compiled successfully. Fix it by simply right-clicking the Fether window to reveal the Fether menu, and choose the menu item ‘View > Reload’ (or use shortcut CMD + R on macOS, CTRL + R on Linux/Windows). Alternatively run Fether with yarn electron (without live reload).

If Fether is otherwise unresponsive or does not load then please follow the steps in the FAQ How to access logs to troubleshoot errors.

Production Environment

Please follow the steps in the FAQ How to access logs to troubleshoot errors.

How to switch between languages that Fether supports?

In the Fether window you can switch between supported languages by simply right-clicking the Fether window to reveal the Fether menu, then choosing the menu item ‘Preferences > Language’, and selecting one of the available languages from the list (i.e. English).

The Fether window will then automatically refresh and its contents will now be in the language you chose. The active language that you chose will now have a tick next to it in the menu.

How to add support for a new language to Fether?

Contributors are invited to create a Pull Request that translates Fether other languages.

English language support is currently the default.

Example: Add language support for the German language

Solution: See the following Pull Request that shows the changes that were required to add German language support https://github.com/paritytech/fether/pull/464

1) Find the internationalisation abbreviation of the new language that you want to add. In this example the new language will be referred to as . Example: 'de' for Deutsch (German), or 'en' for English. So if you wanted to add the French language then would be 'fr'. 2) Convert the Fether menu into the new language as follows.

Limitations