Conflux 开发教程 | 使用 IDE 开发 DApp 的实战操作指南

以下文章来源于黑曜石实验室 ,作者Obsidian Labs

一、简介

Conflux Studio 是一个帮助开发者快速开发 Conflux 智能合约的集成化开发环境。Conflux DApp 开发教程将使用 Conflux Studio 在 Oceanus 网络下开发一个简单的代币应用 Coin。

通过这个开发教程,你将会学习到如何进行 Conflux 智能合约的编写、调用,配置智能合约的代付以及如何使用 Web 前端项目与智能合约进行交互,从而实现一个包含前端和智能合约的完整的 DApp。

二、准备工作

2.1 安装 IDE

请在 GitHub 的下载页面

(github.com/ObsidianLabs/ConfluxStudio/releases) 下载 Conflux Studio。目前 Conflux Studio 支持 macOS 和 Linux 系统,请根据系统下载对应的版本。

正确安装 Conflux Studio 并初次启动后,Conflux Studio 将显示欢迎页面,根据提示完成 Docker, Conflux Node 以及 Conflux Truffle 的下载、安装及启动。

2.2 创建钱包

完成所有的安装步骤后,首先需要创建钥匙对来完成后续的合约部署以及调用。

在 Conflux Studio 的任意界面,点击应用左下⻆的钥匙图标,打开密钥管理器。点击 Create 按钮打开新钥匙对弹窗,输入钥匙对的名字并点击 Save 按钮。完成后将在密钥管理器中看到刚刚生成的钥匙对的地址。钥匙对由私钥和公钥组成,公钥在智能合约中也常被称作地址。

导出私钥可以通过点击每个地址后面的眼睛按钮打开查看私钥弹窗,弹窗显示地址以及私钥。后续教程中会需要通过管理器导出私钥。

为了顺利完成教程,首先需要创建三个钥匙对:

· minter_key 用于 Coin 合约部署时的签名,是这个教程中最常使用的钥匙对

· receiver_key 用于 Coin 合约接收转账,将在后文中介绍转账时用到

· sponsor_key 用于 Coin 合约代付功能,将在后文中介绍代付功能时用到

2.3 连接 Conflux 网络

教程将在 Oceanus 网络进行合约的部署以及合约的调用。点击顶部 Network 标签的倒三角打开下拉菜单,点击选择 Oceanus 网络进行切换。

切换完成后,可以在主页面中看到当前网络为 oceanus。页面左边包括了当前网络的节点 URL,Chain ID,TPS 信息,页面右边包含了当前网络区块的信息。

2.4 申请测试 CFX

点击顶部 Explorer 标签打开区块浏览器,并在地址栏粘贴钥匙对地址,可以在左边看到当前地址的 CFX 余额信息。

在区块链的世界中,大家通常将申请测试 Token 的方式称为 faucet,目前在 Oceanus 网络下每次 faucet 申请到的 Token 为 100 CFX。

获取 CFX 的方式有两种方式:

· 输入地址后点击地址栏右边的水龙头按钮,Conflux Studio 将为地址自动申请 CFX;

· 你也可以直接在浏览器中输入 wallet.confluxscan.io/faucet/dev/ask?address={address} 来申请 CFX;

使用上述方法在 Conflux Studio 中为 minter_key 和 sponsor_key 申请 CFX Token。完成申请后,这两个账户上的余额将会从 0 CFX 更新为 100 CFX。

目前余额信息为:

· minter_key 余额 100 CFX

· receiver_key 余额 0 CFX

· sponsor_key 余额 100 CFX

三、智能合约创建项目

3.1 创建项目

点击顶部左边的 Project 标签切换至项目列表页面,点击页面中的 New 按钮打开项目创建窗口,输入项目的名称并选择 coin 模版,点击 Create Project 完成项目的创建。

3.2 合约代码

Coin 合约是一个简单的代币合约,其中:

· 通过 mint 方法可以增发代币数量

· 通过 send 方法可以将一定数量的代币转账给别的用户,同时会在事件中记录下这笔转账的信息

· 通过 balanceOf 方法可以查询到指定账户地址的代币余额

· 通过 add_privilege 方法可以为合约添加代付白名单

· 通过 remove_privilege 方法可以为合约移除代付白名单

Conflux 智能合约使用 Solidity 语言进行开发,打开目录下的 contracts/Coin.sol 文件,这个是本项目的核心代码:

// 指定了 Solidity 的版本,通过 Pragmas(https://solidity.readthedocs.io/en/latest/layout-of-source-files.html#pragmas) 告诉编译器本代码可以兼容的版本为 0.5.0 到 0.7.0
pragma solidity >=0.5.0 <0.7.0;

