NAC_Blockchain/nac-cli

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

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

特性

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

NAC原生技术栈

• 智能合约语言: Charter（非Solidity）
• 虚拟机: NVM（非EVM）
• RPC协议: NRPC 4.0（非JSON-RPC）
• 共识机制: CBPP（宪政区块生产协议）
• 网络协议: CSNP（非传统P2P）
• 地址格式: 32字节（非以太坊的20字节）
• 哈希算法: SHA3-384（48字节，非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-384（48字节）
• 签名: secp256k1
• 地址: 32字节
• 加密: AES-256-GCM

NRPC客户端

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

许可证

MIT License

更新日志

v2.0.0 (2026-02-18)

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

致谢

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