{"id":20392387,"url":"https://github.com/wiseplat/mist","last_synced_at":"2026-05-28T13:06:44.099Z","repository":{"id":122792514,"uuid":"131140651","full_name":"WISEPLAT/mist","owner":"WISEPLAT","description":"Wiseplat wallet","archived":false,"fork":false,"pushed_at":"2018-05-29T20:19:07.000Z","size":5005,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-15T10:26:25.866Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WISEPLAT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-26T10:39:37.000Z","updated_at":"2023-05-22T19:06:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"16c42abe-3fdb-41c0-b07f-a04a6ce585a7","html_url":"https://github.com/WISEPLAT/mist","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fmist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fmist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fmist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fmist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WISEPLAT","download_url":"https://codeload.github.com/WISEPLAT/mist/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241941713,"owners_count":20046173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T03:43:35.499Z","updated_at":"2026-05-28T13:06:39.056Z","avatar_url":"https://github.com/WISEPLAT.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mist Browser\n\n[![Join the chat at https://gitter.im/wiseplat/mist](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/wiseplat/mist?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![Build Status develop branch](https://travis-ci.org/wiseplat/mist.svg?branch=develop)](https://travis-ci.org/wiseplat/mist)\n[![Code Climate](https://codeclimate.com/github/wiseplat/mist/badges/gpa.svg)](https://codeclimate.com/github/wiseplat/mist)\n\nThe Mist browser is the tool of choice to browse and use Ðapps.\n\nFor the Mist API see the [MISTAPI.md](MISTAPI.md).\n\nPlease note that this repository is the Electron host for the Meteor based wallet dapp whose repository is located here: https://github.com/wiseplat/meteor-dapp-wallet.\n\n## Help and troubleshooting\n\nPlease check the [Mist troubleshooting guide](https://github.com/wiseplat/mist/wiki).\n\nOr the [Gitter Channel](https://gitter.im/wiseplat/mist), to connect with the community for instant help.\n\n## Installation\n\nIf you want to install the app from a pre-built version on the [release page](https://github.com/wiseplat/mist/releases),\nyou can simply run the executeable after download.\n\nFor 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).\n\n#### Config folder\nThe data folder for Mist is stored in other places:\n\n- Windows `%APPDATA%\\Mist`\n- macOS `~/Library/Application\\ Support/Mist`\n- Linux `~/.config/Mist`\n\n\n## Development\n\nFor development, a Meteor server will need to be started to assist with live reload and CSS injection.\nOnce a Mist version is released the Meteor frontend part is bundled using the `meteor-build-client` npm package to create pure static files.\n\n### Dependencies\n\nTo run mist in development you need:\n\n- [Node.js](https://nodejs.org) `v7.x` (use the prefered installation method for your OS)\n- [Meteor](https://www.meteor.com/install) javascript app framework\n- [Yarn](https://yarnpkg.com/) package manager\n- [Electron](http://electron.atom.io/) `v1.7.9` cross platform desktop app framework\n- [Gulp](http://gulpjs.com/) build and automation system\n\nInstall the latter ones via:\n\n    $ curl https://install.meteor.com/ | sh\n    $ curl -o- -L https://yarnpkg.com/install.sh | bash\n    $ yarn global add electron@1.7.9\n    $ yarn global add gulp\n\n### Initialisation\n\nNow you're ready to initialise Mist for development:\n\n    $ git clone https://github.com/wiseplat/mist.git\n    $ cd mist\n    $ yarn\n\nTo update Mist in the future, run:\n\n    $ cd mist\n    $ git pull\n    $ yarn\n\n### Run Mist\n\nFor development we start the interface with a Meteor server for autoreload etc.\n*Start the interface in a separate terminal window:*\n\n    $ cd mist/interface \u0026\u0026 meteor --no-release-check\n\nIn the original window you can then start Mist with:\n\n    $ cd mist\n    $ yarn dev:electron\n\n*NOTE: client-binaries (e.g. [gwsh](https://github.com/wiseplat/go-wiseplat)) specified in [clientBinaries.json](https://github.com/wiseplat/mist/blob/master/clientBinaries.json) will be checked during every startup and downloaded if out-of-date, binaries are stored in the [config folder](#config-folder)*\n\n*NOTE: use `--help` to display available options, e.g. `--loglevel debug` (or `trace`) for verbose output*\n\n### Run the Wallet\n\nStart the wallet app for development, *in a separate terminal window:*\n\n    $ cd mist/interface \u0026\u0026 meteor --no-release-check\n\n    // and in another terminal\n\n    $ cd my/path/meteor-dapp-wallet/app \u0026\u0026 meteor --port 3050\n\nIn the original window you can then start Mist using wallet mode:\n\n    $ cd mist\n    $ yarn dev:electron --mode wallet\n\n\n### Connecting to node via HTTP instead of IPC\n\nThis is useful if you have a node running on another machine, though note that\nit's less secure than using the default IPC method.\n\n```bash\n$ yarn dev:electron --rpc http://localhost:8747\n```\n\n\n### Passing options to Gwsh\n\nYou can pass command-line options directly to Gwsh by prefixing them with `--node-` in\nthe command-line invocation:\n\n```bash\n$ yarn dev:electron --mode mist --node-rpcport 19343 --node-networkid 2\n```\n\nThe `--rpc` Mist option is a special case. If you set this to an IPC socket file\npath then the `--ipcpath` option automatically gets set, i.e.:\n\n```bash\n$ yarn dev:electron --rpc /my/gwsh.ipc\n```\n\n...is the same as doing...\n\n\n```bash\n$ yarn dev:electron --rpc /my/gwsh.ipc --node-ipcpath /my/gwsh.ipc\n```\n\n### Creating a local private net\n\nSee this guide to quickly set up a local private network on your computer:\nhttps://gist.github.com/evertonfraga/9d65a9f3ea399ac138b3e40641accf23\n\n\n### Using Mist with a privatenet\n\nTo run a private network you will need to set the IPC path, network id and data\nfolder:\n\n```bash\n$ yarn dev:electron --rpc ~/Library/Wiseplat/gwsh.ipc --node-networkid 1234 --node-datadir ~/Library/Wiseplat/privatenet\n```\n\n_NOTE: since `ipcpath` is also a Mist option you do not need to also include a\n`--node-ipcpath` option._\n\nYou can also launch `gwsh` separately with the same options prior starting\nMist.\n\n\n### Deployment\n\nOur build system relies on [gulp](http://gulpjs.com/) and [electron-builder](https://github.com/electron-userland/electron-builder/).\n\n#### Dependencies\n\n[meteor-build-client](https://github.com/frozeman/meteor-build-client) bundles the [meteor](https://www.meteor.com/)-based interface. Install it via:\n\n    $ npm install -g meteor-build-client\n\nFurthermore cross-platform builds require additional [`electron-builder` dependencies](https://github.com/electron-userland/electron-builder/wiki/Multi-Platform-Build#linux). On macOS those are:\n\n    // windows deps\n    $ brew install wine --without-x11 mono makensis\n\n    // linux deps\n    $ brew install gnu-tar libicns graphicsmagick xz\n\n#### Generate packages\n\nTo generate the binaries for Mist run:\n\n    $ gulp\n\nTo generate the Wiseplat Wallet (this will pack the one Ðapp from https://github.com/wiseplat/meteor-dapp-wallet):\n\n    $ gulp --wallet\n\nThe generated binaries will be under `dist_mist/release` or `dist_wallet/release`.\n\n\n#### Options\n\n##### platform\n\nTo build binaries for specific platforms (default: all available) use the following flags:\n\n    // on mac\n    $ gulp --win --linux --mac\n\n    // on linux\n    $ gulp --win --linux\n\n    // on win\n    $ gulp --win\n\n##### walletSource\n\nWith the `walletSource` you can specify the Wallet branch to use, default is `master`:\n\n    $ gulp --wallet --walletSource develop\n\n\nOptions are:\n\n- `master`\n- `develop`\n- `local` Will try to build the wallet from [mist/]../meteor-dapp-wallet/app\n\n*Note: applicable only when combined with `--wallet`*\n\n#### skipTasks\n\nWhen building a binary, you can optionally skip some tasks — generally for testing purposes.\n\n  $ gulp --mac --skipTasks=bundling-interface,release-dist\n\n#### Checksums\n\nSpits out the MD5 checksums of distributables.\n\nIt expects installer/zip files to be in the generated folders e.g. `dist_mist/release`\n\n    $ gulp checksums [--wallet]\n\n\n## Testing\n\nTests are ran using [Spectron](https://github.com/electron/spectron/), a webdriver.io runner built for Electron.\n\nFirst make sure to build Mist with:\n\n    $ gulp\n\nThen run the tests:\n\n    $ gulp test\n\n*Note: Integration tests are not yet supported on Windows.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiseplat%2Fmist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwiseplat%2Fmist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiseplat%2Fmist/lists"}