开发指南

快速入门

搭建一个 FIBOS 开发环境需要安装 fibos 和 fibos.js，安装过程请参考 【快速安装】 章节。

本章节示例代码的目录结构：

1
2
3
4
5
6
7
8
9
10
11
hello_fibos/
├── fibos_client
│   ├── call.js  //调用合约接口脚本文件
│   ├── initClient.js  //FIBOS连接文件
│   ├── deploy.js  //加载、发布合约脚本文件
│   ├── hello
│   │   ├── hello.abi  //合约abi文件
│   │   └── hello.js  //合约代码文件
│   └── package.json
└── start_fibos
    └── node.js

本章节示例代码地址：https://github.com/FIBOSIO/samples 下basic文件夹示例。

启动节点

环境配置脚本

创建 start_fibos 文件夹，保存如下代码至 node.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
var fibos = require('fibos');

fibos.load('chain');
fibos.load('chain_api');
fibos.load('history_api');
fibos.load('producer', {
    'producer-name': 'eosio',
    'enable-stale-production': true
});
fibos.load('http', {
    'http-server-address': '0.0.0.0:8888'
});

fibos.load('net', {
    'p2p-listen-endpoint': '0.0.0.0:9876'
});
fibos.config_dir = 'fibos_config_dir/';
fibos.data_dir = 'fibos_data_dir/';
fibos.enableJSContract = true;
fibos.start();

运行 FIBOS 开发环境

1
hello_fibos$ fibos start_fibos/node.js

运行结果日志（部分）：

1
2
……
2018-07-30T03:29:01.004 thread-1   producer_plugin.cpp:1194      produce_block        ] Produced block 00000002e091c956... #2 @ 2018-07-30T03:29:01.000 signed by eosio [trxs: 0, lib: 0, confirmed: 0]

如果你看到了以上的消息，说明运行成功，fibos 已经开始区块生产。

JavaScript 合约代码

注意：需新建窗口，保证 node.js 节点正常运行

创建文件夹 fibos_client，保存如下代码至 hello/hello.js：

1
exports.hi = user => console.error('in contract:', user);

合约 ABI 文件

保存如下代码至 hello/hello.abi：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
    "version": "eosio::abi/1.0",
    "structs": [{
        "name": "player",
        "base": "",
        "fields": [{
            "name": "title",
            "type": "string"
        }, {
            "name": "age",
            "type": "int64"
        }]
    }, {
        "name": "hi",
        "base": "",
        "fields": [{
            "name": "user",
            "type": "name"
        }]
    }],
    "actions": [{
        "name": "hi",
        "type": "hi",
        "ricardian_contract": ""
    }]
}

连接 FIBOS 节点

在文件夹fibos_client下，新建 initClient.js，保存如下代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
var FIBOS = require('fibos.js');

function initClient(_keyProvider) {
    return FIBOS({
        chainId: 'cf057bbfb72640471fd910bcb67639c22df9f92470936cddc1ade0e2f2e7dc4f',
        keyProvider: _keyProvider, 
        httpEndpoint: 'http://127.0.0.1:8888',
        logger: {
            log: null,
            error: null
        }
    });
}

module.exports = initClient;

加载、发布合约脚本

在文件夹fibos_client下，新建 deploy.js，保存如下代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
var FIBOS = require('./initClient.js')
var fs = require('fs');
var config = {
    'public-key': 'your public key',
    'private-key': 'your private key',
    'contractName': 'hello'
};

// new FIBOS client
var fibos = FIBOS(config['private-key']);
// create account hello
fibos.newaccountSync({
    creator: 'eosio',
    name: 'hello',
    owner: config['public-key'],
    active: config['public-key']
});
//setcode
var js_code = fs.readTextFile('./hello/hello.js');
fibos.setcodeSync(config['contractName'], 0, 0, fibos.compileCode(js_code));

//getcode
var code = fibos.getCodeSync(config['contractName'], true);
console.log('code:', code);

//setabi
var abi = JSON.parse(fs.readTextFile('./hello/hello.abi'));
fibos.setabiSync(config['contractName'], abi);

运行脚本：

1
hello_fibos$ fibos fibos_client/deploy.js

输出结果（部分）：

