本文基于墨客区块链(MOAC BlockChain),使用moac网页版钱包部署ERC-20合约。
环境:
墨客区块链版本:MOAC-pangu0.8.2;
节点版本:MOAC-pangu0.8.2-windows.exe;
操作系统:64位Windows 10家庭版。
1.安装并启动本地节点
1.1 安装moac节点
请参考文档《第三篇 墨客区块链(MOAC BlockChain)节点安装教程》。
1.2 启动moac节点
打开命令终端(cmd),转到墨客当前目录,在命令行中执行:
D:\moacPangu0.8.2-win>moac --rpc --rpccorsdomain "http://wallet.moac.io"
备注:
--rpc 启动RPC服务,本机访问节点
--rpccorsdomain 启动浏览器访问服务,非本机访问节点
"http://wallet.moac.io" moac在线钱包网址,会自动连接到本机启动的moac节点并显示已有账号,如果本机节点没有启动,会显示以下提示信息。
启动正常,会显示以下账号信息。确保其中一个账号有足够的moac以进行智能合约部署。
2.编写并编译智能合约
2.1 以下为基于erc-20编写的一个代币合约
本文实际测试代码TestToken20.sol附在文章末尾。
注意:该代码为测试实例使用,非标准部署智能合约代码。
2.2 编译、部署合约
在网页钱包点击合约按钮“CONTRACTS”
然后点击部署新合约按钮“DEPLOY NEW CONTRACT”
选择一个有moac余额的账号。
把自己编写的智能合约代码放进代码区“Solidity contract source code”,该代码会自动进行编译,如果编译通过,右侧会显示"Select contract to deploy"。
如果编译没有通过,则不会显示相应内容。
在“Select contract to deploy”下拉框选择相应的token类型,本例为“Token Demo”,下面会自动弹出参数输入框,主要包括四项:
1、initial Amount - 256 bits unsigned integer //token发行总量,本例为"10000"
2、token Name - String //token名称,本例为"KongFuZi Token"
3、decimal Units - 8 bits unsigned integer //token最小单位是小数点后第几位
4、token Symbol - String //token简称,本例为"KFZT"
在选择gas费用后,点击"DEPLOY"部署合约。此时会显示发布合约确认界面。
如果提示需要解锁(发送代币的)账户,进入moac命令行界面,输入命令:
>personal.unlockAccount(mc.accounts[0], "passwd", 300)
该命令共有三个参数:
第一个参数表示解锁的账户,
第二个参数是该账户的密码,
第三个参数是解锁时间,本例为300秒,300秒后会重新锁住账户;
如果解锁时间设为0,表示一直解锁,此时账号有风险,慎用。
为了隐藏密码,可以输入命令:
>personal.unlockAccount(mc.accounts[0])
回车后提示输入密码,此时密码不显示出来,该命令默认将账户解锁300秒。
成功解锁会返回true。此时会显示发布合约确认界面。
注意:Data里必须有数据,否则不能正常部署
点击“OK”,开始部署合约,界面下方会显示当前部署合约的进度条
点击成功部署的合约,可以看到基本内容,包括合约地址hash、被写入的区块号等。
登录moac区块链浏览器:http://explorer.moac.io/home。在tokens下拉框选择“View ERC20”。
在搜索栏输入合约地址,可以搜索到该合约的相应内容。
点击进去,可以看到合约基本信息、Token Transfers和Token Holders信息。
注意:该步骤可能需要已经有交易才能在浏览器查询。
至此,可以确认合约部署成功。
3.token的交易
3.1 查看合约状态
点击部署完毕的合约进度条上的“Test Token (管理页面)”,进入合约管理界面。
管理界面的上半部分显示基本信息,顶部是合约地址,右边有通用功能按钮。主要包括:接收墨客和token、浏览器查看、拷贝地址、二维码和显示接口。
点击“浏览器查看”,会跳转到区块浏览器并自动显示合约查询结果界面。
点击“显示接口”,跳出如下界面,显示“合约JSON接口”。提示如果有其他人需要管理或操作这个智能合约,则需要把接口内容连同合约地址一并发送给他。
管理界面的下半部分显示合约自身功能。
其中左边显示合约的读操作,本例中主要包括name、发行总量等。
右边为对合约的写操作,除非有自己定义的功能,对于erc-20合约不经常用到。
3.2 查看token
点击进入钱包的“CONTRACT”界面,会自动在查看合约(WATCH CONTRACT)和查看通证(WATCH TOKEN)显示所有本节点部署的合约和token。点击均可以进入相应管理和查看界面。
在账户界面,也能看到每个账户拥有的token情况。
进入发行该智能合约的主账户MAIN ACCOUNT,会显示token信息,及该账户拥有的token余额等。
3.3 交易
从钱包里拥有KFZT token的主账户,点击“SEND”进入发送交易界面。
填入要接收的账户(“TO”)、选择要发的代币名称(“KongFuZi Token”)、填入要交易的token数量(“AMOUNT”),点击“SEND”
显示发送信息界面。
此处如果提示需要解锁账户,参考前面2.2节的unlockAccount命令。
交易成功后会看到FROM账号token数量减少。
而TO账号相应token数量增加。
4.增加token
点击主界面右上角“CONTRACTS”。
选择最下面的“WATCH TOKEN”增加需要查看token。弹出增加界面。
输入合约地址,然后点击“OK”,会在界面自动增加该token,如果节点的账号拥有该token,也会自动显示出来。
附件:
本文所用合约代码TestToken20.sol。
注意:该代码为测试实例使用,非通用智能合约代码。
pragma solidity ^0.4.16;
contract Token{
function balanceOf(address _owner) public constant returns (uint256 balance);
function transfer(address _to, uint256 _value) public returns (bool success);
function transferFrom(address _from, address _to, uint256 _value) public returns (bool success);
function approve(address _spender, uint256 _value) public returns (bool success);
function allowance(address _owner, address _spender) public constant returns (uint256 remaining);
event Transfer(address indexed _from, address indexed _to, uint256 _value);
event Approval(address indexed _owner, address indexed _spender, uint256 _value);
}
contract TokenDemo is Token {
uint256 public totalSupply; //发行总量
string public name; //名称,例如"My test token"
uint8 public decimals; //返回token使用的小数点后几位。比如如果设置为3,就是支持0.001表示.
string public symbol; //token简称,like MTT
function TokenDemo(uint256 initialAmount, string tokenName, uint8 decimalUnits, string tokenSymbol) public {
totalSupply = initialAmount * 10 ** uint256(decimalUnits); // 设置初始总量
balances[msg.sender] = totalSupply; // 初始token数量全部给予合约的创建者
name = tokenName;
decimals = decimalUnits;
symbol = tokenSymbol;
}
function transfer(address _to, uint256 _value) public returns (bool success) {
//默认totalSupply 不会超过最大值 (2^256 - 1).
//如果随着时间的推移将会有新的token生成,则可以用下面这句避免溢出的异常
require(balances[msg.sender] >= _value && balances[_to] + _value > balances[_to]);
require(_to != 0x0);
balances[msg.sender] -= _value; //从消息发送者账户中减去token数量_value
balances[_to] += _value; //往接收账户增加token数量_value
Transfer(msg.sender, _to, _value); //触发转币交易事件
return true;
}
function transferFrom(address _from, address _to, uint256 _value) public returns (bool success) {
require(balances[_from] >= _value && allowed[_from][msg.sender] >= _value && _value > 0);
balances[_to] += _value; //接收账户增加token数量_value
balances[_from] -= _value; //支出账户_from减去token数量_value
allowed[_from][msg.sender] -= _value; //消息发送者可以从账户_from中转出的数量减少_value
Transfer(_from, _to, _value); //触发转币交易事件
return true;
}
function balanceOf(address _owner) public constant returns (uint256 balance) {
return balances[_owner];
}
function approve(address _spender, uint256 _value) public returns (bool success)
{
allowed[msg.sender][_spender] = _value;
Approval(msg.sender, _spender, _value);
return true;
}
function allowance(address _owner, address _spender) public constant returns (uint256 remaining) {
return allowed[_owner][_spender]; //允许_spender从_owner中转出的token数,也就是授权
}
mapping (address => uint256) balances;
mapping (address => mapping (address => uint256)) allowed;
}