![eos-blockchain.png](https://steemitimages.com/DQmWTGmBvJRmM8PgAcEeQ8mYGMnRrcVuwFYDNbRYDs3cYCF/eos-blockchain.png)

There's been a bit of confusion about how to contribute to the EOS ICO with MyEtherWallet. I speculate this is an inadvertent result of Dan being spoiled by Graphene blockchains, and the inherent ease of building a web-interface on top of them. By using MetaMask, the EOS team could come close to meeting these high standards. The reality is likely a bit different, but I digress...

This ICO Contract was designed to be interacted with through the [Official EOS Site](http://eos.io). Using the official interface helps you understand various parameters and avoid potentially catastrophic validation mistakes and/or process omissions. On the other hand, MyEtherWallet aggregates interfaces rudimentarily at best, and so you are unnecessarily inflicting a great deal of usability constraints onto yourself when attempting to interact with the EOS Token Sale contract in this way.

All that aside, some people don't want to use the [Official EOS Page](http://eos.io) because it requires MetaMask or they don't use Chrome. Some just insist on using MyEtherWallet (MEW). There's also the chance that the EOS site goes down or MetaMask causes you problems, in this situation, using MEW is one potential workaround. This article is directed towards this niche group of users and entirely possible situation.

_Instructions start at Dancing Avocados_ 

Due to the complexity and risks associated to this crowdsale I did not skimp on any details, and it will probably be the most **tl;dr** article you will (or will not) read today. **For those of you who want me to just tell you how to participate without explaining the risks,** you'll be sorely disappointed, because that's not going to happen here. It's a complex ICO that requires explanation, accept no less. 

# This guide is intended for ADVANCED USERS

If you are a novice, you should really just install the [MetaMask Chrome extension](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn?hl=en) and proceed over to the [Official EOS Contribution MetaMask enabled Interace](http://eos.io/distribution). For those that don't understand how to use MetaMask and the official interface [here's a great tutorial that explains it.](https://steemit.com/eos/@ash/full-walkthrough-how-to-join-eos-ico).

# That Said, You Assume All Risk

**USE AT YOUR OWN RISK. I AM NOT RESPONSIBLE FOR TOKEN LOSS. THIS IS NOT LEGAL OR INVESTMENT ADVICE. IT IS HIGHLY SUGGESTED YOU READ THIS ARTICLE IN IT'S ENTIRETY AND UNDERSTAND THE IMPLICATIONS BEFORE CONDUCTING A TRANSACTION. IF YOU'RE A US CITIZEN OR RESIDENT YOU CANNOT PARTICIPATE IN EOS TOKEN SALE AND BY EXERCISING THIS CONTRACT YOU ARE AGREEING TO THOSE TERMS.**

# About the EOS Token Sale

It's probably a good idea to understand a higher level view of the EOS ICO, here's a [wonderful article](https://steemit.com/eos/@trogdor/the-eos-ico-for-dummies) written by @trogdor. If you're more technical, [read the whitepaper](https://github.com/EOSIO/Documentation/blob/master/TechnicalWhitePaper.md) and if you don't know how to read instructions just scroll down to the comments and ask a question that was answered in the article you're commenting on ;) 

![dancing avocados](https://media.giphy.com/media/l2JJurAjg3LRPcYHS/giphy.gif)

# Prerequisites 
1. Prior MyEtherWallet experience
2. A funded Ethereum Wallet (for funding the contract, and paying the fees associated to transactions)

# Useful Tools before you begin

**If you want to be playing on the same level** as contributors using the official MetaMask integration on the EOS site, you may consider using one or both of following tools that will provide insight into the current state of the EOSCrowdsale. 

_First up_ is [EOSScan](http://eosscan.io/), it will show you the current rate, as well as time left in the current window and is very simple to use.

![Screen Shot 2017-06-28 at 6.30.04 PM copy.png](https://steemitimages.com/DQmb3HvPY7oE2SLeSsWqRxfdA9kgiHQmERYVgcvhKiy2sUU/Screen%20Shot%202017-06-28%20at%206.30.04%20PM%20copy.png)

_Next up_ is for people who want to see into future windows, [here's a tool I made based on code originally written by Luke Stokes](https://steemit.com/eos/@sandwich/eos-sale-tracker-fork-with-usability-improvements-suitable-for-novices), it takes about 60 seconds of setup but allows you to peak into future windows. It also display both USD and ETH EOS rates.  _This is most useful if you're looking to contribute to future windows_

![Screen Shot 2017-06-28 at 5.18.21 PM copy.png](https://steemitimages.com/DQmamux5A9yMvzFNXpLRTDdPC64eKRA1XtXHTFbJCi6QPTm/Screen%20Shot%202017-06-28%20at%205.18.21%20PM%20copy.png)

_Feel free to let me know of any other tools you may have come across in the comments below :)_


# Step 1: Fund EOS Contract (The Current Window, "Today")

This will fund the current window, if you're looking to fund a future window, [click here](https://steemit.com/eos/@sandwich/how-to-contribute-to-a-future-window-on-eoscrowdsale-using-myetherwallet-mew)

1. Obtain the contract address from http://EOS.io or trust me when I say it is `0xd0a6E6C54DbC68Db5db3A091B171A77407Ff7ccf`(It's always suggested to trust no one in these situations)
2. Go to [https://www.myetherwallet.com/#send-transaction](https://www.myetherwallet.com/#send-transaction)
5. Load your wallet using any one of the methods listed, for this example I used the Keystore File. Enter the password to your wallet in the very likely event is is encrypted. If it's not encrypted, may Murphy's Law forever be in your favor.
6. Click `Unlock` button
7. In _Address_ field, enter the contract address.
8. In _Amount to send_ field, enter the amount you would like to contribute.
9. Allow the wallet to suggest a _Gas Limit_. If it does not autopopulate, enter `90000` or more. If your TX fails, increase Gas Limit.  If you would like your TX to go through more quickly, adjust your gas limit accordingly.
9. Click `Generate Transaction` button
10. Check the details of the transaction, and if you are confident, click `Yes, I am sure! Make transaction`
11. If all went well, a green bar will appear at the bottom of the page including a link to your transaction on the blockchain. 

# Step 2: Claim EOS Tokens

You can claim tokens at the end of any window you have contributed to. **If you attempt to claim tokens before a window(s) you have contributed to has closed, the transaction will fail. This is intended functionality.** 

2. Go to [https://www.myetherwallet.com/#contracts](https://www.myetherwallet.com/#contracts)
3. Under heading **Select Existing Contract** is a dropdown, select _EOS Contribution_
4. Click `Access`
5. Under the "Read / Write Contract" heading, in the dropdown select `claimAll`.
5. Load your wallet using any one of the methods listed, for this example I used the Keystore File. Enter the password to your wallet in the very likely event is is encrypted. If it's not encrypted, may Murphy's Law forever be in your favor.
6. Click `Unlock` button
7. Click `Write` button 
8. Set _Amount to send_ to `0` and allow the wallet to suggest a _Gas Limit_. If it does not autopopulate, enter `90000` or more. If your TX fails, increase Gas Limit.  If you would like your TX to go through more quickly, adjust your gas limit accordingly.
9. Click `Generate Transaction` button
10. Check the details of the transaction, and if you are confident with the details you have entered, click `Yes, I am sure! Make transaction` 
11. If all went well, a green bar will appear at the bottom of the page including a link to your transaction on the blockchain. 
12. After the transaction is confirmed the ERC20 tokens will be transferred to your wallet.

**Note:** You will not see your tokens immediately in MEW, you need to take a few extra steps. See [instructions for seeing token balance and transferring tokens.](https://steemit.com/eos/@sandwich/how-to-transfer-eos-erc20-tokens-using-myetherwallet)

# Step 3: EOS Public Key Mapping

This is the part of the process that confuses people the most. So please read every single word here very carefully. These steps can be completed at any time before the ERC20 tokens are frozen somewhere around **June 3rd 2018**.

## Step 3.A: Generate EOS Key-pair

1. Visit the [EOS Token Generator](https://nadejde.github.io/eos-token-sale/) created by @nadejde based off the official EOS Contribution Interface code, but with everything stripped out but the Key Generator. The original article about this code is [here](https://steemit.com/eos/@nadejde/eos-key-generator)
2. Click `Generate EOS key`
3. CAREFULLY SAVE THE GENERATED KEY-PAIR

If for whatever reason you lose them, you can [update your EOS keys at any time](https://steemit.com/eos/@sandwich/how-to-update-the-eos-public-key-mapped-registered-to-your-ethereum-wallet-with-myetherwallet-mew) anytime between now and 48 hours after the token sale.

## Step 3.B: Registering/Mapping your EOS Key

### About EOS Key Mapping

Registering your EOS key will map the key-pair you generated earlier, the public key of your future EOS wallet, to the Ethereum Address this transaction is broadcasted from. It is **very** important to understand this, because 48 hours after the token sale ends, ERC20 tokens can no longer be transferred, and where they live at that moment in time will be **where they die**, only to be _reborn_ on the EOS blockchain according to the mapping defined by this function. 

(takes deep breath)

For example, if you move the EOS ERC20 tokens to an exchange, and fail to move your tokens back to an **Ethereum address you posses the private keys for that is mapped/registered to an EOS address**, you will not have access to those EOS tokens on the native chain after _June 3rd 2018_. 

_...But relax, you have time, there is no rush or need for anxiety yet, June 3rd is still a ways away_

### Does it matter _when_ the EOS keys are mapped to an Ethereum Wallet?

**What's most important about all this is that you have a valid EOS key-pair whose public key is mapped to an Ethereum wallet containing EOS ERC20 tokens BEFORE the end of the 48 hour grace period following the end of the EOS token sale on June 1, 2018 at 22:59:59 UTC**

This means that registering a.k.a. "Mapping" your EOS key can be completed at your discretion, before or after funding the EOSCrowdsale Contract, at any time between now and the end of the ICO.

**EOS Public Key Registration can be completed at your discretion, before or after funding the contract**

### How to Register your EOS Key

**YOU ONLY NEED TO MAP AN EOS KEY TO AN ETHEREUM ADDRESS ONCE! DOING MORE THAN ONCE IS JUST WASTING MONEY!** ... Unless of course you need to [Update Your EOS Key Mapping](https://steemit.com/eos/@sandwich/how-to-update-the-eos-public-key-mapped-registered-to-your-ethereum-wallet-with-myetherwallet-mew)

2. Go to [https://www.myetherwallet.com/#contracts](https://www.myetherwallet.com/#contracts)
3. Under heading **Select Existing Contract** is a dropdown, select _EOS Contribution_
4. Click `Access`
5. Under "Read / Write Contract" select `register`from dropdown.
6. In the field named _Key_ enter the **EOS Public Key** you generated earlier. **DO NOT**, I repeat, **DO NOT** enter your Private key here.
5. Load your wallet using any one of the methods listed, for this example I used the Keystore File. Enter the password to your wallet in the very likely event is is encrypted. If it's not encrypted, may Murphy's Law forever be in your favor.
6. Click `Unlock`
7. Click `Write`
8. Set _Amount to send_ to `0` and allow the wallet to suggest a _Gas Limit_. If it does not autopopulate, enter `90000` or more. If your TX fails, increase Gas Limit.  If you would like your TX to go through more quickly, adjust your gas limit accordingly.
9. Click "Generate Transaction"
10. Check the details of the transaction, and if you are confident, click `Yes, I am sure! Make transaction`
11. If all went well, a green bar will appear at the bottom of the page including a link to your transaction on the blockchain. 

## Unanswered Questions

- What happens if a single EOS public key is mapped to multiple Ethereum addresses?

## Answered Questions
> Can `register()` be called from the Ethereum wallet to update its mapping to an EOS public key? 

**[Yes, it can](https://steemit.com/eos/@sandwich/how-to-update-the-eos-public-key-mapped-registered-to-your-ethereum-wallet-with-myetherwallet-mew)**
> How does `buyWithLimit()` work in practice? Are funds not meeting limit requirements returned when running `claimAll()`? If so, where is the code for this? 

`buyWithLimit()` function will prevent you from sending the same contribution twice, for example, if a TX is stuck due to network congestion. I have provided a [tutorial on this](https://steemit.com/eos/@sandwich/how-to-contribute-to-a-future-window-on-eoscrowdsale-using-myetherwallet-mew)

# Conclusion

I strongly suggest you use the official EOS contribution page with MetaMask integration, [here's a good tutorial that explains how](https://steemit.com/eos/@ash/full-walkthrough-how-to-join-eos-ico). It takes far less time, and the chances of making a mistake are many orders of magnitude lower. 

For the advanced users, MEW fanatics, and paranoiac offline TX signers, you probably found this helpful. If you've found an error, please let me know! 

### Recap

2. Fund Contract from Ethereum Wallet you have mapped with your EOS key (or be sure to send the ERC20 tokens there by end of Token Sale)
3. Claim your tokens if you would like to transfer them
1. Generate and save EOS key pair
1. Register (map) your EOS public key to your Ethereum Wallet (technically anytime before end of Token Sale). 

_**Remember** that your EOS ERC20 tokens should be in a wallet mapped to an EOS public key that you posses the private keys for sometime before the end of the ICO._

If you have no specific reasoning for preferring MEW you should really visit [this article](https://steemit.com/eos/@trogdor/the-eos-ico-for-dummies) by @trogdor that explains the EOS sale in its entirely, as well as the MetaMask contribution process.

# Troubleshooting
- If you're getting "Window Blocked" errors in MEW, try the following
     - Disable your adblocker
     - If using brave, switch to chrome
     - Visit `chrome://settings/content/popups` and turn off pop-up blocker (switch to "allowed") 

# More EOS MEW Guides
- [How to contribute to a future window on EOSCrowdsale using MyEtherWallet (MEW)](https://steemit.com/eos/@sandwich/how-to-contribute-to-a-future-window-on-eoscrowdsale-using-myetherwallet-mew)
- [How to Transfer EOS ERC20 Tokens with MyEtherWallet](https://steemit.com/eos/@sandwich/how-to-transfer-eos-erc20-tokens-using-myetherwallet)
- [How to Check Which EOS Public Key is mapped to your Ethereum Address](https://steemit.com/eos/@sandwich/how-to-check-which-eos-public-key-is-mapped-to-your-eth-address-with-myetherwallet-mew)
- [How to update the EOS public key mapped/registered to your Ethereum Wallet with MyEtherWallet (MEW)](https://steemit.com/eos/@sandwich/how-to-update-the-eos-public-key-mapped-registered-to-your-ethereum-wallet-with-myetherwallet-mew)
- [EOS Sale Tracker Fork with Usability Improvements, Suitable For Novices](https://steemit.com/eos/@sandwich/eos-sale-tracker-fork-with-usability-improvements-suitable-for-novices)
- [Has MyEtherWallet's EOS Contribution instructions left you with more questions than answers?](https://steemit.com/eos/@sandwich/has-myetherwallet-s-eos-distribution-instructions-left-you-with-more-questions-than-answers)
- [Dissecting the EOS ICO Distribution App, how does it interface with the EOSCrowdsale Contract?
](https://steemit.com/eos/@sandwich/dissecting-the-eos-ico-distribution-app-how-does-it-interface-with-the-eoscrowdsale-contract)

# Coming soon
- Instructions for adding EOS ERC20 token to MEW with "Add Custom Token"
- Videos for each step. 

Again, **USE AT YOUR OWN RISK** ... I'm only a Sandwich. 

Thanks for reading :)

# Changelog
- Some wording has been improved and simplified, excess removed. 
- I verified the instructions, You can view [Registration TX](https://etherscan.io/tx/0xbe78d536e6da9fc69ff130a1855c4d0362249b4684f074bde070cad0550e2c72) and [Funding TX ](https://etherscan.io/tx/0xf0e9650e27dc5074a58a255977ea66ab2f91e8d066239445405604f3979d4a79) on the blockchain. _I will test the Claim instructions at end of first window._
- MyEtherWallet added contract to their interface, updated accordingly.
- Removed Technical Breakdown, moved it into it's own post.
- Changed step order to subdue chaos and confusion.