// 导入 SponsorWhitelistControl 合约
import "./SponsorWhitelistControl.sol";

// 定义 Coin 的合约
contract Coin {
// 定义了两个 State Variables(https://solidity.readthedocs.io/en/latest/structure-of-a-contract.html#state-variables)
address public minter;
mapping (address => uint) private balances;

// 使用 SponsorWhitelistControl 合约连接系统合约
SponsorWhitelistControl constant private SPONSOR = SponsorWhitelistControl(address(0x0888000000000000000000000000000000000001));

// 定义了 `Sent` 的事件,定义了 from / to / amount 列
event Sent(address from, address to, uint amount);

// Coin 合约的 constructor ,在 constructor 中指定了 minter 的地址
constructor() public {
    // msg.sender 为部署合约时签名的账户地址,将这个地址赋值给 minter
    minter = msg.sender;
    }

// 定义 mint 方法,通过此方法来增发代币
function mint(address receiver, uint amount) public {
    require(msg.sender == minter);
    require(amount < 1e60);
    balances[receiver] += amount;
    }

// 定义 send 方法,通过此方法可以给别的账户转账代币
function send(address receiver, uint amount) public {
    require(amount <= balances[msg.sender], "Insufficient balance.");
    balances[msg.sender] -= amount;
    balances[receiver] += amount;
    // 通过 emit 触发 Sent 事件,记录这笔转账的信息
    emit Sent(msg.sender, receiver, amount);
    }

// 定义 balanceOf 方法,这是个 view 类型的方法,用于查询账户余额
function balanceOf(address tokenOwner) public view returns(uint balance){
  return balances[tokenOwner];
    }

// 定义了 add_privilege 方法,调用系统合约 add_privilege 方法添加地址到代付白名单
function add_privilege(address account) public payable {
    address[] memory a = new address[](1);
    a[0] = account;
    SPONSOR.add_privilege(a);
    }

// 定义了 remove_privilege 方法,调用系统合约 remove_privilege 从合约代付白名单中移除地址
function remove_privilege(address account) public payable {
    address[] memory a = new address[](1);
    a[0] = account;
    SPONSOR.remove_privilege(a);
    }
}

3.3 编译及部署合约

点击工具栏的 Build 按钮进行合约的编译,编译的结果将会保存在 build/Coin.json 文件中。

image

在部署合约前,首先需要确认在 Explorer 中选择合约部署所使用的地址,Conflux Studio 会使用这个地址将部署合约这笔交易进行签名(选择的方法为在 Explorer 的地址栏中输入地址)。在合约代码的 constructor 中,minter 被赋值为 msg.sender,这个 msg.sender 就是 Explorer 所选择的地址。

在此我们选择 minter_key 作为部署合约的签名者。

image

点击工具栏的部署按钮进行部署,部署完成后,部署结果会在 deploys 的 JSON 文件中,在这个文件中可以在 contractCreated 中找到当前合约部署的地址,后文中使用 contract_addr 来代表这个合约地址。

四、调用合约

点击顶部的 Contract 标签切换至合约页面,在地址栏输入 contract_addr 地址并加载合约。

合约页面由三个部分组成:

· 左边为合约调用区域

· 中间为合约数据查询区域

· 右边为事件查询区域

4.1 合约调用及查询

4.1.1 增发代币

点击合约调用的下拉菜单中选择 mint 方法,在下方的参数区域分别填入以下信息:

· receiver 接收代币的地址。填入 minter_key 地址

· amount 发行的代币总数。填入整数 1000

· Value 选填项,具体可查看 Value 详解。填 0 或者不填

· Signer 这笔交易的签名地址,如果没有开通代付功能,交易手续费将在这个账户地址中扣除,在合约代码中通过 msg.sender 获取到这个地址。填入 minter_key 地址

填写完成后点击执行按钮,Conflux Studio 将自动构造交易并推送到网络中。成功执行后可以在下方 Result 中看到这笔成功的交易。

4.1.2 查询代币余额

点击查询区域的下拉菜单并且选择 balanceOf 方法,这是在代码中定义的查询方法。在下方的 tokenOwner 填入 minter_key 地址并点击执行,就可以在下方的 Result 中看到 minter_key 账户的 Coin 代币的余额信息为 1000。使用同样方法可以查询到 receiver_key 账户的代币余额为 0。

4.1.3 转账代币

在合约调用区域选择 send 方法,在 Parameters 中分别填入:

