# Charter中文标准库 (charter-std-zh)

## 📖 简介

Charter中文标准库是NAC区块链的原生智能合约标准库，提供完整的中文语法支持，让开发者可以使用中文编写智能合约。

## 🌟 特性

- **完整中文支持**: 所有关键字、函数名、变量名都支持中文
- **NAC原生**: 专为NAC区块链设计，支持NAC特有功能
- **模块化设计**: 清晰的模块划分，易于使用和扩展
- **完整测试**: 每个模块都有完整的测试用例
- **详细文档**: 丰富的示例和API文档

## 📦 模块列表

### 1. ACC协议模块 (`acc/`)
- **ACC-20**: 同质化代币协议 (384行)
- 功能: 代币创建、转账、授权、增发、销毁

### 2. 资产模块 (`asset/`)
- **ACC-721**: 非同质化代币协议 (508行)
- 功能: NFT铸造、转移、授权、销毁

### 3. DeFi模块 (`defi/`)
- **流动性池**: 去中心化交易 (671行)
- **借贷协议**: 存款、借款、清算
- **质押协议**: 质押、解除质押、奖励

### 4. 治理模块 (`governance/`)
- **治理协议**: 提案、投票、执行 (596行)
- 功能: 去中心化治理

### 5. 跨链模块 (`sovereignty/`)
- **跨链桥接**: 资产锁定、解锁、消息传递 (533行)

### 6. 工具模块 (`utils/`)
- **数学工具**: 安全运算 (575行)
- **地址工具**: 地址操作
- **字符串工具**: 字符串处理
- **可拥有合约**: 所有权管理
- **可暂停合约**: 暂停/恢复功能

## 🚀 快速开始

### 使用示例

#### 创建ACC-20代币

```charter
使用 charter-std-zh/acc/acc20;

合约 我的代币 {
    私有 代币: ACC20基础;
    
    构造函数() {
        代币 = ACC20基础::新建("我的代币", "MYT", 18, 1000000 * (10 ** 18));
    }
    
    函数 转账(接收者: 地址, 数量: u256) {
        代币.转移(接收者, 数量);
    }
}
```

## 🧪 运行测试

```bash
charter test tests/test_acc20.ch
charter test tests/test_acc721.ch
charter test tests/test_defi.ch
charter test tests/test_governance.ch
```

## 📚 中文关键字对照表

| 中文 | 英文 | 说明 |
|------|------|------|
| 资产 | asset | 资产类型 |
| 合约 | contract | 智能合约 |
| 函数 | fn | 函数定义 |
| 让 | let | 变量声明 |
| 可变 | mut | 可变变量 |
| 常量 | const | 常量声明 |
| 如果 | if | 条件判断 |
| 否则 | else | 否则分支 |
| 对于 | for | 循环 |
| 在 | in | 在...中 |
| 循环 | while | while循环 |
| 返回 | return | 返回值 |
| 触发 | emit | 触发事件 |
| 模块 | module | 模块声明 |
| 使用 | import | 导入模块 |
| 要求 | require | 断言条件 |
| 公开 | public | 公开可见性 |
| 私有 | private | 私有可见性 |
| 真 | true | 布尔真值 |
| 假 | false | 布尔假值 |

## 🔧 编译器支持

Charter编译器已完整支持中文关键字和中文标识符。

## 📄 许可证

MIT License

## 🔗 相关链接

- [NAC区块链官网](https://newassetchain.io)
- [Git仓库](https://git.newassetchain.io/nacadmin/NAC_Blockchain)

---

**版本**: 1.0.0  
**最后更新**: 2026-02-18  
**维护者**: NAC开发团队