Struct SagaHttpCredentials 

pub struct SagaHttpCredentials { /* private fields */ }

业务作用：保存当前出站 HMAC 与仅在重叠窗口内允许入站验签的历史材料。

Implementations

impl SagaHttpCredentials

pub fn from_hex_key(hex_key: &str) -> Result<Self, SagaHttpMessageAuthError>

业务作用：在配置准备阶段校验 HMAC 材料，避免无效候选影响当前请求。

参数说明：

• hex_key：必须是 256 位小写十六进制 key。

返回：合法材料对应的不可变凭据快照；非法编码返回脱敏配置错误。

pub fn rotated( &self, hex_key: &str, overlap: Duration, ) -> Result<Self, SagaHttpMessageAuthError>

业务作用：准备新出站凭据并保留有界的旧入站验签窗口，候选未发布时不改变当前权威。

参数说明：

• hex_key：是新材料
• overlap：为本地单调时钟上的旧 key 保留期限，最长一小时。

返回：完整候选快照；非法 key、零期限或超过八份仍有效的旧材料时拒绝候选，不提前丢弃旧窗口。

pub fn current_result_contract(&self) -> &str

业务作用：让 capability 绑定当前实际出站 key 的不可逆合同摘要，避免 Registry 凭据掩盖结果凭据错配。

参数说明：无。

返回：当前 HMAC 材料的域分离 SHA-256，不暴露 key 或可重放的请求签名。

pub fn accepted_result_contracts(&self) -> BTreeSet<String>

业务作用：让 Catalog 使用与入站验签相同的旧 key 截止时刻判断结果凭据是否可接受。

参数说明：无。

返回：当前与尚在重叠窗口内的合同摘要；过期旧 key 不进入激活证据。

Trait Implementations

impl Clone for SagaHttpCredentials

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl SagaHttpCredentialSource for SagaHttpCredentials

fn credentials(&self) -> Arc<SagaHttpCredentials>

业务作用：为固定 key 使用者提供与动态认证器一致的快照读取边界。

参数说明：无。

返回：当前固定凭据的独立不可变快照。