OpenZeppelin 可昇級合約插件 4/9 在 Buidler 環境下使用插件

Oct 19, 2020

在 Buidler 環境下使用插件

這個插件增加 Buidler 環境腳本的功能，可以為部署和昇級的合約。Buidler環境跟插件依賴於 ethers.js。

以下的命令可以安裝插件

然後，在 buidler 的設定檔 buidler.config.js 裡設定

如果使用 TypeScript ,記得加入 type extensions 到 tconfig.json

可以在腳本中調用本插件的 deployProxy 函數來部署可昇級的合約實體。

以上的代碼會完成以下的動作，自動檢查 Box 合約是不是可以安全昇級的，設定一個代理合約管理員(如果需要的話)，然後部署一個 Box合約實體(除非之前已經部署完成)，建立一個代理合約，調用 initialize(42) 來初化合約。

在另一個用來昇級的腳本，可以調用 upgradeProxy 函數來昇級一個已經部署的合約實體。這個新的版本的合約可以是完全不同的合約，像是 BoxV2 , 或是只是重新編譯舊版本合約 Box 的修正，插件會自動注意到合約已經改變。

需要注意的是，雖然本插件會持續追蹤已部署在所有網路上的功能實現合約，使之有重用性及驗証存儲的相容性，但是不會持續追蹤代理合約。這表示在有必要時，必需手動去追蹤每個代理合約部署地址上的昇級功能。

本插件會比對 BoxV2 跟上一個合約，確定這兩個合約是相容的，然後部署新的 BoxV2 功能實作合約(除非在此之前已經部署完成)，然後更新代理合約指向到新的功能實作合約。

也可以在 Buidler 測試時使用 deployProxy 和 upgraderProxy 函數，以下的代碼為昇級合約增加測試。