1
2
3
4
5
6
code: {
  "account_name": "hello",
  "code_hash": "383a12daacaf124eea9afc529822d990853b5b99570401b8394534b746ea3977",
  "wast": "",
  "wasm": "504b03042d00000008002cadfe4c6a9400a2360000003900000008001400696e6465782e6a7301001000000000000000000000000000000000004bad28c82f2a29d6cbc854b055282d4e2d52b0b55348cecf2bcecf49d54b2d2aca2fd250cfcc0389941425269758a9eb8055695a0300504b010200001400000008002cadfe4c6a9400a23600000039000000080000000000000001000000000000000000696e6465782e6a73504b0506000000000100010036000000700000000000"
}

备注：wasm 是一个低层级的、轻便式的字节码,它致力于实现接近原生的执行速度。

调用合约

使用 fibos.js 中的 API 去调用合约。

在文件夹fibos_client下，新建 call.js，保存如下代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
var FIBOS = require('./initClient.js')
var config = {
    'public-key': 'your public key',
    'private-key': 'your private key',
    'contractName': 'hello'
};

// new FIBOS client
var fibos = FIBOS(config['private-key']);

//call abi
var ctx = fibos.contractSync(config['contractName']);
let i = ctx.hiSync('hello', {
    authorization: config['contractName']
});
console.log(i)

执行脚本：

1
hello_fibos$ fibos fibos_client/call.js

控制台打印结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
{
  "broadcast": true,
  "transaction": {
    "compression": "none",
    "transaction": {
      "expiration": "2018-10-29T09:54:38",
      "ref_block_num": 45,
      "ref_block_prefix": 552314262,
      "max_net_usage_words": 0,
      "max_cpu_usage_ms": 0,
      "delay_sec": 0,
      "context_free_actions": [],
      "actions": [
        {
          "account": "hello",
          "name": "hi",
          "authorization": [
            {
              "actor": "hello",
              "permission": "active"
            }
          ],
          "data": "00000000001aa36a"
        }
      ],
      "transaction_extensions": []
    },
    "signatures": [
      "SIG_K1_JxKj8whii1gosSY6S5b3JcNxZ7x7xTUFkWg3fsjpiQ3K8eTfY6N8van5PqoUFYGJVRGNzdxapWLc6NAcieJgPCh8e8hkDA"
    ]
  },
  "transaction_id": "5d7262907ab645168f6a1fdd1e17988ca7f50a07d2ef6bb90f5891a6c2cb8bb9",
  "processed": {
    "id": "5d7262907ab645168f6a1fdd1e17988ca7f50a07d2ef6bb90f5891a6c2cb8bb9",
    "block_num": 47,
    "block_time": "2018-10-29T09:53:39.000",
    "producer_block_id": null,
    "receipt": {
      "status": "executed",
      "cpu_usage_us": 3510,
      "net_usage_words": 13
    },
    "elapsed": 7273,
    "net_usage": 104,
    "scheduled": false,
    "action_traces": [
      {
        "receipt": {
          "receiver": "hello",
          "act_digest": "35c685a9391997dfe62291f39ead19cde36bbfb29f411deb9019592ed6be5b4f",
          "global_sequence": 50,
          "recv_sequence": 1,
          "auth_sequence": [
            [
              "hello",
              3
            ]
          ],
          "code_sequence": 1,
          "abi_sequence": 1
        },
        "act": {
          "account": "hello",
          "name": "hi",
          "authorization": [
            {
              "actor": "hello",
              "permission": "active"
            }
          ],
          "data": {
            "user": "hello"
          },
          "hex_data": "00000000001aa36a"
        },
        "context_free": false,
        "elapsed": 7011,
        "cpu_usage": 0,
        "console": "in contract: hello\n",
        "total_cpu_usage": 0,
        "trx_id": "5d7262907ab645168f6a1fdd1e17988ca7f50a07d2ef6bb90f5891a6c2cb8bb9",
        "block_num": 47,
        "block_time": "2018-10-29T09:53:39.000",
        "producer_block_id": null,
        "account_ram_deltas": [],
        "inline_traces": []
      }
    ],
    "except": null
  }
}

同时在 FIBOS 节点服务控制台显示 trxs:1 显示结果如下：

1
2018-8-30T14:28:22.005 thread-1   producer_plugin.cpp:1196      produce_block        ] Produced block 00000e57c573a33b... #3671 @ 2018-07-30T14:28:22.000 signed by eosio [trxs: 1, lib: 3670, confirmed: 0]

本章带领大家快速了解以及发布了一个简单的 JavaScript 合约，下面为大家准备了一个示例可以在【教程】章节中查阅。