Quorum is an Ethereum-forked distributed ledger protocol with transaction/contract privacy and a new consensus mechanism.
- QuorumChain – a new consensus model based on majority voting
- Constellation – a peer-to-peer encrypted message exchange
- Peer Security – node/peer permissioning using smart contracts
The above diagram is a high-level overview of the privacy architecture used by Quorum. For more in-depth discussion of the components, refer to the wiki pages.
git clone https://github.com/jpmorganchase/quorum-examples cd quorum-examples vagrant up # (should take 5 or so minutes) vagrant ssh
Now that you have a fully-functioning Quorum environment set up, let’s run the 7-node cluster example. This will spin up several nodes with a mix of voters, block makers, and unprivileged nodes.
# (from within vagrant env, use `vagrant ssh` to enter) ubuntu@ubuntu-xenial:~$ cd quorum-examples/examples/7nodes $ ./init.sh # (output condensed for clarity) [*] Cleaning up temporary data directories [*] Configuring node 1 [*] Configuring node 2 as block maker and voter [*] Configuring node 3 [*] Configuring node 4 as voter [*] Configuring node 5 as voter [*] Configuring node 6 [*] Configuring node 7 $ ./start.sh [*] Starting Constellation nodes [*] Starting bootnode... waiting... done [*] Starting node 1 [*] Starting node 2 [*] Starting node 3 [*] Starting node 4 [*] Starting node 5 [*] Starting node 6 [*] Starting node 7 [*] Unlocking account and sending first transaction Contract transaction send: TransactionHash: 0xbfb7bfb97ba9bacbf768e67ac8ef05e4ac6960fc1eeb6ab38247db91448b8ec6 waiting to be mined... true
We now have a 7-node Quorum cluster with a private smart contract (SimpleStorage) sent from
node 1 “for”
node 7(denoted by the public key passed via
privateFor: ["ROAZBWtSacxXQrOe3FGAqJDyJjFePR5ce4TSIzmJ0Bc="] in the
Connect to any of the nodes and inspect them using the following commands:
Note in particular the
v field of “0x25” (37 in decimal) which marks this transaction as having a private payload (input).
Documentation detailing steps to demonstrate the privacy features of Quorum can be found in quorum-examples/7nodes/README.
- Quorum – https://github.com/jpmorganchase/quorum (this repository)
- Constellation – https://github.com/jpmorganchase/constellation
- quorum-examples – https://github.com/jpmorganchase/quorum-examples
- Quorum Wiki – https://github.com/jpmorganchase/quorum/wiki
Thank you for your interest in contributing to Quorum!
Quorum is built on open source and we fully intend to accept public contributions in the near future. Until then, feel free to file issues and open pull requests, but note that we won’t be merging them until the necessary processes are in place.
The go-ethereum library (i.e. all code outside of the
cmd directory) is licensed under the GNU Lesser General Public License v3.0, also included in our repository in the
The go-ethereum binaries (i.e. all code inside of the
cmd directory) is licensed under the GNU General Public License v3.0, also included in our repository in the