Simple cookie jar example of a Sawtooth application.
This is a minimal example of a Sawtooth 1.1 application, with a transaction processor and corresponding client. This example demonstrates a simple use case, where a baker bakes or eats cookies saved in a virtual cookie jar.
A baker can:
All cookie jar transactions have the same 6 hex digit prefix, which is the first 6 hex characters of the SHA-512 hash of "cookiejar" (that is, "a4d219").
The cookie jar is identified by
mycookiejar with a corresponding public/private keypair.
The cookie jar count is stored at an 70 hex digit address derived from:
I have a video presentation on YouTube that uses this application as an example. It is "Hyperledger Sawtooth Application Developer Overview using 'CookieJar'". It is at https://www.youtube.com/watch?v=VFXary3rwY0
The cookie jar transaction family contains two parts, both written in Python 3:
The client application has two parts:
pyclient/cookiejar_client.pycontains the client class which interfaces to the Sawtooth validator via the REST API
pyclient/cookiejar.pyis the Cookie Jar CLI app The client container is built with files setup.py and Dockerfile.
The Transaction Processor,
This example uses docker-compose and Docker containers. If you do not have these installed please follow the instructions here: https://docs.docker.com/install/
The preferred OS environment is Ubuntu Linux 16.04.3 LTS x64. Although other Linux distributions which support Docker should work.
To build TP code for Python and run the cookiejar.py example:
sudo docker-compose up --build
docker-compose.yaml file creates a genesis block, which contain initial Sawtooth settings, generates Sawtooth and client keys, and starts the Validator, Settings TP, Cookie Jar TP, and REST API.
In a separate shell from above, launch the client shell container:
sudo docker exec -it cookiejar-client bash
You can locate the correct Docker client container name, if desired, with
sudo docker ps .
In the client shell you just started above, run the cookiejar.py application. Here are some sample commands:
cookiejar.py bake 100 # Add 100 cookies to the cookie jar cookiejar.py eat 50 # Remove 50 cookies from the cookie jar cookiejar.py count # Display the number of cookies in the cookie jar
To stop the validator and destroy the containers, type
^c in the docker-compose window, wait for it to stop, then type
sudo docker-compose down
For C++ TP instructions, see cxxprocessor/.
To run sawtooth-simplewallet without dockers, we'll have to use a Ubuntu 16.04 OS installation and compile simplewallet from sources. Below is a sample procedure for Python TP/client:
RUNline in file
RUNline in file
git clone https://github.com/danintel/sawtooth-cookiejar
git branch nodocker; git checkout nodocker
sudo -u sawtooth sawtooth-validator -vv
sudo -u sawtooth sawtooth-rest-api -vvv
sudo -u sawtooth settings-tp -vv
./pyclient/cookiejar.pyand follow the "sample commands" above
A simple events handler is included. To run, start the validator then
type the following on the command line:
emptywhich empties the cookie jar (sets the count to 0) in the client and processor
cborbranch of this repository
protobufbranch of this repository
masteris the main branch. It uses comma-separated variable (CSV) serialization
cboruses Concise Binary Object Representation (CBOR) serialization
protobufuses Protocol Buffer (Protobuf) serialization
protobuf branches modify files
protobuf branch also adds files
build.sh in directory
proto to create
This software is Apache 2.0 licensed and accepts contributions via
GitHub pull requests.
Each commit must include a
Signed-off-by: in the commit message (
git commit -s). This sign-off means you agree the commit satisfies the Developer Certificate of Origin (DCO).
This example software is derived from the Sawtooth Simplewallet application. Simplewallet supports more programming languages and handles transactions with multiple keys.
This example and Hyperledger Sawtooth software are licensed under the Apache License Version 2.0 software license.
Antique sawtooth cookie cutters.
© Copyright 2018, Intel Corporation.