NAC_Blockchain/charter-std-zh/README.md

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-std-zh/acc/acc20;

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

🧪 运行测试

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区块链官网
• Git仓库

---

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