Setting Up Your Wallet

To receive Bitcoin payments, you need to add a Payment Destination — your wallet's public key data. Ludilol derives unique addresses for each order from this data, so payments go directly to your wallet.

Supported Wallet Types

Type	Example	Description
Xpub	xpub6D4B...	Extended public key (BIP-44/49/84)
Descriptor	wpkh(xpub.../0/*)	Output descriptor (more flexible)
Lightning Address	user@wallet.com	For Lightning payments

Adding a Wallet

1. Navigate to Payment Destinations (/seller/payment-destinations)
2. Click Add Wallet
3. Fill in:
   • Label — A name you'll recognize (e.g. "My Ledger", "Blue Wallet")
   • Type — Choose Xpub, Descriptor, or Lightning Address
   • Network — Mainnet or Testnet
   • Public Wallet Data — Paste your xpub, descriptor, or lightning address
4. Submit

Getting Your Xpub

From Popular Wallets

• Electrum: Wallet → Information → Master Public Key
• Blue Wallet: Settings → Wallet → Show XPUB
• Sparrow: Settings → Show xpub
• Ledger Live: Account → Advanced → Extended public key

From Hardware Wallets

Most hardware wallets can export the xpub through their companion app. Look for "Extended Public Key" or "Account Public Key" in the wallet settings.

WARNING

Never share your private key or seed phrase. The xpub is a public key that can only generate addresses — it cannot spend funds.

Validation

After adding a wallet, Ludilol validates the format:

• Valid — Ready to receive payments
• Invalid — Check the format and try again
• Pending — Validation in progress

Managing Wallets

• You can have multiple wallets and switch between them per store page
• Activate/Deactivate — Toggle a wallet's availability
• Each store page references one on-chain wallet and optionally one Lightning wallet

Address Derivation

For each new order, Ludilol:

1. Increments the derivation index on your wallet
2. Derives a unique address at path m/0/{index}
3. The buyer pays to that specific address
4. The Payment Detector monitors the address for incoming transactions

This means every order gets its own address, making it easy to track payments in your wallet.