代理合約是智能合約開發者的重要工具。如今,合約系統里已有多種代理模式和對應的使用規則。我們之前已經概述了可升級的代理合約安全最佳實踐。
本文我們將介紹了另一種在開發者社區頗受青睞的代理模式,即鉆石代理模式。
鉆石代理合約,也被稱為“鉆石”,是以太坊智能合約的一種設計模式,由以太坊改進提案(EIP)2535引入。
鉆石模式通過將合約的功能分割成較小的合約(也被形象地稱為“切面”),允許合約擁有無限的功能。鉆石充當代理,將函數調用路由到適當的切面。
鉆石模式的設計可以解決以太坊網絡的最大合約大小限制問題。通過將一個大型合約分解成較小的切面,鉆石模式允許開發人員建立更復雜和功能豐富的智能合約而不受大小限制影響。
與傳統的可升級合約相比,鉆石代理提供了巨大的靈活性。它們允許合約部分升級,增加、替換或刪除選定的部分函數,而不觸及其他部分。
本文提供了EIP-2535的概述,包括與廣泛使用的透明代理模式和UUPS代理模式的比較,以及它對開發者社區的安全考慮。
在EIP-2535的背景下,"鉆石 "是一個代理合約,其功能實現由不同的邏輯合約提供,稱為“切面”。
想像一下,真正的鉆石有不同的側面,叫做切面(facet),那么相應的以太坊鉆石合約也有不同的切面。每一個鉆石借用功能的合約都是不同的側面或切面(facet)。
鉆石標準使用類比的方式擴展了“鉆石切割”的功能 ,用于增加,替換,或刪除切面和功能。
此外,鉆石標準提供了稱為“鉆石放大鏡(Diamond Loupe)”的功能,返回關于切面的信息和鉆石存在的功能。
與傳統的代理模式相比,“鉆石”等同于代理合約,而不同的“切面”對應于實現合約。一個鉆石代理的不同切面可以共享內部函數、庫和狀態變量。鉆石的關鍵組成部分如下:
Diamond Standard CEO:代幣化鉆石使投資者能接觸價值1.2萬億美元的鉆石市場:8月27日消息,區塊鏈初創公司Diamond Standard創始人及CEO Cormac Kinney表示,代幣化鉆石可以向更廣泛的投資者群體開放價值1.2萬億美元的鉆石市場。Cormac Kinney將Diamond Standard視為消除擁有和投資寶石的主要障礙的一種方式。
Diamond Standard的專利技術旨在創建一個更加透明的系統,使投資者能夠更輕松、更高效地跟蹤供應鏈和隨后對世界終極珠寶的所有權。Kinney指出,鉆石市場“比黃金以外的幾乎所有其他貴金屬加起來還要大”。鉆石與黃金、股票或債券不相關,這也為投資者提供一種對沖工具。
據悉,Diamond Standard在百慕大獲準發行、出售和贖回代幣和數字資產,為散戶和機構投資者提供具有標準化價值和流動性的鉆石支持的數字貨幣Diamond Standard Coin。(CoinDesk)[2022/8/27 12:52:11]
作為代理的中央合約,將函數調用路由到適當的切面。它包含一個函數選擇器到“切面”地址的映射。
實現特定功能的單個合約。每個切面都包含一組可以被鉆石調用的函數。
是在EIP-2535中定義的一組標準函數,提供關于鉆石中使用的切面和函數選擇器的信息。鉆石放大鏡允許開發者和用戶檢查和了解鉆石的結構。
用于添加、替換或刪除鉆石中的切面及其相應的功能選擇器的函數。只有授權的地址(例如,鉆石的所有者或多簽名的合約)才能進行鉆石切割。
動態 | 盧卡拉鉆石公司計劃將部分鉆石交易遷移至整合區塊鏈的交易平臺Clara:據彭博報道,Lucara Diamond計劃將其180億美元規模的鉆石交易的一部分遷移至整合區塊鏈技術的交易網站Clara之上。該公司CEO Eira Thomas表示,如果Clara能達到15億美元的交易量,該平臺產生的現金流將與從礦山產生的現金流一樣重要。Thomas稱:“我們現在正采取初步措施,每個季度我們都會出具報告,預計銷量會增加。”[2019/4/29]
與傳統代理類似,當鉆石代理上有一個函數調用時,代理的fallback函數(回退函數)就會被觸發。與鉆石代理的主要區別是,在回退函數中,有一個selectorToFacet映射,存儲并確定哪個邏輯合約地址有被調用的函數的實現。然后,它使用delegatecall來執行該函數,就像傳統的代理一樣。
所有的代理都使用fallback()函數,將函數調用委托給外部地址。下面是鉆石代理的實現和傳統代理的實現。
值得注意的是它們的匯編代碼塊非常相似,因此唯一的區別是鉆石代理委托調用中的切面地址和傳統代理委托調用中的impl地址。
而其主要區別在于:在鉆石代理中,切面的地址是由調用者的msg.sig(函數選擇器)到切面的地址的hashmap決定的,而在傳統代理中,impl地址不依賴于調用者的輸入。
鉆石代理fallback 函數
傳統的代理fallback 函數
SelectorToFacet映射決定了哪個合約包含了每個函數選擇器的實現。項目工作人員經常需要添加、替換或刪除這種函數選擇器到實現合約的映射。EIP-2535規定:為了達到此目的,必須有一個 diamondCut() 函數。下面是一個示例接口。
動態 | 鉆石交易平臺CEDEX開始交易服務 并計劃推出ETF:據Finance Magnates消息,基于區塊鏈技術的鉆石交易平臺CEDEX宣布,6000多顆鉆石(總價值超5000萬美元)將在該平臺上進行交易。此外,該交易所還計劃推出一個目前處于開發階段的鉆石支持的交易所交易基金(ETF)。此前消息,2018年11月,倫敦交易所上市技術提供商TechFinancials宣布,其推出基于區塊鏈技術的鉆石交易平臺CEDEX測試版。[2019/3/27]
每個FacetCut結構都包含一個切面地址和四字節的功能選擇器數組,以在鉆石代理合約中進行更新。FaceCutAction允許人們添加、替換和刪除功能選擇器。diamondCut()函數的實現應該包括足夠的訪問控制,防止存儲槽的碰撞,在失敗時進行恢復等。
為了查詢一個鉆石代理有哪些功能,使用哪些切面,我們使用了“鉆石放大鏡”。“鉆石放大鏡”是一個特殊的切面,它實現了EIP-2535中定義的以下接口:
facets()函數應該返回所有切面的地址和它們的四字節的函數選擇器。facetFunctionSelectors()函數應該返回一個特定切面所支持的所有函數選擇器。facetAddresses()函數應該返回一個鉆石所使用的所有切面地址。
facetAddress()函數應該返回支持給定選擇器的切面,如果沒有找到,則返回address(0)。請注意,不應該有一個以上的切面地址具有相同的功能選擇器。
鑒于鉆石代理將不同的函數調用委托給不同的實現合約,正確管理存儲槽以防止沖突是至關重要的。EIP-2535提到了幾種存儲槽管理方法。
動態 | 眾安科技與擎億科技合作推出區塊鏈鉆石溯源及交易平臺:眾安保險全資子公司眾安科技宣布,與生態伙伴擎億科技成立合資公司——上海鼎鉆信息科技有限公司(簡稱“鼎鉆科技”),推出區塊鏈鉆石溯源及交易平臺。[2018/8/6]
這個切面可以在結構中聲明狀態變量。這個切面可以使用任意數量的結構,每個結構有不同的存儲位置。每個結構在合約存儲中都有一個特定的位置。切面可以聲明他們自己的狀態變量,但不能與其他切面所聲明的狀態變量的存儲位置相沖突。EIP-2535中提供了一個樣本庫和鉆石存儲合約,如下圖所示:
App存儲是鉆石存儲的一個更專精的版本。這種模式被用來更方便、更容易地共享切面的狀態變量。一個App存儲結構被定義為包含一個應用程序所需的任意數量和類型的狀態變量。一個切面總是將AppStorage結構聲明為第一個也是唯一一個狀態變量,位于存儲槽的第0位。然后不同的切面可以從該結構中訪問變量。
此外也有其他的存儲槽管理策略,包括鉆石存儲和AppStorage的混合。比如有些結構在不同的切面之間共享,有些則是特定切面所特有的。在所有情況下,防止意外的存儲槽碰撞是非常重要的。
與透明代理和UUPS代理的比較
目前Web3開發者社區使用的兩種主要代理模式是透明代理模式和UUPS代理模式。在這一節中,我們簡要比較了鉆石代理模式與透明代理和UUPS代理模式。
印度鉆石公司開始引入區塊鏈技術:印度鉆石公司Dharmanandan和Hari Krishna已開始采用區塊鏈技術來提高供應鏈上鉆石的可追溯性。Dharmanandan與技術公司Everledger合作,將其鉆石跟蹤數據放入區塊鏈平臺,這將使他們能夠在一個不可變的平臺上記錄每一塊石頭的關鍵數據,包括其來源,交易和認證。而Hari Krishna已將區塊鏈納入其更新的移動應用程序中,供鉆石買家使用。此前加拿大盧卡拉鉆石集團收購了一家數字平臺,并準備利用區塊鏈技術解決鉆石供應鏈的問題。[2018/2/28]
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
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
曼昆區塊鏈法律
作者:@RileNFTs;編譯:白話區塊鏈永遠毀了 Web3 的名人?這些是有史以來最嚴重的加密騙局嗎? 今天給大家揭示一下那些名人是如何從他們的粉絲那里偷走1億美元的.
1900/1/1 0:00:00在過去的一個月內,加密行業在快速發展,OKX Ventures 見證了行業的快速發展:BTC 生態繼續快速發展,OKX 引入 BRC-30 的概念.
1900/1/1 0:00:00原文作者:Beehive Validator 原文編譯:深潮 TechFlow 目前,質押(Staking)是 DeFi 市場中最大的領域之一.
1900/1/1 0:00:00▌ARK Invest修改比特幣現貨ETF申請資料,或促使其先于貝萊德獲得審批機會彭博社高級ETF分析師Eric Balchunas發推稱.
1900/1/1 0:00:00作者:Nikhilesh De,CoinDesk;編譯:松雪,金色財經美國加密貨幣交易所 Coinbase 在針對監管機構訴訟的首次法律回應中聲稱.
1900/1/1 0:00:00來源:bitcoinist;編譯:區塊鏈騎士隨著法律網絡的持續收緊,美國檢察官要求對已倒閉的Crypto交易所FTX的創始人Sam Bankman-Fried進行一場單獨的審判.
1900/1/1 0:00:00