OpenZeppelin 可昇級合約插件 4/9 在 Buidler 環境下使用插件
在 Buidler 環境下使用插件
這個插件增加 Buidler 環境腳本的功能,可以為部署和昇級的合約。Buidler環境跟插件依賴於 ethers.js。
在Buidler論壇裡有一篇文件可以參考。https://forum.openzeppelin.com/t/openzeppelin-upgrades-step-by-step-tutorial-for-buidler/3580
安裝
以下的命令可以安裝插件
然後,在 buidler 的設定檔 buidler.config.js 裡設定
如果使用 TypeScript ,記得加入 type extensions 到 tconfig.json
在腳本中使用插件
可以在腳本中調用本插件的 deployProxy 函數來部署可昇級的合約實體。
以上的代碼會完成以下的動作,自動檢查 Box 合約是不是可以安全昇級的,設定一個代理合約管理員(如果需要的話),然後部署一個 Box合約實體(除非之前已經部署完成),建立一個代理合約,調用 initialize(42) 來初化合約。
在另一個用來昇級的腳本,可以調用 upgradeProxy 函數來昇級一個已經部署的合約實體。這個新的版本的合約可以是完全不同的合約,像是 BoxV2 , 或是只是重新編譯舊版本合約 Box 的修正,插件會自動注意到合約已經改變。
需要注意的是,雖然本插件會持續追蹤已部署在所有網路上的功能實現合約,使之有重用性及驗証存儲的相容性,但是不會持續追蹤代理合約。這表示在有必要時,必需手動去追蹤每個代理合約部署地址上的昇級功能。
本插件會比對 BoxV2 跟上一個合約,確定這兩個合約是相容的,然後部署新的 BoxV2 功能實作合約(除非在此之前已經部署完成),然後更新代理合約指向到新的功能實作合約。
在測試時使用本插件
也可以在 Buidler 測試時使用 deployProxy 和 upgraderProxy 函數,以下的代碼為昇級合約增加測試。
參考
https://docs.openzeppelin.com/upgrades-plugins/1.x/buidler-upgrades