智能合约升级模式介绍 — 入门篇

以太坊最大的优势就是,每一笔用来转账、部署合约或者和合约交互的交易(事务)都被存在一个叫做区块链的公共账本上。一旦交易发生,就再也无法隐藏或者改变。这带来一个巨大的好处,就是在以太坊中的每一个节点都可以去验证任意一笔交易的合法性和当前状态。这使得以太坊成为一个非常健壮的去中心化系统。

但是随之而来的是,它还有一个最大的缺点,就是智能合约一旦部署之后,就再也无法改变源码。开发中心化应用(比如facebook或者Airbnb)的开发者,都已经习惯了,为了修复bug或者引入新的特性而频繁更新产品。但这种方式却不适用以太坊。

还记得当面Parity多签名钱包被黑导致150000以太币被偷的恶劣事件吗?在整个攻击中,就因为钱包中的一个bug导致很多巨额钱包的资金被清空。而唯一的解决方案就是尝试以比黑客更快的速度,利用相同的漏洞攻击剩余的钱包,来把以太币重新分配给它们合法的所有者。

要是有一种方法可以在智能合约部署之后,还能对它们进行升级,那该多好...

引入代理模式

尽管想升级已经部署的智能合约中的代码是不可能的,但是可以通过设计一个代理合约结构,这个结构可以让你可以通过新部署一个合约的方式,来实现升级主要的处理逻辑的目的。

代理结构模式就像下面这张图一样:所有消息通过一个代理合约来间接调用最新部署的逻辑合约。如果想要升级的话,只需要部署一个新的合约,然后在代理合约中更新引用新的合约地址就可以了。

1Proxy0

作为实现zeppelin_os的一部分,zeppelin正致力于实现集中代理模式。目前已经探索出来的有下面三个:

  1. 继承存储模式 Inherited Storage
  2. 永久存储模式 Eternal Storage
  3. 非结构化存储模式 Unstructured Storage

所有三种模式都依赖低阶的delegatecall。尽管solidity提供了一个delegatecall方法,但它只能返回true或者false来显示调用是否成功,而不是允许你操作返回的数据。

在我们深入了解之前,理解两个关键的概念很重要:

  • 当调用一个合约中并不支持的的方法时,就会调用合约中的fallback方法。你可以自己写一个fallback函数来处理这种场景。代理合约就是用自定义的fallback方法将调用重定向到其他合约实现。
  • 每当合约A授权对另一个合约B的调用时,它就会在合约A的上下文中执行合约B的代码。这就意味着msg.valuemsg.sender的值会被保留。并且对存储的修改将会作用在合约A的存储上。

zeppelin的代理合约,为了可以返回调用逻辑合约后的结果,实现了自己的delegatecall方法,所有模式都是这样。如果你想要使用zeppelin的代理合约代码,你就要理解代码的每一个细节。让我们先来看看它是如何发挥作用的,以及理解为了达到目的它所使用的assembly操作码。

 assembly {
    let ptr := mload(0x40)
    calldatacopy(ptr, 0, calldatasize)
    let result := delegatecall(gas, _impl, ptr, calldatasize, 0, 0)
    let size := returndatasize
    returndatacopy(ptr, 0, size)

    switch result
    case 0 { revert(ptr, size) }
    default { return(ptr, size) }
 }

为了授权对另一个合约中方法的调用,我们需要把它赋值给proxy合约接收的msg.data。因为msg.databytes类型的,是一个动态的数据结构,所以它在msg.data的第一个字(word,也就是32个字节)中的存储长度会不一样。如果我们想要只取出真正的数据,我们需要跳过第一个字(word),从msg.data0x20(32个字节)开始。然而,我们会用到两个操作码来实现此目的。我们会使用calldatasize来获取msg.data的大小,以及calldatacopy来把它复制到ptr所指向的位置。

注意到我们是如何初始化ptr变量的。在solidity中,内存槽中的0x40位置是和特殊的,因为它存储了指向下一个可用自由内存的指针。每次当你想往内存里存储一个变量时,你都要检查存储在0x40的值。这就是你变量即将存放的位置。现在我们知道了我们要在哪儿存变量,我们就可以使用calldatacopy,把大小为calldatasize的calldata从0开始啊复制到ptr指向的那个位置了。

let ptr := mload(0x40)
calldatacopy(ptr, 0, calldatasize)

我们再看看下面的assembly代码(使用delegatecall操作码)

let result := delegatecall(gas, _impl,  ptr, calldatasize, 0, 0)

解释一下上面的参数:

  • gas:函数执行所需的gas
  • _impl:我们调用的逻辑合约的地址
  • ptr:内存指针(指向数据开始存储的地方)
  • calldatasize:传入的数据大小
  • 0:调用逻辑合约后的返回值。我们没有使用这个参数因为我们还不知道返回值的大小,所以不能把它赋值给一个变量。我们可以后面可以进一步使用returndata操作码来获取这些信息。
  • 0:返回值的大小。这个参数也没有被使用因为我们没有机会创造一个临时变量用来存储返回值。鉴于我们在调用其他合约之前无法知道它的大小(所以就无法创造临时变量呀)。我们稍后可以用returndatasize操作码来得到这个值。

