How to run and publish Bitroute
Step 1
Get the latest version of the 21 software. You should be at version 2.3.1.
$ 21 update
$ 21 --version
21 v2.3.1
Step 2
Clone the Bitroute repository and make sure you have got traceroute installed.
$ git clone https://github.com/21dotco/bitroute.git
$ cd bitroute
$ sudo pip3 install -r requirements.txt
$ sudo apt-get install traceroute
Step 3
Join the 21market Marketplace, and start a local
server to accept Bitroute requests. The server will run in the
background and process requests. You can optionally edit the file
to change the default price, which is 1000 Satoshis per request.
$ 21 join 21market
$ python3 bitroute-server.py &
Step 4
Now use 21 publish to submit the manifest file describing the
Bitroute service you just started. You can pass in arguments to override the
default values in the file. The name and email should be your own. The price
field should match the price in the @payment.required decorator in bitroute-server.py.
The host of 'AUTO' is a special input that tells the publish command to use
the IP of your bitcoin computer within the 21market Marketplace (see
[here](https://21.co/learn/21-marketplace/#the-21-network for details)). The
port of 6003 is the default port specified within the
bitroute-server.py code that you are running.
$ 21 publish submit manifest.yaml -p 'name="Joe Smith" email="joe@example.com" price="1000" host="AUTO" port="6003"'
Step 5
After a brief wait of a second or so, you should be able to use 21 publish list
to see the endpoint you just put up:
$ 21 publish list
You can also search the 21 Marketplace for your app:
$ 21 search "Bitroute"
Step 6
You can now use bitcoin to buy that endpoint from yourself to test it out:
$ 21 buy $HOST:$PORT/?uri=google.com
where $HOST is your Bitcoin Computer's IP address on the 21 Marketplace and
$PORT is the port the web service is running on.
Step 7
And you can see a receipt for this transaction:
$ 21 log