第十二章 · 高级可编程性

本章系统讲解 sui:: Framework（以及与之配合的 std:: 能力）在合约中的实际用法：从每笔交易自带的上下文，到发布时的一次性初始化、链下可观测的事件，再到 Epoch / 时钟 / 随机数，然后是 对象内集合与动态字段上的大规模集合，最后落到 Coin / BCS / 密码学。全章的模块地图与三层包关系已集中在 §12.1 · Sui Framework 概览，建议先通读 §12.1，再按下面路线读各节。

建议阅读路线

阶段	节	主题	说明
A. 交易与启动	§12.2	`TxContext`	隐式模块 `tx_context`；`sender` / `epoch` / `object::new` 的前提
	§12.3	`init`	发布时一次；可与 OTW、`package::claim` 配合
B. 可观测性	§12.4	`event::emit`	`copy + drop`、内部类型约束；链下索引依赖
C. 时间与随机	§12.5	Epoch 与 `Clock`	粗粒度 epoch vs 毫秒级 `Clock@0x6`
	§12.14	`Random@0x8`	与 §12.5 同属「系统共享对象」语境
D. 存储：小与大	§12.6	`VecMap` / `VecSet`	数据在对象内部，适合小规模
	§12.7	动态字段	`UID` 上异构扩展，是 §12.8 / §12.10 的底层
	§12.8	动态对象字段	值为子对象，可索引
	§12.9	`derived_object`	确定性地址与注册表模式
	§12.10	`Table` / `Bag` / …	基于动态（对象）字段的集合；与 §12.6 对照
E. 资产与数据编码	§12.11	`Balance` / `Coin`	代币底层；与第十五章 · 代币衔接
	§12.12	`sui::bcs`	字节与结构体；与 `std::bcs` 分工见节内
	§12.13	哈希与签名	`crypto/*` 原语
回顾	§12.1	框架总览	`move-stdlib` / `sui-framework` / `sui-system`、集合选型表

本章内容（与 §12.1 对照）

节	主题	在框架中的位置（摘要）
11.1	Sui Framework 概览	`packages` 三层、`std`/`sui`/`sui_system`、集合与模块总表
11.2	交易上下文	隐式 `sui::tx_context`
11.3	模块初始化器	`init`、`sui::package` 与 OTW
11.4	事件	`sui::event`
11.5	Epoch 与时间	`sui::clock` 与 `TxContext` 中的 epoch
11.6	集合类型（Vec）	`sui::vec_map` / `vec_set`
11.7	动态字段	`sui::dynamic_field`
11.8	动态对象字段	`sui::dynamic_object_field`
11.9	派生对象	`sui::derived_object`
11.10	动态集合	*`table` / `bag` / `object_` / `linked_table` / `table_vec`** 等
11.11	Balance 与 Coin	`balance` / `coin` / `sui::SUI`
11.12	BCS 序列化	`sui::bcs`（与 `std::bcs` 配合）
11.13	密码学与哈希	*`crypto/`、哈希、签名**
11.14	链上随机数	`sui::random`

与其它章的衔接

对象与存储 API：第九章 · 对象模型、第十章 · 使用对象
内部约束与 emit：第十章 §10.5
设计模式（OTW、Capability）：第十三章
代币与 NFT 实战：第十五、第十六

学习目标

读完本章后，你将能够：

正确使用 TxContext，并理解 init 与 OTW 在发布流程中的角色
发出符合验证器要求的事件，并理解其与链下索引的关系
区分 Epoch / Clock / Random 的语义与适用场景
在 VecMap/VecSet 与 Table/Bag/… 之间做存储选型（并与 §12.1 对照表一致）
使用 动态字段与动态对象字段 扩展对象；在合适场景使用 派生对象
操作 Balance/Coin，并了解 BCS 与 密码学模块 的常见用法

本章实战练习

动手任务见 hands-on.md；示例代码见 code/README.md。