Mist provides an API for dapp developers to use special features only available in Mist.

To make your dapp compatible with other browsers, it is recommended that you check the mist object before you use it:

if(typeof mist !== 'undefined') {
    ...
}

You have three different possibilities to use web3:

// 1. simply use it: web3 comes already defined
web3

// 2. optionally use web3 from Mist or load if outside of Mist
if(typeof web3 === 'undefined')
  web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"));

// 3. always use web3 provided by the dapp ("Web3" won't be supplied by Mist), but the provider from Mist
if(typeof web3 !== 'undefined')
  web3 = new Web3(web3.currentProvider);
else
  web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"));

• mist.platform
• mist.requestAccount(callback)
• mist.menu
• mist.menu.add([id,] options, callback)
• mist.menu.clear()
• mist.menu.remove(id)
• mist.menu.select(text)
• mist.menu.setBadge(text)
• mist.menu.update(id [, options] [, callback])
• mist.sounds
• mist.sounds.bip()
• mist.sounds.bloop()
• mist.sounds.invite()

Returns the current platform, mist is running on:

• darwin (Mac OSX)
• win32 (Windows)
• linux (Linux)

Asks the user to provide, or create a new account.

1. Function The callback to be called with the new address as the second parameter.

mist.requestAccount(function(e, address){
    console.log('Added new account', address);
});

Provides functionality to control the sub menu of your dapp, when its added to the sidebar.

Adds/Updates a sub menu entry, which is placed below you dapp button in the sidebar.

1. String optional and id string to identify your sub menu entry when updating.
2. Object The menu options:
   • name (String): The name of the sub menu button.
   • badge (String|null) optional: The badge text for the sub menu button, e.g. 50.
   • position (Number) optional: The position of the submenu button, 1 is on the top.
   • selected (Boolean) optional: Whether or not this sub menu entry is currently selected.
3. Function optional: The callback to be called when the sub menu entry is clicked.

mist.menu.add({name: 'My account'});

mist.menu.add('tkrzU', {
    name: 'My Meny Entry',
    badge: 50,
    position: 1,
    selected: true
}, function(){
    // Redirect
    window.location = 'http://domain.com/send';
    // Using history pushstate
    history.pushState(null, null, '/my-entry');
    // In Meteor iron:router
    Router.go('/send');
})

Removes all sub menu entries. You can use this when you reload your app, to clear up incorrect menu entries, which might have been lost since the last session.

None

Removes a sub menu entry.

1. String and id string to identify your sub menu.

Selects the respective sub menu entry.

1. String the sub menu entry identifier.

Sets the main badge of your dapp, right below your dapps menu button.

1. String the string used as the badge text.

Works like mist.menu.add(), but only the id parameter is required.

1. String and id string to identify your sub menu entry.
2. Object The menu options:
   • name (String): (optional) The name of the sub menu button.
   • badge (String|null): (optional) The badge text for the sub menu button, e.g. 50.
   • position (Number): (optional) The position of the submenu button, 1 is on the top.
   • selected (Boolean): (optional) Whether or not this sub menu entry is currently selected.
3. Function (optional) The callback to be called when the sub menu entry is clicked.

mist.menu.update('tkrzU', {
    badge: 50,
    position: 2,
})

Provides a list of sounds.

Makes a bip sound.

None

Makes a bloop sound.

None

Makes an invite sound.

None