📜 [專欄新文章] Merkle Tree in JavaScript

✍️ Johnson

📥 歡迎投稿： https://medium.com/taipei-ethereum-meetup #徵技術分享文 #使用心得 #教學文 #medium

這篇文章會說明 Merkle Tree 的運作原理，以及解釋 Merkle Proofs 的用意，並以 JavaScript / TypeScript 簡單實作出來。

本文為 Tornado Cash 研究系列的 Part 1，本系列以 tornado-core 為教材，學習開發 ZKP 的應用，另兩篇為：

Part 2：ZKP 與智能合約的開發入門

Part 3：Tornado Cash 實例解析

Special thanks to C.C. Liang for review and enlightenment.

本文中實作的 Merkle Tree 是以 TypeScript 重寫的版本，原始版本為 tornado-core 以 JavaScript 實作而成，基本上大同小異。

Merkle Tree 的原理

在理解 Merkle Tree 之前，最基本的先備知識是 hash function，利用 hash 我們可以對資料進行雜湊，而雜湊後的值是不可逆的，假設我們要對 x 值做雜湊，就以 H(x) 來表示，更多內容可參考：

一次搞懂密碼學中的三兄弟 — Encode、Encrypt 跟 Hash

SHA256 Online

而所謂的 Merkle Tree 就是利用特定的 hash function，將一大批資料兩兩進行雜湊，最後產生一個最頂層的雜湊值 root。

當有一筆資料假設是const leaves = [A, B, C, D]，我們就用function Hash(left, right)，開始製作這顆樹，產生H(H(A) + H(B))與H(H(C) + H(D))，再將這兩個值再做一次 Hash 變成 H(H(H(A) + H(B)) + H(H(C) + H(D)))，就會得到這批資料的唯一值，也就是 root。

本文中使用的命名如下：

root：Merkle Tree 最頂端的值，特色是只要底下的資料一有變動，root 值就會改變。

leaf：指單一個資料，如 H(A)。

levels：指樹的高度 (height)，以上述 4 個資料的假設，製作出來的 levels 是 2，levels 通常會作為遞迴的次數。

leaves：指 Merkle Tree 上的所有資料，如上述例子中的 H(A), H(B), H(C), H(D)。leaves 的數量會決定樹的 levels，公式是 leaves.length == 2**levels，這段建議先想清楚！

node：指的是非 leaves 也非 root 的節點，或稱作 branch，如上述例子中的H(H(A) + H(B)) 和 H(H(C) + H(D))。

index：指某個 leaf 所在的位置，leaf = leaves[index]，index 如果是偶數，leaf 一定在左邊，如果是奇數 leaf 一定在右邊。

Merkle Proofs

Merkle Proofs 的重點就是要證明資料有沒有在樹上。

如何證明？就是提供要證明的 leaf 以及其相對應的路徑 (path) ，經過計算後一旦能夠產生所需要的 root，就能證明這個 leaf 在這顆樹上。

因此這類要判斷資料有無在樹上的證明，類似的說法有：proving inclusion, proving existence, or proving membership。

這個 proof 的特點在於，我們只提供 leaf 和 path 就可以算出 root，而不需要提供所有的資料 (leaves) 去重新計算整顆 Merkle Tree。這讓我們在驗證資料有沒有在樹上時，不需要花費大量的計算時間，更棒的是，這讓我們只需要儲存 root 就好，而不需要儲存所有的資料。

在區塊鏈上，儲存資料的成本通常很高，也因此 Merkle Tree 的設計往往成為擴容上的重點。

我們知道 n 層的 Merkle Tree 可以存放 2**n 個葉子，以 Tornado Cash 的設計來說，他們設定 Merkle Tree 有 20 層，也就是一顆樹上會有 2**20 = 1048576 個葉子，而我們用一個 root 就代表了這 1048576 筆資料。

接續上段的例子，這顆 20 層的 Merkle Tree 所產生的 Proof ，其路徑 (path) 要從最底下的葉子 hash 幾次才能到達頂端的 root 呢？答案就是跟一棵樹的 levels 一樣，我們要驗證 Proof 所要遞迴的次數就會是 20 次。

