请选择 进入手机版 | 继续访问电脑版
投稿
 找回密码
 注册

QQ登录

只需一步,快速开始

布道财经 资讯 查看内容

本体技术视点|Python智能合约教程之合约升级

2019-9-18 15:04| 发布者: 新的财富| 查看: 353| 评论: 0

摘要: 01 导语在上一期的技术视点中,我们介绍了合约原生API,讲述了如何利用智能合约进行ONT/ONG转账。本期我们将讨论如何通过UpgradeAPI来进行合约升级。合约升级共有2个API,分别为 Destroy和 Migrate。其用法如下: ...

01 导语

在上一期的技术视点中,我们介绍了合约原生 API,讲述了如何利用智能合约进行ONT / ONG 转账。本期我们将讨论如何通过 Upgrade API 来进行合约升级。合约升级共有2个 API,分别为 Destroy和 Migrate。其用法如下:640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1下面我们具体讲述一下这两个 API 的使用方法。在这之前,小伙伴们可以在本体智能合约开发工具 SmartX 中新建一个合约,跟着我们进行操作。跟以前的 API 讲解一样,在文章最后我们将给出这次讲解的视频示例。

02 Upgrade API 使用方法

使用这两个函数前需要引入。下面两条语句分别引入了 Migrate 和 Destroy 这两个函数。

S6G4lk82X2Qb0o2V88tiKyr5uoaAA9m0Fy4jwFZX.png

2.1 Destroy API

Destroy API 用于销毁合约,旧合约将会在链上被删除。下面是使用该 API 的示例代码。

WEViC4EU6WgmdEeDZ3rLNUIDKAS92CBC1pq32rI1.png

在 SmartX 上可以看到该示例代码的运行结果:

  1. 将以上代码粘贴至 SmartX 编译并部署;

  2. 再次点击部署会弹出「合约部署失败,该合约已经部署过」,因为链上已经存在相同合约;

640?wx_fmt=jpeg&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1

  3.运行 destroy_contract 函数销毁合约;

640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1

4. 再次点击部署合约,会发现合约可以再次部署,不会再弹出「合约部署失败,该合约已经部署过」。这可以证明原先合约已经在链上被销毁。

2.2  Migrate API

Migrate API 用于迁移合约, 旧合约将会被新合约取代,旧合约中的数据也将自动迁移到新合约。迁移数据量越大,迁移费用越高。迁移成功后,旧合约会被删除。特别注意:合约中的资产不会被自动迁移,需要提前转走。否则该合约中的资产将无法取回,相当于被转入黑洞地址。Migrate 函数的传入参数列表如下:

640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1

同样,我们给出使用 Migrate 函数的合约示例代码:

RB4P0948BKttBJ6koqI6tlwX8y1DUcpctC7DUSuW.pngkdf9dJUEPz5XoAGY5d4WmS1zF6uXEzFMNuNVR7jT.png

在 SmartX 上可以看到该示例代码的运行结果:

  1. 将以上代码粘贴至 SmartX 编译,填入参数。参数填入时需要特别注意以下两点:

    a. 要确认 avm_code 在链上不存在,不然会报错;

    b. Migrate 需要较高的 gas limit,所以运行函数时要调整 gas limit。

640?wx_fmt=jpeg&tp=webp&wxfrom=5&wx_lazy=1&wx_co=12. 部署成功后,可以从控制台拿到新的合约哈希。该示例中,be4606c4663081b70f745ed9fc64d4c3b0d9c183 即为新的合约哈希。640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1

03 结论

本次技术视点中我们介绍了本体区块链的 Upgrade API,开发者可以用来进行合约升级。合约升级共有2个 API,其中 Destroy API 用于销毁合约,Migrate API 用于迁移合约。希望教程会对大家有帮助。下一期我们将介绍本体 Python 智能合约语法的 Static & Dynamic Call API,讲述如何在 Python 智能合约中进行静态调用和动态调用。以下为本期教程的中文视频,欢迎小伙伴们观看学习。