Struct QueryKey 

pub struct QueryKey { /* private fields */ }

A type-erased query cache key combining the query type’s stable QUERY_TYPE_ID discriminator and the hash of the postcard encoding of the input key.

Key equality is build/process-independent: both components derive from values that are stable across restarts, enabling PN3’s load_derived to rehydrate entries directly into the same cache slots warm-path insert_query and get use.

Implementations

impl QueryKey

pub fn new<Q: DerivedQuery>(key: &Q::Key) -> Self

Creates a new query key from a concrete query type and input key.

Both components of the key are computed from stable, process-independent sources so that entries rehydrated by PN3’s cold-load path (ShardedCache::insert_validated, which has no typed Q and works from raw bytes alone) live in the SAME key space as warm-path entries. This is what makes “first query after a cold start is free” actually hold:

• type_hash is Q::QUERY_TYPE_ID as u64 (the stable on-disk discriminator defined in spec §5.1), not TypeId::of::<Q>() which is build/process-local.
• key_hash is a hash of the postcard encoding of key, matching what ShardedCache::insert_query already stores as raw_key_bytes and what ShardedCache::insert_validated hashes at cold-load time.

Deterministic serialization of the key is guaranteed by the serde::Serialize bound on DerivedQuery::Key; a panic on serialization failure would indicate a serde derive bug and is treated as a non-recoverable programmer error here.

Trait Implementations

impl Clone for QueryKey

fn clone(&self) -> QueryKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryKey

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

Formats the value using the given formatter.

impl Hash for QueryKey

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 QueryKey

fn eq(&self, other: &QueryKey) -> 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 Eq for QueryKey

impl StructuralPartialEq for QueryKey