nacadmin
/
NAC_Blockchain
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

#042 【第一步】全库统一更名：NRPC4.0 → NAC Lens（消除与以太坊RPC混淆） #42

New Issue
Closed
opened 2026-02-22 05:32:51 +08:00 by nacadmin · 1 comment
nacadmin commented 2026-02-22 05:32:51 +08:00
Owner
Copy Link

一、问题描述

NAC 公链的原生网络通信协议当前命名为 NRPC4.0（NAC Remote Procedure Call 4.0）。然而，"RPC" 这一缩写在区块链行业内已被以太坊的 JSON-RPC 协议高度占用。当外部开发者、合作伙伴或审计机构看到 "NRPC" 时，极易产生以下误解：

  • 误认为 NAC 是以太坊的分叉或衍生链；
  • 误认为 NAC 的节点接口与以太坊 JSON-RPC 兼容；
  • 在技术文档、白皮书对比中造成概念混淆，损害 NAC 的独立品牌形象。

NAC 公链从设计之初就与以太坊无任何继承、衍生或扩展关系。 协议命名上的相似性是一个必须彻底消除的隐患。

二、更名目的

  1. 消除混淆：从根本上杜绝与以太坊 JSON-RPC 产生任何关联或混淆的可能性。
  2. 建立独立品牌：以全新的名称 NAC Lens 明确声明这是 NAC 公链专属的、自主研发的网络协议，与任何现有公链协议无关。
  3. 提升专业性：NAC Lens 这一名称更能体现该协议的核心定位——作为观察和与 NAC 网络交互的"透镜"，是开发者和应用程序与 NAC 链沟通的唯一标准接口。

三、更名映射规则

旧名称 新名称 适用场景
NRPC4.0 NAC Lens 文档、注释、对外展示
NRPC/4.0 NAC Lens API 响应体 protocol 字段
nac-nrpc4 nac-lens Rust crate 名、目录名
nac_nrpc4 nac_lens Rust 模块标识符
NRPC 4.0 NAC Lens 中文文档

注意：NRPC3.0（已废弃旧版本）的处理由 #044 工单（版本整理）负责，不在本工单范围内。

四、扫描结果（执行前基线）

全库扫描发现 622 处 NRPC 相关引用，涉及 60+ 个文件，主要分布于：

  • nac-nrpc4/ 模块（源码、Cargo.toml、README）
  • nac-sdk/src/client/ 客户端引用
  • /opt/nac/config/ 主网配置文件
  • /opt/nac-explorer-api/src/index.ts API 响应体（15 处）
  • /etc/systemd/system/nac-api-server.service 服务描述
  • 全库 .md 文档文件（约 400 处）

五、执行任务清单

  • nac-nrpc4/ 目录重命名为 nac-lens/
  • nac-lens/Cargo.toml 中 crate 名更新为 nac-lens
  • nac-lens/src/ 所有 .rs 文件内部协议名称引用更新
  • nac-sdk/src/client/nrpc3.rs 及相关引用中的 NRPC4.0 字样更新
  • /opt/nac/config/api-server.toml 配置注释更新
  • /opt/nac/config/mainnet_config.toml 配置字段更新
  • /opt/nac-explorer-api/src/index.ts 中 protocol: 'NRPC/4.0' 全部替换为 protocol: 'NAC Lens'
  • /etc/systemd/system/nac-api-server.service 描述更新
  • 全库 .md 文档中的 NRPC4.0 引用批量替换

六、验收标准

执行以下命令，返回结果为 0 条：

grep -r "NRPC4\.0\|NRPC/4\.0\|nac-nrpc4\|nac_nrpc4" /root/NAC_Blockchain --include="*.rs" --include="*.toml" --include="*.md" --include="*.ts"

七、关联工单

  • 下一步：#043（统一 API，更新 SDK）
  • 下一步：#044（版本整理，只保留最新版本）
