EOS开发从智能合约开始(二)——通证Token合约介绍

Eosio.token、Exchange 和 Eosio.msig 智能合约

本教程假定你已经完成了EOS开发从智能合约开始(一)

在这个阶段,区块链没有做太多的事情,现在我们来部署eosio.token。该合约允许创建许多不同的通证(token,也有叫令牌的,以下直接用token),这些token都在同一个合约上运行,但可能由不同的用户管理。

在部署 token 合约之前,我们必须创建一个用来部署它的帐户,代码如下:

1
2
3
4
$ cleos create account eosio eosio.token \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
...

然后我们可以所部署合约中找到它:

1
${EOSIO_SOURCE}/build/contracts/eosio.token

然后:

1
2
3
4
5
6
7
$ cleos set contract eosio.token build/contracts/eosio.token -p eosio.token@active
Reading WAST...
Assembling WASM...
Publishing contract...
executed transaction: 528bdbce1181dc5fd72a24e4181e6587dace8ab43b2d7ac9b22b2017992a07ad 8708 bytes 10000 cycles
# eosio <= eosio::setcode {"account":"eosio.token","vmtype":0,"vmversion":0,"code":"0061736d0100000001ce011d60067f7e7f7f7f7f00...
# eosio <= eosio::setabi {"account":"eosio.token","abi":{"types":[],"structs":[{"name":"transfer","base":"","fields":[{"name"...

创建 Exchange 合约

你可以查看智能合约eosio.token的定义,如contracts/eosio.token/eosio.token.hpp

1
2
3
4
5
6
7
8
9
10
void create( account_name issuer,
asset maximum_supply );


void issue( account_name to, asset quantity, string memo );

void transfer( account_name from,
account_name to,
asset quantity,
string memo );

要创建新的token,我们必须用适当的参数调用create(...)。此命令将使用最大标识符号来唯一地标识(其实就是注册)tokens列表中这一个新建的token。创建者将有权发行,或执行其他操作,如冻结,召回,和列入所有者白名单。

使用地址参数调用此方法的简单办法:

1
2
3
4
$ cleos push action eosio.token create '[ "eosio", "1000000000.0000 SYS"]' \
-p eosio.token@active
executed transaction: 0e49a421f6e75f4c5e09dd738a02d3f51bd18a0cf31894f68d335cd70d9c0e12 120 bytes 1000 cycles
# eosio.token <= eosio.token::create {"issuer":"eosio","maximum_supply":"1000000000.0000 SYS"}

或者,使用命名参数调用此方法:

1
2
3
4
5
$ cleos push action eosio.token create \
'{"issuer":"eosio", "maximum_supply":"1000000000.0000 SYS"}' \
-p eosio.token@active
executed transaction: 0e49a421f6e75f4c5e09dd738a02d3f51bd18a0cf31894f68d335cd70d9c0e12 120 bytes 1000 cycles
# eosio.token <= eosio.token::create {"issuer":"eosio","maximum_supply":"1000000000.0000 SYS"}

此命令创建了一个新的 token 名称为 SYS,其精度为4位小数,最大供应量为 1000000000.0000 SYS。

为了创建这个token,我们需要eosio.token合约的许可,因为owns即它对代币注册表有所有权(例如SYS)。该合约的未来版本可以允许其他各方自动购买这些各种名称的代币。出于这个原因,我们必须通过-p eosio.token@active来授权此调用。

将代币发送到“User”帐户中

现在我们已经创建了token,发行者可以向我们先前创建的帐户用户发出新的token。如果你没有创建一个名为“User”的帐户,请参阅这里的说明。

我们将使用参数调用约定(vs named args)。

1
2
3
4
5
6
7
8
9
$ cleos push action eosio.token issue '[ "user", "100.0000 SYS", "memo" ]' \
-p eosio@active
executed transaction: 822a607a9196112831ecc2dc14ffb1722634f1749f3ac18b73ffacd41160b019 268 bytes 1000 cycles
# eosio.token <= eosio.token::issue {"to":"user","quantity":"100.0000 SYS","memo":"memo"}
>> issue
# eosio.token <= eosio.token::transfer {"from":"eosio","to":"user","quantity":"100.0000 SYS","memo":"memo"}
>> transfer
# eosio <= eosio.token::transfer {"from":"eosio","to":"user","quantity":"100.0000 SYS","memo":"memo"}
# user <= eosio.token::transfer {"from":"eosio","to":"user","quantity":"100.0000 SYS","memo":"memo"}

这次输出,包含几个不同的操作:一个发送和三个转移。虽然我们签署的唯一操作是发送,但发送操作执行了“内联转移”,“内联转移”通知发送者和接收者账户。输出指示被调用的所有操作处理程序,调用它们的顺序,以及操作是否生成任何输出。

从技术上讲,eosio.token合约可以跳过“内链转移”,并选择直接修改余额。然而,在这种情况下,eosio.token遵循我们的token约定,该约定要求所有帐户余额可由引用它们的转移操作的总和来推导。还要求通知资金发送方和接收方,以便他们能够自动处理存款和取款。