· receiver 收款人地址。填入 receiver_key 地址

· amount 转账的代币数量。填入整数 200

· Signer 这笔交易的签名地址,代币转出的数量将会在这个账户中扣除。填入 minter_key 地址,

点击执行完成转账,再次查询代币余额可以看到 minter_key 账户只剩下 800 代币,而 receiver_key 账户则从 0 变成了 200 代币。

4.1.4 Value 参数

Conflux 智能合约的每个调用的方法都可以带上 Value 参数,这是一个可选的参数。如果带上了这个值,智能合约除了在执行这个方法的逻辑外,还会额外转 Value 中指定数量的 CFX token 到 receiver 账户,转账金额为 Value 中所填的值。有些智能合约的方法需要这个参数才可以完成调用,但是在 Coin 合约不需要这个参数。

后文中的代付功能将会使用到 Value 参数。

4.2 查询事件

在事件区域选择 Sent 并点击执行,下方的 Event Logs 可以看到转账的记录。Sent 事件的列都是由代码中的 Sent 事件的参数来定义的(其中 epoch 为事件发生的时间,这个为系统默认列)。在代码中定义了 Sent 方法的参数为 from, to 和 amount,分别对应了这笔转账的发起者地址,接受者地址以及转账的数量。

五、代付功能

Conflux Studio 支持 Conflux 系统合约提供的代付功能。

通过系统合约可以为别的合约设置代付功能,系统合约提供给了四个方法:

· add_privilege 添加合约代付白名单,在代付白名单中的地址调用该合约的方法时不需要付手续费,费用由代付账户支付。其中添加特殊地址 0x0000000000000000000000000000000000000000 代表为所有调用该合约的地址代付费用

· remove_privilege 移除合约代付白名单

· set_sponsor_for_collateral 设置合约储存费 (collateral for storage) 的代付账户及代付金额

· set_sponsor_for_gas 设置合约手续费 (gas fee) 的代付账户、代付金额及每笔交易代付金额上限

启用一个合约的代付需要设置代付的账户、代付金额及代付白名单。教程将会使用 Conflux Studio 通过系统合约设置代付账户及代付金额,通过 Coin 合约添加代付白名单。设置完成后,minter_key 账户调用 Coin 合约的方法时将不会被扣除手续费,手续费由 sponsor_key 账户代付。

5.1 设置代付账户及代付金额

在 Conflux Studio 中访问系统合约地址

0x0888000000000000000000000000000000000001,在合约调用区域能看到前文中提及的四个设置代付的方法。

选择 set_sponsor_for_collateral 方法,该方法有三个参数:

· contract_addr 设置代付的合约地址。填入 contract_addr

· Value 设置代付金额。填入整数 40

· Signer 代付账户地址。填入 sponsor_key 地址

填好以上参数并执行运行,系统合约将为 Coin 合约设置好储存费代付账户,此时 sponsor_key 账户将会被扣除 40 CFX。

选择 set_sponsor_for_gas 方法,该方法有四个参数:

· contract_addr 设置代付的合约地址。填入 contract_addr

· upper_bound 设置每笔交易代付的上限。填入 1000000000000

· Value 设置代付金额。填入整数 40

· Signer 代付账户地址。填入 sponsor_key 地址

填好以上参数并再次执行运行,系统合约将为 Coin 合约设置好手续费代付账户,此时 sponsor_key 账户将会再次被扣除 40 CFX。

完成这两个方法的调用后 Coin 合约代付账户便设置好了,sponsor_key 账户将为 Coin 合约的手续费和储存费各提供为 40 CFX Token 的代付服务。由于目前代付白名单中并没有账户地址,因此还需要添加白名单地址才能完成代付设置。

5.2 添加代付白名单

在 Coin 合约中集成了设置代付白名单的方法,通过调用此方法可以添加或删除代付白名单。

在 Conflux Studio 中访问 contract_addr 合约,选择 add_privilege 方法:

· account 添加白名单的地址。填入 minter_key 地址

· Value 不填

· Signer 这笔交易的签名地址。填入 minter_key 地址

运行后就成功设置了代付白名单了,至此 Coin 合约的代付功能设置好了。

5.3 代付测试

在进行代付测试前,先查询并记录下 minter_key 账户的 CFX 余额。例如本教程中,minter_key 的初始余额为 97.6210937497093952 CFX。

回到 Coin 合约调用页面,再次调用 mint 方法并使用 minter_key 地址增发代币 1000,完成代币增发后再次查询 minter_key 的余额,仍然为 97.6210937497093952 CFX。

