Struct FrameToken 

pub struct FrameToken { /* private fields */ }

所有权令牌

每个令牌唯一对应一个 Frame，通过类型系统在编译期保证：

• 不可跨线程（!Send + !Sync，通过 PhantomData<*const ()> 实现： 原始指针自动不实现 Send/Sync，令牌无法传递或共享到其他线程）
• 不可复制/克隆（!Copy + !Clone，通过不 derive 相应 trait 实现）
• 不可在外部构造（pub(crate) 构造函数）

所有权守恒

令牌的生命周期必须严格遵循以下规则：

1. 令牌创建后只能有一个所有者
2. 所有权转移必须是原子操作
3. 令牌销毁前必须归还到 FramePool

Implementations

impl FrameToken

pub fn frame_id(&self) -> FrameId

获取 Frame ID

pub fn domain_id(&self) -> u32

获取域ID

pub fn generation(&self) -> u64

获取代际号

pub fn epoch(&self) -> u64

获取Epoch编号

pub fn verify_ownership( &self, expected_domain: u32, expected_generation: u64, ) -> Result<(), CoreError>

验证令牌是否属于指定域和代际

使用恒定时间比较防止时序侧信道攻击。

Arguments

• expected_domain - 期望的域ID
• expected_generation - 期望的代际号

Returns

• Ok(()) - 验证通过
• Err(CoreError::OwnershipViolation) - 验证失败

pub fn verify_epoch(&self, expected_epoch: u64) -> Result<(), CoreError>

验证令牌是否属于指定Epoch

使用恒定时间比较防止时序侧信道攻击。

Arguments

• expected_epoch - 期望的Epoch编号

Returns

• Ok(()) - 验证通过
• Err(CoreError::StateConflict) - 验证失败

pub fn into_frame_id(self) -> FrameId

消费令牌并获取 Frame ID

此方法消费令牌，返回 Frame ID。 令牌被消费后不可再使用（self 在函数结束时自动释放所有权）。

Returns

Frame ID

Trait Implementations

impl Debug for FrameToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.