In crypto, it's common for tokens to undergo migrations or upgrades. These could include:
A project migrates from blockchain to another and users may need to swap their tokens on the original chain for those on the new chain (often referred to as a token migration)
A project upgrades its smart contract and users may need to swap their old tokens for upgraded versions of the same token (often referred to as a token swap)
How can I represent a token migration or swap in CoinLedger?
If you engaged in a token migration or token swap, these transactions will typically be imported automatically into CoinLedger, and no manual reclassification should be required. However, if you are importing transactions from a blockchain or protocol which CoinLedger does not have full classifications for yet, your token migration/swap may need to manually imported into CoinLedger.
This is an easy fix! Here's how you can represent a token migration or swap in CoinLedger:
Step 1
From within your CoinLedger account, navigate to the Transactions page and select Add Transaction.
Step 2
Next, enter the swap or migration transaction. From the classification dropdown, choose Trade as the transaction type. Next, enter the Timestamp of the transaction (in UTC), and select which platform this transaction occurred on under Source.
Next, you'll want to enter the old version of the token as the asset sent and the new version of the token as the asset received. For example: if you held the old version of VGX before their token upgrade occurred, you would use VGX (Old) as the Asset Sent and VGX (the new token) as the Asset Received. Make sure you enter the same quantity under Amount for each asset if they were swapped on a 1:1 basis.
Once you've added all the necessary information for this transaction, press Save.
Step 3
Finally, select the three dots next to the transaction and select Mark as non-taxable. This ensures that the original acquisition date of the asset (pre-migration) is carried over properly after the token migration/swap.
How are token migrations and swaps taxed?
All token swaps and upgrades are treated as regular crypto-to-crypto trades from a taxable perspective, as you are trading one cryptocurrency for another.
In the case of a token swap or migration, if you swapped an old version of a token for the new version of the token on a 1:1 ratio, then you won't have any gains or losses. You may see a marginal gain or loss depending on the fees disposed of in this transaction.
To learn more about how token swaps or migrations are taxed, please see this guide.