可可金融旗下CoCo交易所开放上币申请通道

本体技术视点:Python智能合约教程之原生合约调用 | 火星号精选

本体Ontology·热度: 11582
原生合约调用最典型的功能就是合约转账,这也是整个智能合约最核心的部分。

01 导语

上一期我们介绍了本体 Python 智能合约的合约执行 API,本期我们将讨论如何通过 Native API 来进行本体原生合约调用。原生合约调用最典型的功能就是合约转账,这也是整个智能合约最核心的部分。Native API 只有1个 API。用法如下:

同时,使用 Invoke 函数需要内建的 state 函数辅助来封装参数,用法如下:

下面我们具体讲述一下这两个 API 的使用方法。在这之前,小伙伴们可以在本体智能合约开发工具 SmartX 中新建一个合约,跟着我们进行操作。跟以前的API讲解一样,在文章最后我们将给出这次讲解的所有源代码以及视频讲解。

02 Native API 使用方法

同样,使用这两个函数前需要引入。下面两条语句分别引入了这两个函数。

    from ontology.interop.Ontology.Native import Invokefrom ontology.builtins import state


    2.1 本体原生合约列表

    目前,本体可供使用的原生合约有六个。以下就是可以使用 Native API 调用的原生合约列表:

    在合约中,将合约地址转成 bytearray 形式传入 Invoke 即可。例如,需要调用 ONT Token 合约时,可以先将 ONT Token 合约对应的地址转成相应的 bytearray 形式,再进行相应的 Invoke 函数调用。在进行 Invoke 函数调用时,传入的参数分别为版本号,合约地址,调用的合约方法以及 state 函数封装的转账相关参数。这里特别要注意的一点是,在进行 ONG 的合约转账时,所填数量是实际数量的10^9倍。 即,如果需要转10个 ONG,那么数量需要填为10^10。而在采用 ONTO 或者 Cyano 等钱包转账时,所填数量即为转账数量。

      contract_address_ONT = bytearray(b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01')param = state(from_acct, to_acct, ont_amount) # 参数为转出地址,转入地址, 转账金额res = Invoke(1, contract_address_ONT, 'transfer', [param])

      2.2 转账合约代码

      下面我们给出一个完整的示例,演示如何使用 Python 语言来实现 ONT 以及 ONG 的转账功能。下述代码以传入的转出账户和转入地址参数类型为string为例实现该合约。另外,也可以以address为类型的账户参数进行传递,从而达到节省调用Gas费用的目的。该合约代码流程如下:

      1. 定义合约地址变量 contract_address_ONT,contract_address_ONG;

      2. 将转出地址和转入地址从 base58 格式转成 bytearray 格式;

      3. 验签,确认转出地址与合约调用地址为同一地址;

      4. state 函数封装转账相关参数;

      5. Invoke 函数调用 ONT Token 和 ONG Token 原生合约转账;

      6. 通过返回 res 判断转账是否成功。返回值 b'\x01' 为成功,成功则推送事件“transfer succeed”。

        from ontology.interop.System.Runtime import Notify, CheckWitnessfrom ontology.interop.Ontology.Runtime import Base58ToAddressfrom ontology.interop.Ontology.Native import Invokefrom ontology.builtins import state
        # contract address contract_address_ONT = bytearray(b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01')contract_address_ONG = bytearray(b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02')
        def Main(operation, args): if operation == 'transfer': from_acct = args[0] to_acct = args[1] ont_amount = args[2] ong_amount = args[3] return transfer(from_acct,to_acct,ont_amount,ong_amount) return False

        def transfer(from_acct, to_acct, ont_amount, ong_amount): # 将base58地址转换成 bytearray格式地址 from_acct=Base58ToAddress(from_acct) to_acct=Base58ToAddress(to_acct) # 验签,调用方必须与转出地址为同一地址 if CheckWitness(from_acct): # ONT转账 if ont_amount > 0: param = state(from_acct, to_acct, ont_amount) # state函数用于封装转账相关参数 res = Invoke(1, contract_address_ONT, 'transfer', [param]) # invoke调用ONT token原生合约转账 if res and res == b'\x01': Notify('transfer succeeded') else: Notify('transfer failed') # ONG转账,流程同上 if ong_amount > 0: param = state(from_acct, to_acct, ong_amount) res = Invoke(1, contract_address_ONG, 'transfer', [param]) if res and res == b'\x01': Notify('transfer succeeded') else: Notify('transfer failed') else: Notify('CheckWitness failed')

        03 SmartX 实践

        接下来,小伙伴们可以在 SmartX 上进行操作,动手编译和运行上述提供的合约示例代码。具体步骤如下:1. 编译合约。首先在 SmartX 中新建一个合约项目,并将代码放入该项目中进行编译。

        2. 部署合约。部署过程中如需申请测试币,申请地址为https://developer.ont.io/applyOng。部署结果示意如下:

        3. 执行转账。执行 transfer 函数进行转账前需要进行相关参数设置。在该示例中,需要填入发送地址、接收地址、代转账的 ONT 数量以及 ONG 数量:

        4. 转账成功。当转帐参数设置正确时,执行 transfer 函数将转账成功。上面所填的接收地址中将显示出收到的代币:

        04 总结

        本次技术视点中我们介绍了本体区块链的 Native API,开发者可以使用 Native API 来进行本体原生合约调用。原生合约调用最典型的功能就是合约转账,这也是整个智能合约最核心的部分。在下一期技术视点中,我们将介绍 Upgrade API,探讨如何在本体智能合约中进行合约升级。本期讲述的所有语法部分我们提供了中文视频,小伙伴们可以观看学习。

        复制链接到浏览器观看视频教程:https://v.qq.com/x/page/r0830erkp8b.html

        声明:本文为入驻“火星号”作者作品,不代表火星财经官方立场。
        转载请联系网页底部:内容合作栏目,邮件进行授权。授权后转载时请注明出处、作者和本文链接。 未经许可擅自转载本站文章,将追究相关法律责任,侵权必究。
        提示:投资有风险,入市须谨慎,本资讯不作为投资理财建议。
        语音技术由科大讯飞提供
        最近更新
        本文来源:本体Ontology
        原文标题:
        涨跌幅
        排名币种成交额价格(USD)涨幅
        您可能感兴趣的内容
        暂无内容

        评论0