可以看到增发代币的这笔交易,原本应该由 minter_key 账户支付的手续费,变成了由 sponsor_key 账户支付。

六、前端项目

前端项目源码可以前往 Conflux 前端。

6.1 预备

6.1.1 下载项目并安装依赖

· 下载前端项目:git clone github.com/ObsidianLabs/conflux-frontend-react

· 使用 npm install 或者 yarn 进行项目依赖安装

6.1.2 Conflux Fluent 的安装及配置

Conflux Fluent 是由 Conflux 提供的浏览器插件,目前提供了 Chrome 及 Edge 的支持,用户可以使用 Conflux Fluent 进行私钥的管理以及交易签名。

Fluent 钱包将兼容 Portal Provider 一段时间,Dapp 可以继续以调用 Portal 的方式调用Fluent,预计到 2022年3月31号,之后将不再继续支持。强烈建议 Dapp 在此窗口期完成升级,至少Fluent 的支持(同时对 Portal 和 Fluent 的支持当然更好)。若无法迁移将无法继续使用 fluent,但可以继续正常使用 Portal。

前往 Conflux Fluent GitHub 下载安装。项目的源代码在 GitHub 中可以找到。

在这里需要将 Conflux Studio 中生成的地址导入到 Conflux Fluent 中。完成插件安装后,在 Conflux Fluent 的页面中点击右上角菜单栏,进入 账户管理,点击右上角 添加,进入 新增账户 页面,点击 导入私钥,将 Conflux Studio 中的 minter_key 的私钥(在创建钱包章节中介绍了如何将私钥导出)粘贴到输入框中,点击 导入 按钮完成私钥导入。

6.2 运行前端项目

在运行项目之前,需要修改一些默认的环境变量。

在前面的教程中部署合约后会生成一个 contractCreated,这个值便是部署在网络中智能合约的地址。打开项目根目录并找到 .env 文件,这个文件提供了项目的环境变量,将 REACT_APP_CONFLUX_COIN_ADDRESS 的值修改为 contract_addr。

使用 yarn start 启动前端项目,开发服务器运行起来后会在浏览器中打开前端页面(如果没有打开,请在浏览器中访问 localhost:3000)。

项目运行起来后,页面将显示四个卡片信息,分别为:

· 左上角 Conflux 网络信息模块

· 右上角 Conflux Portal 模块

· 左下角 Coin 合约模块

· 右下角 SponsorWhitelistControl 合约模块

6.2.1 连接 Conflux Fluent

点击右上角组件中的 Connect to Conflux Portal 按钮,Conflux Fluent 页面将被打开,输入密码和选择账户后完成连接。连接成功后,将会在按钮下看到当前连接的账户地址以及账户中的 CFX 余额。

image

6.2.2 运行 Coin 合约代币增发和代币转账操作

左下角的组件为 Coin 合约组件,可以通过这个组件调用代币增发和代币转账功能。

· 代币增发:选择 mint 方法并在 receiver 中填入增发地址 minter_key 地址和在 amount 中填入增发代币的数量 100,点击 Push Transaction,在弹出的 ConfluxPortal Notification 窗口中点击 Confirm 按钮来确认交易。

· 代币转账:选择 send 方法并在 receiver 中填入收款人地址 receiver_key 地址和在 amount 中转账代币的数量 20,点击 Push Transaction,在弹出的 ConfluxPortal Notification 窗口中点击 Confirm 按钮来确认交易。

image

6.2.3 查看 Coin 合约中的余额

选择 balanceOf 方法并在 tokenOwner 输入框中填入查询的地址,点击 Query Data 按钮可以查询到账户的余额。

image

6.2.4 查看 Sent 事件

选择 Sent 事件并点击 Query Data 可以查询到转账操作所触发的转账事件的记录。

6.3 前端项目解析

项目使用 React 进行开发。主要由三大部分组成:视图组件、js-conflux-sdk 以及 Conflux Portal。

项目根目录下的 .env 环境变量,在这里定义了两个环境变量,分别为:

· REACT_APP_CONFLUX_NODE_RPC:Conflux 的网络节点地址,目前默认为 Oceanus 网络的地址

· REACT_APP_CONFLUX_COIN_ADDRESS:已部署的 Coin 智能合约地址

6.3.1 视图组件

视图组件在项目的 src/components 中,其中 App.js 为页面的主入口,负责页面的排列及合约信息的读取。

ConfluxNetwork.js

负责渲染 Conflux 网络信息,Node URL 的值为 .env 环境变量文件下的 REACT_APP_CONFLUX_NODE_RPC 设置的值(默认为 Oceanus 网络)。