在實作之前，我們先來看 MerkleTree 在 client 端是怎麼調用的，這有助於我們理解 Merkle Proofs 在做什麼。

基本上一個 proof 的場景會有兩個人：prover 與 verifier。

在給定一筆 leaves 的樹，必定產生一特定 root。prover 標示他的 leaf 在樹上的 index 等於 2，也就是 leaves[2] == 30，以此來產生一個 proof，這個 proof 的內容大致上會是這個樣子：

對 verifier 來說，他要驗證這個 proof，就是用裡面的 leaf 去一個一個與 pathElements 的值做 hash，上述就是 H('30', 40) 後得出 node，再 hash 一次 H('19786...', node) 於是就能得出這棵樹的 root。

重點來了，這麼做有什麼意義？它的巧思在於對 verifier 來說，他只需要儲存一個 root，由 prover 提交證明給他，經過計算後產生的 root 如果跟 verifier 儲存的 root 一樣，那就證明了 prover 所提供的資料確實存在於這個樹上。

而 verifier 若不透過 proof ，要驗證某個 leaf 是否存在於樹上，也可以把 leaves = [10, 20 ,leaf ,40]整筆資料拿去做 MerkleTree 的演算法跑一趟也能產生特定的 root。

但由 prover 先行計算後所提交的 proof，讓 verifier 不必儲存整批資料，也省去了大量的計算時間，即可做出某資料有無在 Merkle Tree 上的判斷。

Sparse Merkle Tree

上述能夠證明資料有無在樹上的 Merkle Proofs 是屬於標準的 Merkle Tree 的功能。但接下來我們要實作的是稍微不一樣的樹，叫做 Sparse Merkle Tree。

Sparse Merkle Tree 的特色在於除了 proving inclusion 之外，還可以 proving non-inclusion。也就是能夠證明某筆資料不在某個 index，例如 H(A) 不在 index 2 ，這是一般 Merkle Tree 沒辦法做到的。

而要做到 non-membership 的功能其實也不難，就是我們要在沒有資料的葉子裡補上 zero value，或是說 null 值。更多內容請參考：What’s a Sparse Merkle Tree。

實作細節

本節將完整的程式碼分成三個片段來解釋。

首先，這裡使用的 Hash Function 是 MiMC，主要是為了之後在 ZKP 專案上的效率考量，你可以替換成其他較常見的 hash function 例如 node.js 內建 crypto 的 sha256：

crypto.createHash("sha256").update(data.toString()).digest("hex");

這裡定義簡單的 Merkle Tree 介面有 root, proof, and insert。

首先我們必須先給定這顆樹的 levels，也就是樹的高度先決定好，樹所能容納的資料量也因此固定為 2**levels 筆資料，至於要不要有 defaultLeaves 則看創建 Merkle Tree 的 client 自行決定，如果有 defaultLeaves 的話，constructor 就會跑下方一大段計算，對 default 資料開始作 hash 去建立 Merkle Tree。

如果沒有 defaultLeaves，我們的樹也不會是空白的，因為這是顆 Sparse Merkle Tree，這裡使用 zeroValue 作為沒有填上資料的值，zeros 陣列會儲存不同 level 所應該使用的 zero value。假設我們已經填上第 0 筆與第 1 筆資料，要填上第 2 筆資料時，第 2 筆資料就要跟 zeros[0] 做 hash，第 2 筆放左邊， zero value 放右邊。

我們將所有的點不論是 leaf, node, root 都用標籤 (index) 標示，並以 key-value 的形式儲存在 storage 裡面。例如第 0 筆資料會是 0–0，第 1 筆會是 0–1，這兩個 hash 後的節點 (node) 會是 1–0。假設 levels 是 2，1–0 節點就要跟 1–1 節點做 hash，即可產出 root (2–0)。

後半部份的重點在於 proof，先把 proof 和 traverse 看懂，基本上就算是打通任督二脈了，之後有興趣再看 insert 和 update。

