nacadmin
/
NAC_Blockchain
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NAC_Blockchain/nac-api-server
History
nacadmin f5788b5eac feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成 
## 完成内容

### 1. 全库 NRPC 更名为 NAC_lens
- 1208处替换，代码文件中 NRPC 引用归零
- 重命名文件: nrpc.rs → nac_lens.rs, nrpc_wrapper.rs → nac_lens_wrapper.rs
- 修复 nac-udm/src/l1_protocol/cbpp/mod.rs 中 mod nrpc → mod nac_lens
- 保留 JSON-RPC 协议字段名（标准协议不更名）

### 2. CNNL 编译器去以太坊化 Lint
- 新增 src/nac_lint.rs 模块
- 检测 RPC/EVM/Solidity/ERC20/ETH 等以太坊关键字
- 提供自动纠正建议（RPC → NAC_lens, EVM → NVM 等）
- 支持 --check 模式（仅检测）和 --fix 模式（自动修复）

### 3. nac-lens 六层架构 100% 完成
- L3 聚合层: 完整 DHT 路由（Kademlia XOR距离）+ 意识分叉投票机制
- L4 宪法层: 完整 Merkle 证明生成/验证 + 全息编码/重构
- L5 价值层: 完整价值转移逻辑（余额检查/原子转移/防双花/批量清算）
- upgrade.rs: 完整版本管理和热升级实现
- lib.rs: 协议魔数修正 NRP4 → NLNS (NAC Lens)
- error.rs: 新增 ValueTransferError 变体

### 测试结果
- nac-lens 核心模块: 31 passed, 0 failed
- cnnl-compiler: 26 passed, 0 failed

Closes #63
 		2026-02-28 09:50:03 +08:00
..
src feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成 2026-02-28 09:50:03 +08:00
tests 同步所有模块更新 2026-02-18 23:28:26 -05:00
.gitignore Initial commit: NAC公链核心模块 - 生产级别代码 2026-02-16 19:19:43 -05:00
Cargo.lock 同步所有模块更新 2026-02-18 23:28:26 -05:00
Cargo.toml feat: Issue #25 - 为所有模块增加统一的升级机制 2026-02-19 01:45:46 -05:00
README.md 同步所有模块更新 2026-02-18 23:28:26 -05:00
config.toml.example 同步所有模块更新 2026-02-18 23:28:26 -05:00
issue_007_nac_lens_upgrade.md feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成 2026-02-28 09:50:03 +08:00

README.md

NAC API服务器

NAC公链统一API服务器，为钱包应用和RWA资产交易所提供后端API支持。

功能特性

核心功能

  • ✅ 钱包API - 余额查询、转账、交易历史
  • ✅ 交易所API - 资产列表、订单管理、市场数据、订单簿
  • ✅ 区块链集成 - 通过RPC连接真实NAC区块链节点
  • ✅ 安全机制 - JWT认证、速率限制、输入验证
  • ✅ 错误处理 - 统一错误格式、详细日志
  • ✅ 配置管理 - TOML配置文件支持

技术栈

  • Web框架: Axum 0.7
  • 异步运行时: Tokio
  • 序列化: Serde
  • HTTP客户端: Reqwest
  • 认证: JWT (jsonwebtoken)
  • 验证: Validator
  • 日志: Tracing

快速开始

1. 配置

复制配置文件示例：

cp config.toml.example config.toml

编辑config.toml，修改区块链RPC地址和JWT密钥。

2. 编译

cargo build --release

3. 运行

cargo run --release

服务器将在http://0.0.0.0:8080启动。

4. 测试

# 运行所有测试
cargo test

# 健康检查
curl http://localhost:8080/health

API文档

钱包API

  • GET /api/wallet/balance/:address - 查询余额
  • POST /api/wallet/transfer - 发起转账
  • GET /api/wallet/transactions/:address - 查询交易历史
  • GET /api/wallet/transaction/:hash - 查询交易详情

交易所API

  • GET /api/exchange/assets - 获取资产列表
  • POST /api/exchange/orders - 创建订单
  • GET /api/exchange/orders/:order_id - 查询订单详情
  • GET /api/exchange/market/:asset - 获取市场数据
  • GET /api/exchange/orderbook/:asset - 获取订单簿
  • GET /api/exchange/trades - 获取最近交易

详细API文档请参考代码注释。

项目结构

nac-api-server/
├── src/
│   ├── main.rs              # 主入口
│   ├── blockchain/          # 区块链客户端
│   ├── auth/                # 认证模块
│   ├── middleware/          # 中间件
│   ├── error/               # 错误处理
│   ├── config/              # 配置管理
│   ├── models/              # 数据模型
│   ├── wallet.rs            # 钱包API
│   └── exchange.rs          # 交易所API
├── tests/                   # 集成测试
├── Cargo.toml               # 依赖配置
├── config.toml.example      # 配置示例
└── README.md                # 本文档

测试统计

  • 总测试数: 20个
  • 测试通过率: 100%
  • 代码覆盖: 核心模块全覆盖

许可证

Copyright © 2026 NAC Team. All rights reserved.

版本: 1.0.0
最后更新: 2026-02-18