鉆石代理合約最佳安全實踐_FACE:Diamond Hands

代理合約是智能合約開發者的重要工具。如今，合約系統里已有多種代理模式和對應的使用規則。我們之前已經概述了可升級的代理合約安全最佳實踐。

本文我們將介紹了另一種在開發者社區頗受青睞的代理模式，即鉆石代理模式。

鉆石代理合約，也被稱為“鉆石”，是以太坊智能合約的一種設計模式，由以太坊改進提案（EIP）2535引入。

鉆石模式通過將合約的功能分割成較小的合約（也被形象地稱為“切面”），允許合約擁有無限的功能。鉆石充當代理，將函數調用路由到適當的切面。

鉆石模式的設計可以解決以太坊網絡的最大合約大小限制問題。通過將一個大型合約分解成較小的切面，鉆石模式允許開發人員建立更復雜和功能豐富的智能合約而不受大小限制影響。

與傳統的可升級合約相比，鉆石代理提供了巨大的靈活性。它們允許合約部分升級，增加、替換或刪除選定的部分函數，而不觸及其他部分。

本文提供了EIP-2535的概述，包括與廣泛使用的透明代理模式和UUPS代理模式的比較，以及它對開發者社區的安全考慮。

在EIP-2535的背景下，"鉆石 "是一個代理合約，其功能實現由不同的邏輯合約提供，稱為“切面”。

想像一下，真正的鉆石有不同的側面，叫做切面（facet），那么相應的以太坊鉆石合約也有不同的切面。每一個鉆石借用功能的合約都是不同的側面或切面（facet）。

鉆石標準使用類比的方式擴展了“鉆石切割”的功能 ，用于增加，替換，或刪除切面和功能。

此外，鉆石標準提供了稱為“鉆石放大鏡(Diamond  Loupe)”的功能，返回關于切面的信息和鉆石存在的功能。

與傳統的代理模式相比，“鉆石”等同于代理合約，而不同的“切面”對應于實現合約。一個鉆石代理的不同切面可以共享內部函數、庫和狀態變量。鉆石的關鍵組成部分如下：

De Beers Group推出由區塊鏈支持的鉆石溯源平臺Tracr?:金色財經消息，De Beers Group正在大規模部署Tracr?區塊鏈平臺用于鉆石生產。Tracr?利用區塊鏈技術對鉆石進行溯源，從而保證其來源真實可信。

據稱，Tracr?平臺將分布式賬本技術與先進的數據安全和隱私相結合，確保參與者控制自己數據的使用和訪問。（MediaOutReach）[2022/5/6 2:53:46]

作為代理的中央合約，將函數調用路由到適當的切面。它包含一個函數選擇器到“切面”地址的映射。

實現特定功能的單個合約。每個切面都包含一組可以被鉆石調用的函數。

是在EIP-2535中定義的一組標準函數，提供關于鉆石中使用的切面和函數選擇器的信息。鉆石放大鏡允許開發者和用戶檢查和了解鉆石的結構。

用于添加、替換或刪除鉆石中的切面及其相應的功能選擇器的函數。只有授權的地址（例如，鉆石的所有者或多簽名的合約）才能進行鉆石切割。

與傳統代理類似，當鉆石代理上有一個函數調用時，代理的fallback函數（回退函數）就會被觸發。與鉆石代理的主要區別是，在回退函數中，有一個selectorToFacet映射，存儲并確定哪個邏輯合約地址有被調用的函數的實現。然后，它使用delegatecall來執行該函數，就像傳統的代理一樣。

所有的代理都使用fallback()函數，將函數調用委托給外部地址。下面是鉆石代理的實現和傳統代理的實現。

BiKi平臺今日上線DMD(鉆石)，開盤漲幅達236.37%:據官方消息，BiKi平臺今日已上線DMD，開盤漲幅高達236.37%，現報價1743USDT。

鉆石(DMD)是EOS的DeFi項目，鉆石將以比特幣和YFI的形式發放：沒有創始人，沒有投資人，沒有預挖，沒有增發，全民平等。dmd.finance希望推動EOS Defi社區的大發展。[2020/9/4]

值得注意的是它們的匯編代碼塊非常相似，因此唯一的區別是鉆石代理委托調用中的切面地址和傳統代理委托調用中的impl地址。

而其主要區別在于：在鉆石代理中，切面的地址是由調用者的msg.sig（函數選擇器）到切面的地址的hashmap決定的，而在傳統代理中，impl地址不依賴于調用者的輸入。

