python智能合约编程 -- 智能合约之helloworld

这章从一个简单的hello,world的例子来介绍如何去编写一个python智能合约。

每一个智能合约由两部分组成，代码和ABI。代码可以是python代码，也可以是C/C++代码，当然也可以是其它任意支持的代码。代码最终会被编译成bytecode被运行，如果是C/C++代码，则要事先通过编译生成wast文件。而python代码则是在pyeos内部编译的，不需要事先编译，当然后面可能会支持事先编译好的python代码。ABI是Application Binary Interface的简写，用于定义智能合约的结构，这样用户才能通过发送ts的方式和智能合约打交道。

下面是helloworld智能合约的代码，可以从hello这个目录获取

hello.py

import eoslib

def init():
    print('hello,world')

def sayHello():
        print('read message:', eoslib.read_message())

def apply(name, type):
    if type == eoslib.N('sayhello'):
        sayHello()

简单介绍下，这个python代码里有两个预定义的函数，init和apply。

1. init函数只会在智能合约发布的时候调用，在这个函数里可以作些智能合约的初始化工作，如设置总token的数量。这里只是简单的打印hello,world，以表示代码被调用了。
2. apply是调用智能合约代码的入口，两个参数都是64位的无符号整数，分别用于代表调用智能合约的账号的名称和调用的类型名称。
   64位的无符号整数是从一个不大于13个字符的字符串转换过来的，并且字符限定在下面列出的字符范围之内。

.12345abcdefghijklmnopqrstuvwxyz

也就是只能是小写的26个字母，外加“12345”和“.”一共32个字符。

eoslib.N函数可以把这样的字符串转化成无符号的64位整数

下面来看下智能合约的ABI文件。

hello.abi

{
  "actions": [{
      "action": "sayhello",
      "type": "bytes"
    }
  ]
}

这个ABI文件非常简单，真正的ABI文件要比这个复杂得多。参考hello.py的代码就可以很好理解这个abi文件了。
"action": "sayhello"表示要触发的动作名称为sayhello，这在python代码里可以对应一个函数,在hello.py里有对这个动作进行判断并调用sayHello函数。

def apply(name, type):
    if type == eoslib.N('sayhello'):
        ...

这个动作的参数为bytes类型，参数在智能合约里通过eoslib.read_message来读取，

接下来看下如何将这个智能合约发布到eos的区块链上并调用智能合约。这里默认已经按照python智能合约编程 -- 在python中调用Eos API的步骤创建了钱包并且已经解锁，私钥已经导入了钱包。

先创建名称为hello的智能合约账号：

key1 = 'EOS61MgZLN7Frbc2J7giU7JdYjy2TqnfWFjZuLXvpHJoKzWAj7Nst'
key2 = 'EOS5JuNfuZPATy8oPz9KMZV2asKf9m8fb2bSzftvhW55FKQFakzFL'
r = eosapi.create_account('inita', 'hello', key1, key2)

再调用eosapi.set_contract函数将代码发布到区块链上，set_contract
要指定代码文件和abi文件。注意文件路径是相对于build/programs目录而言的。

r = eosapi.set_contract('hello','../../programs/pyeos/contracts/hello/hello.py','../../programs/pyeos/contracts/hello/hello.abi', 1)

最后来看下如何调用智能合约。

r = eosapi.push_message('hello','sayhello','hello,world',['hello'],{},rawargs=True)

push_message的六个参数分别是：

1. 账号名称
2. 要调用的action
3. action的参数
4. scope，表面意思即为范围，用于指定代码允许操作的数据范围。在后面的文章里会有详细讲解其作用。
5. 要使用的权限， 里没有指定，最经常使用的是active权限。
6. 指定参数的类型，默认是一个dict类型，用于代表一个在abi文件中指定的类型。底层代码里根据这个dict类型通过abi文件中指定的结构将dict里的值转换成二进制数据，这里rawargs=True表示原始数据，不进行转换。

执行这行代码后会看到有下面的打印输出

read message: b'hello,world'

到此，本章结束。下章开始介绍智能合约中要用到的几个重要函数。