118 lines
3.1 KiB
Markdown
118 lines
3.1 KiB
Markdown
# 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开发团队
|