Hardware Wallet Integration

BTCPay Vault is a cross-platform desktop application that allows the use of a hardware wallet with a full node inside BTCPay Server.

Getting Started with BTCPay Vault

In laymen words, BTCPay Vault is a separate app, locally hosted on your own PC, which BTCPay Server connects to and asks for permission. Once permission is granted, BTCPay is able to integrate with any hardware wallet connected to your PC.

You can import your wallet and spend incoming funds with a simple confirmation on your device, with your keys never leaving your hardware device, with all funds being validated against your own Bitcoin full node and no data leakage.

Connecting a wallet to a store

Setting up BTCPay Vault is quite easy. You only need to have already set up BTCPay Server.

  1. Install the Vault on your PC (Windows, MacOS or Linux)

  2. Open the BTCPay Vault app

  3. Plug in the hardware wallet into your PC and make sure it’s in a wake up state

  4. Go to your BTCPay Server’s Store > General Settings > Derivation Scheme > Import from the Vault

  5. Grant the permission

  6. The public key will automatically be imported in the store and configured to an appropriate format

  7. Validate that address shown on BTCPay is the same as the one on your device

  8. Save

Spending funds with BTCPay Wallet

Once you’ve received funds to your wallet and you decide to spend them, you can sign the transaction with your hardware wallet, all inside BTCPay Server.

  1. Open BTCPay Vault app on your PC

  2. Plug in the hardware wallet and make sure it’s in wake up state

  3. In BTCPay Server, go to > Wallets > Manage > Send

  4. Fill in the Destination address and the Amount

  5. Select Sign with the Vault

  6. Verify the transaction on your hardware wallet and confirm it

  7. Broadcast the transaction

Supported Hardware Wallets

The list of supported hardware wallets is available on this link.