ethereum / mist

[DEPRECATED] Mist. Browse and use Ðapps on the Ethereum network.

Mist Browser [Deprecated]

Mist and Ethereum Wallet have been deprecated. See the announcement and view the migration guide.

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.

mist's Issues

Collision Found on Blockies.js

I found out that these two addresses generate the same pumpkin looking avatars:

<img width="350" alt="screen shot 2015-10-22 at 11 28 59 am" src="https://cloud.githubusercontent.com/assets/112898/10666979/a3c22b56-78b3-11e5-8dcc-19bd9e6f73b5.png">

• 0x163b948e79a4108b7146c58102ecb965fbed6973
• 0x38cd6ac0e09c517ab75267c6bc76e5bb8baf14d0

They don't just look the same I've checked and they actually produce the same code:

background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAABY0lEQVR4Xu2aMRIBQRBFbe4CMneQyMScwCWETuISTkCoZBJ3cAg55QD6Bb+6apUnbX9n5+/v39MzM8wus9ek+B1Pqyo8+th2cy3fcZAAFWAK6AGaoFXgOwN/XwbTQp8SSHU8fT9cB6QDSEC4klQBsJRNFWoKUC+QMqwH6AFZO91ugtf9tuwF0hRYnu/RI27rRYQn8CABKsAU0APIKJK4JmgVGHkZdCkM2+JJ/n+w9gL2AiPvBfQAPaA+GtMEQwZ+vgrQBGjDgvDEb/p8wuOmKE2ABiC8BAADKcGEVwG0DiAJE8OENwVMgZqBVGGE1wNSD0hzmPDdHhIrgCZAEiS8BDTvJ6gAPaD5qqweEF5x0QS7TZCOx0nC9IW6j8bS98P7AekAEtB8Nph+IBWgB8AVmVRieoAe0Hs/IFUoNkPUrlL8sZvSX8r4/PCM8ASWAOoGiUGKqwBTQA+gLNEEKwasAs1l8A1UJr4guMBztQAAAABJRU5ErkJggg==')`

This is certainly a bug in the blockies.js generator: https://github.com/alexvandesande/blockies

This is the rand seed generator:

       function seedrand(s) {
        randseed = 0;
        for(var i = 0; i < s.length; i += 2) {
            var h = (s.charCodeAt(i) << 8) | s.charCodeAt(i + 1);
            randseed ^= h;
        }
    }
    function rand() {
        var n = (Math.sin(randseed++) + 1) / 2; // Move range from -1 - 1 to 0 - 1
        var r = n * 10000; // Remove first few digits since they tend to have low entropy
        n = r - Math.floor(r);
        return n;
    }

Error message when Mist is closed on linux

When Mist is closed with the close button the following message appears:

This only happens when Mist has started the geth node.

Add custom coins

• code cleanup

PR
ethereum/meteor-dapp-wallet#63

Contract Wallet transaction issue

I sent ether to my newly created account on the gui. I then Added a Wallet, and transferred ether from the owner account to the Contract Based Wallet - this worked fine.

I tried sending ether to the wallet from another account with no success though. Despite showing up on the blockchain, the balance has not updated.

https://etherscan.io/address/0x727c8217b0005e3e5362103bd80976f6fd3bb99d

As you can see, the account has 52 ether, despite having 6 txs of 72.9979 Ether going in, and only 2 ether going out.

I understand this may simply be my ignorance on ethereum transactions, and I apologize if so, please correct my confusion if that's the case. Thanks!

Edit: I realize this wallet is a contract and not an account. I must be mistaken in thinking you can transact with this wallet like you would an account.

Implement the Browser Bar

The purpose of the bar is to:

• Allow the user to manage which keys are visible for the Ðapp
• Allow the user to add and remove Ðapps to the sidebar
• Allow the user to navigate a Ðapp
• Show information about the current Ðapp
• Show information about the network (that is relevant to his current navigation)

Add tab indexes to sidebar and other buttons

