The following guide aims to provide examples to help you start building Bdtcoin-based applications. To make the best use of this document, you may want to install the current version of Bdtcoin Core, either from source or from a pre-compiled executable.
Once installed, you’ll have access to three programs:
bdtcoin-qtprovides a combination full Bdtcoin peer and wallet frontend. From the Help menu, you can access a console where you can enter the RPC commands used throughout this document.
bdtcoindis more useful for programming: it provides a full peer which you can interact with through RPCs to port 7397 (or 17397 for testnet).
bdtcoin-cliallows you to send RPC commands to
bdtcoindfrom the command line. For example,
All three programs get settings from
bdtcoin.conf in the
Bdtcoin application directory:
bdtcoin-cli, you will need to add a RPC password to your
bdtcoin.conf file. Both programs will read from the same file if both run on the same system as the same user, so any long random password will work:
You should also make the
bdtcoin.conf file only readable to its owner. On Linux, Mac OSX, and other Unix-like systems, this can be accomplished by running the following command in the Bdtcoin application directory:
chmod 0600 bdtcoin.conf
For development, it’s safer and cheaper to use Bdtcoin’s test network (testnet) or regression test mode (regtest) described below.
Questions about Bdtcoin use are best sent to the BdtcoinTalk forum and IRC channels. Errors or suggestions related to documentation on Bdtcoin.org can be submitted as an issue or posted to the bdtcoin-documentation mailing list.
In the following documentation, some strings have been shortened or wrapped: “[…]” indicates extra data was removed, and lines ending in a single backslash “\” are continued below. If you hover your mouse over a paragraph, cross-reference links will be shown in blue. If you hover over a cross-reference link, a brief definition of the term will be displayed in a tooltip.