鉆石代理fallback 函數

傳統的代理fallback 函數

SelectorToFacet映射決定了哪個合約包含了每個函數選擇器的實現。項目工作人員經常需要添加、替換或刪除這種函數選擇器到實現合約的映射。EIP-2535規定：為了達到此目的，必須有一個 diamondCut() 函數。下面是一個示例接口。

每個FacetCut結構都包含一個切面地址和四字節的功能選擇器數組，以在鉆石代理合約中進行更新。FaceCutAction允許人們添加、替換和刪除功能選擇器。diamondCut()函數的實現應該包括足夠的訪問控制，防止存儲槽的碰撞，在失敗時進行恢復等。

DTrader社區入選Bitget第五位鉆石節點:據官方消息，Bitget經過嚴格篩選，今日誕生第五位鉆石節點：DTrader社區。Desirable Trader，簡稱DT社區或燈塔社區，旨在為行業用戶提供交易全方位的咨詢，幫助用戶養成自有交易系統，打造行業良好生態圈。Bitget將為鉆石節點頒布榮譽金幣，目前鉆石席位僅余5個。鉑金節點與黃金節點同步限量招募，平臺將優先開放3個月以上穩定合作伙伴的申請，更多節點申請與詳情前往官網查看。[2020/7/2]

為了查詢一個鉆石代理有哪些功能，使用哪些切面，我們使用了“鉆石放大鏡”。“鉆石放大鏡”是一個特殊的切面，它實現了EIP-2535中定義的以下接口：

facets()函數應該返回所有切面的地址和它們的四字節的函數選擇器。facetFunctionSelectors()函數應該返回一個特定切面所支持的所有函數選擇器。facetAddresses()函數應該返回一個鉆石所使用的所有切面地址。

facetAddress()函數應該返回支持給定選擇器的切面，如果沒有找到，則返回address(0)。請注意，不應該有一個以上的切面地址具有相同的功能選擇器。

鑒于鉆石代理將不同的函數調用委托給不同的實現合約，正確管理存儲槽以防止沖突是至關重要的。EIP-2535提到了幾種存儲槽管理方法。

這個切面可以在結構中聲明狀態變量。這個切面可以使用任意數量的結構，每個結構有不同的存儲位置。每個結構在合約存儲中都有一個特定的位置。切面可以聲明他們自己的狀態變量，但不能與其他切面所聲明的狀態變量的存儲位置相沖突。EIP-2535中提供了一個樣本庫和鉆石存儲合約，如下圖所示：

動態 | 香港推出首個區塊鏈鉆石交易平臺:據21世紀經濟網，近日香港科技園培育的初創公司智信鏈金融科技在香港推出首個應用區塊鏈技術及交易所系統的鉆石實物交易平臺EverCarat。該平臺利用區塊鏈技術，全面追蹤鉆石來源地、認證資料、成交倉儲紀錄、交易流向等信息，并支持各種交易記賬及核實交易，內容難以篡改。買賣雙方可以隨時隨地在手機上便捷安全地交易實物鉆石。[2018/11/15]

App存儲是鉆石存儲的一個更專精的版本。這種模式被用來更方便、更容易地共享切面的狀態變量。一個App存儲結構被定義為包含一個應用程序所需的任意數量和類型的狀態變量。一個切面總是將AppStorage結構聲明為第一個也是唯一一個狀態變量，位于存儲槽的第0位。然后不同的切面可以從該結構中訪問變量。

此外也有其他的存儲槽管理策略，包括鉆石存儲和AppStorage的混合。比如有些結構在不同的切面之間共享，有些則是特定切面所特有的。在所有情況下，防止意外的存儲槽碰撞是非常重要的。

與透明代理和UUPS代理的比較

目前Web3開發者社區使用的兩種主要代理模式是透明代理模式和UUPS代理模式。在這一節中，我們簡要比較了鉆石代理模式與透明代理和UUPS代理模式。

1.EPI-2535:https://eips.ethereum.org/EIPS/eip-2535#Facets,%20State%20Variables%20and%20Diamond%20Storage

2.EPI-1967:https://eips.ethereum.org/EIPS/eip-1967    

動態 | 香港珠寶零售商將使用區塊鏈平臺追蹤鉆石:據報道，香港珠寶零售商周大福珠寶集團將部分鉆石放在由區塊鏈初創公司Everledger開發并由IBM區塊鏈平臺保護的區塊鏈平臺上。將使零售商的客戶能夠使用T Mark應用確定其T Mark品牌商店中出售的寶石的來源和真實性。T Mark是該公司去年8月啟動的一項計劃，該計劃為某些寶石分配了一系列序列號，以便更容易驗證其出處和交易歷史。該公司目前已在其四家商店推出3,000 T Mark鉆石計劃，并計劃在10家商店中將其擴展至10,000顆鉆石。[2018/9/13]

