Skip to main content

Selling Your Ember Portfolio(s) On-Chain

This article provides a step-by-step guide on how to process portfolio sales directly on-chain.

Jack avatar
Written by Jack
Updated this week

A quick note before we begin: early in the process you won’t see your full balance reflected right away. This is expected — as you move through the steps, you’ll progressively unlock access to your tokens.

To complete this process, you'll need:

  1. A smartphone

  2. A computer with Google Chrome

Section 0: Getting your portfolio info from Ember (~2 minutes)

  1. Open up the Ember app

  2. Send your portfolio information to your email

In this email, you will receive the following info:

  • Name of your portfolio

  • Coin Name

  • Edge Smart Wallet Address

  • Proxy Address

  • Portfolio Contract Address

  • Network (Ethereum or Polygon)

We’ll guide you through when and how to use each of these in the tutorial. Now that you have everything you need, you're ready to move on to the next step!


Section 1: Retrieving Your Seed Phrase from Edge (~5 minutes)

  1. Install the Edge App on your smartphone if you haven't already
    ​

  2. Log in to Edge using your Ember username and password. Please make sure that you log in instead of creating an account! Creating a new account on Edge will not work for this.
    ​

  3. Tap Assets
    ​

  4. Look for any wallet(s) labeled: ETH Ember Smart Wallet or com.krytonite.ember. If you have multiple portfolios, you may see multiple of these wallets in Edge!
    ​
    ​


    ​

  5. We are looking specifically for the wallet with the same address as the "Edge Smart Wallet Address" sent in the email and shown in the Ember app.
    ​

  6. To check the addresses of the wallets in Edge:
    ​

    1. Tap on one of the ETH Ember Smart Wallet (or "com.krytonite.ember")

    2. Tap Receive

    3. Compare the wallet address shown here with the Edge Smart Wallet Address provided in your email. If they match, you're on the correct wallet!
      ​

Common issue #1: Using a wallet address in Edge that is different than the Edge Smart Wallet that we sent in our email!

Fix: Make sure that you find the matching wallet. Wallet addresses are insensitive, so don't worry if the capitalization looks different.

4. Once you found the matching wallet address, go back and then tap the three dots near the top right. Then choose Get Raw Keys:


5. Enter your Ember password again, then you should see your 12 or 24-word "ethereumMnemonic" phrase. Keep this open for the next step! We'll tell you what to do with this shortly.


Section 2: Installing Metamask & Importing Your Smart Wallet (~5 minutes)

Important: If you already use Metamask, do NOT use your primary browser profile, as this may overwrite your wallet and risk losing access to existing assets. We recommend creating a new Chrome profile to stay safe.


S2, Step 1: Installing Metamask

  1. Open Chrome and create a new browser profile, and install Metamask from https://metamask.io:
    ​

  2. Click Install Extension, then Add to Chrome.
    ​

  3. When Metamask opens, select Import an Existing Wallet.
    ​

  4. Enter the 12 or 24-word mnemonic phrase you have in the Edge app, then confirm.
    ​

  5. You will be prompted to create a new Metamask wallet password. Write this down!

S2, Step 2: Adding your portfolio tokens

  1. In Metamask, click the three dots next to "Popular Networks," then select Import tokens

  2. Choose Custom Token
    ​

  3. Select the correct network (Ethereum or Polygon)
    ​

  4. Copy and paste your Portfolio Contract Address (from our email!)
    ​

  5. Follow the prompts and import!
    ​

  6. Once you've imported the tokens, you should see the token added to the bottom of your Tokens page. It will have 0 tokens in it -- that's expected for now!
    ​

Common issue #2: The Token Symbol doesn't automatically fill in.

Fix: Check the Ember app to see the token symbol for your given portfolio. It should look like "EMVI", "BIG", or something in that form! The token decimal will fill in automatically.


Section 3: Moving Portfolios into Metamask (~30 minutes)

S3, Step 0: Add ETH or MATIC/POL to cover gas fees

Before we begin, you’ll need a small amount of crypto in your MetaMask wallet to cover gas (network) fees for the upcoming transactions.


​If your portfolio is on Ethereum: Add about $20 worth of ETH to your MetaMask wallet.


​If your portfolio is on Polygon: Add about $2 worth of POL AND $20 of ETH to your MetaMask wallet.

Once you have ETH and/or POL in your wallet, you’ll be ready to move on to the next step.
​

S3, Step 1: Connect Metamask to MyCrypto

  1. Using your new Chrome profile with Metamask, visit https://app.mycrypto.com/add-account.
    ​

  2. Before you connect your Metamask account, be sure that you select the network that your portfolio is held on!
    ​

  3. Next, click Connect to Metamask and follow the prompts:
    ​


    ​

Common issue #3: MyCrypto connects to the wrong network.

To check this, go to the Settings page at the bottom left of MyCrypto. Be sure that your network is correct for your portfolio! (Ethereum or Polygon). Side note: you can safely ignore the value that is shown here.

Fix: If you're on the incorrect network, tap the "X" to remove the wallet. Tap "Add" to re-add the wallet and follow the prompts. Go back to Settings to check the network. Repeat these steps until you see the correct network!

S3, Step 2: Interact with the Token Contract

  1. Once your wallet is connected on the correct network, navigate to this page: (Interact with Contracts).
    ​

  2. Fill out the contract info from your email:

Network: Choose Ethereum or Polygon based on your portfolio.
​