Sub-module issues

Hi @frozeman!

See ethereum/go-ethereum#1302.

I think it's related to http://stackoverflow.com/questions/4161022/git-how-to-track-untracked-content/4162672#4162672.

And is probably fixable by adding a .submodules. I will try to make that change and construct a pull request.

You probably haven't seen it yet because all the commits are from a single author, not via forks of this master.

osx/macos app signing

classic OSX issue.

A workaround is to right click and then click "Open"

Swarm Integration

• Add the bzz:// protocol to load files
• Use manifest to handle full apps
• Allow uploading to swarm

Menu items raise error on Windows

When one of the menu items (except for the entries in the Develop menu) is clicked the following alert is raised:

This is on Windows 7.

Allow pasting of password in "Enter Master Password

It would be nice to be able to paste into the password field in this prompt.

Address page and dapp inputs

Create the address page as a (separate popup ?) window where users can select addresses to be send to dapps.

Additionally we should provide a address input auto detection mechanism for dapps, to open the address book and when an address is selected, it gets inserted into the input automatically, without that the dapp has to write any code.

Editing of contract wallet name captures wrong name

When you:

Select a contract wallet
type in a new name "Test 1"
hit enter key
name is saved as "Test 1Test 1Test 1"

Live Price Feed Distorts USD Balance Accounting

This is a bug, but also a feature request.

In the Wallet Section of Mist, beneath LATEST TRANSACTIONS, it appears that some information is wrong for each transaction shown including some details shown in the TRANSACTIONS pop-up window. USD price is wrong for each transaction Amount & Gas Price. I can confirm this by looking up each transaction event's TIME in a Block Explorer, then hunting down the Open Close High and Low PRICE for that time period in chart with historical data. What a pain in the butt!

1. THE USD PRICE IS WRONG.
2. WALLET USERS SHOULD NOT HAVE TO HUNT ELSEWHERE FOR PRICE HISTORY.

I would like to see Ethereum blockchain transaction events are linked from every block to a data store with the global price index (e.g. www.ethereumwisdom.com has such an index) - such that Block Explorers & MIST WALLET can accurately represent the cost of ETH in FIAT. After all, that is how financial accounting is done.

Please fix then help your friendly Accountants, Bookkeepers, and Financial professionals who must have this accurate information. :-)

Binaries look for bundled (and not available) geth resources.

I'm trying to build mist and wallet (what's the difference?) from source on ArchLinux.

This is my proceedure:

  git submodule update --init
  npm update
  gulp mist --platform linux
  gulp wallet --platform linux

Now, I have binaries, e.g.:

./dist_mist/Mist-linux-x64-0-3-2/Mist

Starting this looks for a running geht instance. If it's not running, it tries to start:

./dist_mist/Mist-linux-x64-0-3-2/resources/nodes/geth/linux-x64/geth

Which is not available. But I have geth installed. Why not simply try to start geth first?

Full log:

 $ ./dist_mist/Mist-linux-x64-0-3-2/Mist 
[10578:1020/102931:ERROR:browser_main_loop.cc(189)] Running without the SUID sandbox! See https://code.google.com/p/chromium/wiki/LinuxSUIDSandboxDevelopment for more information on developing with the sandbox on.
[10608:1020/102932:INFO:renderer_main.cc(200)] Renderer process started
[10611:1020/102932:INFO:renderer_main.cc(200)] Renderer process started
CONNECT to IPC PATH: /home/user/.ethereum/geth.ipc
Starting geth node...
Couldn't start geth node! { [Error: spawn /home/user/aur/mist/src/mist/dist_mist/Mist-linux-x64-0-3-2/resources/nodes/geth/linux-x64/geth ENOENT]
  code: 'ENOENT',
  errno: 'ENOENT',
  syscall: 'spawn /home/user/aur/mist/src/mist/dist_mist/Mist-linux-x64-0-3-2/resources/nodes/geth/linux-x64/geth',
  path: '/home/user/aur/mist/src/mist/dist_mist/Mist-linux-x64-0-3-2/resources/nodes/geth/linux-x64/geth',
  spawnargs: [] }
