Mist. Browse and use Ðapps on the Ethereum network.
Pull request Compare This branch is 52 commits ahead, 527 commits behind ethereum:master.
nyatla 不要なリンクの削除
接続先ノードをMainNetだけにする。
パッケージの更新
Latest commit 6820375 Apr 27, 2018
Permalink
Failed to load latest commit information.
.github Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
errorPages Merge develop into master for v0.8.9 (ethereum#1632) Feb 1, 2017
gulpTasks Nekoniumに合わせた修正 Apr 25, 2018
icons 画像の差し替え Jun 22, 2017
interface 不要なリンクの削除 Apr 27, 2018
modules 不要なリンクの削除 Apr 27, 2018
scripts Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
sounds add nodes and sound Oct 15, 2015
tests 不要なリンクの削除 Apr 27, 2018
.babelrc Updates master branch (ethereum#3065) Sep 22, 2017
.codeclimate.yml 0.8.10 into master (ethereum#2159) Apr 26, 2017
.editorconfig Prettier files (ethereum#3755) Mar 18, 2018
.eslintignore 0.8.10 into master (ethereum#2159) Apr 26, 2017
.eslintrc.yml Develop into master (ethereum#2804) Jul 24, 2017
.gitignore update npm-shrinkwrap.json Nov 18, 2016
.gitmodules moved interface back Sep 17, 2015
.nvmrc Version bump: 0.9.0 (ethereum#2716) Jul 11, 2017
.prettierignore Prettier files (ethereum#3755) Mar 18, 2018
.prettierrc Prettier files (ethereum#3755) Mar 18, 2018
.travis.yml Refactoring upload-queue task; Prettier code style changes Mar 20, 2018
AUTHORS added testnet indicator Feb 15, 2016
CODE_OF_CONDUCT.md Prettier files (ethereum#3755) Mar 18, 2018
CONTRIBUTING.md Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
LICENSE bumped to 0.5.0 Feb 29, 2016
MISTAPI.md Prettier files (ethereum#3755) Mar 18, 2018
README.md Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
Wallet-README.txt Prettier files (ethereum#3755) Mar 18, 2018
clientBinaries.json clientBinariesの巻き戻し Apr 24, 2018
customProtocols.js Prettier files (ethereum#3755) Mar 18, 2018
gulpfile.js Prettier formatting: single-quotes Mar 21, 2018
main.js Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
nekoniumTODO Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018
package-lock.json Slightly improved version of japanese translation from ethereum/develop Feb 28, 2018
package.json Nekoniumに合わせた修正 Apr 25, 2018
release.js Prettier files (ethereum#3755) Mar 18, 2018
yarn.lock Merge branch 'v0.10.0' into nek-v0.10.0 Apr 9, 2018

README.md

Nekonium Mist Browserbeta

Github All Releases Build Status develop branch 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 the MISTAPI.md.

Please note that this repository is the Electron host for the Meteor based wallet dapp whose repository is located here: https://github.com/ethereum/meteor-dapp-wallet.

Help and troubleshooting

In order to get help regarding Mist or Ethereum Wallet, please follow:

  1. Please check the Mist troubleshooting guide.
  2. Go to the Gitter Channel to connect with the community for instant help.
  3. Search for similar issues and potential help.
  4. Or create a new issue.

How to contribute

Contributions via Pull Requests are so welcome. You can see where to help looking for issues with the Enhancement or Bug labels. We can help guiding 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 executeable 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 is stored in other places:

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

Development

For development, a Meteor server will need to be started to assist 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 prefered installation method for your OS)
  • Meteor javascript app framework
  • Yarn package manager
  • Electron v1.7.11 cross platform desktop app framework
  • Gulp build and automation system

Install the latter ones via:

$ curl https://install.meteor.com/ | sh
$ curl -o- -L https://yarnpkg.com/install.sh | bash
$ yarn global add electron@1.8.4
$ yarn global add gulp

Initialisation

Now you're ready to initialise Mist for development:

$ git clone https://github.com/ethereum/mist.git
$ cd mist
$ yarn

To update Mist in the future, run:

$ cd mist
$ git pull
$ yarn

Run Mist

For development we start the interface with a Meteor server for autoreload etc. Start the interface in a separate terminal window:

$ cd mist/interface && meteor --no-release-check

In the original window you can then start Mist with:

$ cd mist
$ yarn dev:electron

NOTE: client-binaries (e.g. gnekonium) 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:

$ cd mist/interface && meteor --no-release-check

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

Connecting to node via HTTP instead of IPC

This is useful if you have a node running on another machine, though note that it's less secure than using the default IPC method.

$ yarn dev:electron --rpc http://localhost:8545

Passing options to Gnekonium

You can pass command-line options directly to Gnekonium 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 /my/gnekonium.ipc

...is the same as doing...

$ yarn dev:electron --rpc /my/gnekonium.ipc --node-ipcpath /my/gnekonium.ipc

Creating a local private net

See this guide to quickly set up a local private network on your computer: https://gist.github.com/evertonfraga/9d65a9f3ea399ac138b3e40641accf23

Using Mist with a privatenet

To run a private network you will need to set the IPC path, network id and data folder:

$ yarn dev:electron --rpc ~/Library/Ethereum/gnekonium.ipc --node-networkid 1234 --node-datadir ~/Library/Nekonium/privatenet

NOTE: since ipcpath is also a Mist option you do not need to also include a --node-ipcpath option.

You can also launch gnekonium separately with the same options prior starting Mist.

Deployment

Our build system relies on gulp and electron-builder.

Dependencies

meteor-build-client bundles the meteor-based interface. Install it via:

$ npm install -g meteor-build-client

Furthermore cross-platform builds require additional electron-builder dependencies. On macOS those are:

Windows deps:

$ brew install wine --without-x11 mono makensis

Linux deps:

$ brew install gnu-tar libicns graphicsmagick xz

Generate packages

To generate the binaries for Mist run:

$ gulp

To generate the Ethereum Wallet (this will pack the one Ðapp from https://github.com/ethereum/meteor-dapp-wallet):

$ gulp --wallet

The generated binaries will be under dist_mist/release or dist_wallet/release.

Options

platform

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

$ gulp --mac      # mac
$ gulp --linux    # linux
$ gulp --win      # windows
walletSource

With the walletSource you can specify the Wallet branch to use, default is master:

$ gulp --wallet --walletSource develop

Options are:

  • master
  • develop
  • local Will try to build the wallet from [mist/]../meteor-dapp-wallet/app

Note: applicable only when combined with --wallet

skipTasks

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

$ gulp --mac --skipTasks=bundling-interface,release-dist
Checksums

Spits out the MD5 checksums of distributables.

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

$ gulp checksums [--wallet]

Cutting a release

  1. Install release globally:

    $ yarn global add release
  2. Create a git tag and a GitHub release:

    $ release <major|minor|patch>
  3. A generated release draft will open in the default browser. Edit the information and add assets as necessary.

Testing

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

First make sure to build Mist with:

$ gulp

Then run the tests:

$ gulp test

Note: Integration tests are not yet supported on Windows.