NAC_Blockchain/nac-cli
NAC Admin 41c193ccf9 feat: 主网模块集成 + 彻底去除以太坊技术栈残留
本次提交完成以下工作:

1. 去除以太坊技术栈残留(FIX-ETH-001)
   - nac-cbpp: 重写 consensus.rs/vote.rs/validator.rs
     * BFT Prevote/Precommit → CBPP 宪法收据(CR)验证
     * Validator/voting_power → 区块生产者(CBP)/DID 身份
     * SHA256 → SHA3-384(48字节)
     * Gas → ComplianceFee(合规费)
   - nac-cli: 移除 secp256k1,改为 BLS 简化实现
   - nac-upgrade-framework: 投票机制 → 宪法授权审批
   - nac-udm: 修正 validator/stake 描述为 CBP/DID

2. 主网模块集成(INT-001)
   - nac-api-server v3.0.0: 统一代理所有主网微服务
     * /api/v1/{module}/... 统一入口
     * 支持 NVM/ACC/Charter/GNACS/CNNL/Exchange/Wallet/Onboarding
     * 聚合健康检查 /api/v1/health/all
   - 修复 Exchange/GNACS/CNNL 代理路径映射

3. 代码质量
   - nac-asset-onboarding: 修复所有编译错误(0错误0警告)
   - nac-sdk: 添加 NacLensClient stub
   - 旧版 wallet 模块归档至 _archive/wallet_legacy_v1/

编译状态: 16/16 核心 crate 全部通过(0错误0警告)
集成测试: 8/8 模块通过 API Server 统一入口互通
2026-03-07 06:10:51 +08:00
..
docs feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成 2026-02-28 09:50:03 +08:00
src feat: 主网模块集成 + 彻底去除以太坊技术栈残留 2026-03-07 06:10:51 +08:00
test-constitution Initial commit: NAC公链核心模块 - 生产级别代码 2026-02-16 19:19:43 -05:00
test-contract Initial commit: NAC公链核心模块 - 生产级别代码 2026-02-16 19:19:43 -05:00
.gitignore Initial commit: NAC公链核心模块 - 生产级别代码 2026-02-16 19:19:43 -05:00
CHANGELOG.md [Ticket #9] 完成NAC CLI工具100%实现 2026-02-18 13:05:49 -05:00
Cargo.lock feat: 主网模块集成 + 彻底去除以太坊技术栈残留 2026-03-07 06:10:51 +08:00
Cargo.toml feat: 主网模块集成 + 彻底去除以太坊技术栈残留 2026-03-07 06:10:51 +08:00
README.md feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成 2026-02-28 09:50:03 +08:00
README.old.md [Ticket #9] 完成NAC CLI工具100%实现 2026-02-18 13:05:49 -05:00

README.md

NAC CLI - NAC区块链命令行工具

NAC CLI是NAC (Native Autonomous Chain) 原生RWA公链的官方命令行工具提供完整的账户管理、交易发送、合约部署、宪法查询等功能。

特性

NAC CLI是专为NAC原生公链设计的命令行工具不继承任何以太坊或ERC标准,具有以下核心特性:

NAC原生技术栈

  • 智能合约语言: Charter非Solidity
  • 虚拟机: NVM非EVM
  • RPC协议: NAC Lens非JSON-RPC
  • 共识机制: CBPP宪政区块生产协议
  • 网络协议: CSNP非传统P2P
  • 地址格式: 32字节非以太坊的20字节
  • 哈希算法: SHA3-38448字节非Keccak256

核心功能

账户管理

  • 创建新账户(交互式密码输入)
  • 导入/导出私钥AES-256-GCM加密
  • 列出所有账户
  • 查询账户余额和RWA资产
  • Keystore加密存储

交易管理

  • 发送NAC交易带签名和确认
  • 查询交易详情和状态
  • 获取交易收据包含宪法收据CR
  • 签名和广播交易

Charter合约

  • 部署Charter智能合约
  • 调用合约方法(只读查询)
  • 发送合约交易(状态变更)
  • 查询合约代码和信息

宪法系统

  • 查询宪法条款(三层级:基础/核心/操作)
  • 验证条款状态
  • 查看条款参数
  • 获取宪法收据Constitutional Receipt

节点和区块

  • 查询节点信息和状态
  • 查看对等节点列表
  • 查询区块详情
  • 获取最新区块和区块高度

配置管理

  • 初始化配置文件
  • 查看和修改配置
  • 多环境支持

安装

从源码编译

# 克隆仓库
git clone ssh://root@103.96.148.7:22000/NAC/nac-cli.git
cd nac-cli

# 编译
cargo build --release

# 安装
cargo install --path .

系统要求

  • Rust 1.70+
  • 操作系统: Linux, macOS, Windows

快速开始

1. 初始化配置

nac config init

2. 配置RPC节点

nac config set network.rpc_url http://your-nac-node:8545

3. 创建账户

nac account create

4. 查询余额

nac account balance <地址>

5. 发送交易

nac tx send <发送方地址> <接收方地址> <金额>

命令参考

完整的命令参考请查看 docs/COMMANDS.md

NAC RPC方法

完整的RPC方法列表请参考 docs/NAC_RPC_METHODS.md

配置文件

配置文件位于 ~/.nac/config.toml,详细说明请查看 docs/CONFIGURATION.md

安全注意事项

  • 私钥使用AES-256-GCM加密存储
  • 所有交易都需要通过宪法验证CEE
  • 使用HTTPS连接RPC节点

技术架构

加密模块

  • 哈希: SHA3-38448字节
  • 签名: secp256k1
  • 地址: 32字节
  • 加密: AES-256-GCM

NAC Lens客户端

实现了60+个NAC RPC方法包括账户、交易、合约、宪法、共识等。

许可证

MIT License

更新日志

v2.0.0 (2026-02-18)

  • 完整实现NAC原生RPC客户端60+方法)
  • 使用NAC原生加密算法SHA3-384、32字节地址
  • Keystore管理AES-256-GCM加密
  • 账户、交易、合约、宪法、节点、区块、配置管理
  • 完整的文档和测试

致谢

感谢NAC团队的所有贡献者。