FIBOS 模块

fibos 实例对象

使用方法：

1	var fibos = require('fibos')

实例属性

data_dir

fibos 的数据存放目录

类型：String

1	fibos.data_dir = './fibos_data_dir';

config_dir

fibos 的配置存放目录

类型：String

1	fibos.config_dir = './fibos_config_dir';

core_symbol

fibos 主 token 名称

类型：String

1	fibos.core_symbol = 'FO';

pubkey_prefix

fibos 公钥前缀

类型：String

1	fibos.pubkey_prefix = 'FO';

enableJSContract

查询和设置 JavaScript 智能合约状态，为 True 时支持 JavaScript 智能合约

类型：Boolean

1	fibos.enableJSContract = true;

实例方法

load

加载 load 本身配置

1	fibos.load(cfgs);

参数说明：

cfgs : Object ，配置对象。

加载系统 plugin 及其配置

1	fibos.load( name, cfg );

参数说明：

name : String ，系统 plugin 名称。
cfg : Object ，提供给系统 plugin 的配置。[可选]

start

启动 fibos

1	fibos.start();

stop

停止 fibos

1	fibos.stop();

系统 plugin

注意：系统 plugin 请配合 fibos.load 实例方法进行使用

http 插件

启用 FIBOS 节点上所有的 RPC API

配置说明：

配置名称	配置含义	默认值	参考值
http-server-address	本地 http 服务地址	127.0.0.1:8888
https-server-address	本地 https 服务地址	-
max-body-size	RPC 请求允许最大字节	1024*1024(bytes)
verbose-http-errors	显示 Http 返回的错误日志	false
http-validate-host	验证 Http 请求 host	true
access-control-allow-origin	对每个请求返回特殊的 Access-Control-Allow-Origin	-	*

chain 插件

是 FIBOS 节点上处理和聚合链数据所需的核心插件

配置说明：

配置名称	配置含义	默认值	参考值
genesis-json	指定创世块数据路径	-	文件路径参考文件[FIBOS MainNet]https://github.com/FIBOS-Community/fibos-nodes/blob/master/genesis.json)
genesis-timestamp	覆盖创世块中的初试时间戳	-	-
print-genesis-json	是否打印创世数据	false	-
fix-reversible-blocks	是否将数据恢复到不可逆高度	false	-(无法使用)
replay-blockchain	是否清除状态数据然后回滚所有数据	false	-(无法使用,猜测为命令行使用?)
hard-replay-blockchain	是否清除状态数据,然后从区块日志中回滚尽可能多的数据	false	-
delete-all-blocks	是否删除所有的状态数据和区块数据	false	-
truncate-at-block	停止出块,并在该区块高度回滚	0	-(无法使用)
blocks-dir	区块数据存放地址	blocks	-
abi-serializer-max-time-ms	覆盖默认 ABI 序列化允许的最大时间	15*1000(ms)	-
chain-state-db-size-mb	区块数据库中允许的最大容量	1024 (MB)	-
chain-state-db-guard-size-mb	当区块数据库中剩余的数据小于此大小时可以安全地关闭节点	128(MB)	-
reversible-blocks-db-size-mb	最大能够回滚的数据量	340(MB)	-
contracts-console	是否打印合约输出	false	-
read-mode	mode database contains changes done up to the head block plus changes made by transactions not yet included to the blockchain mode database contains changes done up to the current head block.	speculative	-

net 插件

组成一个网络

配置说明：

配置名称	配置含义	默认值	参考值
p2p-listen-endpoint	监听 p2p 连接的地址和端口	0.0.0.0:9876	-
p2p-server-addrsss	提供给其它节点 p2p 服务地址	p2p-listen-endpoint	-
p2p-peer-address	公共的 p2p 对等节点地址	-	FIBOS TestNet [ 103.80.170.107:9876 ]
p2p-max-nodes-per-host	单个 IP 能够连接的最大客户端数量	1	-
allowed-connection	允许连接	any	‘any’/‘producers’/‘specified’/‘none’。如果 ‘specified’ ，则必须至少指定一次对等密钥。如果只有 ‘producers’ ，则不需要对等密钥。
peer-private-key	一个公钥、私钥组成的数组
max-clients	允许连接客户端的最大数量	25	0: 无限制
connection-cleanup-period	清除不可用链接周期	30(s)	-
network-version-match	是否需要相同版本的网络	false	-
peer-log-format	节点日志格式化	[“ $n a m e ”$ {_ip}:${_port}]	-

chain_api 插件

将 chain_plugin 的功能公开到由 http_plugin 管理的 RPC API 接口上

依赖：

chain_plugin
http_plugin

配置说明：

api	请求	含义
get_info	GET	获取与节点相关的最新信息
get_block	POST	获取一个块的信息
get_account	POST	获取账户的信息
get_code	POST	获取智能合约代码

