Importing Wallets

Vigil supports importing wallet configurations from popular formats.

Caravan Import

Caravan is an open-source multisig coordination tool from Unchained. Vigil can import Caravan wallet configurations directly.

Exporting from Caravan

1. Open your wallet in Caravan
2. Go to Wallet → Export
3. Download the JSON configuration file

Importing to Vigil

1. Navigate to Wallets → Add Wallet
2. Select Import from Caravan
3. Either:
   • Upload File - Select your JSON file
   • Paste JSON - Paste the configuration directly
4. Review the imported settings:
   • Wallet name
   • Quorum (e.g., 2-of-3)
   • Extended public keys
   • Derivation paths
5. Click Create Wallet

Caravan JSON Format

Example Caravan export:

{
  "name": "My Multisig Vault",
  "network": "mainnet",
  "quorum": {
    "requiredSigners": 2,
    "totalSigners": 3
  },
  "extendedPublicKeys": [
    {
      "xpub": "xpub6...",
      "bip32Path": "m/48'/0'/0'/2'",
      "xfp": "12345678"
    },
    {
      "xpub": "xpub6...",
      "bip32Path": "m/48'/0'/0'/2'",
      "xfp": "87654321"
    },
    {
      "xpub": "xpub6...",
      "bip32Path": "m/48'/0'/0'/2'",
      "xfp": "abcdef12"
    }
  ],
  "addressType": "P2WSH"
}

Vigil will automatically convert this to the appropriate output descriptor for monitoring.

BSMS Import

Bitcoin Secure Multisig Setup (BSMS) is a standard format for multisig wallet configurations (BIP-129).

Supported BSMS Versions

• BSMS 1.0

Importing BSMS

1. Navigate to Wallets → Add Wallet
2. Select Descriptor (BSMS is converted to a descriptor)
3. Paste your BSMS descriptor token
4. Vigil will parse and validate the configuration
5. Click Create Wallet

Electrum Import

For Electrum wallet exports:

1. In Electrum, go to Wallet → Information
2. Copy the Master Public Key (xpub/ypub/zpub)
3. In Vigil, create an Extended Public Key wallet
4. Paste the master public key

Multisig Electrum Wallets

For Electrum multisig:

1. Export each cosigner's xpub
2. Use Vigil's descriptor format:

wsh(sortedmulti(M,xpub1...,xpub2...,xpub3...))

Replace M with your threshold.

Specter Import

For Specter Desktop wallets:

1. In Specter, go to your wallet settings
2. Export the wallet descriptor
3. In Vigil, create a Descriptor wallet
4. Paste the descriptor

Common Import Issues

Invalid Checksum

If you see a checksum error:

• Verify you copied the complete xpub/descriptor
• Check for extra spaces or line breaks
• Ensure the network matches (mainnet vs testnet)

Unsupported Descriptor

Some advanced miniscript features may not be fully supported. Contact support if you need help with a specific descriptor.

Network Mismatch

Ensure your wallet matches the expected network:

• Mainnet: xpub, ypub, zpub, bc1...
• Testnet: tpub, upub, vpub, tb1...

---

Next: Managing Wallets →