You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 5b404e9
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: learn/sip-03-migration.mdx
+30-5Lines changed: 30 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: 'SIP-03 Migration Guide'
3
3
sidebarTitle: 'SIP-03 Migration'
4
4
description: 'Practical steps and resources for users and exchanges migrating during SIP-03, including asset transfer, USDC, and exchange migration guidance.'
@@ -45,8 +45,8 @@ If you hold any of the following IBC assets on Sei, take action before [Proposal
45
45
46
46
| Asset | Token contract | Action(s) | Possible route(s) | Support |
47
47
| :---- | :---- | :---- | :---- | :---- |
48
-
|**USDC.n (USDC via Noble)**|[seiscan](https://seiscan.io/address/0x3894085ef7ff0f0aedf52e2a2704928d1ec074f1)[mintscan](https://www.mintscan.io/sei/assets/ibc%2FCA6FBFAF399474A06263E10D0CE5AEBBE15189D6D4B2DD9ADE61007E68EB9DB0)| Swap to native USDC or migrate via CCTP |[Saphyre](https://saphyre.xyz/swap?inputCurrency=0x3894085Ef7Ff0f0aeDf52E2A2704928d1Ec074F1&outputCurrency=0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392), [Symphony](https://symph.ag/), or [Stargate](https://stargate.finance/?srcChain=sei&srcToken=0x3894085Ef7Ff0f0aeDf52E2A2704928d1Ec074F1)|[Sei blog](https://blog.sei.io/announcements/holders-of-usdcn-need-to-swap-or-migrate/)[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei?ref=blog.sei.io)|
49
-
|**USDT.kava (USDT via Kava)**|[seiscan](https://seiscan.io/token/0xb75d0b03c06a926e488e2659df1a861f860bd3d1)[mintscan](https://www.mintscan.io/sei/assets/ibc%2F6C00E4AA0CC7618370F81F7378638AE6C48EFF8C9203CE1C2357012B440EBDB7)| Swap via Symphony or bridge out to Kava |[Symphony](https://symph.ag/), [Stargate](https://stargate.finance/?srcChain=sei&srcToken=0xB75D0B03c06A926e488e2659DF1A861F860bD3d1)|[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei)|
48
+
|**USDC.n (USDC via Noble)**|[seiscan](https://seiscan.io/address/0x3894085ef7ff0f0aedf52e2a2704928d1ec074f1)[mintscan](https://www.mintscan.io/sei/assets/ibc%2FCA6FBFAF399474A06263E10D0CE5AEBBE15189D6D4B2DD9ADE61007E68EB9DB0)| Swap to native USDC or migrate via CCTP |[Saphyre](https://saphyre.xyz/swap?inputCurrency=0x3894085Ef7Ff0f0aeDf52E2A2704928d1Ec074F1&outputCurrency=0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392), [Symphony](https://symph.ag/), or [CCTP Exchange](https://cctp.exchange/)|[Sei blog](https://blog.sei.io/announcements/holders-of-usdcn-need-to-swap-or-migrate/)[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei?ref=blog.sei.io)|
49
+
|**USDT.kava (USDT via Kava)**|[seiscan](https://seiscan.io/token/0xb75d0b03c06a926e488e2659df1a861f860bd3d1)[mintscan](https://www.mintscan.io/sei/assets/ibc%2F6C00E4AA0CC7618370F81F7378638AE6C48EFF8C9203CE1C2357012B440EBDB7)| Swap to a native asset via Symphony |[Symphony](https://symph.ag/)|[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei)|
50
50
|**USDCso (Wormhole, Solana)**|[mintscan](https://www.mintscan.io/sei/assets/factory%2Fsei189adguawugk3e55zn63z8r9ll29xrjwca636ra7v7gxuzn98sxyqwzt47l%2F9fELvUhFo6yWL34ZaLgPbCPzdk9MD1tAzMycgH45qShH)| Bridge out to Solana via Wormhole |[Portal Bridge (legacy)](https://legacy.portalbridge.com/#/transfer)|[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei)|
51
51
|**Wormhole-bridged WETH**|[mintscan](https://www.mintscan.io/sei/assets/factory%2Fsei189adguawugk3e55zn63z8r9ll29xrjwca636ra7v7gxuzn98sxyqwzt47l%2F4tLQqCLaoKKfNFuPjA9o39YbKUwhR1F8N29Tz3hEbfP2)| Bridge out to Ethereum via Wormhole |[Portal Bridge (legacy)](https://legacy.portalbridge.com/#/transfer)|[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei)|
52
52
|**USDCet (Wormhole, Ethereum)**|[mintscan](https://www.mintscan.io/sei/assets/factory%2Fsei189adguawugk3e55zn63z8r9ll29xrjwca636ra7v7gxuzn98sxyqwzt47l%2FHq4tuDzhRBnxw3tFA5n6M52NVMVcC19XggbyDiJKCD6H)| Bridge out to Ethereum via Wormhole |[Portal Bridge (legacy)](https://legacy.portalbridge.com/#/transfer)|[Sei Tech Chat](https://t.me/+KZdhZ1eE-G01NmZk)[Discord](https://discord.com/invite/sei)|
@@ -83,13 +83,34 @@ Native USDC and Circle's CCTP V2 are now supported on Sei. USDC from Noble (USDC
83
83
84
84
**Migrate (larger amounts):**
85
85
86
-
-**Manual migration:** Bridge USDC.n via [Stargate](https://stargate.finance/?srcChain=sei&srcToken=0x3894085Ef7Ff0f0aeDf52E2A2704928d1Ec074F1) to an intermediary chain with CCTP v1 and v2 (e.g., Base), then use CCTP to burn/mint native USDC back to Sei.
87
-
- Other useful bridging frontends: [CCTP Exchange](https://cctp.exchange/)
86
+
USDC.n reached Sei over IBC from Noble, so larger balances are best migrated to native USDC by routing back through Noble — this avoids the slippage of a direct DEX swap.
87
+
88
+
- IBC-transfer your USDC.n from Sei back to Noble, where it becomes native Noble USDC, then use Circle's CCTP to mint native USDC on Sei. [CCTP Exchange](https://cctp.exchange/) is a useful frontend for the CCTP leg.
89
+
90
+
Complete this **before** the SIP-03 upgrade, while IBC routing through Noble is still available.
88
91
89
92
**For DeFi suppliers of USDC.n (Yei, Takara Lend, etc.):**
90
93
91
94
- Wind down and withdraw your positions **before** migrating to native USDC. Failure to do so before the SIP-03 upgrade may result in inability to access your supplied assets.
92
95
96
+
### 3) Address Association (Seistream)
97
+
98
+
[Seistream's SIP-03 migration page](https://seistream.app/migrate-sip03) links your EVM (`0x...`) and Cosmos (`sei1...`) addresses for the **native SEI token** in three guided steps. It is a community-built tool that streamlines the standard association flow.
99
+
100
+
Address association is the one-time, on-chain step that links your `0x...` and `sei1...` addresses so a single key controls both. It must be completed **before** the SIP-03 upgrade — afterward, Cosmos (`sei1...`) interfaces stop working and addresses can no longer be associated. See [Account Linking](/learn/accounts) for how association works under the hood.
101
+
102
+
What the tool does:
103
+
104
+
1.**Connect wallet** — connect any EVM wallet with an injected provider (MetaMask, Keplr, Rabby, Compass, Tangem, Trust Wallet, OKX, and most others).
105
+
2.**Gas + association** — cover the small amount of SEI needed for gas (Seistream provides a mainnet faucet to help), then submit the transaction that associates your `0x...` and `sei1...` addresses on-chain. Any outgoing EVM transaction registers the link automatically.
106
+
3.**Transfer from Cosmos** — send your existing native SEI from the old Cosmos wallet to the linked `sei1...` address, where it becomes spendable from your EVM wallet.
107
+
108
+
This is a streamlined alternative to the manual association flow in [Migrating a hardware or mnemonic-only wallet](#migrating-a-hardware-or-mnemonic-only-wallet).
109
+
110
+
<Warning>
111
+
Seistream handles association for the **native SEI token only**. For USDC, USDT, ATOM, WBTC, and other IBC-bridged assets, use the [IBC Asset Migration Table](#ibc-asset-migration-table). Seistream is a third-party tool; its inclusion here is not an endorsement, and you should do your own research before connecting a wallet.
112
+
</Warning>
113
+
93
114
## Migrating a hardware or mnemonic-only wallet
94
115
95
116
If your wallet can export a raw private key, the simplest path is to import that key into an EVM wallet. A private key is independent of coin type, so it reproduces the same `0x...` and `sei1...` addresses in any wallet, and no funds need to move.
@@ -109,6 +130,10 @@ For background, see [HD Paths and Coin Types](/learn/accounts#hd-paths-and-coin-
109
130
110
131
This works because every account has exactly one EVM (`0x...`) address and one Cosmos (`sei1...`) address, both derived from the same key. Funds sent to the new account's `sei1...` address are therefore spendable from the EVM wallet that holds its `0x...` address.
111
132
133
+
<Tip>
134
+
Prefer a guided flow? [Seistream's SIP-03 migration tool](https://seistream.app/migrate-sip03) walks through these same steps — connect an EVM wallet, cover gas, associate addresses, then transfer native SEI from the Cosmos side. See [Address Association (Seistream)](#3-address-association-seistream). It covers native SEI only; the manual steps below work for any wallet you control.
135
+
</Tip>
136
+
112
137
<Steps>
113
138
114
139
<Steptitle="Create a new account in an EVM wallet you control">
0 commit comments