New doc "Fund Coinos server (via bitcoin-cli)"

2 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
+```
+
+![](./img/50-bitcoin-server-balance.gif)
+
+
+#### 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
+
diff --git a/doc/img/50-bitcoin-server-balance.gif b/doc/img/50-bitcoin-server-balance.gif
new file mode 100644
index 00000000..2fba5088
--- /dev/null
+++ b/doc/img/50-bitcoin-server-balance.gif