下面一行代码就是用returndatasize操作码得到了返回数据的大小:

let size := returndatasize

我们使用这个返回值的大小,来把返回值复制到ptr指向的内存,使用returndatacopy来达到这个目的:

returndatacopy(ptr, 0, size)

最后,switch语句要么返回 【返回值】,要么抛出错误,如果发生错误的话。

storage_proxy

很好,我们现在有了一个从逻辑合约中获取正确结果的方法。

现在,我们理解了代理合约是如何工作的。下面就让我们正式学习三种模式:继承存储模式、永久存储模式和非结构化存储模式。

这三种方法用不同的方法来解决同一个难点:怎样确保逻辑合约不会重写/覆盖代理中的状态变量。

任何代理结构模式的主要问题就是如何分配存储。记住,既然我们使用一个合约来存储,另一个合约来实现逻辑,它们中的任何一个都有可能重写一个已经使用的存储槽。这意味着如果代理合约有一个状态变量在某个存储槽中存储着最新的逻辑合约地址,但是逻辑合约却不知道的话,那么逻辑合约可能就会在那个槽中存一些其他数据,这样就把代理合约中的重要信息覆盖了。zeppelin的这三种方法代表了架构合约系统的三种途径,实现通过代理模式升级合约的目的。

使用继承存储模式升级

继承存储方法要求逻辑合约内部也实现代理合约内的存储结构。代理合约和逻辑合约都要继承完全一样的存储结构,来确保二者都支持存储必要的代理合约的状态变量。

当探索这种模式时,我们有这样一个想法,我们想要有一个Registry合约来追踪不同版本的逻辑合约。 为了升级成新的逻辑合约,你需要为它在Registry里注册一个新的版本,并且要求代理合约中也升级成这个最新版本的逻辑合约。注意到有一个Registry合约并不影响存储机制,实际上,它可以应用到这篇文章中提到的任意一种存储模式中。

inherit_storage

如何初始化

  1. 部署Registry合约
  2. 部署一个逻辑合约的最初版本(V1),确保它继承了Upgradeable合约
  3. Registry合约中注册这个最初版本(V1)的地址
  4. 要求Registry合约创建一个UpgradeabilityProxy实例
  5. 调用你的UpgrageabilityProxy实例来升级到你最初版本(V1)

如何升级

  1. 部署一个继承了你最初版本合约的新版本(V2),==确保它保留了代理合约和最初版本逻辑合约中的存储结构==
  2. Registry中注册合约的新版本
  3. 调用你的UpgradeabilityProxy实例来升级到最新注册的版本

tips

我们可以在未来部署的逻辑合约中升级现有方法、创造新的方法以及新的状态变量,但仍然调用同一个UpgradeabilityProxy合约。

使用永久存储模式升级

在永久存储模式中,存储模式用一个独立的合约(代理和逻辑合约都要继承这个合约)来定义。这个存储合约保留了所有逻辑合约需要的状态变量,因为代理合约也会知道这些变量的存在(因为继承),它就可以为升级定义自己的状态变量,不用考虑覆盖变量这些问题。注意到所有的版本的逻辑合约都不可以再定义任何额外的状态变量。所有版本的逻辑合约都必须一直使用一开始就定义好的永久存储架构。

这种应用在zeppelin labs项目中提供了实现,并且同时引入了代理所有权的概念。一个代理的所有者是唯一一个可以升级代理并指定一个新的逻辑合约的地址,也是唯一一个可以转移所有权的地址。

eternal_storage

如何初始化

  1. 部署一个EternalStorageProxy实例
  2. 部署一个逻辑合约的最初版本(V1)
  3. 调用EternalStorageProxy实例来升级到这个最初版本合约的地址
  4. 如果你的逻辑合约依赖自己的构造函数(constructor)来设置某个初始状态,那么在它和代理合约产生联系之后,之前的这些状态就要重新修改,因为代理合约的存储并不知道(逻辑合约里的)这些值。EternalStorageProxy有一个叫upgradeToAndCall的函数专门来调用一些逻辑合约中的方法,一旦代理合约升级到最新版本时,就把连接到的那个逻辑合约里的初始设置重新设置一遍。

如何升级

  1. 部署一个逻辑合约的最新版本(v2),确保它也包含永久存储结构。
  2. 调用EternalStorageProxy实例来升级到最新版本。

tips

这是没有增加太多开销同时很直观的逻辑合约。 以后的逻辑合约可以升级现有的方法或者创造新的方法,但是不能引入新的状态变量。

使用非结构化存储升级

非结构化存储模式和继承存储类似,但是不要求逻辑合约继承任何和升级相关的状态变量。这个模式使用代理合约中定义的非结构化的存储槽来保存升级所需的数据。

