WasabiWallet.md

Connecting Wasabi Wallet to BTCPay Server

This documents shows how to connect Wasabi Wallet to BTCPay Server.

1. Create a Store in BTCPay Server
2. Download Wasabi Wallet
3. Install Wasabi Wallet

Wasabi Wallet Setup

After installation, open the Wasabi Wallet by clicking on the icon on your desktop.

Quick Setup

1. Generate Wasabi Wallet
2. In Wasabi, Advanced Settings > Wallet info - copy the Extended Public Key.
3. In BTCPay Server, Store Settings > General > Derivation Scheme - Paste the Extended Public Key
4. In Receive tab in Wasabi, generate a new address.
5. Compare the addresses in Wasabi and BTCPay Server, they should match.
6. Confirm the address match in BTCPay.

Step by Step

Firstly, give your wallet a name, for example, BTCPay Server Wallet and enter the password. Make sure to remember or write down the password. Agree to Terms of Service, and click Generate in the right corner.

IMPORTANT NOTE: Write down your recovery words in the order you see them on the screen. Write them down a piece of paper and store it somewhere secure. Take your time and triple check each word. Do not store your seed in a digital format (photograph, text document). Whoever has the access to your seed can access your funds. Confirm that the seed has been properly backed up.

Before proceeding, it is recommended to test the password, to be sure that the wallet can be accessed without any problems.

To test the password, enter it in the password field, and click Test Password.

The green message on the left bottom side of the screen will appear if the password is correct. If by any chance your password is incorrect, delete the wallet and start from scratch.

Upon testing the password, click on the Load Wallet to access your newly created wallet.

When the wallet loads (it may take few moments), on the right hand sidebar, toggle the Advanced options and then click Wallet Info

Select and copy the Extended Account Public Key. This is the public key from which BTCPay will derive addresses.

Return to your BTCPay Server. Click on the Stores in the header menu and scroll until you see Derivation Scheme section. Click on the Modify link.

Paste the Extended Account Public Key into derivation scheme field as it is, without adding anything else. Make sure that Enabled checkbox is ticked and click Continue.

Return to the Wasabi Wallet. Go to Receive tab and generate a new address.

Compare the address you see in Wasabi Wallet to Addresses shown in BTCPay Server. If there's a match, continue. If there is no match, copy the address from Wasabi and paste it into Hint Address Form. If you still can't get the matching, double-check that you're actually pasting Extended Account Public Key.

Connecting Wasabi to BTCPay Server Full Node (If you're self-hosting BTCPay)

After wallets are connected, it is highly-recommended to connect Wasabi to your full node in BTCPay. The process is easy, but can only be done if you self-host BTCPay and are logged in as Admin. Tor has to be enabled in BTCPay (it is enabled by default). This process enhances privacy even further.

In BTCPay, go Server Settings > Services > Full node P2P > See Information. On the BTCP-P2P page, click on the Show Confidential QR Code. Bellow the QR Code, there's a link See QR Code information by clicking here, so click on the link to reveal your string. Copy the string but remove bitcoin-p2p:// part.

In Wasabi, Tools > Settings. Scroll to the bottom of the page and click Open Config File. The config file should look similar to this:

{

  "Network": "TestNet",
  "MainNetBackendUriV3": "http://wasabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion",
  "TestNetBackendUriV3": "http://testwnp3fugjln6vh5vpj7mvq3lkqqwjj3c2aafyu7laxz42kgwh2rad.onion",
  "MainNetFallbackBackendUri": "https://wasabiwallet.io",
  "TestNetFallbackBackendUri": "https://wasabiwallet.co",
  "RegTestBackendUriV3": "http://localhost:37127",
  "TorHost": "127.0.0.1",
  "TorSocks5Port": 9050,
  "MainNetBitcoinCoreHost": "127.0.0.1",
  "TestNetBitcoinCoreHost": "127.0.0.1",
  "RegTestBitcoinCoreHost": "127.0.0.1",
  "MainNetBitcoinCorePort": 8333,
  "TestNetBitcoinCorePort": 18333,
  "RegTestBitcoinCorePort": 18444,
  "MixUntilAnonymitySet": 50,
  "PrivacyLevelSome": 2,
  "PrivacyLevelFine": 21,
  "PrivacyLevelStrong": 50
}

Replace

"MainNetBackendUriV3": "127.0.0.1",

with

"MainNetBackendUriV3": "bitcoinp2pstringgoeshere"

Remember to remove bitcoin-p2p:// from the string.

The replaced string should look similar this "MainNetBackendUriV3": "http://xkasdsabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion:8333",

For better privacy, MainNetFallbackBackendUri can be replaced with the same string.

Save the file, quit Wasabi and open it again.

Configuring the Gap Limit in Wasabi

In the top menu, select click on the File > Open > Wallets Folder. Shortly the json file will be shown in a sub-folder. Open that file with a text editor like notepad. Locate "MinGapLimit": 21, change it to "MinGapLimit": 100, and save the file.

There's no good answer to how much you should set the gap limit to. Most merchants set 100-200. If you're a big merchant with high transaction volume, you can try with even higher gap limit.

For more details about the Gap Limit, check the FAQ.

Wasabi Wallet and BTCPay Server are now connected. Any payments received to your BTCPay will be visible in Wasabi, where you can further spend or mix them.