以太坊– 开发智能合约



以太坊(Ethereum) – 开发智能合约

我们将使用truffle创建一个智能合约项目,该智能合约的功能是可以获取值和设置值。

1. 初始化项目

首先创建项目目录:
 $ 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

contracts 目录 智能合约源文件目录,现在已经有了一个Migrations.sol源文件,功能是迁移/部署/升级智能合约。
migrations 目录 迁移文件目录,迁移文件都是javascript脚本,帮助我们把智能合约部署到以太坊。
test 目录 测试代码目录。
truffle-config.js 文件 Truffle项目配置文件,例如可以在里面配置网络。

添加package.json文件

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"
  }
}

关于依赖的包,可以在后面章节中,用到时逐个安装。

2. 添加智能合约源文件

在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;
    }
}

这个智能合约的功能是可以获取值和设置值。

3. 编译项目

现在让我们编译项目:
项目目录下执行命令:
$ truffle compile

等编译完成,可以看到多了一个
build目录,该目录下生成了新文件:
./build/contract/MyContract.json
这个文件是智能合约ABI文件,代表“抽象二进制接口”。这个文件有很多作用,其中2个重要作用:

作为可在Ethereum虚拟机(EVM)上运行的可执行文件
包含智能合约函数的JSON表示,以便外部客户端可以调用这些函数

本教程的后续章节中,将涉及到这两个功能。