Migrating Particles from V1 to V2
A guide on Migrating Particle balances from V1 to V2

Overview

With the launch of Charged Particles V2 comes the option to migrate your Particle's wallet balances from V1 to V2. This guide explains the what, why, and when of migration to help you make a decision on whether or not to migrate your Particle's assets, and how to do so if you choose to.

What does migration mean?

There are two types of migrations related to V2 of Charged Particles -- contract-level migrations, and asset migration:
  • Contract-level migrations refer to the ChargedSettings.sol and ChargedState.sol and will be done automatically for all Particles after upgrades are complete.
  • Asset migration refers to moving balances from a Particle's V1 smart wallets to its V2 smart wallets. Asset migration is optional and must be done by a Particle's owner. For more information on smart wallets, see this high-level overview.

Asset Migration Flow

Who should migrate their Particles' assets?

Migrating assets from V1 to V2 is not necessary and does not make sense in many scenarios.
Scenarios when it DOES make sense to migrate your Particle's assets:
  • You want to be able to redirect your Particle's royalties and/or creator annuities to a third party, (that feature is only available in V2)
  • You do not plan on depositing any additional assets into V1
Scenarios where it DOES NOT make sense to migrate your Particle's assets:
  • You are not concerned with getting all of V2's features
  • You already have assets in V1 and do not want to pay gas fees to withdraw those assets from V1 and deposit into V2 -- In this case, you can just keep depositing into V1 so that when you do decide to withdraw from your Particle, you only have to do so once for each asset type

Migration Guide

Migrating assets from V1 to V2 requires 2 basic steps -- withdrawing assets from V1 and depositing them into V2. See below for specific instructions on how to migrate Aave ERC20s, Non-aave ERC20s, and Nested NFTs.

Migrating Tokens

Removing an Asset from V1
  • Click the "Discharge" button on the Energize page for your particle.
  • Select "Total Amount" from the dropdown
  • Make sure V1 is selected
  • Select either the Aave or Non-Aave depending on what you are trying to withdraw, and select the token you want to migrate
Depositing an Asset into V2
  • After successfully withdrawing your asset, click the "Charge" button
  • Ensure that V2 is selected on the Energize popup
  • Deposit your asset into V2

Migrating NFTs

Removing an Asset from V1
  • Click the "Discharge" button on the Energize page for your particle.
  • Select "NFTs" from the dropdown
  • Make sure V1 is selected
  • Select the NFT you want to migrate and remove it from the V1 wallet of your Particle
Depositing an Asset into V2
  • After successfully withdrawing your asset, click the "Charge" button
  • Ensure that V2 is selected on the Energize popup
  • Deposit your asset into V2