本教程主要面向初阶开发人员，目的在于带领大家以最简单的示例合约，通过简单但不失完整的流程，体验整个合约的编译、发布与调用过程，从而让大家从直观角度有个清晰的概念认识。
在进行帐户注册时，需要事先提供一对公私钥地址，以便在注册帐号时进行绑定使用。可通过EOS Key Generation网站进行公私钥地址生成。
通过Jungle2.0 - EOS Test Network Monitor (CryptoLions.io)网站进行EOS帐户的创建
点击图中标红create account, 在弹出界面中，填写事先生成的公钥地址
见上图中，需要填写三个信息，其中account name主要用于填写我们易于记忆的帐户名称，但其帐户名称长度只允许12位长度，且其组成字符也只能从a-z, 1-5以及一个点符号组成。
至于owner public key和 active public key分别对应该帐户owner权限和active权限。如果从安全角度讲，两个权限所对应的公钥地址应该设置成不一样的，这样当active private key丢失的时候，可以使用ower权限对active权限对应的公钥地址进行更换。因为ower和active权限是有层次关系的，只允许低级权限对下次权限进行操作。在不丢失ower私钥的情况下，也可以实现对ower权限地址的更换操作。
点击create, 创建成功后，会显示如下信息
在Jungle2.0 - EOS Test Network Monitor (CryptoLions.io)页面，点击菜单栏中的Faucet按钮，会弹出如下界面
在Jungle2.0 - EOS Test Network Monitor (CryptoLions.io)页面，点击菜单栏中的account info按钮，弹出如下界面：
填写帐号名称后，点击get按钮, 便可以查到该用户的EOS余额及公钥地址信息。
本步骤将使用EOS所提供的cdt开发工具包完成对简单示例合约的编译工作。
1）在本地安装eosio-cpp工具命令
brew tap eosio/eosio.cdt //增加仓库
brew install eosio.cdt //安装工具包注： 可使用eosin-cpp --help命令来查看所有参数说明
> eosio-cpp --help
OVERVIEW: eosio-cpp (Eosio C++ -> WebAssembly compiler)
USAGE: eosio-cpp [options] <input file> ...
OPTIONS:
Generic Options:
-help - Display available options (-help-hidden for more)
-help-list - Display list of available options (-help-list-hidden for more)
-version - Display the version of this program
compiler options:
-C - Include comments in preprocessed output
-CC - Include comments from within macros in preprocessed output2）编写简单示例合约(helloworld.cpp)
#include <eosiolib/eosio.hpp>
using namespace eosio;
class [[eosio::contract]] hello : public contract {
public:
using contract::contract;
[[eosio::action]]
void hi( name user ) {
print( "Hello, ", user);
}
};
EOSIO_DISPATCH(hello, (hi))
3）进行合约编译，生成abi合约描述文件及wasm合约文件
eosio-cpp -abigen 'contracts/hello.cpp' -o 'contracts/hello.wasm' --contract 'hackdappcom1'编译完成后，会生成hello.abi、hello.wasm两个文件。
在chrome浏览器中安装Chrome 网上应用店 - scatter插件
导入私钥地址
针对测试网绑定身份
访问内存交易 - 钱包 - EOSX - Fastest EOS Block Explorer网站，绑定scatter帐号
购买RAM
购买CPU与NET资源
如果你没有事先购买RAM资源，可以会提示以下错误信息
{
"code": 500,
"message": "Internal Service Error",
"error": {
"code": 3080001,
"name": "ram_usage_exceeded",
"what": "Account using more than allotted RAM usage",
"details": [
{
"message": "account hackdappcom1 has insufficient ram; needs 26318 bytes has 5471 bytes",
"file": "resource_limits.cpp",
"line_number": 213,
"method": "verify_account_ram_usage"
}
]
}
}为了方便大家的操作，特提供了一个发布合约的示例工程
1）克隆示例工程:
git clone git@github.com:hackdapp/learn_eos.git将之前编写的示例合约，放在工程目录contracts下
2）编辑配置文件deploy.js和package.json
//file: deploy.js
const eos = require('./utils/eossdk')({
chainId: "e70aaab8997e1dfce58fbfac80cbbb8fecec7b99cf982a9444273cbc64c41473",
httpEndpoint: "http://jungle2.cryptolions.io:80",
keyProvider: "5JxqGao9rzXWBUDnNzALyxaFdmZYXiZ46EzHL4sJkHkryzCFKxu", //可改为自己的私钥地址
authorization: 'hackdappcom1@active',//可以改为自己的eos帐户
broadcast: true,
sign: true
})
const {deployContract} = require('./utils/deploy')
deployContract(eos, { account: "hackdappcom1", contractDir: "./contracts" }).then((result) => {
console.log(`Deployment successful`, JSON.stringify(result, null , 4))
})
.catch(err => {
console.error(`Deployment failed`, err)
})同时，还需要再编辑package.json
//package.json
{
"name": "learn_eos",
"version": "1.0.0",
"description": "快速体验EOS入门合约",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"build": "eosio-cpp -abigen 'contracts/hello.cpp' -o 'contracts/hello.wasm' --contract 'hackdappcom1'", //根据自己的情况修改合约名称 --contract '合约帐户名'
"deploy": "node index.js"
},
"repository": {
"type": "git",
"url": "git+https://github.com/hackdapp/learn_eos.git"
},
"author": "",
"license": "ISC",
"bugs": {
"url": "https://github.com/hackdapp/learn_eos/issues"
},
"homepage": "https://github.com/hackdapp/learn_eos#readme",
"dependencies": {
"eosjs": "^16.0.9"
}
}3）合约发布
npm run deploy显示Deployment successful, 则表示发布合约成功。
const eos = require('./utils/eossdk')({
chainId: "e70aaab8997e1dfce58fbfac80cbbb8fecec7b99cf982a9444273cbc64c41473",
httpEndpoint: "http://jungle2.cryptolions.io:80",
keyProvider: "5JxqGao9rzXWBUDnNzALyxaFdmZYXiZ46EzHL4sJkHkryzCFKxu",
authorization: 'hackdappcom1@active',
broadcast: true,
sign: true
})
const data = {
actions: [
{
account: 'hackdappcom1',
name: 'hi',
authorization: [{
actor: 'hackdappcom1',
permission: 'active'
}],
data: {"user": "lisa"}
}
]
}
eos.transaction(data).then((result)=>{
console.log(JSON.stringify(result.processed.action_traces[0].console, null, 4))
}).catch((err)=>{
console.log(err)
})运行调用命令
node index.js运行结果如下
"Hello, 111"
通过本章的学习以及自我动手实践，了解在测试网上如何进行私钥生成以及帐号注册，学会如何使用eosio-cpp命令编译示例合约以及通过脚本进行合约的发布及测试的完整操作流程。
| 帐户名 | 公钥 | 私钥 |
|---|---|---|
| hackdappcom1 | EOS6LTWfM5ffbmjUhvwFnrU5QEBrmkzsRo2eXogr2h9oP8DUuzgAi | 5JxqGao9rzXWBUDnNzALyxaFdmZYXiZ46EzHL4sJkHkryzCFKxu |
| hackdappcom2 | EOS6qCqbFLuYK5rGK9LDPzcboLqy4phrUxLXLrhLgXxVBpzLzsJke | 5Jnw2anG8Zzy6MuCNxvwmaX5Hu4B6de1uzuae5QyRrUFtyfL2Wo |
| hackdappcom3 | EOS57B3rxRBBUiTyZf9iBxsWyQnvEhq2H95wbBbjdzcLbV1gfJ4zy | 5Ju2NNc24q3jQ2Yc2JcvwWjtGVeAyuWcNsaNVb37u7cmRW56zgc |
| hackdappcom4 | EOS7i5Diz2uqXSpvutmV4DftBRrL1XASzxsSdWBGrgzngPoXhT2dk | 5K6nyWMvpfYnQqLhS545dm53exduJgDBLHMYQ6SCNaPmeHjGZdr |
| hackdappcom5 | EOS6NcaFvvoekuBjhZLsBVywiMcN7VTVmgvAdA5srgTvQMeDmdiAH | 5JjN9efKokkgZYno2qjbE9C7WCGbVpPvgNArKDvcjbDic2pRGCS |
- https://nadejde.github.io/eos-token-sale/
- http://monitor.jungletestnet.io/#home
- https://jungle.eosx.io/tools/ram/buy?symbol=10
- https://github.com/hackdapp/learn_eos
在教程中如出现错误🐛或不易理解的知识点，欢迎加我微信指正! Name: zhangliang | WeChat: rushking2009 | Mail: zhangliang@cldy.org