外部矿工

外部挖矿把 PoW nonce 搜索与节点分离。内存池、交易选择、State 转换、 HistoryStep 证明、模板以及区块中继仍由节点掌控。

外部挖矿进程不会收到区块体或生成证明所需的见证数据。

本地挖矿进程

创建受保护的令牌文件，并让节点和本地挖矿进程共同使用：

umask 077
openssl rand -hex 32 > ~/.parano1d/mining.key

parano1d --mode extminer --mining-key-file ~/.parano1d/mining.key

在另一个终端运行：

parano1d-miner \
  --rpc http://127.0.0.1:9601 \
  --key-file ~/.parano1d/mining.key

不带 Origin 的本地客户端可以在通过回环地址连接时省略 Authorization，使 GUI 和 CLI 无需密码即可保留完整的本地管理权限。即使外部挖矿进程在本地运行，也应继续向它提供 --key-file，这样它的请求只获得挖矿权限。故意省略令牌的本地原生进程会被视为受信任的本地所有者进程。旧的 --mining-key TOKEN 和 --key TOKEN 形式继续兼容，但其值可能出现在进程参数中。在 Unix 上，key 文件必须属于当前用户，并且组和其他用户不可访问。

需要时可限制挖矿进程的线程数：

parano1d-miner --key-file ~/.parano1d/mining.key --threads 8

远程挖矿进程

切勿通过互联网直接传输未加密的 Bearer 令牌。RPC 服务器仅支持 HTTP，并拒绝 WebSocket 升级。

应把挖矿进程与节点放在经过认证的私有网络中，或由反向代理终止 TLS 并限制暴露路径。只有安全传输就绪后才绑定公网 RPC：

parano1d \
  --mode extminer \
  --rpc-listen 0.0.0.0:9601 \
  --mining-key-file /secure/parano1d-mining.key

防火墙应只允许指定挖矿进程或代理访问该端口。

奖励地址

模板默认使用节点配置的奖励地址，这是更安全的单机挖矿方式。

若允许挖矿进程请求自己的奖励地址，节点运营者必须显式启用：

parano1d \
  --mode extminer \
  --mining-key-file ~/.parano1d/mining.key \
  --allow-custom-coinbase

此后挖矿进程可以使用：

parano1d-miner \
  --key-file ~/.parano1d/mining.key \
  --coinbase o1...

自定义 coinbase 只改变证明构建前嵌入的奖励地址，挖矿进程仍无法修改已经证明的模板。

挖矿令牌只允许 getBlockTemplate 和 submitBlock。它不能调用钱包、节点控制或通用查询方法。

独立的矿池运营主机

将记账和付款服务与钱包节点分离的矿池可以配置第二个独立凭据：

umask 077
openssl rand -hex 32 > /secure/parano1d-operator.key

parano1d \
  --mode node \
  --rpc-listen 0.0.0.0:9601 \
  --operator-key-file /secure/parano1d-operator.key

运营者令牌允许有界的记账查询、交易和收据查询与验证、费用和付款规划、walletSend、精确的钱包合并，以及提交已在外部获得授权的原始交易意图。完整列表见 JSON-RPC 认证。该令牌不能获取或提交挖矿模板、停止节点、扫描钱包、发现或更改地址、枚举无界的钱包历史或 UTXO，也不能调用列表之外的方法。挖矿令牌与运营者令牌必须不同。

如果一个守护进程同时服务挖矿和矿池运营，请使用 extminer 模式并提供两个不同的令牌文件。如果钱包守护进程独立部署，它只需要运营者令牌，证明节点只保留挖矿令牌。

walletSend 具有支出权限。防火墙应只允许记账主机访问，并应使用 VPN、经过认证的 TLS 或 SSH 隧道。节点的 HTTP listener 不会加密 Bearer 令牌。

模板生命周期

getBlockTemplate 返回不透明的一次性 ID、16 字段 PoW 输入序列、 nonce 索引和目标值。挖矿进程搜索随机且互不重叠的 nonce 范围，再通过 submitBlock 提交恰好 16 个小端序 nonce 字节。

模板在 30 秒后过期；规范链尖变化、成功提交或节点主动取消也会使其失效。结果过期是正常现象，挖矿进程会在下一次轮询时请求新模板。

诊断

运行：

parano1d-miner --check-hardware

请求失败时：

401 Unauthorized 表示 token 缺失或不匹配；
自定义 coinbase 错误表示节点未启用该功能；
模板不断过期通常表示节点持续收到新链尖，或证明准备超过模板生命周期；
没有模板表示节点尚未同步、对等节点数量不足，或不在 extminer 模式。