我们将使用truffle创建一个智能合约项目,该智能合约的功能是可以获取值和设置值。
首先创建项目目录:
$ mkdir mydapp
$ cd mydapp
然后使用truffle init
初始化项目,将生成项目模板文件:
$ truffle init
我们可以查看一下生成的项目目录:
G:\qikegu\ethereum\mydapp>tree /f
卷 数据 的文件夹 PATH 列表
卷序列号为 0C52-9CF4
G:.
│ truffle-config.js
│
├─contracts
│ Migrations.sol
│
├─migrations
│ 1_initial_migration.js
│
└─test
Migrations.sol
源文件,功能是迁移/部署/升级智能合约。package.json
是npm用来管理包的配置文件,在项目根目录下创建此文件,内容如下:
{
"name": "ethereum-demo",
"version": "1.0.0",
"description": "以太坊demo",
"main": "truffle-config.js",
"directories": {
"test": "test"
},
"scripts": {
"dev": "lite-server",
"test": "echo \"Error: no test specified\" && sexit 1"
},
"author": "kevinhwu@qikegu.com",
"license": "ISC",
"devDependencies": {
"@truffle/contract": "^4.0.33",
"dotenv": "^8.1.0",
"lite-server": "^2.5.4",
"truffle-hdwallet-provider": "^1.0.17"
}
}
关于依赖的包,可以在后面章节中,用到时逐个安装。
在contracts 目录中创建一个新文件MyContract.sol
,内容如下所示:
// 声明solidity版本
pragma solidity ^0.5.0;
// 声明智能合约MyContract,合约的所有代码都包含在花括号中。
contract MyContract {
// 声明一个名为value的状态变量
string value;
// 合约构造函数,每当将合约部署到网络时都会调用它。
// 此函数具有public函数修饰符,以确保它对公共接口可用。
// 在这个函数中,我们将公共变量value的值设置为“myValue”。
constructor() public {
value = "myValue";
}
// 本函数读取值状态变量的值。可见性设置为public,以便外部帐户可以访问它。
// 它还包含view修饰符并指定一个字符串返回值。
function get() public view returns(string memory ) {
return value;
}
// 本函数设置值状态变量的值。可见性设置为public,以便外部帐户可以访问它。
function set(string memory _value) public {
value = _value;
}
}
这个智能合约的功能是可以获取值和设置值。
现在让我们编译项目:
项目目录下执行命令:
$ truffle compile
等编译完成,可以看到多了一个build
目录,该目录下生成了新文件:./build/contract/MyContract.json
这个文件是智能合约ABI文件,代表“抽象二进制接口”。这个文件有很多作用,其中2个重要作用:
本教程的后续章节中,将涉及到这两个功能。