如果你想查看发送的实际交易,可以使用-d选项显示“不发送”和“将交易返回为JSON格式”。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
$ cleos push action eosio.token issue '["user", "100.0000 SYS", "memo"]' -p eosio@active -d -j
{
"expiration": "2018-05-25T19:02:58",
"ref_block_num": 18200,
"ref_block_prefix": 614206268,
"max_net_usage_words": 0,
"max_cpu_usage_ms": 0,
"delay_sec": 0,
"context_free_actions": [],
"actions": [{
"account": "eosio.token",
"name": "issue",
"authorization": [{
"actor": "eosio",
"permission": "active"
}
],
"data": "00000000007015d640420f00000000000453595300000000046d656d6f"
}
],
"transaction_extensions": [],
"signatures": [
"SIG_K1_Khyk1GsxWCx4axqYMF2AREDvaZtZdFaQifNPkR9DomR7toJ4sGua7pMBNq2osV5TY8rcGNcgNwn1eFe3noAXsoUA26HNDJ"
],
"context_free_data": []
}

将代币发送到帐户“tester”

现在该帐户user有token,我们会将一些代币发送给帐户tester。 我们指定user使用权限参数-p user@active授权此操作。

1
2
3
4
5
6
7
$ cleos push action eosio.token transfer \
'[ "user", "tester", "25.0000 SYS", "m" ]' -p user@active
executed transaction: 06d0a99652c11637230d08a207520bf38066b8817ef7cafaab2f0344aafd7018 268 bytes 1000 cycles
# eosio.token <= eosio.token::transfer {"from":"user","to":"tester","quantity":"25.0000 SYS","memo":"m"}
>> transfer
# user <= eosio.token::transfer {"from":"user","to":"tester","quantity":"25.0000 SYS","memo":"m"}
# tester <= eosio.token::transfer {"from":"user","to":"tester","quantity":"25.0000 SYS","memo":"m"}

部署交易EXchange合约

与上面显示的示例类似,我们可以部署 Exchange 合约。Exchange 合约提供了创建和交易货币的能力。假设这是从EOSIO源代码的根目录运行的。

1
2
3
4
5
6
7
8
9
10
11
12
13
$ cleos create account eosio exchange  \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
executed transaction: 4d38de16631a2dc698f1d433f7eb30982d855219e7c7314a888efbbba04e571c 364 bytes 1000 cycles
# eosio <= eosio::newaccount {"creator":"eosio","name":"exchange","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJxe...

$ cleos set contract exchange build/contracts/exchange -p exchange@active
Reading WAST/WASM from build/contracts/exchange/exchange.wasm...
Using already assembled WASM...
Publishing contract...
executed transaction: 503dddec456ae301ef467c6a05bc6bf61e1ea21ab911ef6cc6e0750001b675c8 33888 bytes 5841 us
# eosio <= eosio::setcode {"account":"exchange","vmtype":0,"vmversion":0,"code":"0061736d0100000001bb022f60067f7e7f7f7f7f00600...
# eosio <= eosio::setabi {"account":"exchange","abi":"0e656f73696f3a3a6162692f312e30010c6163636f756e745f6e616d65046e616d650e0...

部署Eosio.msig合约

eosio.msig合约允许多方异步签署单个交易。EOSIO本身具有多重签名(multisig)基础支持,但它需要一个同步通道,主要是进行数据传送和签名。Eosio.msig是一种对用户更加友好方式,可以在多方同意的情况下异步提议,批准并最终发布交易。

以下步骤可用于部署eosio.msig合约:

1
2
3
4
5
6
7
8
9
10
11
12
$ cleos create account eosio eosio.msig  \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 \
EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4
# eosio <= eosio::newaccount {"creator":"eosio","name":"eosio.msig","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJ...

$ cleos set contract eosio.msig build/contracts/eosio.msig -p eosio.msig@active
Reading WAST/WASM from build/contracts/eosio.msig/eosio.msig.wasm...
Using already assembled WASM...
Publishing contract...
executed transaction: 3433c434bdef42ba2150d5df46c17e0258f20b7836a057911faa2daa66262338 8864 bytes 1319 us
# eosio <= eosio::setcode {"account":"eosio.msig","vmtype":0,"vmversion":0,"code":"0061736d010000000198011760017f0060047f7e7e7...
# eosio <= eosio::setabi {"account":"eosio.msig","abi":"0e656f73696f3a3a6162692f312e30030c6163636f756e745f6e616d65046e616d650...

另:《EOS智能合约与DApp开发入门》教程已经上线,爱学习等不及的可以抓紧体验一下:

EOS教程

本教程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用React和EOS的各知识点完成一个便签DApp的开发。

  • web3j教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • 以太坊教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和事件等内容。

汇智网原创翻译,转载请标明出处。原文