About
-----

This is gbw-node, the online database component of Gales Bitcoin Wallet as described at:

	http://fixpoint.welshcomputing.com/2019/gales-bitcoin-wallet-spec-and-battle-plan/
	http://fixpoint.welshcomputing.com/2019/draft-gbw-node-schema/

It indexes and formats data as needed for the offline counterpart, gbw-signer.

Written by Jacob Welsh for JWRD Computing.

Prerequisites
-------------

- sqlite 3.7.0 or newer including the sqlite3 shell
- python 2.7.x including the sqlite3 module
- The Real Bitcoin node

Installation
------------

This software sheds some historical Unix conventions in favor of Bernstein's /package scheme ( http://cr.yp.to/slashpackage.html ), which I find meshes fairly well with the ideas of V. If this is your first time using it, you may need to create the /package directory and add /command to your shell's PATH variable.

1. Press or otherwise install the tree at the path:

	/package/gbw-node-1

The installation path is not configurable. This amounts to a claim on the global namespace, as command names always do. People and programs can count on finding components at known paths if they are to be found at all, as surely as with /bin/sh. This doesn't mean the files must physically exist under /package; for example, a symlink from there could ease working on the code as a non-root user.

2. From the above directory, run (as root):

	sh package/install

Operation
---------

First the database must be initialized:

	mkdir ~/.gbw
	sqlite3 ~/.gbw/db </package/gbw-node/library/schema-node.sql

The main program is "gbw-node", which provides a number of subcommands. Run "gbw-node help" for details.

RPC username and password are read from ~/.bitcoin/bitcoin.conf.

It's possible for bitcoind to get blocked on writing to a pipe if a scan process is interrupted during the dumpblock call. To recover, allow the write to complete:

	cat ~/.gbw/blockpipe >/dev/null