Update migrating-aeusdc.md #1803
Conversation
There was a problem hiding this comment.
Pull request overview
This PR significantly expands and improves the documentation for migrating aeUSDC tokens to USDCx on Stacks. The update transforms a brief migration guide into a comprehensive resource with detailed step-by-step instructions, comparison tables, FAQs, and technical architecture explanations.
Changes:
- Expanded migration instructions with two detailed methods: Bitflow swap (recommended) and Allbridge Classic + USDCx bridge
- Added comprehensive sections on benefits of USDCx including liquidity, user experience, security, and ecosystem support
- Included comparison table, FAQ section, technical architecture details, and additional resources with links
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| aeUSDC on Stacks is a bridged form of USDC managed by Allbridge Classic. Following the launch of USDCx on Stacks in December 2025, aeUSDC holders should upgrade to USDCx for better liquidity, improved user experience, and stronger trust assumptions. | ||
|
|
||
| aeUSDC was first released in 2023. It will be gradually depreciated in favor of USDCx. | ||
| aeUSDC was first released in 2023 as a wrapped token that required users to lock USDC on Ethereum and receive aeUSDC on Stacks. With the introduction of native USDCx via Circle's xReserve infrastructure, aeUSDC is being gradually deprecated. |
There was a problem hiding this comment.
The spelling "depreciated" should be "deprecated". "Depreciated" refers to a decrease in financial value over time, while "deprecated" means marked as obsolete or discouraged from use in software/technical contexts.
| - **To:** Ethereum | ||
| - **Asset:** aeUSDC | ||
| 4. Enter the amount to bridge | ||
| 5. Review fees and confirmation time (approximately 60 minutes - six confirmation blocks) | ||
| 6. Initiate the bridge transaction | ||
| 7. Sign the transaction in your Stacks wallet |
There was a problem hiding this comment.
The text states "six confirmation blocks" but Bitcoin (which Stacks is anchored to) produces blocks approximately every 10 minutes, so six blocks would be ~60 minutes. However, Stacks itself produces blocks faster (approximately every 5-10 minutes). The documentation should clarify whether this refers to Stacks blocks or Bitcoin blocks to avoid confusion.
| - **To:** Ethereum | |
| - **Asset:** aeUSDC | |
| 4. Enter the amount to bridge | |
| 5. Review fees and confirmation time (approximately 60 minutes - six confirmation blocks) | |
| 6. Initiate the bridge transaction | |
| 7. Sign the transaction in your Stacks wallet | |
| - **To:** Ethereum | |
| - **Asset:** aeUSDC | |
| 4. Enter the amount to bridge | |
| 5. Review fees and confirmation time (approximately 60 minutes – about six Bitcoin confirmation blocks; actual time may vary based on network conditions) | |
| 6. Initiate the bridge transaction | |
| 7. Sign the transaction in your Stacks wallet |
| - **To:** USDCx (Stacks) | ||
| 4. Enter the amount to bridge | ||
| - Minimum amount: 10 USDC | ||
| - Network fees: ~$4.80 USD |
There was a problem hiding this comment.
The network fee amount "$4.80 USD" appears to be a static estimate for Ethereum gas fees. Ethereum gas fees are highly variable and can fluctuate significantly based on network congestion. Consider either removing the specific dollar amount or adding a disclaimer that this is an estimate and actual fees may vary significantly.
| - Network fees: ~$4.80 USD | |
| - Network fees: variable and depend on Ethereum gas prices (often a few USD; check your wallet for the current fee) |
1 participant
Description
Describe the changes that were made in this pull request. When possible start with the motivations behind the change.