之前有自己开发过 Ethereum 智能合约,但没有好好纪录开发的过程和碰到的问题,觉得满可惜。这次想重新开始,从最傻的姿势开始,一步步成长。本篇希望将一个很简单的代币合约(只能发行和转帐),部署在本地和测试网路上,并测试其功能。本篇是较详细描述使用 Remix 的步骤及使用上可能碰到的问题。
开发环境
不需要安装,直接在任何浏览器开启 Remix。
Remix 是一个 Open Source 的 Solidity 智能合约开发环境,提供基本的编译、部署至本地或测试网路、执行合约等功能。Solidity 是 Ethereum 官方设计和支援的程式语言,专门用于编写智能合约。
取得代币合约
代币合约的范例很多,Ethereum 官网有提供一个最小可行的代币合约(MINIMUM VIABLE TOKEN):
pragma solidity ^0.4.0;
contract MyToken {
/* This creates an array with all balances */
mapping (address => uint256) public balanceOf;
/* Initializes contract with initial supply tokens to the creator of the contract */
function MyToken(
uint256 initialSupply
) public {
balanceOf[msg.sender] = initialSupply; // Give the creator all initial tokens
}
/* Send coins */
function transfer(address _to, uint256 _value) public {
require(balanceOf[msg.sender] >= _value); // Check if the sender has enough
require(balanceOf[_to] + _value >= balanceOf[_to]); // Check for overflows
balanceOf[msg.sender] -= _value; // Subtract from the sender
balanceOf[_to] += _value; // Add the same to the recipient
}
}
这个 MyToken 合约真的很傻,只能做两件事:
- 创造代币:发起合约时创造指定数量的代币,代币拥有者是发起合约的 Ethereum 帐户
- 转移代币:转移指定数量的代币到指定的 Ethereum 帐户
使用 Remix 編譯合約
1. 点选右上角 + 新增一个档案
名称任意只要副档名是 ".sol"。
2. 复制合约内容到该档案并编译
Remix 预设会自动编译,旁边没有跳出红色的 ERROR 就代表编译成功。
在本地部署合约
1. 设定网路
点选左边上面的 run。
Environment 选择 JavaScript VM 代表所有资料都是存在本地记忆体(功能类似 testrpc)。它会提供 5 个虚拟帐户每个有 100 ETH,随便选一个帐户(要记住)。
2. 发送交易部署合约
选择 MyToken。可以看到 create 按钮。且已根据合约内容显示必须填入 initialSupply
(也就是要发行的代币数量)。输入一个数目并按 create,就会发送交易部署合约。
合约部署成功后,可以看到合约的使用介面。Remix 会自动根据合约的内容,产生对应的合约使用介面。可以看到合约有两个功能:balanceOf(查询余额) 和 transfer(转移代币)。
底下可以看到 log(纪录每一次的操作)。实际上部署合约是透过一个 Ethereum 交易完成,点 Details 可以看到该笔交易详细资料。
执行合约 - 查询余额
1. 选择刚刚发起合约的帐户
2. 输入帐户
注意要用 "" 把帐户包起来,范例:
"0xca35b7d915458ef540ade6068dfe2f44e8fa733c"
3. 点击 balanceOf
可以在旁边看到执行结果,也就是目前这个帐户的代币余额。
错误情况
说明一下,因为资料传送是用 JSON 格式,所以要加上 ""。如果忘记输入 "" 就会在 log 看到错误:
执行合约 - 转移代币
1. 选择要转出的帐户
选择刚刚发起合约的帐户。
2. 输入要转入的帐户
选择并复制另一个帐户。在合约介面 transfer 后面的栏位,输入转入帐户和要转移的代币数量。帐户同样用 "" 包起来,范例:
"0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db", 10
3. 点击 transfer
点击 transfer,成功后会看到 log 更新。
4. 确认余额更新
再查询转入帐户的余额,就可以看到代币余额增加啦!
错误情况
如果选择要转出的帐户代币余额不足,这笔交易会失败,就会在 log 看到错误。
在测试网路部署合约
1. 安装 MetaMask
首先,要连到测试网路,就要安装 MetaMask。他是浏览器端的 Ethereum 钱包,可以连结 Ethereum 主要和测试网路。安奘后需要建立 Ethereum 帐户,教练,我”只”想学Solidity 这篇有详细的步骤。
2. 选择测试网路
回到 Remix,这次 Environment 选择 Injected Web3,Remix 会自动连结 MetaMask。
3. 部署合约
接著用刚才同样的方式,按 create 部署合约,就会看到 MetaMask 的弹出视窗。直接按 submit 发送交易。
稍等一点时间(因为要等这个交易被确认),部署成功后合约的使用介面就会跑出来。
就可以用同样的方式使用合约啦!
总结
Remix 提供一个 Solidity 智能合约的开发环境,可以简易的编译、部署、执行甚至除错,适合编程经验不多的初学者。但无法做到版本控制、测试及和其他开发工具一起使用等,实际要开发 DApp 的话会比较不方便。下一篇会参考以下文章:
使用 Truffle3、Ganache、web3.js 来编译和部署合约。