1
0
mirror of https://github.com/kremalicious/metamask-extension.git synced 2024-11-26 20:39:08 +01:00
🦊 Minimalized version of MetaMask for my own personal use.
Go to file
2017-06-01 10:18:20 -07:00
app Version 3.7.3 2017-06-01 10:18:20 -07:00
development Update announcer wording 2017-05-23 15:02:03 -07:00
docs Add to doc 2016-10-11 15:06:09 -07:00
mascara mascara - fix deploy instructions 2017-05-15 22:12:06 -07:00
notices Add new beta notice. 2017-05-08 13:54:25 -07:00
test Modfiy test to ether standards. 2017-05-24 10:51:44 -07:00
ui remove more in operators 2017-05-26 11:16:58 -07:00
.babelrc Add support for async/await 2017-05-12 12:04:42 -07:00
.dockerignore mascara - ready to deploy via docker 2017-04-05 22:59:25 -07:00
.editorconfig
.eslintignore Ignore tests bundle, jquery, abd helpers 2017-05-04 14:33:29 -07:00
.eslintrc Add support for async/await 2017-05-12 12:04:42 -07:00
.gitattributes
.gitignore break out IndexDbController && Run the first time test on mascara 2017-04-28 14:11:46 +02:00
.jshintrc
.nvmrc Add platform specific builds and zip tasks (#486) 2016-07-26 15:15:40 -07:00
.travis.yml
.yo-rc.json
CHANGELOG.md Version 3.7.3 2017-06-01 10:18:20 -07:00
circle.yml ci - use node 7.6.0 2017-05-12 12:37:31 -07:00
CONTRIBUTING.md
docker-compose.yml mascara - ready to deploy via docker 2017-04-05 22:59:25 -07:00
Dockerfile mascara - docker - bump to node7 2017-04-25 12:49:24 -07:00
fonts Improved Ui Dev Mode 2016-07-01 14:23:37 -07:00
gulpfile.js Add address image map to icon factory 2017-05-26 00:43:14 -07:00
images Improved Ui Dev Mode 2016-07-01 14:23:37 -07:00
LICENSE license 2016-07-14 14:37:40 -07:00
mock-dev.js Fix UI Dev Mode for Tx Approval 2017-02-20 23:33:21 -08:00
package-lock.json Version 3.7.3 2017-06-01 10:18:20 -07:00
package.json Move to eth-contract-metadata 2017-05-26 09:58:33 -07:00
README.md Add (vague) instructions to adding a new network to the dropdown. 2017-04-25 14:57:07 -07:00
testem.yml Merge in crypto. 2016-10-19 11:17:29 -07:00
ui-dev.js Fix UI Dev Mode for Tx Approval 2017-02-20 23:33:21 -08:00
USER_AGREEMENT.md Remove version from terms of service. 2016-10-11 14:33:05 -07:00

MetaMask Plugin Build Status

Developing Compatible Dapps

If you're a web dapp developer, we've got two types of guides for you:

Building locally

  • Install Node.js version 6.3.1 or later.
  • Install local dependencies with npm install.
  • Install gulp globally with npm install -g gulp-cli.
  • Build the project to the ./dist/ folder with gulp build.
  • Optionally, to rebuild on file changes, run gulp dev.
  • To package .zip files for distribution, run gulp zip, or run the full build & zip with gulp dist.

Uncompressed builds can be found in /dist, compressed builds can be found in /builds once they're built.

Installing Local Builds on Chrome

To install your locally built extension on Chrome, follow this guide.

The built extension is stored in ./dist/chrome/.

Architecture

Architecture Diagram

Development

npm install
npm start

Build for Publishing

npm run dist

In Chrome

Open Settings > Extensions.

Check "Developer mode".

At the top, click Load Unpacked Extension.

Navigate to your metamask-plugin/dist/chrome folder.

Click Select.

You now have the plugin, and can click 'inspect views: background plugin' to view its dev console.

In Firefox

Go to the url about:debugging.

Click the button Load Temporary Add-On.

Select the file dist/firefox/manifest.json.

You can optionally enable debugging, and click Debug, for a console window that logs all of Metamask's processes to a single console.

If you have problems debugging, try connecting to the IRC channel #webextensions on irc.mozilla.org.

For longer questions, use the StackOverfow tag firefox-addons.

Developing on UI Only

You can run npm run ui, and your browser should open a live-reloading demo version of the plugin UI.

Some actions will crash the app, so this is only for tuning aesthetics, but it allows live-reloading styles, which is a much faster feedback loop than reloading the full extension.

Developing on UI with Mocked Background Process

You can run npm run mock and your browser should open a live-reloading demo version of the plugin UI, just like the npm run ui, except that it tries to actually perform all normal operations.

It does not yet connect to a real blockchain (this could be a good test feature later, connecting to a test blockchain), so only local operations work.

You can reset the mock ui at any time with the Reset button at the top of the screen.

Developing on Dependencies

To enjoy the live-reloading that gulp dev offers while working on the web3-provider-engine or other dependencies:

  1. Clone the dependency locally.
  2. npm install in its folder.
  3. Run npm link in its folder.
  4. Run npm link $DEP_NAME in this project folder.
  5. Next time you npm start it will watch the dependency for changes as well!

Running Tests

Requires mocha installed. Run npm install -g mocha.

Then just run npm test.

You can also test with a continuously watching process, via npm run watch.

You can run the linter by itself with gulp lint.

Writing Browser Tests

To write tests that will be run in the browser using QUnit, add your test files to test/integration/lib.

Deploying the UI

You must be authorized already on the MetaMask plugin.

  1. Update the version in app/manifest.json and the Changelog in CHANGELOG.md.
  2. Visit the chrome developer dashboard.
  3. Run gulp dist (or gulp zip if you've already built)
  4. Upload the latest zip file from builds/metamask-$PLATFORM-$VERSION.zip as the updated package.

Generate Development Visualization

This will generate a video of the repo commit history.

Install preqs:

brew install gource
brew install ffmpeg

From the repo dir, pipe gource into ffmpeg:

gource \
  --seconds-per-day .1 \
  --user-scale 1.5 \
  --default-user-image "./images/icon-512.png" \
  --viewport 1280x720 \
  --auto-skip-seconds .1 \
  --multi-sampling \
  --stop-at-end \
  --highlight-users \
  --hide mouse,progress \
  --file-idle-time 0 \
  --max-files 0  \
  --background-colour 000000 \
  --font-size 18 \
  --date-format "%b %d, %Y" \
  --highlight-dirs \
  --user-friction 0.1 \
  --title "MetaMask Development History" \
  --output-ppm-stream - \
  --output-framerate 30 \
  | ffmpeg -y -r 30 -f image2pipe -vcodec ppm -i - -b 65536K metamask-dev-history.mp4

Generating Notices

To add a notice:

npm run generateNotice

Enter the body of your notice into the text editor that pops up, without including the body. Be sure to save the file before closing the window! Afterwards, enter the title of the notice in the command line and press enter. Afterwards, add and commit the new changes made.

To delete a notice:

npm run deleteNotice

A list of active notices will pop up. Enter the corresponding id in the command line prompt and add and commit the new changes afterwards.

Adding Custom Networks

To add another network to our dropdown menu, make sure the following files are adjusted properly:

app/scripts/config.js
app/scripts/lib/buy-eth-url.js
app/scripts/lib/config-manager.js
ui/app/app.js
ui/app/components/buy-button-subview.js
ui/app/components/drop-menu-item.js
ui/app/components/network.js
ui/app/components/transaction-list-item.js
ui/app/config.js
ui/app/css/lib.css
ui/lib/account-link.js
ui/lib/explorer-link.js

You will need:

  • The network ID
  • An RPC Endpoint url
  • An explorer link
  • CSS for the display icon