2.5 KiB

Raw Permalink Blame History

心跳块展示修复日志

工单编号

Issue #52（心跳块展示问题）

修复时间

2026-02-28

问题描述

explorer.newassetchain.io 区块浏览器显示所有区块交易数均为 0，用户误以为所有区块都是空块，实际上是 CBPP 协议的心跳块。

根本原因分析

1. 数据层（nac-explorer-api）

旧版本：使用 MySQL 注册数据伪造区块数据，未对接 CBPP 节点
新版本 v6.0.0：100% 对接 CBPP 节点（9545端口），使用 NAC 原生查询协议（nac_* 方法）

2. 展示层（nac-quantum-browser PHP）

旧版本：无心跳块标注，txCount=0 的块无任何区分
新版本：心跳块显示黄色 badge 心跳块，鼠标悬停显示 CBPP 宪法原则四说明

修复内容

nac-explorer-api v6.0.0（/opt/nac-explorer-api/src/index.ts）

所有区块数据从 CBPP 节点 RPC 9545 读取（dataSource: CBPP-Node-9545）
新增字段：isHeartbeat, blockType, blockTypeLabel, blockTypeNote, epoch, confirmations
心跳块判断逻辑：txCount=0 且 CBPP 节点确认为心跳块
协议标识：protocol: NAC Lens（非以太坊 JSON-RPC）

nac-quantum-browser PHP 层

Index.php processBlock()：

新增字段：isHeartbeat, blockType, blockTypeLabel, blockTypeNote, blockTypeBadge, confirmations, epoch, dataSource

blocks.html（区块列表页）：

新增类型列：心跳块显示
新增确认数列
心跳块行背景微黄（rgba(255,193,7,0.05)）
心跳块交易数列显示—而非 0

index.html（首页）：

PHP volist 区块行：心跳块显示黄色心跳badge
JS WebSocket prependBlock：实时推送的新块也正确标注心跳

block.html（区块详情页）：

区块号旁显示类型 badge
心跳块显示 CBPP 宪法原则四说明文字

技术说明

心跳块是 CBPP 协议的正当行为（宪法原则四），不是 Bug：

无交易时每 60 秒产生一个心跳块
证明网络存活，维持 CBPP 共识状态
心跳块 txCount=0，blockType=heartbeat

验证结果

API 健康检查：blockProductionMode: transaction-driven+heartbeat
区块列表页：心跳块正确显示黄色 badge
首页实时推送：心跳块正确标注
区块详情页：显示心跳块说明

相关文件

/opt/nac-explorer-api/src/index.ts（v6.0.0）
/opt/nac-quantum-browser/app/controller/Index.php
/opt/nac-quantum-browser/view/index/blocks.html
/opt/nac-quantum-browser/view/index/index.html
/opt/nac-quantum-browser/view/index/block.html