Welcome to Baseline

Combining advances in cryptography, messaging, and blockchain to execute
secure and private business processes via the public Ethereum Mainnet.

Read the full documentation here at docs.baseline-protocol.org.

Join our Slack workspace for Baseline news and updates!

Baseline is an open source initiative with a large and growing team of supporting companies. The first code was donated by Ernst & Young and ConsenSys, with support from Microsoft, and is now receiving contributions from many other companies. The purpose of the project is to bring enterprises and complex business processes to the Ethereum Mainnet, while guarding the privacy constraints and needs of a typical group of enterprises.

The Baseline Protocol defines a series of steps to privately and securely synchronize data and business logic between multiple independent systems of record, using the Ethereum Mainnet as an auditable common frame of reference. This protocol implements best practices around data consistency and compartmentalization, and leverages public Ethereum for verifying execution of private transactions, contracts and tokens on the Mainnet using ZKP (zkSnarks). The Baseline Protocol is designed such that it can be extended and applied to any database/workflow.

Radish34 Demo

In order to demonstrate the Baseline Protocol, we needed a use-case. The use-case chosen was product procurement within a supply-chain, and the custom application built for this workflow is called Radish34. This application was built as a proof of concept for the Baseline Protocol.

The Baseline Protocol code is currently embedded inside the /radish-api directory, but we are in the process of moving that code into the /baseline directory to clearly distinguish the protocol from the use-case. Once this move is complete, radish-api will import baseline as a module, which will be the same process that other projects will need to follow to implement Baseline.

Quickstart

A Makefile has been included for convenience; most of its targets wrap npm, docker and solc invocations.

Just want to get the Baseline Protocol running locally? The following sequence will build the monorepo, start the Baseline Protocol stack locally, deploy contracts and run the full test suite. *Note: this typically takes at least 20 minutes to complete.

make && make start && make test

Note: to speed up testing you can use "dummy" ZKP circuits (createDummyMSA and createDummyPO) instead of the createMSA and createPO. This shortens the integration test time significantly because the proof generation for the "dummy" circuits is trivial. To use the dummy circuits, add a mode argument to the make start command as shown here:

make && make start mode=1 && make test

The demo UI

After running the above (make test optional) you can view the Radish34 demo by opening http://localhost:3000 in your browser.

Here are the targets currently exposed by the Makefile:

Target	Description
`make`	Alias for `make build`.
`make build`	Build all modules within the monorepo.
`make build-containers`	Dockerize all modules within the monorepo.
`make clean`	Reclaim disk used by all modules (i.e. `node_modules/`) and the local docker environment. This effectively uninstalls your local Baseline environment and will require building from scratch.
`make contracts`	Compile the Solidity contracts.
`make deploy-contracts`	Deploy the Solidity contracts. Requires the stack to be running.
`make npm-install`	`npm i` wrapper for all modules in the monorepo.
`make start`	Start the full Baseline stack. Requires `docker` service to be running with at least 12 GB RAM allocation.
`make stop`	Stop the running Baseline stack.
`make system-check`	Verify that `docker` is configured properly.
`make restart`	Stop and start the `docker` stack.
`make reset`	Clean the docker environment by pruning the docker networks and volumes.
`make test`	Run the full test suite. Requires the stack to be running.
`make zk-circuits`	Perform zk-SNARK trusted setups for circuits contained within `zkp/circuits`

Running Radish34

To get more insight into the individual steps taken to run the Radish34 application, follow the instructions in radish34/README.md.

cd radish34 and go from there 🚀

What is here?

The root directory of this repo (where this Readme currently lives) contains the following folders:

.
├── baseline  <-- Future home to the Baseline Protocol libraries
├── bin <-- Scripts to run across the entire project
├── docs <-- auto-generated and artisanal hand crafted documentation 
└── radish34 <-- The demonstration POC (you probably are looking for this)

Running scripts across the project

To use the top level scripts (currently just documentation auto-generation and collection) do the following:

Required: NodeJS 11.15 (nvm is recommended)

run make npm-install to install the top level packages

optionally make clean to clean out any node_modules folders installed by the make npm-install command.

How to contribute?

See our contributing guidelines

License

All code in this repo is released under the CC0 1.0 Universal public domain dedication. For the full license text, refer to license.md.

KevinSmall/baseline