Quick Start

$ pip install cancelchain

# Flask Settings
FLASK_APP=cancelchain
FLASK_SECRET_KEY=0b6ceaa3b10d3e7a5dc53194

# Flask-SQLAlchemy Settings
FLASK_SQLALCHEMY_DATABASE_URI=sqlite:///cc.sqlite

$ cancelchain init

$ cancelchain import path/to/cancelchain.jsonl

Run

Run the cancelchain application by issuing the run command:

$ cancelchain run

Open http://localhost:5000 in a browser to explore the local copy of the blockchain.

Home Page (Current Chain)

Block Page

Transaction Page

Running the cancelchain application also exposes a set of web service endpoints that comprise the communications layer of the blockchain. See the API Documentation for more information.

There are other cancelchain commands for interacting with the blockchain. See the Command Line Interface Documentation for more information or run cancelchain --help.

Joining The CancelChain Network

The CancelChain is run by a permissioned network of nodes. A CancelChain instance requires miller or transactor role API access to a node in the network in order to have locally milled blocks or submitted transactions propagate to the official CancelChain.

The Cancel Button allows reader role API access to any account that completes at least one transaction on the blockchain:

1. Register for an account.

2. Submit a successful transaction for any subject. Access won’t be granted until the sentiment transaction successfully completes.

3. Click Download Account Key on the account page to download the account’s key (PEM) file.

4. Create a directory called wallets and copy the downloaded key file into it.

5. Add the following settings to the .env configuration file. Replace CCTheCancelButtonAddressCC with the address on the account page and /path/to/wallet with the path to the wallets directory created above:

# CancelChain Settings
CC_NODE_HOST=http://CCTheCancelButtonAddressCC@localhost:5000
CC_PEERS=["https://CCTheCancelButtonAddressCC@thecancelbutton.com"]
CC_DEFAULT_COMMAND_HOST=https://CCTheCancelButtonAddressCC@thecancelbutton.com
CC_WALLET_DIR=/path/to/wallets

6. Restart to load the new configuration.

See Configuration Documentation for more detailed information about these settings.

The reader role API access allows the sync command to update to the most recent peer block data:

$ cancelchain sync

This command could take a while to run depending on your computer, internet access, and the number of blocks synchronized. A progress bar will display with estimated time remaining. You can run the sync command multiple times and it will only synchronize new blocks that are not yet in the database.

Reader access also allows querying data (i.e. subject counts and balances) using the CLI. See Command Line Interface Documentation for more information.

If you would like to be granted other API access to a node in the CancelChain network, send an email to contact@cancelchain.org including what kind of role you’d like (e.g. reader, transactor, or miller) and how you intend to use it (e.g. research, business, non-profit, hobby).

See the documentation for some potential development ideas.