配置

Core 默认从以下位置读取 TOML 配置：

~/.parano1d/parano1d.toml

也可通过 --config 指定其他文件。文件不存在时会以安全默认值原子创建。 TOML 格式错误会直接阻止启动，程序不会静默覆盖它。

完整配置

[network]
listen = "0.0.0.0:9400"
seeds = []

[storage]
backend = "mdbx"
path = "~/.parano1d/data"

[rpc]
listen = "127.0.0.1:9401"

[mining]
enabled = false
miner_address = ""

命令行参数会覆盖对应的文件配置。

网络

network.listen 接受 HOST:PORT 或 libp2p multiaddress。绑定 0.0.0.0:9400 可接受公网 IPv4 连接。

network.seeds 用于添加引导节点，支持以下形式：

198.51.100.10:9400
seed.example.org:9400
/ip4/198.51.100.10/tcp/9400
dnsaddr:seed.example.org

内置 DNS 种子始终可用，自定义种子只是在其基础上补充。

--seed HOST:PORT 可重复使用，并追加到配置的种子列表。

存储

发布版运行时 storage.backend 使用 mdbx。RAM 后端仅供测试，不提供持久化 Live State。

storage.path 包含链数据库、钱包文件、对等身份、证明缓存以及快照暂存数据。不要让两个正在运行的节点共用同一个目录。

命令行参数 --data-dir 会覆盖该路径。

RPC

RPC 应保持监听：

127.0.0.1:9401

该接口包含钱包提交和进程控制功能，并不是带有通用认证的公网浏览器 API。

外部挖矿部署可使用 --mining-key 保护整个 RPC 端点。Bearer token 不会加密传输；远程挖矿进程应通过回环地址、私有网络、SSH 隧道或经过认证的 TLS 代理连接。

挖矿

进程模式具有决定性：

parano1d --mode node
parano1d --mode miner
parano1d --mode extminer --mining-key TOKEN

旧的 mining.enabled 字段不会覆盖 --mode。miner_address 为空时，使用钱包活动地址；--miner-address 则覆盖当前进程的奖励地址。

--cpu-threads N 限制内置挖矿共享 CPU 池，对普通节点模式和独立的外部挖矿进程均无影响。

日志

--log 接受 error、warn、info、debug 等过滤器。建议先使用 info。debug 适合有时间边界的诊断，但日志量会明显增加。

systemd 环境下输出进入 journal。GUI 则把私有节点日志写入所选数据目录的 parano1d-node.log。

启动前检查

无需创建配置、钱包或数据库即可检查 CPU：

parano1d --check-hardware

检查成功时，最后一行是 NODE READY。