#35NAC VISION 钱包与 NRPC 4.0 集成方案 #35
Loading…
Reference in New Issue
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?
NAC VISION 钱包与 NRPC 4.0 集成方案
版本：1.0
制定方：NAC钱包工作组 · 网络协议研究室
发布日期：2026年3月
关联文档：VISION钱包白皮书、NRPC 4.0 规范、NRP协议规范、CSNP V2.0
0. 执行摘要
NAC VISION 钱包作为连接用户与宪法公链的智能门户，其通信层必须与 NRPC 4.0 的元协议文明网络栈深度集成。通过采用 NRP 原生二进制协议取代传统 JSON-RPC，VISION 钱包能够：
•高效同步：利用 NRP 多路复用和流式传输，实时推送资产状态、宪法收据验证结果、元胞网络信息。
•宪法收据原生：所有交易在钱包内部构造时即关联宪法收据，通过 NRP 提交，确保合规性在通信层自动验证。
•全息宪法可视化：从全息宪法层获取宪法碎片，在钱包中重构并展示宪法状态，增强用户对宪法规则的感知。
•文明间交互准备：支持未来跨文明通信（如与以太坊、Polkadot 等交互）时，使用灵魂签名和文明间路由。
本方案详细阐述 VISION 钱包与 NRPC 4.0 的集成架构、关键交互流程、安全措施及开发者接口。
一、集成架构
钱包作为 NRP 轻客户端，通过 QUIC 连接到一个或多个 NAC 节点，使用 NRP 协议进行所有通信。钱包不参与元胞路由，但可订阅元胞状态更新，用于可视化。
二、核心集成功能
2.1 账户与资产查询
传统方式：通过 JSON-RPC 调用 eth_getBalance 等，返回 JSON。
NRP 集成：
•钱包使用 NRP 方法 account.balance，参数为 Address 和可选的 asset_id（GNACS）。
•节点返回 BalanceResponse，包含余额、资产状态、最后更新时间等。
•利用 NRP 多路复用，可在同一连接上并发查询多个资产。
rust
// 请求帧
Request {
method: "account.balance",
params: [Address::from_hex("0x1234..."), Some(gnacs)],
cr: None,
}
// 响应帧
Response {
result: BalanceResponse {
balance: 1000000,
asset_status: AssetStatus::Active,
updated_at: timestamp,
},
}
2.2 交易发送与宪法收据自动附加
传统方式：钱包构造交易，调用 eth_sendRawTransaction，需自行处理收据。
NRP 集成：
•钱包构造交易后，先向 CEE 请求宪法收据（CR）（可通过内置的 CEE 客户端模块）。
•将交易与 CR 一起通过 NRP 方法 tx.send 发送。
•节点在协议层自动验证 CR，若无效则拒绝。
rust
// 请求帧（包含 CR）
Request {
method: "tx.send",
params: [Transaction { ... }, cr],
flags: NEEDS_CR, // 可省略，因 CR 已在 params 中
}
// 响应帧
Response {
result: TxHash("0x7f3a..."),
}
2.3 实时订阅（流式）
钱包可订阅多种数据流，如：
•新区块：subscribe.blocks
•资产状态变更：subscribe.asset_updates (指定 GNACS)
•宪法收据验证事件：subscribe.receipts
通过 NRP 流式标志，节点持续发送数据帧，直到客户端取消。
rust
// 发起订阅请求（流式标志）
Request {
method: "subscribe.asset_updates",
params: [gnacs],
flags: STREAMING_RESPONSE,
stream_id: new_stream_id,
}
// 节点持续发送 Stream Data 帧
StreamData {
stream_id: same,
data: AssetUpdate { ... },
}
2.4 宪法收据可视化
钱包可利用 NRP 获取当前宪法状态（全息宪法）并可视化：
•通过 constitution.get_hologram 获取宪法全息图碎片。
•本地重构全息图，渲染为动态的宪法 DNA 视图。
•展示宪法条款摘要、投票历史等。
2.5 元胞网络邻居发现
钱包可显示当前连接的元胞邻居信息，增强网络透明度：
•通过 cell.get_neighbors 获取邻居列表。
•每个邻居包含信誉值、意识温度、位置哈希。
•在钱包中绘制简单的网络拓扑图。
三、关键交互流程示例
3.1 用户领取分红
1.用户点击“领取分红”按钮。
2.钱包向 CEE（通过内置接口）请求宪法收据，证明用户持有资产且满足分红条件。
3.钱包构造领取分红交易，并附带 CR。
4.钱包通过 NRP 发送 tx.send 到节点。
5.节点验证 CR 后打包交易。
6.钱包通过之前订阅的 subscribe.asset_updates 流实时收到资产更新，显示分红已到账。
3.2 宪法修正案公示
1.钱包订阅 governance.proposals 流。
2.当新宪法修正案提交时，节点推送 Proposal 数据。
3.钱包调用 constitution.get_hologram_fragment 获取提案相关全息碎片。
4.钱包本地重构，展示提案条款、影响分析（从宪法沙箱获取模拟结果）。
5.用户可点击“投票”跳转到治理 DApp。
四、安全设计
•端到端加密：所有 NRP 通信基于 QUIC 的 TLS 1.3 加密，防止中间人攻击。
•消息签名：敏感操作（如交易发送）的 NRP 请求可附加钱包私钥签名，节点验证。
•宪法收据验证：钱包在本地验证节点返回的 CR 签名（从 CEE 公钥列表），确保节点未篡改。
•重放防护：NRP 请求 ID 结合时间戳，节点维护最近 ID 窗口防止重放。
五、开发者接口（Rust SDK）
VISION 钱包将基于 nac-nrp crate 构建，核心接口如下：
rust
use nac_nrp::{Client, Config};
use nac_primitives::{Address, Hash, GNACS};
let config = Config::new("quic://node.nac.org:9000");
let mut client = Client::connect(config).await?;
// 查询余额
let balance = client.balance_of(address, Some(gnacs)).await?;
// 发送交易（带 CR）
let tx_hash = client.send_transaction(tx, cr).await?;
// 订阅资产更新
let mut stream = client.subscribe_asset_updates(gnacs).await?;
while let Some(update) = stream.next().await {
println!("Asset updated: {:?}", update);
}
六、与现有 JSON-RPC 兼容性
VISION 钱包同时保留 JSON-RPC 支持（通过内置网关），用于连接尚未升级至 NRP 的节点。网关在本地将 JSON-RPC 请求转换为 NRP 请求，并反向转换响应，实现无缝过渡。
七、路线图
阶段 时间 交付物
Phase 1 2026 Q3 nac-nrp 客户端库 v1.0，支持基础 RPC 调用
Phase 2 2026 Q4 VISION 钱包集成 NRP，替换现有 JSON-RPC 调用
Phase 3 2027 Q1 增加流式订阅、宪法收据可视化
Phase 4 2027 Q2 元胞邻居发现、全息宪法碎片获取
Phase 5 2027 Q4 支持跨文明通信（灵魂签名预备）
阶段 时间 交付物
Phase 1 2026 Q3 nac-nrp 客户端库 v1.0，支持基础 RPC 调用
Phase 2 2026 Q4 VISION 钱包集成 NRP，替换现有 JSON-RPC 调用
Phase 3 2027 Q1 增加流式订阅、宪法收据可视化
Phase 4 2027 Q2 元胞邻居发现、全息宪法碎片获取
Phase 5 2027 Q4 支持跨文明通信（灵魂签名预备）
阶段 时间 交付物
Phase 1 2026 Q3 nac-nrp 客户端库 v1.0，支持基础 RPC 调用
Phase 2 2026 Q4 VISION 钱包集成 NRP，替换现有 JSON-RPC 调用
Phase 3 2027 Q1 增加流式订阅、宪法收据可视化
Phase 4 2027 Q2 元胞邻居发现、全息宪法碎片获取
Phase 5 2027 Q4 支持跨文明通信（灵魂签名预备）
阶段 时间 交付物
Phase 1 2026 Q3 nac-nrp 客户端库 v1.0，支持基础 RPC 调用
Phase 2 2026 Q4 VISION 钱包集成 NRP，替换现有 JSON-RPC 调用
Phase 3 2027 Q1 增加流式订阅、宪法收据可视化
Phase 4 2027 Q2 元胞邻居发现、全息宪法碎片获取
Phase 5 2027 Q4 支持跨文明通信（灵魂签名预备）
八、结论
通过集成 NRPC 4.0 的 NRP 协议，NAC VISION 钱包从“被动工具”进化为“主动感知、实时响应”的智能宪法门户。它不仅能高效地与节点通信，更能将宪法规则、元胞网络、全息宪法等抽象概念转化为用户可感知的视觉和交互，真正实现“宪法即代码，代码即宪法”的愿景。
制定人：NAC钱包工作组 · 网络协议研究室
最后更新：2026年3月
文档状态：正式发布
✅ 工单完成确认
验证日期: 2026-02-27
验证方式: 逐层系统检查
完成依据
nac-vision-wallet 服务运行中（active），nac-wallet-service.service 正常运行。
验证详情
验证：systemctl is-active nac-wallet-service → active ✅
NAC Lens 客户端已集成（Issue #042 更名完成）
后台管理员账号