sibling 是指要和 current 一起 hashLeftRight 的值…也就是相鄰在兩旁的 leaf (or node)。

到這裡程式碼的部分就結束了。

最後，讓我們回到一開始 client 調用 merkleTree 的例子：

以及 proof 的內容：

前面略過了 proof 裡頭的 pathIndices，pathIndices 告訴你的是當前的 leaf (or node) 是要放在左邊，還是放在右邊，大概是這個樣子：

if (indices == 0) hash(A, B);if (indices == 1) hash(B, A);

有興趣的讀者可以實作 verify function 看看就會知道了！

原始碼

TypeScript from gist

JavaScript from tornado-core

參考

Merkle Proofs Explained

What’s a Sparse Merkle Tree?

延伸：Verkle Tree

Merkle Tree in JavaScript was originally published in Taipei Ethereum Meetup on Medium, where people are continuing the conversation by highlighting and responding to this story.

👏 歡迎轉載分享鼓掌

NT 570 特價中

Vue 3 開發的終極指南! 建構大規模的應用程式並部署到營運環境。從零到精通!

從這 30 小時的課程，你會學到

✅ 建構企業等級的 Vue 應用程式並部署到營運中
✅ 檔案上傳、測試、PWA、國際化、Vue 3的認證
✅ 學習如何像高階開發人員一樣建構反應性強、效能好的大規模應用程式
✅ 學習 Vue 3 的最新功能，包括 Composition API、Vuex、Vue Router等
✅ 學習使用 TailwindCSS、Sass、CSS 動畫和過場特效來建構漂亮的應用程式
✅ 從頭開始掌握 Vue 開發者的最新生態系統
✅ 成為前 10% 的 VueJS 開發者
✅ 在你的應用程式中使用 Vuex 進行狀態管理
✅ 學會在效能和可擴充性方面進行權衡比較
✅ 設定認證和使用者賬戶
✅ 使用 Firebase 來建構全端應用程式
✅ 透過做出良好的架構決策和幫助團隊中的其他人來學習領導 Vue 專案
✅ 掌握 Vue 設計模式
✅ 使用 Vue Router 進行路由選擇
✅ 將應用程式轉換為漸進式 Web 應用程式
✅ 用 Jest、快照測試、甚至 E2E 測試來測試你的應用程式
✅ 使用最新的 ES6/ES7/ES8/ES9/ES10/ES11 JavaScript 來編寫乾淨的程式碼
✅ 瞭解為什麼 Vue 在開發者中的受歡迎程度超過了 React 和 Angular!

https://softnshare.com/complete-vue-js-developer-zero-to-mastery-vuex/

WebAssembly 是你的瀏覽器能夠以（接近）本機速度運行已編譯的程式碼。它現在被W3C識別為繼HTML、CSS和JAVAScript之後的第四種官方網頁程式設計語言。
有了它，你可以在瀏覽器中運行用各種程式設計語言（C/C++、Rust、Go、AssemblyScript 等）編寫的編譯程式碼，而無需任何外掛程式。
這篇文章的作者分享他將既有的 javascript 專案轉換到 WebAssembly 的流程

https://engineering.q42.nl/webassembly/

跨平台APP開發使用Visual Studio2015與PhoneGap(第14次登入帳號密碼與動態切換頁面範例&切頁程式撰寫&BMI計算練習與介面設計&程式設計&計算結果與下周課程預告)

上課內容：
01_登入帳號密碼與動態切換頁面範例
02_切頁程式撰寫說明
03_BMI計算練習與介面設計
04_BMI計算練習與程式設計
05_計算結果與下周課程預告

完整影音
https://www.youtube.com/playlist?list=PLgzs-Q3byiYPzxVRor1khMUH6Xfn4mvZ_

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/labor_app_2016

懶人包：http://terry55wu.blogspot.com/p/android.html

課程理念與課程介紹：

