diff options
| author | Derrick <[email protected]> | 2021-07-01 19:37:36 -0600 |
|---|---|---|
| committer | Derrick <[email protected]> | 2021-07-01 19:37:36 -0600 |
| commit | 2b81a605a9902b6f619f6c175fbd5595d3f706da (patch) | |
| tree | 5b3cf88c91cbc89a482633eb616e2ba1673946df /doc/fund-server-bitcoin-cli.md | |
| parent | 3216b975ed04f08404f6897eb22d1177a81e37e4 (diff) | |
| download | coinos-server-2b81a605a9902b6f619f6c175fbd5595d3f706da.tar.gz coinos-server-2b81a605a9902b6f619f6c175fbd5595d3f706da.zip | |
New doc "Fund Coinos server (via bitcoin-cli)"
Diffstat (limited to 'doc/fund-server-bitcoin-cli.md')
| -rw-r--r-- | doc/fund-server-bitcoin-cli.md | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/doc/fund-server-bitcoin-cli.md b/doc/fund-server-bitcoin-cli.md new file mode 100644 index 00000000..3c5b6ef5 --- /dev/null +++ b/doc/fund-server-bitcoin-cli.md @@ -0,0 +1,66 @@ +## Fund Coinos server (via bitcoin-cli) + +Bitcoin Regtest Mode allows us to create our own Bitcoin sandbox blockchain for use in testing & development. + +In this demo/tutorial we will setup a regtest network along with wallet and some initial bitcoin. + +From the coinos-server dir on your localfilesystem (ie- after following the 'Getting Started' section of our [root README]) + +```bash + +docker exec -it bitcoin bash + +# get an address +bitcoin-cli -regtest -datadir=/config -rpcwallet=coinosdev getnewaddress + +# mine a block to the new address +bitcoin-cli -regtest -datadir=/config generatetoaddress 101 theaddressgneratedabove + +# verify you got the reward: +bitcoin-cli -regtest -datadir=/config -conf=./bitcoin.conf -rpcwallet=coinosdev getbalance +> 50.00000000 +``` + + + + +#### Start from scratch + +To purge any existing transactions you made and to recreate all wallets including the coinos wallet (coinosdev) do (assuming coinos-server is running): + +```bash +docker-compose down +sudo rm -rf config/bitcoin +sudo rm -rf config/lightning +sudo rm -rf config/liquid +cp -rf sampleconfig/bitcoin config +cp -rf sampleconfig/lightning config +cp -rf sampleconfig/liquid config +docker-compose up +# app may crash during re-initalization of blockchains so +# restart it again after a few moments if necessary: +docker-compose restart app +``` + + +#### Creating new (Bitcoin native) wallets + +Note the wallet 'coinosdev' is created apart of the initial docker build for our Coinos Bitcoin server. +To create a new wallet (ie- as an alternate or one for yourself) do: + +```bash +bitcoin-cli -regtest -datadir=/config -conf=./bitcoin.conf createwallet me +> # new wallet created in /config/regtest/wallets +``` +and then specify `-rpcwallet=me` (or wallet name of your choice) + + +#### further reading + +On why to generate 101 blocks and some general info on Regtest Mode: + +https://developer.bitcoin.org/examples/testing.html + + +[root README]:https://github.com/coinos/coinos-server + |