Mist. Browse and use Ðapps on the Ethereum network.
Permalink
Failed to load latest commit information.
.circleci simplifying yarn tasks Jul 23, 2018
.github Update config.yml Sep 19, 2018
build-interface New SendTx and TxHistory windows (#4070) Oct 2, 2018
docs Create CNAME Aug 22, 2018
errorPages Merge develop into master for v0.8.9 (#1632) Feb 1, 2017
gulpTasks Use Buffer.from instead of new Buffer (#4091) Sep 19, 2018
icons Update Master to 0.7.5 (#816) Jun 15, 2016
interface Fixes identicon image (#4124) Oct 16, 2018
meteor-dapp-wallet @ 7899397 Updates to geth 1.8.13 (#4023) Aug 17, 2018
modules Updates Geth to 1.8.16 (#4101) Oct 4, 2018
scripts Update zipdll.nsh Feb 12, 2018
sounds add nodes and sound Oct 15, 2015
tests UI improvements on send tx window and Tx history (#4107) Oct 4, 2018
.babelrc Fix build Apr 8, 2018
.codeclimate.yml Blacklisting files for codeclimate analysis Oct 5, 2018
.eslintignore Update eslint May 31, 2018
.eslintrc.json excluding global variable from ESLint Oct 5, 2018
.gitignore Prebuilding interface/ for windows-only builds Aug 1, 2018
.gitmodules Fixing gitmodules Jul 18, 2018
.nvmrc Using same node version as electron May 31, 2018
.prettierignore Adds deps for prettier Mar 19, 2018
.prettierrc Adds deps for prettier Mar 19, 2018
.travis.yml New SendTx and TxHistory windows (#4070) Oct 2, 2018
AUTHORS added testnet indicator Feb 15, 2016
CODE_OF_CONDUCT.md Merge branch 'develop' of github.com:ethereum/mist into circle-ci Jun 29, 2018
CONTRIBUTING.md Merge branch 'develop' of github.com:ethereum/mist into circle-ci Jun 29, 2018
LICENSE bumped to 0.5.0 Feb 29, 2016
MISTAPI.md Merge branch 'develop' of github.com:ethereum/mist into circle-ci Jun 29, 2018
README.md Using local yarn instance instead (#4093) Sep 19, 2018
Wallet-README.txt Prettier files (#3755) Mar 18, 2018
appveyor.yml Using local yarn instance instead (#4093) Sep 19, 2018
clientBinaries.json Updates Geth to 1.8.16 (#4101) Oct 4, 2018
customProtocols.js Use Buffer.from instead of new Buffer (#4091) Sep 19, 2018
gulpfile.js Decoupling interface build for appveyor workaround Jul 27, 2018
main.js New SendTx and TxHistory windows (#4070) Oct 2, 2018
package.json Merge branch 'codeclimate' into develop Oct 5, 2018
release.js Applies prettier Mar 19, 2018
yarn.lock ESLint configuration for codeclimate analysis Oct 5, 2018

README.md

Mist Browserbeta

Github All Releases Build Status develop branch Build status Join the chat at https://gitter.im/ethereum/mist Code Triagers Badge

The Mist browser is the tool of choice to browse and use Ðapps.

For the Mist API see MISTAPI.md.

This repository is also the Electron host for the Meteor-based wallet dapp.

Help and troubleshooting

In order to get help regarding Mist or Ethereum Wallet:

  1. Please check the Mist troubleshooting guide.
  2. Go to our Gitter channel to connect with the community for instant help.
  3. Search for similar issues and potential help.
  4. Or create a new issue and provide as much information as you can to recreate your problem.

How to contribute

Contributions via Pull Requests are welcome. You can see where to help looking for issues with the Enhancement or Bug labels. We can help guide you towards the solution.

You can also help by responding to issues. Sign up on CodeTriage and it'll send you gentle notifications with a configurable frequency. It is a nice way to help while learning.

Installation

If you want to install the app from a pre-built version on the release page, you can simply run the executable after download.

For updating, simply download the new version and copy it over the old one (keep a backup of the old one if you want to be sure).

Linux .zip installs

In order to install from .zip files, please install libgconf2-4 first:

apt-get install libgconf2-4

Config folder

The data folder for Mist depends on your operating system:

  • Windows %APPDATA%\Mist
  • macOS ~/Library/Application\ Support/Mist
  • Linux ~/.config/Mist

Development

For development, a Meteor server assists with live reload and CSS injection.

Once a Mist version is released the Meteor frontend part is bundled using the meteor-build-client npm package to create pure static files.

Dependencies

To run mist in development you need:

  • Node.js v7.x (use the preferred installation method for your OS)
  • Meteor javascript app framework
  • Yarn package manager

Install the latter ones via:

$ curl https://install.meteor.com/ | sh
$ curl -o- -L https://yarnpkg.com/install.sh | bash

Initialization

Now you're ready to initialize Mist for development:

$ git clone https://github.com/ethereum/mist.git
$ cd mist
$ git submodule update --init --recursive
$ yarn

Run Mist

For development we start the interface with a Meteor server for auto-reload etc.

Start the interface in a separate terminal window:

$ yarn dev:meteor

In the original window you can then start Mist with:

$ cd mist
$ yarn dev:electron

NOTE: Client binaries (e.g. geth) specified in clientBinaries.json will be checked during every startup and downloaded if out-of-date, binaries are stored in the config folder.

NOTE: use --help to display available options, e.g. --loglevel debug (or trace) for verbose output

Run the Wallet

Start the wallet app for development, in a separate terminal window:

$ yarn dev:meteor

In another terminal:

$ cd my/path/meteor-dapp-wallet/app && meteor --port 3050

In the original window you can then start Mist using wallet mode:

$ cd mist
$ yarn dev:electron --mode wallet

Connect your own node

This is useful if you are already running your own node or would like to connect with a private or development network.

$ yarn dev:electron --rpc path/to/geth.ipc

Passing options to Geth

You can pass command-line options directly to Geth by prefixing them with --node- in the command-line invocation:

$ yarn dev:electron --mode mist --node-rpcport 19343 --node-networkid 2

The --rpc Mist option is a special case. If you set this to an IPC socket file path then the --ipcpath option automatically gets set, i.e.:

$ yarn dev:electron --rpc path/to/geth.ipc

...is the same as doing...

$ yarn dev:electron --rpc /my/geth.ipc --node-ipcpath /path/to/geth.ipc

Creating a local private net

If you would like to quickly set up a local private network on your computer, run:

geth --dev

Look for the IPC path in the resulting geth output, then start Mist with:

$ yarn dev:electron --rpc path/to/geth.ipc

Deployment

Our build system relies on gulp and electron-builder.

Dependencies

Cross-platform builds require additional dependencies needed by Electron Builder. Please follow their instructions for up to date dependency information.

Generate packages

To generate the binaries for Mist run:

$ yarn build:mist

To generate the Ethereum Wallet:

$ yarn build:wallet

The generated binaries will be under dist_mist/release or dist_wallet/release. Starting from 0.11.0, both Ethereum Wallet and Mist ships with a meteor-dapp-wallet instance (https://github.com/ethereum/meteor-dapp-wallet).

Options

platform

To build binaries for specific platforms (default: all available) use the following flags:

$ yarn build:mist --mac      # mac
$ yarn build:mist --linux    # linux
$ yarn build:mist --win      # windows
skipTasks

When building a binary, you can optionally skip some tasks — generally for testing purposes.

$ yarn build:mist --mac --skipTasks=build-interface,release-dist
Checksums

Prints the SHA-256 checksums of the distributables.

It expects installer/zip files to be in the generated folders e.g. dist_mist/release

$ yarn task checksums [--wallet]

Tasks found in gulpfile.js and gulpTasks/

Any other gulp task can be run using yarn task.

$ yarn task clean-dist

Testing

Tests run using Spectron, a webdriver.io runner built for Electron.

First make sure to build Mist with:

$ yarn build:mist

Then run the tests:

$ yarn test:unit:once
$ yarn test:e2e

Note: Integration tests are not yet supported on Windows.