docs: SIP-03 migration path for mnemonic-only and hardware wallets

[alexander-sei]

What is the purpose of the change?

Adds new content to the SIP-03 Migration Guide. It documents how to migrate a Cosmos account to Sei EVM in the cases where the usual "export your private key into an EVM wallet" advice doesn't apply — a recurring support question.

Describe the changes to the documentation

Target audience: non-technical end users migrating during SIP-03 whose wallet won't hand them a usable raw private key.

New section "Migrating a hardware or mnemonic-only wallet" (placed after the USDC tools, before the FAQ), plus a matching FAQ entry that links to it.

It clarifies a distinction that trips people up:

• Exporting a raw private key always works — a private key carries no coin type, so it reproduces the same 0x and sei1 addresses in any wallet. If you can export one, that's still the recommended path.
• What actually fails:
  • Mnemonic-only wallets — Sei Cosmos accounts derive on coin type 118; importing the phrase into an EVM wallet re-derives at coin type 60, landing on a different account.
  • Ledger / hardware wallets — export nothing at all; you can only switch between the Cosmos app (118) and Ethereum app (60), which are different accounts.

The workaround documented: create a brand-new account in an EVM wallet you control → fund it (~0.1 SEI for the association tx) → associate it on dashboard.sei.io to reveal its paired sei1... address → send your old Cosmos funds to that sei1... (1 SEI test transfer first) → confirm → send the rest. The assets end up on a key you control via EVM. Includes a test-first warning and notes on timing, staking (unbond first), and verifying the destination via the addr precompile.

Notes

• Also fixes a pre-existing dead anchor: the USDC.n FAQ linked to #3-usdc-on-sei, but the heading is ### 2) USDC on Sei (#2-usdc-on-sei).
• mint broken-links passes (run under Node 22 — the CLI doesn't support Node 25+).
• Content-only change to the user-facing migration page; the exchange/custodian page is untouched.

🤖 Generated with Claude Code

[cursor]

PR Summary

Low Risk
Documentation-only edits to the migration guide; no runtime or security-sensitive code changes.

Overview
Adds SIP-03 guidance for users who cannot migrate by exporting a raw private key (mnemonic-only wallets and hardware wallets such as Ledger), including when raw-key import still works versus coin-type 118 vs 60 pitfalls.

A new section Migrating a hardware or mnemonic-only wallet documents the fund-move workaround: create a new EVM account, fund it for gas, associate on the Sei Dashboard to get the paired sei1... address, then Cosmos-send funds (1 SEI test first) to that address so balances are spendable from the EVM wallet. It includes warnings, pre-upgrade timing, staking/unbonding limits, and optional addr precompile verification.

The FAQ gains a matching entry; frontmatter keywords expand for Ledger/hardware/mnemonic topics. A broken USDC.n FAQ anchor is corrected from #3-usdc-on-sei to #2-usdc-on-sei.

^{Reviewed by Cursor Bugbot for commit e85520a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
sei-docs	🟢 Ready	View Preview	Jun 8, 2026, 11:19 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.