【摘要】 上一期我们介绍了本体 Python 智能合约的合约执行 API，本期我们将讨论如何通过 Native API 来进行本体原生合约调用。原生合约调用最典型的功能就是合约转账
上一期我们介绍了本体 Python 智能合约的合约执行 API，本期我们将讨论如何通过 Native API 来进行本体原生合约调用。原生合约调用最典型的功能就是合约转账，这也是整个智能合约最核心的部分。Native API 只有1个 API。用法如下：
同时，使用 Invoke 函数需要内建的 state 函数辅助来封装参数，用法如下:
下面我们具体讲述一下这两个 API 的使用方法。在这之前，小伙伴们可以在本体智能合约开发工具 SmartX 中新建一个合约，跟着我们进行操作。跟以前的API讲解一样，在文章最后我们将给出这次讲解的所有源代码以及视频讲解。
02 Native API 使用方法
同样，使用这两个函数前需要引入。下面两条语句分别引入了这两个函数。
from ontology.interop.Ontology.Native import Invoke
from 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, CheckWitness
from ontology.interop.Ontology.Runtime import Base58ToAddress
from ontology.interop.Ontology.Native import Invoke
from 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，探讨如何在本体智能合约中进行合约升级。（Sheldon）