交易上下文

每笔 Sui 交易在执行期间都会访问一个名为“交易上下文”的预定义环境。交易上下文包含有关当前交易的关键信息，例如发送者地址、交易哈希和当前纪元。通过访问这些信息，智能合约可以实现动态逻辑，如授权、状态管理和生成唯一对象 ID。

TxContext 结构体概览

交易上下文通过 TxContext 结构体向智能合约公开。该结构体定义在 sui::tx_context 模块中，包含以下字段：

sender：当前交易的发送者地址，即签署该交易的用户的地址。
tx_hash：当前交易的哈希值，用于标识交易的唯一性。
epoch：当前纪元号，表示交易发生的时间段。
epoch_timestamp_ms：当前纪元的起始时间戳（以毫秒为单位）。
ids_created：记录当前交易执行过程中已创建的新对象 ID 数量的计数器，初始值为 0。

TxContext 的核心用途

访问发送者地址

通过 sender 字段，智能合约可以轻松获取发起交易的用户地址。应用场景包括：

授权检查：验证用户是否有权限执行某项操作。
个性化交互：根据用户地址定制特定功能。
活动跟踪：记录用户行为以分析或审计。

move

use sui::tx_context::TxContext;

fun get_sender_address(ctx: &TxContext): address {
    ctx.sender()
}

确定当前纪元

epoch 字段提供当前纪元号，允许智能合约实现依赖于时间周期的功能，例如：

治理机制：基于纪元的投票或选举。
奖励发放：按纪元进行奖励结算或分配。

move

use sui::tx_context::TxContext;

fun get_current_epoch(ctx: &TxContext): u64 {
    ctx.epoch()
}

生成唯一对象 ID

tx_hash 和 ids_created 字段共同确保每笔交易中生成的对象 ID 唯一性：

交易哈希 (tx_hash)：为交易提供唯一标识。
创建计数器 (ids_created)：在每次生成新 ID 时递增，从而避免冲突。

在 Sui 的对象模型中，这种机制对于对象创建的确定性和去中心化非常重要。

TxContext 的可变性

TxContext 是一个可变引用 (&mut TxContext)，通过此引用传递给智能合约。这种设计允许在交易执行期间动态修改 TxContext，例如更新 ids_created 字段。以下是对象创建流程的简单示例：

move

use sui::tx_context::TxContext;

fun create_unique_id(ctx: &mut TxContext): ID {
    let id = tx_context::derive_id(ctx.tx_hash(), ctx.ids_created());
    ctx.increment_ids_created(); // 更新计数器
    id
}

在上述代码中，每次调用 create_unique_id 时都会基于交易上下文生成唯一 ID，并更新 ids_created 计数器以防止重复。