Creating Wallets¶

This guide covers all the ways to add wallets to Vigil for monitoring.

Extended Public Key Wallet¶

What You Need¶

An extended public key from your wallet:

xpub... - Legacy (P2PKH)
ypub... - Nested SegWit (P2SH-P2WPKH)
zpub... - Native SegWit (P2WPKH)
tpub... / upub... / vpub... - Testnet equivalents

Creating the Wallet¶

Navigate to Wallets → Add Wallet
Select Extended Public Key
Fill in the form:

Field	Description
Name	A friendly name for this wallet
Extended Public Key	Your xpub/ypub/zpub
Address Type	Auto-detected from prefix
Gap Limit	Number of unused addresses to scan (default: 20)

Click Create Wallet

Gap Limit¶

The gap limit determines how many consecutive unused addresses Vigil will scan. If you have addresses beyond the gap limit, increase this value.

Setting	Use Case
20 (default)	Standard usage
50-100	Address reuse, merchant receiving
100+	High-volume receiving

Performance Impact

Higher gap limits increase initial scan time. Only increase if needed.

Descriptor Wallet¶

What You Need¶

An output descriptor string. Common formats:

# Single-sig Native SegWit (most common)
wpkh([fingerprint/84'/0'/0']xpub.../0/*)

# Single-sig Taproot
tr([fingerprint/86'/0'/0']xpub.../0/*)

# 2-of-3 Multisig
wsh(sortedmulti(2,[fp1/48'/0'/0'/2']xpub1.../*,[fp2/48'/0'/0'/2']xpub2.../*,[fp3/48'/0'/0'/2']xpub3.../*))

Creating the Wallet¶

Navigate to Wallets → Add Wallet
Select Descriptor
Fill in the form:

Field	Description
Name	A friendly name for this wallet
Descriptor	Your output descriptor
Gap Limit	Number of unused addresses to scan

Click Create Wallet

Vigil will parse the descriptor and automatically:

Detect the network (mainnet/testnet)
Derive addresses
Begin monitoring

Learn more about descriptors →

Static Address Wallet¶

What You Need¶

A list of individual Bitcoin addresses (up to 20).

Creating the Wallet¶

Navigate to Wallets → Add Wallet
Select Static Addresses
Fill in the form:

Field	Description
Name	A friendly name for this wallet
Addresses	One address per line

Click Create Wallet

Supported Address Formats¶

1... - Legacy P2PKH
3... - P2SH (wrapped SegWit or multisig)
bc1q... - Native SegWit P2WPKH
bc1p... - Taproot P2TR
tb1... / 2... - Testnet addresses

Limitations

Static address wallets are limited to 20 addresses. For larger address sets, export an xpub from your wallet software.

After Creation¶

Initial Scan¶

When you create a wallet, Vigil performs an initial scan:

Address Derivation - Derive addresses up to your gap limit
UTXO Discovery - Query for existing UTXOs
Indexing - Add addresses to our monitoring index

This may take 1-5 minutes depending on wallet size.

Wallet Status¶

Status	Description
Scanning	Initial scan in progress
Active	Monitoring active
Error	Issue with wallet configuration

Verify Your Setup¶

After creation, check:

✅ Status shows "Active"
✅ Expected addresses are listed
✅ Existing UTXOs are detected (if any)

Next: Importing Wallets →