etherwallet: A JavaScript repository from m4rky77

Official link: https://www.myetherwallet.com - now with SSL! Content of myetherwallet.com is hosted in github, which will gurantee the validity of the source code.

MyEtherWallet

MyEtherWallet is an open source, javascript, client-side tool for generating Ether wallets. It was created, and is maintained, by kvhnuke and tayvano aka insomniasexx.

Official link: https://www.myetherwallet.com - now with SSL! Content of myetherwallet.com is hosted in github, which will gurantee the validity of the source code.
Original, non-SSL link: http://kvhnuke.github.io/etherwallet/
original reddit thread

Purpose

MyEtherWallet was created because many users were having immense trouble setting up the ethereum client on their computers. Therefore, we am planning to implement following features to the browser-based wallet.

Bulk generate wallets
Import client wallet files and presale wallet files.
Generate transactions from the imported wallet files
Send transactions

We hope that it'll help most of us to accomplish day to day tasks without having a fully running client.

Contact

If you can think of any other features or run into bugs, let us know. You can fork, open a PR, open an issue, message kvhnuke on reddit, email tayvano or in any of these ways.

Developing

Want to contribute? Great! Have questions? Ask us! Have issues? Open an issue!

Using Gulp

EtherWallet uses gulp to compile, minify, and uncss the less and to concatonate and uglify the JS. It watches all the files and works its magic when needed. A full list of packages we are using can be found below. If you aren't familiar with gulp, maybe google it first. The basics on how to use gulp are below.

Make sure you have a fairly recent version of node.js & npm installed. You can check using:

$ npm -v
$ node -v

Globally install gulp. You may need to sudo if you are on mac / linux:

$ npm install gulp -g
$ sudo npm install gulp -g

Make sure gulp is installed:

$ gulp -v

cd into the project folder

$ cd path/to/project

install node_modules into the project directory

$ npm install

Running the default gulp task will run and watch all the required folders and update when necessary.

$ gulp

A list of packages we are using with gulp:

gulp-less - compiles the less
gulp-autoprefixer - autoprefixes
gulp-minify-css - minifies the css once the less is compiled
gulp-notify - notifies when things get compiled, minified, uglified, etc. Also notifies you (sometimes) on errors.
gulp-rename - renames to .min.css etc.
gulp-uncss - gets rid of the bloat by eliminating any unsued CSS styles. If you add an HTML page, you will need to add it to the gulpfile.js
gulp-concat - concats the js
gulp-uglify - uglifies the js
gulp-template - configures templates

Less / CSS

This project uses Twitter Bootstrap as a base. But, we're lazy so we just edit the bootstrap files when necessary. You can too. In the end, all unused CSS rules are removed using the gulp-uncss, which keeps Bootstrap from being bloated.

If you want to edit the styling, you will mostly want to access the following files:

etherwallet-variables.less - all our bootstrap variables and custom variables go here. we do not use the variables.less in the bootstrap folder.
etherwallet-custom.less - all custom rules or overrides go here.
etherwallet-utilities.less - this is a group of utilties that I use on all my projects. Text color, background color, and vertical margins / padding live here. Feel free to add to it.
etherwallet-master.less is the file that brings all our files together.

Don't forget, if you add an additional HTML page, you will need to add it to the gulpfile.js

  .pipe(uncss({
    html: [
      './index.html',
      './newHTMLFile.html',
      './anotherNewHTMLFile.html'
    ]
  }))

JS

This project loads JQuery 1.11.3 and then a minified JS file that is composed of the files found in /js/source/*.js. As long as you add any additional JS files to the /js/source/ folder, gulp will handle it automatically.

ToDo

Add a way to display the paper wallets locally
Create Get Account Info tab

m4rky77/etherwallet