在代理合约中,我们定义了一个常量,每当哈希的时候,就给出一个足够随机的存储位置来存储代理合约需要调用的逻辑合约的地址。

bytes32 private constant implementationPosition = 
                     keccak256("org.zeppelinos.proxy.implementation");

因为常量(恒定)状态变量并不占用存储槽,所以并不用担心implementationPosition会不小心被逻辑合约占用。鉴于solidity在存储中放置状态变量的方法,依然有非常非常非常小的概率可能发生要存储新变量的存储槽已经被占用了。

通过使用这种模式,任何版本的逻辑合约都不需要知道代理合约的存储结构,但是所有后一个版本的逻辑合约都必须继承上一个版本的存储变量。就像在继承存储模式中一样,未来的逻辑合约可以更新现有的方法,也可以创建新的方法和新的状态变量。

这个模式也使用了代理合约所有权的概念。只有代理合约的所有者可以更新逻辑合约的地址,也是唯一可以转移所有权的地址。

unstructured_storage

如何初始化

  1. 部署OwnedUpgradeabilityProxy实例
  2. 部署逻辑合约的初始版本(V1)
  3. 调用OwnedUpgradeabilityProxy实例来更新到初始版本的逻辑合约
  4. 如果你的逻辑合约依赖自己的构造函数(constructor)来设置某个初始状态,那么在它和代理合约产生联系之后,之前的这些状态就要重新修改,因为代理合约的存储并不知道(逻辑合约里的)这些值。OwnedUpgradeabilityProxy有一个upgradeToAndCall方法专门来调用一些逻辑合约中的方法,一旦代理合约升级到最新版本时,就把连接到的那个逻辑合约里的初始设置重新设置一遍。

如何升级

  1. 部署一个新版本的逻辑合约(V2),确保它继承了上一个版本里的状态变量结构。
  2. 调用ownedUpgradeabilityProxy实例来升级到新版本合约的地址。

tips

这个方法很棒,因为它不需要逻辑合约知道它是整个代理系统的一部分。

关于升级

重要:如果你的逻辑合约依赖自己的构造器来设置一些初始状态的话,这个过程在新版本的逻辑合约注册到代理中时需要重新做一遍。举个例子,逻辑合约继承Zeppelin中的Ownable合约,这很常见。当你的逻辑合约继承Ownable,它也就继承了Ownable的构造器,构造器会在合约创建的时候就设置合约的所有者是谁。当你让代理合约来使用你的逻辑合约的时候,代理合约是不知道逻辑合约的所有者是谁的。

升级代理合约的一种常见的模式就代理立即对逻辑合约调用一个初始化方法。这个初始化方法应该去模仿在构造器中做的一些事情。同时你也想要一个标识,用来确保你不可以再次对同一个逻辑合约调用初始化方法。(只能调用一次)

你的逻辑合约看上去可能像下面这样:

contract Token is Ownable {
   ...
   bool internal _initialized;
   
   function initialize(address owner) public {
      require(!_initialized);
      setOwner(owner);
      _initialized = true;
   }
   ...
}

当然这取决于你的部署策略,你可以写一个帮助部署的合约,或者你可以可以单独部署代理合约和逻辑合约。如果你单独部署的话,你需要使用upgradeToAndCall把代理合约链接到逻辑合约上,这看上去就会像下面这样:

const initializeData = encodeCall('initialize', ['address'], [tokenOwner])
await proxy.upgradeToAndCall(logicContract.address, initializeData, { from: proxyOwner })

结论

代理模式的概念已经出来有一段时间了,但是由于太复杂了、害怕引入安全漏洞以及绕过了区块链不可变的特性,它还没有被广泛接受。过去的解决方法在关于未来版本的逻辑合约可以添加和修改的东西上有严格的限制,这很不灵活。但是很显然,开发者对于可升级合约的需求很迫切。zeppelin提供并且测试了三种模式,他们致力于帮助开发者架构自己的项目,引入可升级特性。

尽管代理模式的概念出来也有段时间了,但是它的应用依然处在非常早期。很开心看到越来越多的高级DApp架构通过这种方式得以实现。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,490评论 18 139
  • 本文翻译自:https://github.com/ConsenSys/smart-contract-best-pr...
    tolak阅读 4,854评论 4 21
  • 盘空顶上山风烈,独立崖边解愁眠。 穷目四顾茫茫然,莫辨身处仙与俗。 拂袖可揽云中月,踏步直入凌霄殿。 鹤唳声声如贯...
    牧笛少年阅读 224评论 0 0
  • 我在桥上看风景 手里举着相机 桥上的人不知 争着摆姿势 殊不知 我的心里只有你 等待的只是你的到来 撑着遮阳伞 你...
    拾穗的时光阅读 104评论 0 1
  • 雪怕太阳,草怕霜。 人怕没钱,情怕伤! 花怕凋零,田怕荒。 心怕欺骗,友怕诓! 你没用了,远离你的人就多了, 这就...
    王路柯阅读 1,051评论 0 0