Quorumについて

まず、この動画がオススメ
_[blockchain.tokyo #22 Quorum & Microsoft Azure Blockchain!!](https://www.youtube.com/watch?v=j6W6MCXgoUM&t=1769s&ab_channel=%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%8D%E3%83%83%E3%83%88%E3%83%97%E3%83%A9%E3%82%B9%E7%A0%94%E7%A9%B6%E6%89%80)_

# Quorumとは
Ethereumのコンソーシアム版。_（※Hyperledger版については触れません）_
もともと、JPモルガンがEthereumをforkして開発していた。それをConsensysというオープンソースラブな会社が買い取った。ことで、単なる一企業のBlockchainという枠に囚われない、むしろ、エンタープライズ領域で幅広く使われるんじゃないかと思えるような将来性溢れるChainになった。

# 特徴
- プライベートトランザクションがある
    - 特定のグループ間でのみ閲覧可能なトランザクション
    - パブリックに公開したくない情報を秘匿できる
- ネットワーク接続の認証機能をサポート
    - 信頼のおけないNodeを除外したクローズドなネットワークを構築できる
    - セキュアなコンソーシアムチェーンを構築するための機能
- EthereumのSmart Contractと互換性が高い
    - Ethereum向けに開発したContractをそのまま使える
    - コンパイラはEthereumのものを使う
- スケーラブル
    - コンソーシアムチェーンなので当然TPSは高い。
    - 要因は、重厚なコンセンサスを必要としない（信頼のおけるメンバーだけなので）ことと、参加人数が少ないことと
- トランザクション手数料がない
    - トランザクション手数料は０に設定される


# システム構成
[Quorum_Architecture_20171016.pdf](https://github.com/ConsenSys/quorum-docs/blob/master/Quorum_Architecture_20171016.pdf)
![Screen Shot 2020-10-18 at 17.49.00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/48954/fd8961d0-83b4-0876-a23d-c53230d88ca5.png)

Blockchain部分はコンセンサスを実行する「Quorum Node」とprivateトランザクションを作る「Tessera」の２つに別れている。

まず、Quorum Nodeはgo-ethereumのforkでNode同士のP2P通信や、後述する２つのコンセンサスを実行する。publicトランザクション用とprivateトランザクション用の２つのストレージを持つ（実際は共有していてtrieが違うだけっぽい）ストレージはLevelDB。

つぎに、Tesseraはprivateトランザクションの署名や暗号鍵の管理、暗号化された秘匿情報の格納と共有を行う。

# トランザクションフロー
[Private transaction lifecycle](https://docs.goquorum.consensys.net/en/latest/Concepts/Privacy/PrivateTransactionLifecycle/)
![Screen Shot 2020-10-18 at 18.21.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/48954/923c6ba5-2f66-c695-f5cd-863b5f10f1f7.png)

簡単に説明すると、Nodeに送られたprivateトランザクションは、Tesseraによって暗号化＆ハッシュ化されて、ネットワーク全体で共有される。暗号化された実データはTesseraによって、共有対象の相手のみへ送られる。

# コンセンサス
次の２つから選べる

### Raftコンセンサス
単一のリーダーNodeがブロックを生成する。リーダーNodeがダウンした場合は、別のNodeがリーダーNodeに選出される。ダウンしたかどうかは、時間で管理されており、一定時間経過しても応答のない場合は新たなリーダーが選出される。

特徴は高速であること。まず、リーダーが単独でブロックを生成するので他Nodeと強調するオーバーヘッドが存在しない。つぎに、トランザクションが来たらほぼすぐ（設定できる）にブロック生成されるので、待ち時間が存在しない。

### IBFT(Istanbul Byzantine Fault Tolerant)コンセンサス
PBFTのようなもの。ランダムにProposerがブロックを生成し、Validatorが検証して一定以上の投票を得た場合はファイナライズされる。

特徴はRaftよりも分散でること。一定時間ごとにブロックが生成されるので、空ブロックが存在する。

# ネットワーク認証
### ベーシックな認証
ホワイトリストに登録されたNodeのみ接続を許可する。
起動時に`--permissioned`オプションを指定すると有効となり、設定ファイル（`<data-dir>/permissioned-nodes.json`）に記述されたNodeとのみ通信可能となる。
_参考: [Basic Network Permissioning](https://docs.goquorum.consensys.net/en/latest/Concepts/Permissioning/BasicNetworkPermissions/)_
※このように公式ドキュメントには書いてあるが、実装は違うっぽい💦
実際にオプションを付けて動かしてみると、エラーが出る。解決するには、以下の高度な認証が必要。つまり、ベーシックな認証単体では動作しない。


### 高度な認証
[Enhanced Permissions Model](https://docs.goquorum.consensys.net/en/latest/Concepts/Permissioning/Enhanced/EnhancedPermissionsOverview/)
![Screen Shot 2020-10-22 at 9.51.11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/48954/41fd1e0f-15ea-35a1-1e88-906a99feee1d.png)
AWSのようなグループとロールベースの認証。
スマートコントラクトを使っている。Proxyパターンを採用しており認証ルールのアップデートが可能。コードを読むと、ベーシックな認証の設定ファイル（permissioned-nodes.json）に基づいてアクセス制御をしているっぽい。スマートコントラクトのイベントを監視して、必要に応じて設定ファイルを更新している。

# おまけ（実装にDeep Dive）
### Raftコンセンサス起動
1. Gethを起動しフルノードを作る
    0. [geth(ctx *cli.Context)](https://github.com/ConsenSys/quorum/blob/v2.7.0/cmd/geth/main.go#L328)
2. Gethの起動オプションに`--raft`が入っていればRaftコンセンサスのサービスを登録する
    3. [makeFullNode(ctx *cli.Context)](https://github.com/ConsenSys/quorum/blob/v2.7.0/cmd/geth/config.go#L151)
3. Raftサービス登録時にRaftコンセンサスのインスタンスを`New`する
    4. [RegisterRaftService(stack *node.Node, ctx *cli.Context, nodeCfg *node.Config, ethChan chan *eth.Ethereum)](https://github.com/ConsenSys/quorum/blob/v2.7.0/cmd/utils/flags.go#L1841) 
4. Newしたときにminterを作る
    5. [New(ctx *node.ServiceContext, chainConfig *params.ChainConfig, raftId, raftPort uint16, joinExisting bool, blockTime time.Duration, e *eth.Ethereum, startPeers []*enode.Node, datadir string, useDns bool)](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/backend.go#L41)
5. blockを新規作成する処理を非同期実行する
    6. [newMinter(config *params.ChainConfig, eth *RaftService, blockTime time.Duration)](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L79)
6. 新しいトランザクションが来るか(txPreChan)、新しいブロックが掘られたら（chainHeadChan）、一定時間（blockTime）だけ待って、ブロックを作る
    7. [mintingLoop()](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L230)

### Private Transactionの送信
1. RPCでトランザクションをNodeへ送信
2. NodeのSendTransactionメソッドが呼ばれる
    3. [SendTransaction(ctx context.Context, args SendTxArgs)](https://github.com/ConsenSys/quorum/blob/v2.7.0/internal/ethapi/api.go#L1641)
3. TesseraのAPIを呼び出し、payloadを暗号化したもののハッシュ値を取得する
    4. [setPrivateTransactionHash(sendTxn bool)](https://github.com/ConsenSys/quorum/blob/v2.7.0/internal/ethapi/api.go#L1580)
5. Private Transactionであるというフラグをセット（署名のv値を37か38に設定。なおPublic Transactionの場合は27か28）
    6. [SetPrivate()](https://github.com/ConsenSys/quorum/blob/v2.7.0/core/types/transaction.go#L522)
7. Transactionプールに追加
    8. [SubmitTransaction(ctx context.Context, b Backend, tx *types.Transaction)](https://github.com/ConsenSys/quorum/blob/v2.7.0/internal/ethapi/api.go#L1614)

### Private Transactionの実行
1. Raftコンセンサスのmintループで、新しいブロックが追加するメソッドが呼ばれる
    2. [mintingLoop()](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L230)
    3. [mintNewBlock()](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L308)
3. transactionを取得し、コミットするメソッドが呼ばれる
    
    5. [commitTransactions(txes *types.TransactionsByPriceAndNonce, bc *core.BlockChain)](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L363)
    6. [commitTransaction(tx *types.Transaction, bc *core.BlockChain, gp *core.GasPool)](https://github.com/ConsenSys/quorum/blob/v2.7.0/raft/minter.go#L404)
6. transactionを実行するメソッドが呼ばれる
    7. [ApplyTransaction(config *params.ChainConfig, bc *BlockChain, author *common.Address, gp *GasPool, statedb, privateState *state.StateDB, header *types.Header, tx *types.Transaction, usedGas *uint64, cfg vm.Config)](https://github.com/ConsenSys/quorum/blob/v2.7.0/core/state_processor.go#L97)
8. transactionを実行するstateを選び（private transactionと通常のトランザクションは同じストレージを共有してるが、merkle木が違うっぽい）EVMを初期化し、transactionを適応する
    9. [NewEVM(ctx Context, statedb, privateState StateDB, chainConfig *params.ChainConfig, vmConfig Config)](https://github.com/ConsenSys/quorum/blob/v2.7.0/core/vm/evm.go#L158)
    10. [ApplyMessage(evm *vm.EVM, msg Message, gp *GasPool) ([]byte, uint64, bool, error)](https://github.com/ConsenSys/quorum/blob/v2.7.0/core/state_transition.go#L143:6)

### 認証の有効化
2. Gethの起動オプションに`--permissioned`が入っていれば認証サービスを登録する
    3. [makeFullNode(ctx *cli.Context)](https://github.com/ConsenSys/quorum/blob/master/cmd/geth/config.go#L154)
    4. [IsPermissionEnabled()](https://github.com/ConsenSys/quorum/blob/v2.7.0/node/config.go#L496)
    5. [RegisterPermissionService(stack *node.Node)](https://github.com/ConsenSys/quorum/blob/v2.7.0/cmd/utils/flags.go#L1823)
5. startNodeメソッド中で、サービスのコールバックが呼ばれる
    6. [startNode(ctx *cli.Context, stack *node.Node)](https://github.com/ConsenSys/quorum/blob/master/cmd/geth/main.go#L345)
    7. [AfterStart()](https://github.com/ConsenSys/quorum/blob/v2.7.0/permission/permission.go#L151)
8. 高度な認証でデプロイしたコントラクトのイベントを監視する
    9. [updatePermissionedNodes()](https://github.com/ConsenSys/quorum/blob/v2.7.0/permission/permission.go#L371)
10. イベントが発行されたら設定ファイル（permissioned-nodes.json）を更新する
    11. [updatePermissionedNodes(enodeId string, operation NodeOperation)](https://github.com/ConsenSys/quorum/blob/v2.7.0/permission/permission.go#L502)


### 接続ノードの認証
2. ノードとの接続時に設定ファイル（permissioned-nodes.json）を読み込み、リストに含まれているかチェック
    3. [setupConn(c *conn, flags connFlag, dialDest *enode.Node)](https://github.com/ConsenSys/quorum/blob/master/p2p/server.go#L950)
    4. [isNodePermissioned(nodename string, currentNode string, datadir string, direction string)](https://github.com/ConsenSys/quorum/blob/master/p2p/permissions.go#L21)
    5. [ParsePermissionedNodes(DataDir string)](https://github.com/ConsenSys/quorum/blob/master/p2p/permissions.go#L43)