Baseline Protocol


Baseline Reference Implementation-2


bri-2 is the second "baseline reference implementation". The purpose of this project is to show a baseline stack using different services compared to bri-1, but this stack must still comply with the baseline standards and specificiations, therefore allowing interoperability with other baseline stacks. bri-2 introduces the commit-mgr service to baseline. The commit-mgr acts as an extension to a web3 provider, which allows a variety of Ethereum clients to become "baseline compatible".
Note: bri-2 is still a work in progress. Components such as a vault/key manager and P2P messenger need to be added to make it a complete reference implementation.


The purple/orange blocks in the following diagram have been built. The green blocks are proposed services to be added and interact with the exisiting services.
BRI-2 Architecture

BRI-1 and BRI-2 comparison

Here is a comparison of the reference implementations:
Service Type
Eth. client
commit-mgr + ITX
Key managment
Provide Vault
Codefi Orchestrate
P2P Messenger

BRI-2 Quickstart


  • docker
  • docker-compose
  • node v12.16
  • npm
  • ConsenSys Quorum account (for vault + key-manager services)
Note: Create a free ConsenSys Quorum trial account here. Access the API documention for the key-manager service here.
make build
make start

Workflow creation

After the docker containers have successfully initialized, make the following request to workflow-mgr in order to create a new workflow.
POST http://localhost:5001/workflows?type=signature
"description": "signature test",
"clientType": "test client",
"chainId": "101010",
"identities": [
This request should initiate the following sequence of events. The sequencing of steps is accomplished by using NATS as a job queuing service. If successful, steps 1-8 will be completed and the workflow object will have a ZkCircuitId, Shield contract address, Verifier address, and a status of success-track-shield.

Run dashboard front-end

In order to run interact with the bri-2 stack through a browser, please run the following commands.
Note: be sure to use node v12.16
cd dashboard
npm install
npm run build
npm run dev
Navigate to http://localhost:3000 on your web browser to view the dashboard.


  • If you have an existing bri-2 build, run the following sequence to remove old build artifacts:
make clean
make build
make start
  • You may need to run make build twice in order to properly compile smart contracts
    Note: Environment variables default to use ganache as the Ethereum network

Current Capabilities

  • Create new commitments (hashes of JSON objects) for the Workflows
  • Push the commitments (hashes) into the on-chain merkle tree inside the Shield contract
  • P2P messenger service for communicating commitment details to counterparties
  • Integrated L2 to reduce mainnet gas fees
  • Automated integration level test suite
  • Codefi Orchestrate Key-Manager service integrated for Eth/EDDSA key storage and signing capabilities

Future Capabilities

  • Create new workflows
  • Automatically generate, compile, and run setup for zero-knowledge signature-checking circuit
  • Automatically compile newly created Verifier Solidity smart contract
  • Automatically deploy Shield and signature-checking Verifier smart contracts to ganach