Contract: Paste your Proxy Address, then press Enter.
​

ABI/JSON Interface: Paste this exact code:
​

[
  {
    "inputs": [
      {"internalType": "address[]","name": "_tokenAddresses","type": "address[]"}
    ],
    "name": "withdrawAllAdmin",
    "outputs": [],
    "stateMutability": "nonpayable",
    "type": "function"
  }
]

Common issue #4: Pasting the ABI/JSON code in a different language.

Fix: Be sure to paste this exact code in English. If you paste this in a different language, it will not work.

3. Click Interact with Contract.
​

4. A new Read/Write Contract section will appear: Select withdrawAllAdmin.

6. For _tokenAddresses address[]: Paste your Portfolio Contract Address from the email in brackets and quotes. Example:
​

["0xc4797eda62a675790cf8b7e1f17d16fa9917a248"]

Common issue #5: Not putting the Portfolio Contract Address is brackets and quotes.

Fix: Add bracket and quotes around the Portfolio Contract address, or else the transaction will fail.

7. For the Account, choose your connected Metamask. Here's what it should look like so far:
​
​

8. If everything looks good, tap on Write.

9. On the next screen, confirm by clicking Confirm and Send.


​

10. Metamask will prompt a confirmation review in your Metamask extension!

To prevent the transaction from failing, it's best to set the "Network fee" to "Aggressive". To do so, tap on the small Pencil icon, and then tap on Aggressive.
​

11. Once set, click Confirm:

Common issue #6: The transaction fails after trying.

Fix: This could happen even if all the info is entered correctly. Just try this section again! As long as you see "You receive: +XYZ" token amount at the top of the confirmation screen, it should go through properly.

12. Once completed, your portfolio tokens will be added to your Metamask wallet as seen below. Once you see the token amount, you can move on to the next steps!
​

S3, Step 4 (Polygon Portfolios Only): Moving tokens to Ethereum

  1. Go to Polygon Bridge and connect your MetaMask wallet (top right).
    ​

  2. Under “Transfer From,” select Polygon POS.

  3. Click the token selection dropdown (it should say MATIC or POL by default)
    ​

  4. In the search bar, paste in your Portfolio Contract Address (from the email!)
    ​

  5. Click Add, then confirm the addition
    ​

  6. Click "MAX" to queue up your token to be bridged
    ​

  7. Verify the “Transfer To” field shows Ethereum, then click Bridge to Ethereum.
    ​

  8. Confirm the transaction in MetaMask.


    ​Important Note: Bridging tokens can occasionally take over an hour, so you'll need to wait for it to complete before moving on to Section 4.
    ​

    ​
    You will need to "claim" the token you bridged:

  9. If you did not add the token previously, you will be prompted to add it now:

  10. Once you have your tokens on the ETH Network, you're all set to move on to the next step!
    ​

Section 4: Redeeming your portfolio token(s) for your underlying assets (~10 minutes)

S4, Step 1: Connect your Metamask wallet to Etherscan

  1. Go to Set: Basic Issuance Module
    ​

  2. Connect your Metamask wallet via Connect to Web3 (important!)
    ​

  3. Follow the prompts from Metamask to connect
    ​

  4. Click on the "redeem" dropdown

S4, Step 2: Enter your portfolio info

In this step, you'll need to do each portfolio individually.

  1. setToken (address): Enter the Portfolio Contract Address.
    ​
    If your portfolio is on Ethereum, you can use the Portfolio Contract Address from the email was sent!
    ​
    If your portfolio was originally on Polygon, follow these steps to find your updated Portfolio Contract Address:
    ​

    1. Open your Metamask wallet extension

    2. Tap on your portfolio token

    3. Scroll down and copy the "Contract Address" under the "Token details" section
      ​

  2. quantity (uint256): Enter your token amount converted to uint256 format (steps show below)
    ​

    1. Type the exact amount of tokens that you see in the Ember app

    2. After typing the app, tap on the "+" next to Quantity

    3. Select 10^18

    4. This will reformat your quantity to the correct format!
      ​

  3. to (Address): Enter your Metamask ETH wallet address (should be the same as your Edge Smart Wallet Address)!

Here's how it should look at this point:


​

4. Tap Write, then Confirm the transaction in Metamask.

When the transaction has completed, the underlying assets of your portfolio will be added to your wallet to your wallet!

Common mistake #7: Using the wrong Portfolio Contract Address if your portfolio was originally on Polygon.

Fix: Refer back to the beginning of this step! We cover how to find the update Portfolio Contract Address directly in Metamask.

Common mistake #8: Entering the wrong quantity, causing very high fees in Metamask

Fix: Be sure to copy the exact quantity that you see in Ember, and then be sure to convert it to uint256 format! Refer back to beginning of this step.

If you do not see the new tokens in your wallet:

You may need to import the underlying token to see your redeemed assets in MetaMask:

  1. On your Etherscan transaction page, find the token you redeemed.

  2. Click the copy icon next to the token address to copy it.
    ​

  3. Back in Metamask, follow the same steps we used earlier (end of Section 2) to import a Custom Token using the address you’ve just copied.

Congratulations! You now have extracted all of the underlying tokens from your portfolio. Feel free to hold onto these tokens, or swap them into a different crypto if you'd like. If you'd like to swap to a different crypto, follow this short tutorial (we promise it's a lot shorter than this one): Swapping Tokens for ETH or USDC in SushiSwap

Ember

Did this answer your question?