TABLE OF CONTENTS


  1. To link your Bitcoin wallet you would need to know it's xPub (Master Public Key/Extended Account Public Key) and a Receiving address. If you don't already know these you can follow the instructions in this article to find them: How to find your wallets xPub key and Receiving Address
  2. Once you have xPub and Receiving address, head on to your Blockonomics Dashboard and open Wallets Page. Now, you will be asked to give this new wallet a Name and add it's xPub. You can enter any Name. It's for your internal reference only. In xPub field Copy-Paste/Enter the xPub found in previous step
    • Click on "+ Add a wallet" and then select "BTC wallet".
    • Now, you will be asked to give this new wallet a Name and add it's xPub. You can enter any Name. It's for your internal reference only. In xPub field Copy-Paste/Enter the xPub found in previous step.
    • Once you have entered the xPub, you will be asked for a "Sample Receiving Address". Enter the Receiving address found in previous step and click on "Create Wallet"
    • That's It! You have now link your Bitcoin Wallet with Blockonomics Account.
  3. If you get an "Invalid Extended Public Key" error after clicking on "Create Wallet", please make sure that:
    • You have copied the correct and full xPub and Address. Sometimes because of partial copy/paste you might end up adding wrong path.
    • Make sure that Both xPub and address belong to same wallet.
    • If multiple xPubs were exported, try adding another exported xPub.
    • Please make sure that you are entering values in corresponding fields and not in place of each other.
    • Please note that we currently don't support taproot wallets.


What is an xPub?


The xPub key is an extended public key of your wallet that starts with the prefix xpub, ypub or zpub. Blockonomics will use the xPub to generate a unique address for each order. These addresses will be of your own wallet, so received payments will end up instantly in your wallet. Lets dive into how an xpub is useful and how to get your wallet xpub key.


The xPub key is the master key that all of your addresses are made from. If you use the same address for each and every payment, the balance of that address is exposed to each new user who sends to that address. This results in a loss of privacy. When you use an xPub key, a new address is generated for each new invoice and web store payment so each and every payment is a new address. This not only preserves your own privacy; it also increases the privacy of the sender as well.


xPub Keys are also useful for the following:

  • Checking the balance of your entire wallet instead of one address at a time.
  • Preserving privacy by reducing address reuse on the blockchain.
  • Generating new invoices without having to open your wallet each time.
  • Keeping your private keys private and in your own wallet. Centralised services like Coinbase and BitPay don’t allow you to hold your own private keys.
  • You can keep your private keys safe in your wallet and receive payments on your website via services like Blockonomics etc.
  • If none of the above options work, please try reaching out to us at https://help.blockonomics.co/ along with screenshot of the error message you are getting.


What are the risks of revealing my xPub?


The xPub key is public, so sharing it with Blockonomics or any third party will never allow access to your wallet. That means your Bitcoin funds and keys are still under your control.

However, please be aware that providing it to any third party can introduce additional risks, as the recipient will be able to obtain your wallet public keys, addresses and transactions. As long as you keep your private keys safe, though, your funds will remain safe. 

Read more.


Does Blockonomics support SegWit wallets?


Yes, Blockonomics fully supports SegWit wallets with an xPub. Please refer to this blog post.