链级配置
主要功能
create_cita_config.py 分为两种模式：
- create: 创建全新的一条链
- append: 在已有的链配置上新增一个节点
可通过运行如下命令查看：
$ ./env.sh ./script/create_cita_config.py create --help
usage: create_cita_config.py create [-h]
[--authorities AUTHORITY[,AUTHORITY[,AUTHORITY[,AUTHORITY[, ...]]]]]
[--chain_name CHAIN_NAME]
[--nodes IP:PORT[,IP:PORT[,IP:PORT[,IP:PORT[, ...]]]]]
[--super_admin SUPER_ADMIN]
[--contract_arguments Contract.Argument=Value [Contract.Argument=Value ...]]
[--timestamp TIMESTAMP]
[--resource_dir RESOURCE_DIR]
[--grpc_port GRPC_PORT]
[--jsonrpc_port JSONRPC_PORT]
[--ws_port WS_PORT]
optional arguments:
-h, --help show this help message and exit
--authorities AUTHORITY[,AUTHORITY[,AUTHORITY[,AUTHORITY[, ...]]]]
Authorities (addresses) list.
--chain_name CHAIN_NAME
Name of the new chain.
--nodes IP:PORT[,IP:PORT[,IP:PORT[,IP:PORT[, ...]]]]
Node network addresses for new nodes.
--super_admin SUPER_ADMIN
Address of super admin.
--contract_arguments Contract.Argument=Value [Contract.Argument=Value ...]
Update constructor arguments for system contract. Can
be specify more than once.
--timestamp TIMESTAMP
Specify a timestamp to use.
--resource_dir RESOURCE_DIR
Chain resource directory.
--grpc_port GRPC_PORT
grpc port for this chain
--jsonrpc_port JSONRPC_PORT
jsonrpc port for this chain
--ws_port WS_PORT websocket port for this chain
注意：
- 配置工具会创建以 chain_name 为名称的文件夹，如果没有传递该参数则默认为
test-chain。该文件夹里面再按节点序号创建 0，1，2 等节点文件夹，分别存放每个节点的配置文件。 - 为了方便测试时多个节点在同一台服务器上运行。 grpc，jsonrpc，ws_port 等参数指定的端口号是一个起始端口号。 节点实际使用的端口号，按照节点排列顺序顺延，即 port+n（n 为节点序号）。 比如总共 4 个节点，传递 grpc_port 参数为 7000。则 test-chain/0 的 grpc 端口号为 7000，test-chain/1 的 grpc 端口号为 7001，等等。
- CITA 有一些保留端口，设置节点网络端口，或者自定义端口的时候要避免产生端口冲突。保留端口有：
- 默认的 grpc 端口：5000 到 5000+N（N 为节点总数,以下相同）
- 默认的 jsonrpc 端口：1337 到 1337+N
- 默认的 websocket 端口：4337 到 4337+N
- 默认的 rabbitmq 端口：4369(epmd)/25672(Erlang distribution)/5671，5672(AMQP)/15672(management plugin)
参数解释：
chain_name: cita 支持侧链后，通过 chain_name 生成不同的链配置，默认为 test-chainsuper_admin: 指定生成链的超级管理员地址contract_arguments: 设定系统合约的默认值，这个参数具体的信息请详细查看系统合约文档例如：--contract_arguments "SysConfig.chainId=1"链的 chain_id 值设为 1，默认为随机数--contract_arguments "SysConfig.economicalModel=0"链的经济模型设为 quota，默认为 quota(0), 其他选项有 charge(1) (此模型下只有super_admin账户及节点地址有余额)--contract_arguments "SysConfig.checkFeeBackPlatform=true"交易激励返回链的持有者（运营方），为 false 时，交易激励返回共识节点--contract_arguments "SysConfig.chainOwner=0x0000000000000000000000000000000000000000"运营方地址，默认全 0
setup
默认创建 4 个共识节点的生成方式如下:
$ ./env.sh ./scripts/create_cita_config.py create --nodes "127.0.0.1:4000,127.0.0.1:4001,127.0.0.1:4002,127.0.0.1:4003"
$ ls test-chain/
0 1 2 3 template
相对应给出的参数，生成 4 个节点，test-chain/* 里面包含节点的配置文件，具体如下：
- 生成私钥和地址，私钥存放在
test-chain/*/privkey，其中*为节点号；而所有节点地址都存放在test-chain/template/authorities； - 生成网络配置文件，存放在
test-chain/*/network.toml，文件内容主要为总节点数、本地节点端口以及其它节点的 ip 和端口号； - 生成 genesis 块文件，存放在
test-chain/*/genesis.json， 其中 timestamp 为时间戳，秒为单位；prevhash 指前一个块哈希，这里是默认值；而 alloc 指部署到创世块的合约内容； - 生成节点配置文件，存放在
test-chain/*/consensus.toml，主要包含共识算法的相关参数； - 生成 jsonrpc 配置文件，存放在
test-chain/*/jsonrpc.toml，主要包含 jsonrpc 模块的相关参数。 test-chain/template目录下是模板文件，包括这个链的共识节点地址test-chain/template/authorities.list，系统合约生成参数test-chain/template/init_data.yml, 节点端口地址test-chain/template/nodes.list等信息
增加 1 个节点，需要指定已经创建过的 chain_name。举例如下：
$ ./env.sh ./scripts/create_cita_config.py append --chain_name test-chain --node "127.0.0.1:4004"
$ ls test-chain/
0 1 2 3 4 template
注意：每次只能增加一个节点，且增加的为普通节点。如何把普通接点升级为共识节点，请参考 节点管理。
配置文件
config-tool/config_example 目录下为各个微服务默认使用的配置文件。用户可在 config-tool 下创建格式类似的文件自定义配置信息。
cita-chain
config-tool 下创建chain.toml文件来自定义 cita-chain 配置。格式参考 config_example/chain.toml 文件，如下:
prooftype = 2
其中:
prooftype: 表示当前使用的共识算法，0 表示采用的 Poa 算法、1 表示采用的 Raft 算法、2 表示采用的 CITA-BFT 算法，默认采用 CITA-BFT 算法。
另外还有一项可选配置，如下：
cache_size = 1048576
指明了 Chain 中缓冲区的大小（缓冲区可以加速用户查询），单位是 Byte 。
cita-executor
config-tool 下创建 executor.toml文件来自定义 cita-executor journaldb 的类型等。格式参考 config_example/executor.toml文件，如下:
prooftype = 2
journaldb_type = "archive"
grpc_port = 5000
其中:
prooftype: 表示当前使用的共识算法，0 表示采用的 Poa 算法、1 表示采用的 Raft 算法、2 表示采用的 CITA-BFT 算法，默认采用 CITA-BFT 算法。journaldb_type: 表示当前使用的 JournalDB 算法，有 "archive" "light" "fast" "basic" 等 4 种类型，默认是 archive。grpc_port: grpc 端口
cita-auth
config-tool 下创建 auth.toml文件来自定义 cita-auth 配置。格式参考 config_example/auth.toml文件，如下:
count_per_batch = 30
buffer_duration = 30
tx_verify_thread_num = 4
tx_verify_cache_size = 100000
tx_pool_limit = 0
prof_start = 0
prof_duration = 0
其中：
count_per_batch: 表示批量的数量
cita-bft
config-tool 下创建 consensus.toml文件来自定义 cita-bft 配置。格式参考 config_example/consensus.toml文件，如下:
[ntp_config]
enabled = true
threshold = 1000
address = "0.pool.ntp.org:123"
其中：
enabled: 表示开启 ntpthreshold: 表示时间偏移的阀值address: 表示 ntp 服务器地址
系统合约
系统合约是从 genesis 块开始就部署到链上的用来实现特定功能的合约，它的合约地址写在 genesis 块里，是固定的地址。
CITA 里主要的系统合约有配置合约、共识节点管理合约、配额管理合约、权限管理合约及用户管理合约等。
初始化系统合约说明
其中:
0xffffffffffffffffffffffffffffffffff020000: 代表配置合约 SysConfig。0xffffffffffffffffffffffffffffffffff020001: 代表共识节点管理系统合约地址。0xffffffffffffffffffffffffffffffffff020003: 代表配额管理系统合约地址。0xffffffffffffffffffffffffffffffffff020002: 代表链信息管理系统合约地址。0xffffffffffffffffffffffffffffffffff020004: 代表 CITA 权限管理合约地址。0xffffffffffffffffffffffffffffffffff02000a: 代表用户管理合约地址。
用户可使用系统默认数据，也可通过参数 contract_arguments 自定义配置。默认配置如下：
Contracts:
- SysConfig:
- delayBlockNumber: 1
- checkPermission: false
- checkSendTxPermission: false
- checkCreateContractPermission: false
- checkQuota: false
- checkFeeBackPlatform: true
- chainOwner: '0x0000000000000000000000000000000000000000'
- chainName: test-chain
- chainId: 1
- operator: test-operator
- website: https://www.example.com
- blockInterval: 3000
- economicalModel: 0
- name: Nervos AppChain Test Token
- symbol: NATT
- avatar: https://avatars1.githubusercontent.com/u/35361817
- QuotaManager:
- admin: '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- NodeManager:
- nodes:
- '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- admins:
- '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- stakes:
- 0
- ChainManager:
- parentChainId: 0
- parentChainAuthorities: []
- Authorization:
- superAdmin: '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- Group:
- parent: '0x0000000000000000000000000000000000000000'
- name: rootGroup
- accounts:
- '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- Admin:
- admin: '0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523'
- VersionManager:
- version: 1
默认使用的账户如下：
| privkey | address |
|---|---|
| 5f0258a4778057a8a7d97809bd209055b2fbafa654ce7d31ec7191066b9225e6 | 0x4b5ae4567ad5d9fb92bc9afd6a657e6fa13a2523 |
节点管理系统合约
节点管理合约为 scripts/contracts/src/system/node_manager.sol。
函数签名在 test-chain/template/contracts/docs 目录（test-chain 为当前链名称），提供了 NodeManager-hashes.json可供查看， 并提供了针对用户和开发者的文档，分别为 NodeManager-userdoc.json 及 NodeManager-devdoc.json
共识节点管理的相关描述及方法介绍见 node_manager
配额管理系统合约
配额管理合约存放在 scripts/contracts/src/system/quota_manager.sol。
函数签名在 test-chain/template/contracts/docs 目录（test-chain 为当前链名称），提供了 QuotaManager-hashes.json可供查看， 并提供了针对用户和开发者的文档，分别为 QuotaManager-userdoc.json 及 QuotaManager-devdoc.json
配额管理的相关描述及方法介绍见 quota_manager
权限管理系统合约
函数签名权限管理合约存放在 scripts/contracts/src/permission_management。
在 test-chain/template/contracts/docs 目录（test-chain 为当前链名称），提供了 PermissionManagement-hashes.json 可供查看， 并提供了针对用户和开发者的文档，分别为 PermissionManagement-userdoc.json 及 PermissionManagement-devdoc.json
详细的接口说明见 permission_management
单独增加节点
相关描述及操作见 ordinary_node_management