Skip to content

docs: add seed phrase import guide to Create a Vault - #93

Open
realpaaao wants to merge 2 commits into
mainfrom
docs/import-seed-phrase
Open

realpaaao wants to merge 2 commits into
mainfrom
docs/import-seed-phrase

Conversation

@realpaaao

Copy link
Copy Markdown
Contributor

Summary

New app-guide page for importing a 12 to 24-word seed phrase into a Fast or Secure Vault, with screenshots from the iOS app.

App Guide
└─ Create a Vultisig Fast or Secure Vault
   ├─ Fast Vault
   ├─ Secure Vault
   └─ Import a seed phrase   ← new (plus a card on the parent page)

Context

The apps ship seed phrase import (iOS ImportSeedphraseScreen, Android ImportSeedphraseViewModel, desktop and extension import views), but only the SDK and CLI developer pages documented it. Every user-facing page said Vultisig has no seed phrase.

Facts on the page come from vultisig-ios origin/main (f04879140):

  • The import splits the seed's existing master key (KeygenViewModel.swift:718 → dkls_key_import_initiator_new in DKLSKeygen.swift:145). The vault keeps the same addresses, and the old words can still sign on their own. The page carries a danger hint about this.
  • An imported vault signs only on the chains selected at import (CoinService.assertChainAllowed, KeyImportChainRestrictionTests). The page warns you to pick every funded chain.
  • Duplicate check (ImportSeedphraseScreen.checkIfSeedAlreadyImported): the app refuses a seed phrase that a vault on the device already uses. The troubleshooting entries reflect that.
  • Word counts 12/15/18/21/24, the 2-minute scan, and the Phantom Solana path auto-pick come from the app's strings and KeyImportChainsSetupViewModel.

Screenshots: iOS 1.50 (79) Debug build on an iPhone 17 simulator, driven with Maestro, with the status bar overridden to 9:41. The scan ran on the public BIP39 test vector, and no screenshot shows seed words.

receipts

no runtime changes

not verified: the page's look in GitBook (it uses the same figure and hint blocks as fast-vault.md). Not verified: the Android and desktop flows match the iOS screens step for step.

Merge danger

Door: two-way: a revert removes the page.
Blast radius: the docs nav under Create a Vault only.

realpaaao and others added 2 commits November 5, 2026 12:01
The apps can turn a BIP39 seed phrase into a Fast or Secure Vault, but
the app guide never mentioned it. Only the SDK and CLI pages did, and
every user-facing page said Vultisig has no seed phrase.

The new page walks through the iOS flow with screenshots from the app
and warns that the old words still control the funds, since the vault
keeps the same keys and addresses. It also says the chains picked at
import are the only ones the vault can sign on.
…3 shot

- Parent page description no longer says "No seed phrase" above the
  new Import a seed phrase card.
- Step 3 screenshot retaken at 690x1500 with the 9:41 status bar, like
  the other six (iOS 1.50 (80) Debug, fresh iPhone 17 simulator, no words entered).
- Troubleshooting: Secure Vault re-import, other devices ask to replace
  their copy (KeygenViewModel confirmDuplicateVaultIfNeeded).
@realpaaao
realpaaao force-pushed the docs/import-seed-phrase branch from ee74aa8 to 9d4a132 Compare November 11, 2026 16:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant