21: Build the Machine-Payable Web

21 is an open source Python library and command line interface for quickly building machine-payable web services. It allows you to accomplish three major tasks:

• Get bitcoin on any device
• Add bitcoin micropayments to any Django or Flask app
• Earn bitcoin on every HTTP request

The package includes:

• an HD wallet to securely manage your bitcoin
• crypto and bitcoin libraries to build bitcoin/blockchain applications
• a micropayment-channels client and server
• commands for mining, buying, and earning bitcoin, as well as requesting it from the 21 faucet
• tools for publishing machine-payable endpoints to the 21 Marketplace
• containers that allow your machine to sell machine resources for bitcoin

and much more.

Security

Please note that the 21 software is in beta. To protect the security of your systems while using 21, we highly recommend you install the software on a device other than your main laptop (e.g. 21 Bitcoin Computer, an old laptop, or an Amazon Virtual Machine) while the product is still in beta. You can read more security-related information here. Please send an email to [email protected] regarding any issue concerning security.

Installation

Create an account or install the library and CLI (python3.4+ is required):

$ curl https://21.co | sh

two1 can also be installed via pip:

$ sudo pip3 install two1

Start with the command line tool:

$ 21 help

Then read the Introduction to 21 guide and the two1 documentation.

Developers

If you'd like to contribute to two1, please use the following steps to clone the repository and get it set up on your system.

Clone this repository:

$ git clone https://github.com/21dotco/two1-python.git
$ cd two1-python/

Install the requirements:

$ pip3 install -r requirements.txt

Install 21 as an editable python library:

$ pip3 install -e .

Your changes to the source will now be reflected in your system installation in real-time. When you open a pull request against this repository, your code will automatically be built and tested.

Run the tests:

$ python3 -m pytest

Docker

You can pull Docker images with two1 pre-installed from the 21 Docker Hub repository.

$ docker pull 21dotco/two1

Then run the latest base image:

$ docker run -it 21dotco/two1 sh

Community

Join the 21 developer community to chat with other users or to get in touch with support.

Licensing

two1 is licensed under the FreeBSD License. See LICENSE for the full license text.