...
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
This guide is based on VPS installation only! |
...
This guide demonstrates Bitcoin Core installation for version: 27.0
Other/newer versions may (and probably will) work, but this guide only supports this version.
...
If successfully verified, you’ll see: "
bitcoin-27.0-x86_64-linux-gnu.tar.gz: OK
" .There are additional (optional) steps that can be taken to authenticate your download, and you are definitely encouraged to avail yourself of them. See: https://bitcoincore.org/en/download/
Decompress the Bitcoin Core tarball:
...
The RPC token is designed to eliminate the need for hard-coded passwords in configuration and script files. You will receive a password here ONCE (unless you repeat the process and generate a new token).
Tip |
---|
This password is required for CAS - it's your “RPC Password” noted in Step 6. |
...
Tip |
---|
The user name is required for CAS - it's your “RPC User” as noted in Step 6. |
Example:
...
Save all the information securely. You'll need every detail in the steps to follow.
The RPC User = AnyNameYouWantHere
The RPC Password = Kq66rZya7MNpCU_e0zZSgjR2Mb7rBeyX9QSeGhwPMeY=
The cookie/token ("rpcauth") will only be required in the Bitcoin Core configuration file (next step). The token authenticates the specific username+password combination created.
Tip |
---|
The RPC Password is required for CAS - as noted in Step 6. |
The cookie/token is a secure hash of your password. The point is to hide your password on the node server to other users of the node. If your node is secure, then using the cookie is simply added security in the event of a server breach, however if your server is breached - you have a bigger problem than an exposed password - and that hash will afford very little protection.
The password is sent to the RPC server software by CAS, and must be kept encrypted while traveling over the Internet. This is accomplished using “tunnels” . More (more on that below).
...
3. Create the Bitcoin Core configuration file.
...
Code Block |
---|
server=1
daemon=1
rpcport=8332
rpcauth=AnyNameYouWantHere:cbb36c03b15219cafb1e72ae9329d5fd$72de450660cdb6dd2689cd2cba4091646a5e8005490dec07dc577b6dad608a80
# enable RBF
walletrbf=1 |
Replace the “rpcauth” line with the cookie/token you generated in the previous step 2.
Exit the nano editor with Control+X and “Y” to save your changes.
The CAS parameter “port” is the same as the “rpcport” specified in this step (8332).
...
"When Bitcoin Core daemon first starts, it will begin to download the blockchain. This step will take at least several days, and it may take much more time on a slow Internet connection or with a slow computer."
Code Block |
---|
bitcoind |
It may will take several a few minutes for Bitcoin Core to completely start.
In actual practiceWith the first startup, expect to wait 1- 5+ days for bitcoind to fully synchronize.
CAS will NOT be able to interact with bitcoind until the synchronization is COMPLETE!
When restarting the node, the sync will happen quickly (an hour or less).
To check the status, get the current block being processed by your node:
Code Block bitcoin-cli getblockcount
Compare the returned number to the latest network block:
The debug log is typically located at
$HOME/.bitcoin/debug.log
You can also check the status periodically using
tail .bitcoin/debug.log
...
Code Block |
---|
bitcoin-cli stop |
It may take a few minutes to completely shut down.
It will resume downloading synchronizing from the point where it stopped the next time you start it. It may take a few minutes to completely shut down.
Tip |
---|
The Bitcoin Core node (bitcoind) is now running.
|
...
Your CAS server and this node must have a secure line. Your passphrase password and other sensitive information will be passed back & forth. Encrypt (and thus protect) this communication by using a secure SSH tunnel.
...
Creates a subfolder
cas_default
containing awallet.dat
file (the actual wallet),sets the
avoid_reuse
flag to comply with Bitcoin convention, andloads the wallet by default
cas_default
wallet automatically when starting the node.
Create a new wallet address for funding:
Code Block |
---|
bitcoin-cli getnewaddress bech32m |
...
The latest “bech32m” (Taproot) option is demonstrated, but you may also specify
legacy
,p2sh-segwit
, orbech32
any type works with CAS.Send Bitcoin to whatever address is generated to fund your node.
The
address
bc1q4wv99c3yqpwttt7a59qqqqmyxda0z8l2ups7fx
) funds the walletbc1q4wv99c3yqpwttt7a59qqqqmyxda0z8l2ups7fx
is only an example (do not send BTC to it).
Wallet labels
Bitcoin “Best Practices” discourages the usage of wallet labels
Despite this, a wallet label can be set using
bitcoin-cli getnewaddress "funding" bech32m
...
Tip |
---|
Configure your CAS Crypto Settings |
...
Notes
...
1. Remote Procedure
...
Calls (RPC) (all)
...
:
More information about the RPC API: https://developer.bitcoin.org/reference/rpc/index.html
Note |
---|
Note: bitcoin-qt (a GUI wallet) is NOT supported at this time. |
...
2. Pruning nodes:
A "pruning node" (or lightweight node) is a special configuration that may be applied to bitcoind. It is unsupported by General Bytes. It is a substantial security risk when operating a BATM. Per the Bitcoin wiki:
...
Warning |
---|
The instructions given in this guide do not enable “pruning nodes”.
|
...
Housekeeping
This data is outside the scope of GB Support, but is presented here because it is frequently asked.
RBF and CPFP
Deploying a Bitcoin Core node grants you the ability to modify your unconfirmed transaction fees. Without a node, you must rely on third-party services to “unstuck” a low-fee transaction.
CPFP (Child Pays For Parent) is no longer necessary for modern transactions using this Core version. It has been fully replaced by RBF (Replace By Fee) and is less reliable than RBF. Using the instructions from this article, your node is already configured to use RBF.
To verify that your node is creating RBF-compatible transactions by default, use:
Code Block |
---|
bitcoin-cli getmempoolinfo |
The results should include this:
"fullrbf": true
RBF Instructions:
Use the
bitcoin-cli
command “bumpfee” for simplicity.
Backups
Backup is a matter of copying simple matter of executing this RPC call:
Code Block |
---|
bitcoin-cli backupwallet "backup_name.dat" |
You can also just copy/archive the wallet file normally located in $HOME/.bitcoin/wallet.dat
.
...
A file backup would be the most comprehensive recovery option in the event of catastrophe. Since the file is so sensitive though, having multiple copies also increases your hack risks. Secure your backups!
Private Keys
It is not recommended dangerous to print or expose your private key, especially in a terminal or any other insecure environment. However, if you absolutely need to your private key(s). Be extremely cautious with these operations. Anyone with access to your private key(s) can control your Bitcoin funds associated with that address. We generally recommended you use hardware wallets or other secure methods for managing your private keys.
If you absolutely must retrieve your private key for a specific address - you must first determine the type of wallet you’re using:
Code Block |
---|
bitcoin-cli |
...
getwalletinfo |
Examine the descriptors attribute in the result.
true = use the
listdescriptors
method.false = use the
dumpprivkey
method.
The dumpprivkey
command is deprecated and unusable for non-legacy wallets. Example:
Code Block |
---|
bitcoin-cli dumpprivkey "your_bitcoin_address" |
Replace
"your_bitcoin_address"
with the actual address for which you want to retrieve the private key. This command will output the private key associated with that address.Be extremely cautious with this operation. Anyone with access to your private key can control your Bitcoin funds associated with that address. We generally recommended you use hardware wallets or other secure methods for managing your private keys.Only works for legacy-type (non-descriptor) wallets.
The listdescriptors
command works for non-legacy wallets (bech32, bech32m, and descriptors). It is a bit more complex to use than dumpprivkey
, and prints out the all the keys in JSON format.
Code Block |
---|
bitcoin-cli listdescriptors true |
Returns all descriptors and their private keys, including their derivation paths.
...
Related articles
Filter by label (Content by label) | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
hidden | true |
---|
...