一个等效ping的EOS智能合约

这篇文章是为帮助EOS智能合约开发人员从初级到生产而发布的一系列帖子中的第一篇。有关本教程的完整代码,可以访问github存储库

随着对EOS的所有兴奋而来的,对于大多数希望参与其中的开发人员仍然充满挑战的领域是开始使用智能合约。新开发人员通常需要克服两个障碍:获取工具和设置,并了解如何编写智能合约本身。

EOS智能合约是用C++编写的,并编译成Web Assembly。Dan Larimer选择C++来利用其类型和模板系统,这使得更安全的合约,并补充说,因为智能合约的运行时间很短,大多数内存问题都会消失。

配置

使用EOS的部分挑战是设置本地区块链。幸运的是,EOS为设置本地EOS环境提供了一些基础。对于本指南,我们将使用EOSIO Dawn 3.0。

该指南的摘要可以压缩为几个关键命令:

1
2
3
4
5
6
$ git clone https://github.com/EOSIO/eos --recursive
$ cd eos
$ ./eosio_build.sh
$ cd build && make install
$ cd programs/nodeos
$ ./nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin --access-control-allow-origin=*

安装需要一些时间,但很简单。一旦在本地启动并运行本地EOS区块链,就可以开始了工作了。在整个指南中,我们将引用一些实用程序,如cleoseosiocpp。 你可以在eos/programs文件夹中找到这些内容。

建立ping智能合约

在本教程中,我们将创建和部署分布式系统的“Hello World”:ping/pong。对于没有经验的人,我们将向服务器发送一个“ping”命令,它将以“pong”响应。 智能合约由以下几个部分组成:C++代码,ABI(应用程序二进制接口)和基于C++代码的WAST(Web程序集文本文件)。这是看起来像:

实现ping

在我们完成工具环境设置之后,让我们进入合约!要编写ping智能合约,我们只需要一个实现一个操作的合约:ping。所有这些方法需要做的就是打印“Pong”作为响应。

在contract中创建一个名为ping的文件夹,并在ping/ping.cpp文件中创建一个文件:

1
2
3
4
5
6
7
8
9
10
11
12
#include <eosiolib/eosio.hpp>
#include <eosiolib/print.hpp>

class ping_contract : public eosio::contract {
public:
using eosio::contract::contract;
void ping(account_name receiver) {
eosio::print("Pong");
}
};

EOSIO_ABI( ping_contract, (ping) )

这里有一个简单的小例子,你可以测试,以便更熟悉。让我们分解这里发生的事情:

  • 我们包含一些定义来写我们的合同。
  • 我们创建了一个继承自eos::contract的新合约类。
  • 我们创建了一个打印“Pong”的方法。
  • 最后一行是最近添加的宏,它通过基于我们传递给第二个参数的方法生成一个来节省我们维护自己的手写ABI的工作量。

构建合约

EOS块生成器在执行智能合约时不运行C++代码,他们期望web-assembly。EOS提供了一个名为eosiocpp的工具,用于将C++代码转换为Web Assembly Text。我们现在就这样做eosiocpp -o ping.wast ping.cpp。这一步将产生一些警告,但我们现在可以忽略这些警告。

接下来,我们需要应用程序二进制接口。基本上,你的智能合约的ABI将描述方法及其相应的签名。由于我们在文件的末尾添加了EOSIO_ABI宏,而不手动编写,我们可以使用以下命令生成它:eosiocpp -g ping.abi ping.cpp

此时,您的文件夹应如下所示:

1
2
3
├── ping.abi
├── ping.cpp
└── ping.wast

部署到本地网络

现在我们拥有了智能合约所需的所有资源,让我们来部署它。确保你有一个钱包创建了cleos wallet create并确保它通过运行cleos wallet unlock并在提示时键入你的钱包密码来解锁。我们将在另一个帐户下部署我们的智能合约。

为此,我们需要创建一个新的密钥对,让我们通过运行:cleos create key来实现。这将为你生成随机的公钥和私钥。在本教程的其余部分中,请务必使用你刚刚收到的值替换文中的[public_key]/[private_key]。

将私钥导入当前未锁定的帐户钱包:cleos wallet import [private_key],使用公钥设置合约帐户:cleos create account eosio ping.ctr [owner_key:public_key] [active_key:public_key]

将合约与新创建的帐户链接,ping.ctr ../ping -p ping.ctr

与ping交互

一旦部署了新合约,就可以与它进行交互了!让我们使用相同的密钥创建一个测试人员帐户来运行交易:cleos create account eosio tester [public_key] [public_key]

现在我们可以在命令行上测试它:

1
2
3
4
$ cleos push action ping.ctr ping '["tester"]' -p tester
executed transaction: e89ebeaad8f3623e42d966f62d4d0adbf6a7412b6bb4d7be61f04a22d3cd485e 232 bytes 102400 cycles
# ping.ctr <= ping.ctr::ping {"account":"tester"}
>> Received ping

应该可以了!

这对我们的程序员来说是令人兴奋的,但是大多数用户都不会设置他们的命令行来与你的智能合约进行交互。因此,让我们将这种互动带到他们更熟悉的界面:他们的浏览器。

通过浏览器进行交互

要从前端与EOS交互,我们将使用EOS.js. 由于我们在EOS支持上使用dawn3,我们需要确保在安装时使用dawn3分支:npm install eosjs @ dawn3。

我们从配置开始:

1
2
3
4
5
6
Eos = require('eosjs')

eos = EOS.Localnet({
keyProvider: ['{replace_with_your_private_key}'],
httpEndpoint: 'http://127.0.0.1:8888'
})

配置完成后,我们必须指定一些细节:

1
2
3
4
5
eos.contract('ping.ctr').then((contract) => {
contract.ping("tester", { authorization: ['tester'] }).then((res) => {
console.log(res)
})
})

请注意ping.ctr,它与我们之前部署的合约的名称相匹配。一旦我们获取了合约接口(或ABI),我们就可以与它进行交互,就好像它是本机Javascript一样。合约返回一个promise,其中包含resolve函数中包含的交易详细信息。这是从前端与我们的ping智能合约进行交互的核心思想。

要使用工作示例在更大的上下文中查看此内容,请查看此github存储库中的前端代码

======================================================================

分享一个交互式的在线编程实战,EOS智能合约与DApp开发入门

EOS教程

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

  • web3j教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • 以太坊教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和事件等内容。
  • C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和事件等。
  • php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。

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