Stopping nodes...

After restarting client, "Progress Bar" out of sync with actual progress.

Minor issue:
I started the client for the first time
Progress stalled
I closed out the client using "x"
After restarting client, "Progress Bar" is out of sync with actual progress
Client completes successfully

BTW, It looks great. Congrats and Thanks

Splash window is positioned inappropriately and can't be moved

(This may be related to #49.)

Running mist in a Linux VM. X server is XQuartz 2.7.8 on Mac OS X

The splash window comes up in an annoying place (as if it just looks at the desktop rect to decide where to put it, rather than asking Xinerama/XRandR/etc. for display details), and it can't then be moved.

Thanks,

--Tom

Photo of offending window:

My display arrangement:

hangs when running on testnet

Hi,

I am running on a local testnet and when trying to deploy the original contract it hangs and nothing happens.

I can see that prior to this there is a file not found error in the console (socksjs...)

Any ideas?

Readme Correction

Under "Run the Wallet", the instructions go as follows:

$ cd interface && meteor

// and in another terminal

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

But doesn't this mean that two Meteor processes will be trying to run on port 3000, and second one won't start properly?

Invalid full screen menu item text

When Mist enters full screen mode the text of the full screen menu item isn't changed. To exit the full screen the user must press the same button with the text "Enter fullscreen" which doesn't make sense.

README is incomplete

Haven't looked at Beta 2 yet, but for Beta 1 the README inside the release is very minimal and incomplete in comparison to the excellent info on the Github release page. The LICENSE file looked wrong too.

Mac OS X Mist: 0.3.5 Insufficient funds for gas * price + value

I'm unable to send ETH in any amount from my wallet. It always throws " Insufficient funds for gas * price + value". I've tried deleting all the files under ~/Library/Ethereum and ~/Library/Application Support/Mist and restarting, but this hasn't helped. Any thoughts on how to troubleshoot and correct?

Couldn't start Ethereum Node.

Splash screen says "Are you already running a node? Make sure your IPC path is set to the default: $ geth --ipcpath"
.....
geth is installed but not running.

Add dependency info to build instructions

Currently, the README doesn't address dependencies such as nodejs/npm or meteor.

Simple instructions/links for installing these on major platforms would be very helpful.

Copy & Paste not working

Copying and pasting (specially important for getting addresses) is not working, at least not on the mac.

Do I really have to pay to create a wallet to deposit money?

I'm confused.

I clicked on "create wallet".

As opposed to "create contract".

Do I really need to spend ETH (that I don't have) to create wallet and deposit ETH?

(and of course message account does not exist or not enough funds can be more specific)

So alpha, I was warned. I like software that talks nicely to me: https://twitter.com/stefek99/status/654391430803288064

Window completely white

When I launch the wallet, the window opens but appears completely white. Moving my mouse over it causes cursor changes, so I think the fields are there

Geth Integration

• Include latest geth binary on mist
• Allow mist to connect to geth via ipc

Full Mist Backup

• Export private keys
• Export the mist UI local storage on request
• Export every added tab local storage on request
• Put all on a single encrypted file (maybe M of N in case they lose one key)
• Develop a manual export/import tool
• In the future, develop an automatic export to some external file on a safe place on the system
• In the future, develop automatic encrypted backup to swarm

Add support for creating new accounts

Currently only a new wallet can be created but there is no option to create a new account. New users will need a way to create a new account without the need of using the console/command line interface.

Your stub contract has no original wallet address set, please restart your wallet!

Version 0.3.1 (0.3.1)

Your stub contract has no original wallet address set, please restart your wallet!

I restarted, still occurring.

From readme:

Currently you need an instance of geth running when you want to use the wallet.

It seems like running geth helps.

---

You probably know better what is happening and how to circumvent it.

Transaction Failed =/

Hello,
i made two days ago this transaction:

http://etherscan.io/tx/0xc5e763d3b1bbc8daa0e48beaeb5abbc2e0fa303d4bdaa54890124e67f5937b8b

124.84128972 ETHER for an exchange but they never get the Ether. Is there a way to get them back? here is also the block information i get from the transaction:

http://etherscan.io/block/0xc15c81732768924b12c49f25b2b558052f8cc9eb68daeb15971df8d7722ab83c

It would be nice if there is any way to get my Ether back on my wallet.

Thanks for your help!

With best regards
Eisenkopf89

Automatic builds

We need a script that will automatically package the meteor app into a server less app and integrate it with electron, with the correct icon and name

Need ETH to create contract to receive presale ETH

Hello,

I'm already in contact with ETH helpdesk. Because I have an issue with my presale wallet, they asked me to download and install this GUI wallet.
My GUI wallet has 0 ETH, so I can't create a wallet/contract to receive my presale ETH on it. How do I proceed? (attached screenshots)
Thanks for your feedback.

Error starting wallets ETH Window 8. Help !!!

I found a wallet ETH for windows 8 , set up his wallet and the contract , but it worked after I removed a few games , and I do not need a wallet program has stopped working , gives an error Are you already running a node? Make sure your IPC path is set to the default: $ geth --ipcpath . \ Pipe \ geth.ipc. Individual files geth not work immediately close , what do I do ?
Я установил бумажник ETH для окна 8,создал свой бумажник и контракт, все работало но после того как я удалил несколько игр и не нужных мне программ бумажник перестал работать. выдаёт ошибку Are you already running a node? Make sure your IPC path is set to the default: $ geth --ipcpath .\pipe\geth.ipc . отдельно файл geth не работает сразу закрывается, что мне делать ?
Если можете то дайте ответ на Русском языке. Спасибо.
If you can give the answer to the Russian language. Thank you.

Key Management in dapps

• Allow Mist to show or hide accounts in web3.eth.accounts

Mist and wallet: white screen.

I'm trying to build mist and wallet (what's the difference?) from source on ArchLinux.

This is my proceedure:

  git submodule update --init
  npm update
  gulp mist --platform linux
  gulp wallet --platform linux

Starting either the wallet or mist simply displays a white screen:

Log:

[10922:1020/103810:ERROR:browser_main_loop.cc(189)] Running without the SUID sandbox! See https://code.google.com/p/chromium/wiki/LinuxSUIDSandboxDevelopment for more information on developing with the sandbox
r mo
[10950:1020/103811:INFO:renderer_main.cc(200)] Renderer process started
[10953:1020/103811:INFO:renderer_main.cc(200)] Renderer process started
CONNECT to IPC PATH: /home/user/.ethereum/geth.ipc
Geth connection FOUND
Checking node sync status...
Time between last block 6351576s
Syncing method not implemented, start app anyway.
Loading Interface at file:///home/user/aur/mist/src/mist/dist_mist/Mist-linux-x64-0-3-2/resources/app.asar/interface/index.html
[10965:1020/103811:INFO:renderer_main.cc(200)] Renderer process started
CONNECT to IPC PATH: /home/user/.ethereum/geth.ipc

Add advanced mode

I really like beta 3! But it can be difficult to understand for users that just want a wallet. Suggestions how to make the app really easy to use for beginners, while still allowing advanced users:

Start the app in "normal mode", but allow the user to switch to "advanced mode". When in normal mode:

1. In "Send funds" screen, hide the "Deploy contract", "Data field" and "Select fee" (but still show the fee).
2. In the "Wallets" screen, hide option "Add accounts".
3. In the "Add tokens" screen, only allow addition of predefined tokens.
4. Disable the "Develop" menu (make it gray).
5. The status in the header (showing peers, block etc) is replaced with a lamp. Using red, yellow and green.
6. The "Execute contract" can be simplified. E.g. a beginner doesn't need to understand the concept of "gas usage".

Progress bar overlaps estimate time (linux)

We need to consider removing the estimated time since it is really unreliable.

Account rename

Renaming is not available after the change to empty value
Ubuntu x64

Startup dialog does not register with window manager

This concerns "Wallet 0.3.1 (Beta 1)" - linux x64 version.
When I start Ethereum-Wallet, it prints the following on stdout:

[9217:1014/224556:ERROR:browser_main_loop.cc(189)] Running without the SUID sandbox! See https://code.google.com/p/chromium/wiki/LinuxSUIDSandboxDevelopment for more information on developing with the sandbox on.
[9245:1014/224557:INFO:renderer_main.cc(200)] Renderer process started
[9249:1014/224557:INFO:renderer_main.cc(200)] Renderer process started
CONNECT to IPC PATH: /home/christian/.ethereum/geth.ipc
Starting geth node...
Geth connection FOUND
Checking node sync status...
Time between last block 6423307s

and a startup dialog window appears that first shows "Starting Ethereum node" and then "Ethereum node needs to sync, please wait... Looking for peers".

The problem is that this dialog window neither has window borders, nor does it appear in the list of windows and cannot be moved, or brought to the foreground once it is in the background. My guess is that it does not register properly with the window manager on the system.

I'm running "Linux Mint 17.1" with mdm and cinnamon.

Splash window is a bit hard to read

I found the splash window a bit hard to read. To my eyes, the text doesn't stand out very strongly at all against the background.

Thanks,

--Tom

Mac app closes after start

The Mac version doesn't open. It can't run Geth. When i open the wallet it crash and it closes.

eth integration

• adding eth
• set master password on initial start
• issue: no tx hash response on wallet creation
• issue: eth not starting?

Option to start mist on a private chain.

As we are now trying to get our Ðapp to work in Mist it would be nice if we could point the mist client to a private chain so our remote devs could just download a json file that defines our private network (networkid, bootnodes, etc...) and start the Mist instance against that for better collaboration on the UI work. Something like this proposed data structure would be nice:

{"networkId": 4734, "bootnodes": ["array","of","nodeUrls"....], "genesis": { .... genesis json } }

Then we can startup Mist locally using mist --config

Make the history tab inherit select tabs

The code of the history tab is built in parallel. It has a different html, a different css, a different js, yet it has 90% of the same interface and every new feature we add one we should add to the other.

I ran this problem having to manually implement the slide-out arrow in the history tab. It will work to full tabs but won't allow slide in and out because it requires a tab ID.

This code needs optimisations.

Add contact feature

There should be a way of storing the addresses of other people without their password so you can easily send them ether without having to type out their address.

Your stub contract has no original wallet address set, please restart your wallet!

(I know there's another issue with the same error, but that seemed to be a version mismatch, whereas I think I'm up to date.)
I'm running geth 1.3.1 on Ubuntu. The blockchain is all synced.
I haven't set ETHERBASE or created any accounts.

I downloaded the Wallet v 0.3.5. I created an account, which seems to also set ETHERBASE. WHen I try to add a wallet I get the "Your stub contract..." error (screenshot below). I exited the wallet and went back in and it said "creating" below "contract based wallets" and then I got the error again. I exited and went back in the error wasn't there.

Should there be .meteor content committed to the repo?

I'm getting ...

Bobs-Air-2:mist bob$ meteor
run: You're not in a Meteor project directory.

To create a new Meteor project:
meteor create
For example:
meteor create myapp

For more help, see 'meteor --help'.

Function deposit - UX improvement suggestion

Deposit button opens a transfer screen with destination and source fields filled automatically. Now, the default behaviour is to set the source address as the recently created account, which leads to the scenario where source field == destination field. Maybe it would be better to set the source always to some other local address with balance > 0 and if such doesn't exist the wallet should inform user that she has to buy ether or mine or import private keys of an account with non-zero balance.