Name: quorum
Owner: ConsenSys
Description: A permissioned implementation of Ethereum supporting data privacy
Forked from: jpmorganchase/quorum
Created: 2017-07-18 01:49:00.0
Updated: 2018-01-03 03:59:00.0
Pushed: 2018-01-15 17:42:40.0
Homepage: https://www.jpmorgan.com/quorum
Size: 74697
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Quorum is an Ethereum-based distributed ledger protocol with transaction/contract privacy and new consensus mechanisms.
Quorum is a fork of go-ethereum and is updated in line with go-ethereum releases.
Key enhancements over go-ethereum:
Note: The QuorumChain consensus algorithm is not yet supported by this release.
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.
The quickest way to get started with Quorum is using VirtualBox and Vagrant:
clone https://github.com/jpmorganchase/quorum-examples
uorum-examples
ant up
hould take 5 or so minutes)
ant 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.
rom within vagrant env, use `vagrant ssh` to enter)
tu@ubuntu-xenial:~$ cd quorum-examples/7nodes
raft-init.sh
utput 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
raft-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
ract transaction send: TransactionHash: 0xbfb7bfb97ba9bacbf768e67ac8ef05e4ac6960fc1eeb6ab38247db91448b8ec6 waiting to be mined...
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 sendTransaction
call).
Connect to any of the nodes and inspect them using the following commands:
th attach ipc:qdata/dd1/geth.ipc
th attach ipc:qdata/dd2/geth.ipc
th attach ipc:qdata/dd7/geth.ipc
g.
th attach ipc:qdata/dd2/geth.ipc
ome to the Geth JavaScript console!
ance: Geth/v1.5.0-unstable/linux/go1.7.3
base: 0xca843569e3427144cead5e4d5999a3d0ccf92b8e
lock: 679 (Tue, 15 Nov 2016 00:01:05 UTC)
adir: /home/ubuntu/quorum-examples/7nodes/qdata/dd2
ules: admin:1.0 debug:1.0 eth:1.0 net:1.0 personal:1.0 quorum:1.0 rpc:1.0 txpool:1.0 web3:1.0
orum.nodeInfo
ockMakerAccount: "0xca843569e3427144cead5e4d5999a3d0ccf92b8e",
ockmakestrategy: {
maxblocktime: 10,
minblocktime: 3,
status: "active",
type: "deadline"
nCreateBlocks: true,
nVote: true,
teAccount: "0x0fbdc686b912d7722dc86510934589e0aaf3b55a"
t's look at the private txn created earlier:
h.getTransaction("0xbfb7bfb97ba9bacbf768e67ac8ef05e4ac6960fc1eeb6ab38247db91448b8ec6")
ockHash: "0xb6aec633ef1f79daddc071bec8a56b7099ab08ac9ff2dc2764ffb34d5a8d15f8",
ockNumber: 1,
om: "0xed9d02e382b34818e88b88a309c7fe71e65f419d",
s: 300000,
sPrice: 0,
sh: "0xbfb7bfb97ba9bacbf768e67ac8ef05e4ac6960fc1eeb6ab38247db91448b8ec6",
put: "0x9820c1a5869713757565daede6fcec57f3a6b45d659e59e72c98c531dcba9ed206fd0012c75ce72dc8b48cd079ac08536d3214b1a4043da8cea85be858b39c1d",
nce: 0,
"0x226615349dc143a26852d91d2dff1e57b4259b576f675b06173e9972850089e7",
"0x45d74765c5400c5c280dd6285a84032bdcb1de85a846e87b57e9e0cedad6c427",
: null,
ansactionIndex: 1,
"0x25",
lue: 0
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.
Further documentation can be found in the docs folder and on the wiki.
The following Quorum-related libraries/applications have been created by Third Parties and as such are not specifically endorsed by J.P. Morgan. A big thanks to the developers for improving the tooling around Quorum!
Thank you for your interest in contributing to Quorum!
Quorum is built on open source and we invite you to contribute enhancements. Upon review you will be required to complete a Contributor License Agreement (CLA) before we are able to merge. If you have any questions about the contribution process, please feel free to send an email to quorum_info@jpmorgan.com.
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 COPYING.LESSER
file.
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 COPYING
file.