Using Bcoin node with BitcoinLib

With Python BitcoinLib you can manage wallets and create and receive transactions. BitcoinLib depends on external service providers such as or to communicate with the Blockchain. But too be more efficient and increase privacy you can also setup your local Bcoin node and use this in BitcoinLib.

Bcoin is a full bitcoin node implementation used to parse the blockchain and verify blocks and transactions. In my previous article you can read how to install a Bcoin node.

Setup BitcoinLib to use Bcoin node

First login to your server with the running Bcoin node and check if everything is running as it should.

$ sudo su - bcoin
$ cd bcoin/bin
$ ./bcoin-cli block 101010

This should return block 101010 as dictionary.

Checkout the Bcoin config file in .bcoin/bcoin.conf and look for the API key. The API key should be a long random list of characters. You could use a bitcoin private key for this.

>>> from bitcoinlib.keys import Key
>>> Key().private_hex

Now go to the Bitcoinlib directory and edit the .bitcoinlib/providers.json file to add an extra service provider. Add the following json to the provider.json file, make sure to use the correct API key and fill in your server address.

"bcoin": {
    "provider": "bcoin",
    "network": "bitcoin",
    "client_class": "BcoinClient",
    "provider_coin_id": "",
    "url": "https://x:13729c7f87c56628eb8070214f3bdc62f6904c70c71c465bfffee36e6aa09b39@<your_server_ip>:28332/",
    "api_key": "",
    "priority": 20,
    "denominator": 100000000,
    "network_overrides": null

The priority is set to 20, which is higher then the default priority of 10. This means the Bcoin provider is tried first and if this fails another provider will be used.

Let's test if the Bcoin provider is used by Bitcoinlib.

>>> from import Service
>>> srv = Service(providers=['bcoin'])
>>> srv.getblock(101010)
<Block(000000000001af33247fff33aae7c31baee4148d5a189e7353bf13bcee618202, 101010, transactions: 4)>

It's works! Bitcoinlib will now use your local Bcoin node whenever possible to retrieve and send information to the blockchain.

If you still encounter problems please check:

  • Is port 28332 open on your server and local machine? Does it need to be forwarded?
  • Is SSL correctly setup on the Bcoin server machine, see install Bcoin node.
  • Check the logs in .bitcoinlib/bitcoinlib.log and on the server in .bcoin/debug.log
  • Check the documentation on Github Bcoin Docs or BitcoinLib ReadTheDocs
Bcoin bitcoin node logo

Comments !