從基礎、進階到雲端資料庫整合與行動網頁的全面運用，打造最強、最新、最實用的全方位商業級互動網站!
並延伸到APP開發，並將之結合，用JAVA程式設計APP對一般人來說太難，這門課就是用網站觀念做APP，利用PhoneGap服務見可以快速將Web轉成APP。
並使用Visual Studio 2015 X Cordova跨平台應用程式設計，環境建置 X 開發入門 X 介面設計 X 各種應用元件App實務開發的完全整合學習！
最簡單！開發及維護成本低，直接整合應用HTML、CSS及JavaScript進行App開發，學習曲線最短，效率最高！

超跨界！一次開發，即可發佈Android、iOS、Windows不同平台的App，免除學習多種開發工具的煩惱。
神開發！應用HTML即可直接控制智慧手機照相攝影、錄音放音、GPS羅盤、無線網路等眾多硬體感測器！
極直覺！搭配Visual Studio 2015即可簡化專案佈置與程式碼輸入流程，提高開發效率！
不藏私！全新的版本、最全面的解說，引領全方位的App應用程式開發學習。重實例！以小範例入門，到整合的App實例，深入行動應用，範例全面涵蓋：系統醫生、聯絡簿管理、音樂播放器、定位地圖、自我介紹、QRCode掃瞄器、中英文語音合成、檔案上傳下載、簡易照相機、數位羅盤…

參考書目

跨平台 Android．iPhone 程式開發：使用 Visual Studio Community＋Cordova/PhoneGap＋jQuery Mobile作者：陳會安ISBN：9789863123217出版社：旗標出版日期：2016/01/21
Visual Studio 2015 X Cordova跨平台App實戰訓班(附近120分鐘關鍵影音教學/全書範例程式)鄧文淵 總監製/文淵閣工作室 編著出版商: 碁峰出版日期： 2016-03-29
HTML5+CSS3+jQuery Mobile輕鬆打造App與行動網站(第二版)
作者： 數位新知, 陳婉凌
出版社：博碩 出版日期：2016/01/08

吳老師教學部落格：
http://terry55wu.blogspot.com/

android 開發教學,android 程式教學,android 使用教學,android app教學,android sdk,android eclipse,android 開發,android studio 開發教學,android studio tutorial,app開發教學,Visual Studio2015,PhoneGap

跨平台APP開發使用Visual Studio2015與PhoneGap(第14次登入帳號密碼與動態切換頁面範例&切頁程式撰寫&BMI計算練習與介面設計&程式設計&計算結果與下周課程預告)

上課內容：
01_登入帳號密碼與動態切換頁面範例
02_切頁程式撰寫說明
03_BMI計算練習與介面設計
04_BMI計算練習與程式設計
05_計算結果與下周課程預告

完整影音
https://www.youtube.com/playlist?list=PLgzs-Q3byiYPzxVRor1khMUH6Xfn4mvZ_

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/labor_app_2016

懶人包：http://terry55wu.blogspot.com/p/android.html

課程理念與課程介紹：

從基礎、進階到雲端資料庫整合與行動網頁的全面運用，打造最強、最新、最實用的全方位商業級互動網站!
並延伸到APP開發，並將之結合，用JAVA程式設計APP對一般人來說太難，這門課就是用網站觀念做APP，利用PhoneGap服務見可以快速將Web轉成APP。
並使用Visual Studio 2015 X Cordova跨平台應用程式設計，環境建置 X 開發入門 X 介面設計 X 各種應用元件App實務開發的完全整合學習！
最簡單！開發及維護成本低，直接整合應用HTML、CSS及JavaScript進行App開發，學習曲線最短，效率最高！

超跨界！一次開發，即可發佈Android、iOS、Windows不同平台的App，免除學習多種開發工具的煩惱。
神開發！應用HTML即可直接控制智慧手機照相攝影、錄音放音、GPS羅盤、無線網路等眾多硬體感測器！
極直覺！搭配Visual Studio 2015即可簡化專案佈置與程式碼輸入流程，提高開發效率！
不藏私！全新的版本、最全面的解說，引領全方位的App應用程式開發學習。重實例！以小範例入門，到整合的App實例，深入行動應用，範例全面涵蓋：系統醫生、聯絡簿管理、音樂播放器、定位地圖、自我介紹、QRCode掃瞄器、中英文語音合成、檔案上傳下載、簡易照相機、數位羅盤…