producer 插件

加载出块节点所需要的功能

配置说明：

配置名称	配置含义	默认值	参考值
max-transaction-time	事务最大超时时间	30(s)	-
greylist-account	无法使用 CPU 和 NET 的账号	-	-
enable-stale-production	启用产生区块,即使区块是静止的
max-irreversible-block-age	最大的不可逆块时间	-1	>1
producer-name	控制节点出块的账户名		eosio(可多参)
private-key	签名程序的公钥、私钥		(可多参数)

bnet 插件

提供了一个 P2P 协议，使用非常简单的算法持久同步两个区块链

配置说明：

配置名称	配置含义	默认值	参考值
bnet-endpoint:	所监听的传入链接的端点	0.0.0.0:4321
bnet-follow-irreversible	是否只接受从其他端点的不可逆的块	false
bnet-threads	用于处理网络消息的线程数
bnet-connect	其他节点的远程端点连接; 根据需要使用多个 bnet-connect 选项来组成网络
bnet-no-trx	这个 peer 请求其他节点没有 pending 的 transactions	false	false

实例

bp节点

var fibos = require('fibos');
var fs = require("fs");
var isInit = false;

var producername = '';
var p2p_peer_address = [
    "se-p2p.fibos.io:9870",
    "sl-p2p.fibos.io:9870",
    "to-p2p.fibos.io:9870",
    "ca-p2p.fibos.io:9870",
    "ln-p2p.fibos.io:9870",
    "va-p2p.fibos.io:9870"
];

console.notice("start FIBOS producer nodes");

fibos.config_dir = "./fibos_config_dir";
fibos.data_dir = "./fibos_data_dir";

console.notice("config_dir:", fibos.config_dir);
console.notice("data_dir:", fibos.data_dir);

fibos.load("net", {
    "p2p-peer-address": p2p_peer_address,
    "p2p-listen-endpoint": "0.0.0.0:9870"
});

fibos.load("producer", {
    'producer-name': producername,
    'enable-stale-production': true,
    'private-key': [active_publickey, active_privateKey]
});
fibos.load("chain", {
    // "contracts-console": true,
    'chain-state-db-size-mb': 8 * 1024,
    'genesis-json': 'genesis.json'
});
//允许js合约
fibos.enableJSContract = true;

fibos.start();

同步节点

var fibos = require('fibos');
var fs = require("fs");

var producername = '';
var p2p_peer_address = [
    "se-p2p.fibos.io:9870",
    "sl-p2p.fibos.io:9870",
    "to-p2p.fibos.io:9870",
    "ca-p2p.fibos.io:9870",
    "ln-p2p.fibos.io:9870",
    "va-p2p.fibos.io:9870"
];

console.notice("start FIBOS ABI nodes");

fibos.config_dir = "./fibos_config_dir";
fibos.data_dir = "./fibos_data_dir";

console.notice("config_dir:", fibos.config_dir);
console.notice("data_dir:", fibos.data_dir);

fibos.load("http", {
    "http-server-address": "0.0.0.0:8870",
    "access-control-allow-origin": "*"
});

fibos.load("net", {
    "p2p-peer-address": p2p_peer_address,
    "p2p-listen-endpoint": "0.0.0.0:9870"
});

fibos.load("producer");

fibos.load("chain", {
    'chain-state-db-size-mb': 8 * 1024,
    'genesis-json': 'genesis.json'
});
fibos.load("chain_api");
fibos.load("history");
fibos.load("history_api");
//允许js合约
fibos.enableJSContract = true;

fibos.start();

genesis.json 文件

{
    "initial_timestamp": "2018-08-28T00:00:00.000",
    "initial_key": "FO6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
    "initial_configuration": {
        "max_block_net_usage": 1048576,
        "target_block_net_usage_pct": 1000,
        "max_transaction_net_usage": 524288,
        "base_per_transaction_net_usage": 12,
        "net_usage_leeway": 500,
        "context_free_discount_net_usage_num": 20,
        "context_free_discount_net_usage_den": 100,
        "max_block_cpu_usage": 200000,
        "target_block_cpu_usage_pct": 1000,
        "max_transaction_cpu_usage": 150000,
        "min_transaction_cpu_usage": 100,
        "max_transaction_lifetime": 3600,
        "deferred_trx_expiration_window": 600,
        "max_transaction_delay": 3888000,
        "max_inline_action_size": 4096,
        "max_inline_action_depth": 4,
        "max_authority_depth": 6
    },
    "initial_chain_id": "6aa7bd33b6b45192465afa3553dedb531acaaff8928cf64b70bd4c5e49b7ec6a"
}

FIBOS Node

FIBOS 模块

genesis.json 文件