ConfluxPortal.js

负责渲染 Conflux Portal 的连接信息,并提供了连接 Conflux Portal 的交互按钮。

· connectConfluxPortal 调用 Conflux Portal 的 enable 方法启用 conflux (conflux portal 实例由浏览器插件注入到 windows.portal 中),完成 enable 后调用 getAccount 方法获取到 Portal 中的账户。

· refreshBalance 调用 Conflux SDK 的 getBalance 方法来更新账户余额信息

· renderPortalButton 根据当前不同的状态,渲染连接 Portal 的按钮

ConfluxContract.js

负责渲染 Conflux 合约信息,本项目中提供了 Coin 和 SponsorWhitelistControl 两个合约。

ConfluxContract.js 由三个组件组成,分别为:

· ConfluxContract 负责根据传入的合约 abi 来渲染合约的信息,包括合约地址、合约方法和事件,合约提交的交互逻辑及显示执行后的结果

· ContractMethods 负责渲染合约 abi 中的方法和事件的表单及相对应的按钮

· ConfluxForm 负责根据方法或事件的 abi 来渲染输入表单

lib

lib 在项目的 src/lib 中,这里的文件主要是为视图提供包括连接网络、构造交易、获取账户、读取合约等服务。

七、总结

在本开发教程中,我们学习了如何使用 Conflux Studio 来完成一个完整的 Coin DApp 开发,其中包括了:

· 使用钥匙对管理器创建账户及导出账户私钥

· 切换 Oceanus 网络,查看网络信息

· 账户申请 CFX Token

· 创建、编译并部署项目

· 解析 Coin 合约代码,学习如何编写合约的读写方法及事件

· 使用合约浏览器调用 Coin 合约的代币增发、转账、查询余额及查询事件

· 设置并使用智能合约的代付功能

· 将私钥导入 Conflux Portal 并连接前端项目

· 在前端项目中调用 Coin 合约的代币增发、转账、查询余额及查询事件

· 解析前端项目代码,学习如何通过 Conflux Portal 和 Conflux JavaScript SDK 连接网络并实现交易

八、关于 Conflux Bounty

Conflux 基金会为了鼓励用户参与生态建设,提供了 Conflux Bounty 赏金平台。通过完成 Bounty 赏金平台发布的各项任务,参与者可以获得 FC (Fans Token) 作为奖励。

8.1 FC 的价值

FC,全称 Fans Coin,是由 Conflux 基金会与社区成员共同研发的生态代币,用于记录和感谢对 Conflux 生态建设做出贡献的社区成员。FC 目前在 Oceanus 上运行,Conflux 基金会承诺,在主网上线后,锁定和未锁定的 FC 都可以与主网 CFX 进行 1:1 承兑,以此保障所有社区成员的劳动成果都可以获得奖励。

FC 赏金分配方案会展示在赏金任务详情页中,包括最高奖金数量、奖金分配人数、奖金数量分布、排行名次确定方式等信息。账号余额中的赏金奖励可以随时申请提现至 Conflux 钱包。Conflux 团队会对所有的提现申请进行审核。

对于已经通过的提现申请,Conflux 团队会在每周二中午 12 点(如遇节假日,往后顺延至下一个工作日)进行提币操作。完成提币操作后,您的 Conflux 钱包将会收到您提现的赏金奖励。

8.2 Bounty 的价值

Conflux Bounty (https://bounty.conflux-chain.org) 的宗旨是为每一个通证找到价值。Bounty 分为几个板块:技术、品牌、社群、资源、其他等。

· 技术板块:分为产品、SDK、教程、开发、测试等;主要是奖励社区的一些技术资源贡献者。

· 品牌板块:分为文案、设计、视频、媒体、推广等;主要是奖励在各大网络平台分享 Conflux 的各种最新动态,扩大 Conflux 的生态影响力的活跃贡献者;

· 社群板块:分为活动、推广等;主要是奖励举办各种 Conflux 相关线上线下活动,帮助解答社群问题,活跃日常气氛等。

· 资源板块:分为政务、商务、人力等;主要是奖励为生态中引进企业资源,扩建 Conflux 生态等。

· 其他板块:分为周边、采购等;主要是奖励一些其他的零散任务。

Conflux Studio 下载地址和更新日志:

Conflux dApp 开发教程:

Conflux dApp 教程相关建议:

微信公众号链接

https://mp.weixin.qq.com/s/j3ktQRMZl9MOZJ5ON-m53A