配置变更
本文是v2.3.0-> v2.7.0的配置变更说明文档
说明：在2.0.8版本及以后的安装包中的配置文件只包含了最精简化的配置，安装包中的配置文件已经足够满足hyperchain的正常使用。若您是第一次使用hyperchain，且希望更深入地使用hyperchain时，可以查阅相关功能的使用手册从而知晓配置文件的修改方法；若您以前已经部署过hyperchain，那么仍可以沿用原先的全量配置文件，只不过需要参考《配置变更》对一些配置上的变化进行确认。
增删节点
新增配置
配置文件路径：configuration/config/global/ns_genesis.toml
变更所述模块：genesis
变更原因：将链的ca模式上链，且不可更改
配置项 |
含义 |
|---|---|
genes is.ca_mode |
ca模式，配置后不支持修改。支持的ca模式有：中 心化ca，即Center；分布式ca，即Distributed；无ca，即none |
genes is.root_ca |
当ca模式为中心化ca，即Center时，配置信任的root ca |
删除配置
配置文件路径：configuration/config/global/ns_static.toml
变更所述模块：encryption, distributedCA
变更原因：删除是否开启分布式ca及是否启用Ecert的开关，通过ca_mode控制
配置项 |
含义 |
|---|---|
encryption.check.enable |
是否启用ecert |
distributedCA.enable |
是否启用分布式ca |
不再支持rockit
嵌入式BaaS
新增配置
配置文件路径：configuration/config/system.toml
变更所述模块：baas
变更原因：新增内嵌版BaaS开关
配置项 |
含义 |
|---|---|
baas.enable |
是否开启内嵌版BaaS |
新增配置
配置文件路径：configuration/config/dynamic.toml
变更所述模块：port
变更原因：新增内嵌版BaaS访问接口
配置项 |
含义 |
|---|---|
port.baas |
baas的访问端口 |
NoxBFT
新增配置
配置文件路径：configuration/config/global/ns_static.toml
变更所述模块：consensus.hotstuff
变更原因：共识checkpoint协议重构以及稳定性优化
配置项 |
默认值 |
含义 |
|---|---|---|
consensus.hotstuf f.checkpoint_interval |
100 |
配置NoxBFT允许最大不生成检查点的 轮次数，超过此数量未生成检查点时， 会发起验证区块提案以强制生成检查点 |
co nsensus.hotstuff.chec kpoint_mem_cache_size |
2 |
配置NoxBFT在blo cktree中允许缓存几个检查点中的区块 |
consensus.hotstuff .backward_round_limit |
10 |
配置 NoxBFT落后多少轮后去调用syncchain 同步，落后的轮次低于此数量时，只会 采用fetch的方式拉取落后的共识区块 |
co nsensus.hotstuff.memp ool.commit_cache_size |
3 |
配置mempool 允许缓存多少个提交过的区块中的交易 |
轻节点
新增配置
配置文件路径：configuration/config/global/ns_static.toml
变更所述模块：executor
变更原因：新增lp节点类型
配置项 |
默认值 |
含义 |
|---|---|---|
executor.lp.send_limit |
500 |
vp节点给lp节点 发送的一批区块的数量限制 |
executor.lp.resend_interval |
5s |
p节点给lp节点、lp节点给 vp节点重发数据的时间间隔 |
gas排序
配置项变更
配置文件路径：configuration/global/ns_static.toml
变更所述模块：consensus
变更原因：新增了交易池类型”priced”用于NFT等需求中支持打包时根据交易的优先级（通常指gas price）进行排序。
配置项 |
含义 |
变更类型 |
|---|---|---|
consensus.hotst uff.mempool.type |
启动ho tstuff算法时使 用的交易池类型 |
新增交易池类型”pric ed”，用于支持hotstuff算法按照gas price进行打包排序 |
sync_chain模块
配置项变更
配置文件路径：configuration/global/ns_static.toml
变更所述模块：sync
变更原因：sync_chain流程重构，使用一套新的配置项。目前，sync_chain相关的配置完全处于[sync]标签下，原[executor.sync_chain]下的配置均已弃用。
[sync]
[sync.target]
epoch = 0
height = -1
hash = ""
[sync.provider]
available_mem = "100mb"
[sync.fetcher]
priority = "block"
sync_journal_receipt = false
sync_hpc_blocks = false
batch_block_num = 50
ledger_part_size = "100kb"
[sync.fetcher.task]
timeout = "7s"
limit = 10
配置项 |
含义 |
配置规则 |
|---|---|---|
sync.target.epoch |
节点启动时预期同步的epoch值 |
|
sync.target.height |
节点启动时预期同步的区块号 |
要求该配置项 >= sync.targ et.epoch对应的ch eckpoint的区块号 |
sync.target.hash |
sync. target.height对应的区块hash |
|
sync.prov ider.available_mem |
提供数据端每 一次提供的数据占用内存上限 |
|
syn c.fetcher.priority |
优先同步更 多的区块还是更高的snapshot |
合法可选值为： |
sync.fetcher.sy nc_journal_receipt |
拉取区块数据时 ，是否同时拉取journal和rece ipt（如果配置为true，则会执 行journal，否则会执行交易） |
|
sync.fetch er.sync_hpc_blocks |
是否要同步hype rchain1.8产生的历史数据（只 针对从1.8升级到2.X的场景） |
该配置项如果为 true，则节点一定 采用“优先同步更 多区块”的模式， 即sync.fetcher. priority不再生效 |
sync.fetch er.batch_block_num |
每一批拉取的数据 包数量（该配置通用于拉取数 据的各个流程中，表示一个请 求包含多少个数据包的拉取） |
|
sync.fetche r.ledger_part_size |
当需要同 步账本时，账本数据会被视为 一个文件，该配置项表示一个 账本文件数据包分片的大小（ 例如：账本数据大小为1M，该 配置项为50kb;那么一共需要21 [1024/50向上取整]个数据包） |
|
sync.fe tcher.task.timeout |
拉取 数据流程内部会将拉取一批ba tch_block_num个数据包的过程 视为一个task，该配置项表示 ：系统时间每经过多久回尝试 一次将未完成的task重新发送 |
|
sync. fetcher.task.limit |
该配置项表示同时可以有 多少个未完成的task并行执行 |