Struct FundsCacheKey 

pub struct FundsCacheKey {
    pub acc_id: u64,
    pub asset_category: i32,
    pub currency: Option<i32>,
}

v1.4.106 Finding A (codex source audit 2026-05-01): funds cache currency-aware key.

对齐 C++ INNData_Trd_Acc.cpp::m_mapAccFund: m_mapAccFund: NN_AssetKey -> NN_TrdCurrency -> Ndt_Trd_AccFund

Universal/Futures 账户对不同 currency 有独立 funds snapshot, 之前 Rust 用 DashMap<AccKey, CachedFunds> (1 acc_id → 1 snapshot) 会被 backend pushed snapshots 互相覆盖 — 用户传 currency=USD 拿到的可能是 stale CAD 数据, 客户端无法察觉.

字段语义:

• acc_id: 账户 (主 key)
• asset_category: Trd_Common.proto::AssetCategory enum (0=Default 等), 对齐 C++ NN_AssetKey 子集. 若 client 传 c2s.asset_category=None, 用 0.
• currency: Some(c) 表示 per-currency snapshot (Futures/Universal 路径); None 表示 legacy 单币种账户 native (无 per-currency 概念). C++ 等价于 “first available currency” snapshot.

Fields

acc_id: u64

asset_category: i32

currency: Option<i32>

Implementations

impl FundsCacheKey

pub const fn legacy(acc_id: u64) -> Self

Legacy single-account snapshot key (acc_id only, no per-currency / no per-asset_category dimension). 用于 SingleCurrency 账户 / 无 currency context 的 cache write.

pub const fn per_currency(acc_id: u64, currency: i32) -> Self

Per-currency snapshot key (Universal/Futures 路径).

pub const fn full( acc_id: u64, asset_category: i32, currency: Option<i32>, ) -> Self

Per-asset-category + per-currency snapshot key (full path, asset_category 非 0 时用).

Trait Implementations

impl Clone for FundsCacheKey

fn clone(&self) -> FundsCacheKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FundsCacheKey

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

Formats the value using the given formatter.

impl Hash for FundsCacheKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FundsCacheKey

fn eq(&self, other: &FundsCacheKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for FundsCacheKey

impl Eq for FundsCacheKey

impl StructuralPartialEq for FundsCacheKey