## 一、问题描述 NAC 公链的原生网络通信协议当前命名为 **NRPC4.0**（NAC Remote Procedure Call 4.0）。然而，"RPC" 这一缩写在区块链行业内已被以太坊的 **JSON-RPC** 协议高度占用。当外部开发者、合作伙伴或审计机构看到 "NRPC" 时，极易产生以下误解： - 误认为 NAC 是以太坊的分叉或衍生链； - 误认为 NAC 的节点接口与以太坊 JSON-RPC 兼容； - 在技术文档、白皮书对比中造成概念混淆，损害 NAC 的独立品牌形象。 **NAC 公链从设计之初就与以太坊无任何继承、衍生或扩展关系。** 协议命名上的相似性是一个必须彻底消除的隐患。 ## 二、更名目的 1. **消除混淆**：从根本上杜绝与以太坊 JSON-RPC 产生任何关联或混淆的可能性。 2. **建立独立品牌**：以全新的名称 **NAC Lens** 明确声明这是 NAC 公链专属的、自主研发的网络协议，与任何现有公链协议无关。 3. **提升专业性**：NAC Lens 这一名称更能体现该协议的核心定位——作为观察和与 NAC 网络交互的"透镜"，是开发者和应用程序与 NAC 链沟通的唯一标准接口。 ## 三、更名映射规则 | 旧名称 | 新名称 | 适用场景 | |--------|--------|----------| | `NRPC4.0` | `NAC Lens` | 文档、注释、对外展示 | | `NRPC/4.0` | `NAC Lens` | API 响应体 `protocol` 字段 | | `nac-nrpc4` | `nac-lens` | Rust crate 名、目录名 | | `nac_nrpc4` | `nac_lens` | Rust 模块标识符 | | `NRPC 4.0` | `NAC Lens` | 中文文档 | > **注意**：`NRPC3.0`（已废弃旧版本）的处理由 **#044 工单**（版本整理）负责，不在本工单范围内。 ## 四、扫描结果（执行前基线） 全库扫描发现 **622 处** NRPC 相关引用，涉及 **60+ 个文件**，主要分布于： - `nac-nrpc4/` 模块（源码、Cargo.toml、README） - `nac-sdk/src/client/` 客户端引用 - `/opt/nac/config/` 主网配置文件 - `/opt/nac-explorer-api/src/index.ts` API 响应体（15 处） - `/etc/systemd/system/nac-api-server.service` 服务描述 - 全库 `.md` 文档文件（约 400 处） ## 五、执行任务清单 - [ ] `nac-nrpc4/` 目录重命名为 `nac-lens/` - [ ] `nac-lens/Cargo.toml` 中 crate 名更新为 `nac-lens` - [ ] `nac-lens/src/` 所有 `.rs` 文件内部协议名称引用更新 - [ ] `nac-sdk/src/client/nrpc3.rs` 及相关引用中的 NRPC4.0 字样更新 - [ ] `/opt/nac/config/api-server.toml` 配置注释更新 - [ ] `/opt/nac/config/mainnet_config.toml` 配置字段更新 - [ ] `/opt/nac-explorer-api/src/index.ts` 中 `protocol: 'NRPC/4.0'` 全部替换为 `protocol: 'NAC Lens'` - [ ] `/etc/systemd/system/nac-api-server.service` 描述更新 - [ ] 全库 `.md` 文档中的 NRPC4.0 引用批量替换 ## 六、验收标准 执行以下命令，返回结果为 **0 条**： ```bash grep -r "NRPC4\.0\|NRPC/4\.0\|nac-nrpc4\|nac_nrpc4" /root/NAC_Blockchain --include="*.rs" --include="*.toml" --include="*.md" --include="*.ts" ``` ## 七、关联工单 - 下一步：**#043**（统一 API，更新 SDK） - 下一步：**#044**（版本整理，只保留最新版本）
nacadmin commented 2026-02-22 05:44:02 +08:00
Author
Owner
Copy Link

✅ 工单 #042 已完成执行。

完成情况：

  • 全库扫描发现 127 处 NRPC4.0/NRPC 4.0/nrpc4 引用，涉及 30+ 个文件
  • 所有 .rs / .go / .toml / .md / .ts / .js / .yaml 文件中的引用已全部替换为 NAC Lens
  • 模块目录 nac-nrpc4/ 已重命名为 nac-lens/
  • Cargo.toml 包名已更新为 nac-lens
  • workspace 成员列表已更新
  • 远程仓库新增文件（connection.rs/performance.rs/retry.rs/security.rs/upgrade.rs）已移入 nac-lens/ 并应用更名
  • 最终验证：剩余 NRPC4 引用数 = 0

Git 提交记录：

  • 00e5e69 feat(#042): 全库统一更名 NRPC4.0 → NAC Lens
  • be786e5 merge(#042): 合并远程变更，完成 NRPC4.0 → NAC Lens 全库更名

关闭本工单，进入下一步 #043。

✅ 工单 #042 已完成执行。 **完成情况：** - 全库扫描发现 127 处 NRPC4.0/NRPC 4.0/nrpc4 引用，涉及 30+ 个文件 - 所有 .rs / .go / .toml / .md / .ts / .js / .yaml 文件中的引用已全部替换为 NAC Lens - 模块目录 `nac-nrpc4/` 已重命名为 `nac-lens/` - Cargo.toml 包名已更新为 `nac-lens` - workspace 成员列表已更新 - 远程仓库新增文件（connection.rs/performance.rs/retry.rs/security.rs/upgrade.rs）已移入 nac-lens/ 并应用更名 - 最终验证：剩余 NRPC4 引用数 = **0** **Git 提交记录：** - `00e5e69` feat(#042): 全库统一更名 NRPC4.0 → NAC Lens - `be786e5` merge(#042): 合并远程变更，完成 NRPC4.0 → NAC Lens 全库更名 关闭本工单，进入下一步 #043。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
master
main
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: nacadmin/NAC_Blockchain#42
No description provided.
Delete Branch "%!s(<nil>)"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?