3.Diamond proxy reference implementation: https://github.com/mudgen/Diamond    

4.OpenZeppelin implementation: https://github.com/OpenZeppelin/openzeppelin-contracts/tree/v4.7.0/contracts/proxy

代理和可升級的解決方案是較復雜的系統，OpenZeppelin為UUPS、透明及Beacon可升級代理提供代碼庫及全面的文檔。然而對于鉆石代理模式，雖然OpenZeppelin肯定了它的好處，但他們仍然決定不把EIP-2535鉆石的實現納入他們的庫中。

因此，使用現有的第三方庫或自行實現該解決方案的開發者在實施時必須格外謹慎。在此我們編寫了一份安全最佳實踐清單，供開發者社區參考。

通過將合約邏輯分解成更小、更容易管理的模塊，開發人員可以更容易地測試和審計他們的代碼。

此外，這種方法允許開發人員專注于構建和維護合約的特定方面，而不是管理一個復雜的、單一的代碼庫。最終的結果是一個更加靈活和模塊化的代碼庫，可以很容易地在不影響合約其他部分的情況下被更新和修改。

資料來源：Aavegotchi Github

當鉆石代理合約被部署時，它必須將DiamondCutFacet合約的地址添加到鉆石代理合約中，并實現diamondCut() 函數。diamondCut()函數用于添加、刪除或替換切面和函數，沒有DiamondCutFacet和diamondCut()，鉆石代理無法正常工作。

資料來源：Mugen’s Diamond-3-Hardhat

在智能合約中向存儲結構添加新的狀態變量時，必須將其添加到結構的末端。在結構的開頭或中間添加新的狀態變量會導致新的狀態變量覆蓋現有的狀態變量數據，而新的狀態變量之后的任何狀態變量都可能會引用錯誤的存儲位置。

 AppStorage模式要求為鉆石代理聲明一個且僅有一個結構，并且該結構為所有切面所共享。如果需要多個結構，應該使用DiamondStorage模式。

 不要將結構直接放在另一個結構中，除非確定不打算向內部結構添加更多狀態變量。如果不覆蓋結構之后所聲明的變量存儲槽，就無法在升級中向內部結構添加新的狀態變量。

解決方法是將新的狀態變量添加到存儲映射結構中，而不是直接將“結構”放置在“結構”中。映射中的變量存儲槽計算方式不同，在存儲中不連續。

數組的大小將受到結構大小的影響。當一個新的狀態變量被添加到一個結構中時，它會改變該結構的大小和布局。

如果該結構被用作數組中的一個元素，這可能會導致問題。如果結構的大小和布局發生變化，那么數組的大小和布局也會發生變化，這可能會導致索引或其他依賴結構大小和布局一致的操作出現問題。

 與其他代理模式類似，每個變量都應該有一個唯一的存儲槽。否則，同一位置的兩個不同結構會相互覆蓋。

initialize()函數通常用于設置重要的變量，如特權角色的地址。如果在合約部署時沒有初始化，惡意行為者可以調用并控制合約。

建議在初始化/設置函數上加入適當的訪問控制，或者確保該函數在合約部署時被調用，不能被再次調用。

如果合約中的任何一個切面能夠調用selfdestruct()函數，它就有可能破壞整個合約，導致資金或數據損失。這在鉆石代理模式中極其危險，因為多個切面可以訪問代理合約的存儲和數據。

目前，我們看到越來越多的項目在他們的智能合約中采用鉆石代理模式。與傳統代理相比，它具有靈活性和其他優勢。

然而，額外的靈活性也可能意味著給攻擊者提供了更廣泛的攻擊面。我們希望這篇文章對開發者社區了解鉆石代理模式的機制及其安全考慮有所幫助。

同時，項目團隊應該進行嚴格的測試和第三方審計，以減少與實施鉆石代理合約有關的漏洞風險。

CertiK中文社區

企業專欄

閱讀更多

金色早8點

Odaily星球日報

金色財經

Block unicorn

DAOrayaki

曼昆區塊鏈法律

Tags：DIAAMOFACEdiamondCZodiac StabletokenDIAMONDHANDSFACE價格Diamond Hands

DOGE