迁移教程
简介#
PlatON支持的solidity版本号有(0.4.26 0.5.17 0.6.12 0.7.6 0.8.6)，如果迁移其它版本的合约，需要修改成对应版本号，并调整相关语法。
如果您希望将以太坊的智能合约迁移到PlatON上，可以通过platon-truffle开发工具来进行。首先确保您正确安装了platon-truffle,只需按照以下步骤操作即可。
以下将演示将以太坊的ERC200513Token合约迁移至PlatON上，ERC200513Token.sol合约文件如下
pragma solidity 0.5.17;
contract ERC200513Token { string public name; // ERC20标准--代币名称 string public symbol; // ERC20标准——代币简称 uint8 public decimals = 18; // ERC20标准，decimals 可以有的小数点个数，最小的代币单位。18 是建议的默认值 uint256 public totalSupply = 10000000000000000000 ether; // ERC20标准 总供应量
// 用mapping保存每个地址对应的余额 ERC20标准 mapping(address => uint256) public balanceOf; // 存储对账号的控制 ERC20标准 mapping(address => mapping(address => uint256)) public allowance;
// 事件，用来通知客户端交易发生 ERC20标准 event Transfer(address indexed from, address indexed to, uint256 value);
// 事件，用来通知客户端代币被消费 ERC20标准 event Burn(address indexed from, uint256 value);
/** * 初始化构造 */ constructor(uint256 initialSupply, string memory tokenName, string memory tokenSymbol) public { totalSupply = initialSupply * 10 ** uint256(decimals); // 供应的份额，份额跟最小的代币单位有关，份额 = 币数 * 10 ** decimals。 balanceOf[msg.sender] = totalSupply; // 创建者拥有所有的代币 name = tokenName; // 代币名称 symbol = tokenSymbol; // 代币符号 } /** * 返回代币的名称 */ function getName() view public returns (string memory){ return name; }
/** * 返回代币的简称 */ function getSymbol() view public returns (string memory){ return symbol; } /** * 返回代币最小分割量 */ function getDecimals() public view returns (uint8){ return decimals; }
function getTotalSupply() public view returns (uint256 theTotalSupply) { //函数声明中已经定义了返回变量theTotalSupply theTotalSupply = totalSupply; return theTotalSupply; }
function getBalanceOf(address _owner) public view returns (uint256 balance) { //返回指定地址的通证余额 return balanceOf[_owner]; } /** * 代币交易转移的内部实现 */ function _transfer(address _from, address _to, uint _value) internal returns (bool success){ // 确保目标地址不为0x0，因为0x0地址代表销毁 require(_to != address(uint160(0))); // 检查发送者余额 require(balanceOf[_from] >= _value); // 确保转移为正数个 require(balanceOf[_to] + _value > balanceOf[_to]);
// 以下用来检查交易， uint previousBalances = balanceOf[_from] + balanceOf[_to]; // Subtract from the sender balanceOf[_from] -= _value; // Add the same to the recipient balanceOf[_to] += _value; emit Transfer(_from, _to, _value);
// 用assert来检查代码逻辑。 return (balanceOf[_from] + balanceOf[_to] == previousBalances); }
/** * 代币交易转移 * 从自己（创建交易者）账号发送`_value`个代币到 `_to`账号 * ERC20标准 * @param _to 接收者地址 * @param _value 转移数额 */ function transfer(address _to, uint256 _value) public returns (bool success){ return _transfer(msg.sender, _to, _value); }
/** * 账号之间代币交易转移 * ERC20标准 * @param _from 发送者地址 * @param _to 接收者地址 * @param _value 转移数额 */ function transferFrom(address _from, address _to, uint256 _value) public returns (bool success) { require(_value <= allowance[_from][msg.sender]); // Check allowance allowance[_from][msg.sender] -= _value; _transfer(_from, _to, _value); return true; }
/** * 设置某个地址（合约）可以创建交易者名义花费的代币数。 * * 允许发送者`_spender` 花费不多于 `_value` 个代币 * ERC20标准 * @param _spender The address authorized to spend * @param _value the max amount they can spend */ function approve(address _spender, uint256 _value) public returns (bool success) { allowance[msg.sender][_spender] = _value; return true; }
/** * * 获取_spender可以从账户_owner中转出token的剩余数量 */ function getAllowance(address _owner, address _spender) public view returns (uint remaining){ return allowance[_owner][_spender]; }
/** * 销毁我（创建交易者）账户中指定个代币 *-非ERC20标准 */ function burn(uint256 _value) public returns (bool success) { require(balanceOf[msg.sender] >= _value); // Check if the sender has enough balanceOf[msg.sender] -= _value; // Subtract from the sender totalSupply -= _value; // Updates totalSupply emit Burn(msg.sender, _value); return true; }
/** * 销毁用户账户中指定个代币 *-非ERC20标准 * Remove `_value` tokens from the system irreversibly on behalf of `_from`. * * @param _from the address of the sender * @param _value the amount of money to burn */ function burnFrom(address _from, uint256 _value) public returns (bool success) { require(balanceOf[_from] >= _value); // Check if the targeted balance is enough require(_value <= allowance[_from][msg.sender]); // Check allowance balanceOf[_from] -= _value; // Subtract from the targeted balance allowance[_from][msg.sender] -= _value; // Subtract from the sender's allowance totalSupply -= _value; // Update totalSupply emit Burn(_from, _value); return true; }}操作步聚#
step1. 创建一个新的工作目录如example
mkdir example && cd example- 以下命令如果没有特殊说明都在example目录下进行
step2. 使用platon-truffle初始化一个工程
platon-truffle init在操作完成之后，就有这样的一个项目结构：
contracts/: Solidity合约目录
migrations/: 部署脚本文件目录
test/: 测试脚本目录
truffle-config.js: platon-truffle 配置文件
step3. 将以太坊合约文件ERC200513Token.sol放至example/contracts目录下
ls contracts/- 将看到 ERC200513Token.sol
- PlatON智能合约中的货币单位为LAT和VON。要将以太坊智能合约迁移至PlatON，请将以太币面额更改为PlatON面额。同时注意以太/LAT市场汇率（此合约我们假设市场汇率1:1，将uint256 public totalSupply = 10000000000000000000 ether; 修改成uint256 public totalSupply = 10000000000000000000 lat; ）
- PlatON智能合约中block.timestamp表示的是当前区块以毫秒为单位的时间戳，以太坊是以秒为单位。
step4. 修改truffle-config.js中的编译版本号及链相关配置
module.exports = { networks: { development: { host: "10.1.1.6", // 链地址 port: 8806, // 链使用的rpc端口 network_id: "*", // Any network (default: none) from: "lat1wxadw8yzr6qxdw5yl3f2surp6ue6f03e07kcqc", //部署合约所使用的钱包地址 gas: 999999, gasPrice: 50000000004, }, },
compilers: { solc: { version: "0.5.17", // 编译合约所使用的solidity版本号，与合约定义版本一致 docker: false, // Use "0.5.1" you've installed locally with docker } }}step5. 编译合约
platon-truffle compile编译成功输出如下信息：
Compiling your contracts...Compiling ./contracts/ERC200513Token.solCompiling ./contracts/Migrations.sol compilation warnings encountered:
Warning: This is a pre-release compiler version, please do not use it in production.Artifacts written to /home/guest/example/build/contractsCompiled successfully using: //表示编译成功 solc: 0.5.17-develop.2020.1.2+commit.9ff23752.mod.Emscripten.clangstep6. 添加合约部署配置文件
cd migrations && touch 2_initial_ERC200513Token.js合约部署配置文件2_initial_ERC200513Token.js内容如下：
const ERC200513Token = artifacts.require("ERC200513Token"); //括号中为迁移合约类名module.exports = function(deployer) { deployer.deploy(ERC200513Token,100,'PLA','PLAT'); //ERC200513Token后面三个参数为合约构造函数参数}; step7. 部署合约
platon-truffle migrate输出结果如下，表示迁移成功
Compiling your contracts...Everything is up to date, there is nothing to compile.2_initial_ERC200513Token.js===========================
Deploying 'ERC200513Token' -------------------------- > transaction hash: 0x5667101234fcd3b9dadf96a19bce20d1b94d742e0fd8f3528c641fa587b17eb3 > Blocks: 0 Seconds: 0 > contract address: lat1uetshtp4tp6l067tl02e4x435py9ajrfdhsrd4 > block number: 2153 > block timestamp: 1585538899787 > account: lat1wxadw8yzr6qxdw5yl3f2surp6ue6f03e07kcqc > balance: 4499992.02433 > gas used: 641243 > gas price: 1 gvon > value sent: 0 LAT > total cost: 0.000641243 LAT
> Saving migration to chain. > Saving artifacts ------------------------------------- > Total cost: 0.000641243 LAT
Summary=======> Total deployments: 2> Final cost: 0.000755566 LAT