參考書目

跨平台 Android．iPhone 程式開發：使用 Visual Studio Community＋Cordova/PhoneGap＋jQuery Mobile作者：陳會安ISBN：9789863123217出版社：旗標出版日期：2016/01/21
Visual Studio 2015 X Cordova跨平台App實戰訓班(附近120分鐘關鍵影音教學/全書範例程式)鄧文淵 總監製/文淵閣工作室 編著出版商: 碁峰出版日期： 2016-03-29
HTML5+CSS3+jQuery Mobile輕鬆打造App與行動網站(第二版)
作者： 數位新知, 陳婉凌
出版社：博碩 出版日期：2016/01/08

吳老師教學部落格：
http://terry55wu.blogspot.com/

android 開發教學,android 程式教學,android 使用教學,android app教學,android sdk,android eclipse,android 開發,android studio 開發教學,android studio tutorial,app開發教學,Visual Studio2015,PhoneGap

跨平台APP開發使用Visual Studio2015與PhoneGap(第14次登入帳號密碼與動態切換頁面範例&切頁程式撰寫&BMI計算練習與介面設計&程式設計&計算結果與下周課程預告)

上課內容：
01_登入帳號密碼與動態切換頁面範例
02_切頁程式撰寫說明
03_BMI計算練習與介面設計
04_BMI計算練習與程式設計
05_計算結果與下周課程預告

完整影音
https://www.youtube.com/playlist?list=PLgzs-Q3byiYPzxVRor1khMUH6Xfn4mvZ_

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/labor_app_2016

懶人包：http://terry55wu.blogspot.com/p/android.html

課程理念與課程介紹：

從基礎、進階到雲端資料庫整合與行動網頁的全面運用，打造最強、最新、最實用的全方位商業級互動網站!
並延伸到APP開發，並將之結合，用JAVA程式設計APP對一般人來說太難，這門課就是用網站觀念做APP，利用PhoneGap服務見可以快速將Web轉成APP。
並使用Visual Studio 2015 X Cordova跨平台應用程式設計，環境建置 X 開發入門 X 介面設計 X 各種應用元件App實務開發的完全整合學習！
最簡單！開發及維護成本低，直接整合應用HTML、CSS及JavaScript進行App開發，學習曲線最短，效率最高！

超跨界！一次開發，即可發佈Android、iOS、Windows不同平台的App，免除學習多種開發工具的煩惱。
神開發！應用HTML即可直接控制智慧手機照相攝影、錄音放音、GPS羅盤、無線網路等眾多硬體感測器！
極直覺！搭配Visual Studio 2015即可簡化專案佈置與程式碼輸入流程，提高開發效率！
不藏私！全新的版本、最全面的解說，引領全方位的App應用程式開發學習。重實例！以小範例入門，到整合的App實例，深入行動應用，範例全面涵蓋：系統醫生、聯絡簿管理、音樂播放器、定位地圖、自我介紹、QRCode掃瞄器、中英文語音合成、檔案上傳下載、簡易照相機、數位羅盤…

參考書目

跨平台 Android．iPhone 程式開發：使用 Visual Studio Community＋Cordova/PhoneGap＋jQuery Mobile作者：陳會安ISBN：9789863123217出版社：旗標出版日期：2016/01/21
Visual Studio 2015 X Cordova跨平台App實戰訓班(附近120分鐘關鍵影音教學/全書範例程式)鄧文淵 總監製/文淵閣工作室 編著出版商: 碁峰出版日期： 2016-03-29
HTML5+CSS3+jQuery Mobile輕鬆打造App與行動網站(第二版)
作者： 數位新知, 陳婉凌
出版社：博碩 出版日期：2016/01/08

吳老師教學部落格：
http://terry55wu.blogspot.com/

android 開發教學,android 程式教學,android 使用教學,android app教學,android sdk,android eclipse,android 開發,android studio 開發教學,android studio tutorial,app開發教學,Visual Studio2015,PhoneGap