Struct DeployerCache 

pub struct DeployerCache { /* private fields */ }

Deployer records keyed by their bytecode meta hash.

The key here is not a digest of the value - a deployer is keyed by its bytecode meta hash while carrying a constructor meta of its own - so the invariant is internal: meta_bytes must hash to meta_hash. A record that gets that wrong describes a deployer whose constructor meta is not the meta it names, and crate::meta::Store copies exactly those bytes into the MetaCache under exactly that hash.

Same shape as MetaCache, for the same reason: the check was a convention spread across call sites, and set_deployer and set_deployer_from_query_response both missed it. rainlanguage/rain.metadata#170.

Implementations

impl DeployerCache

pub fn insert_verified( &mut self, key: &[u8], deployer: NPE2Deployer, ) -> Result<&NPE2Deployer, Error>

Caches deployer under key, and only if the key is a hash, every field needed to reproduce the deployer is present, and its own meta bytes hash to the meta hash it claims for them.

The key check has no counterpart in MetaCache, which gets it for free: there the key is a digest of the value, so a key of the wrong length cannot equal one. Here the key is a bytecode meta hash while the value carries a constructor meta of its own, so nothing about the value constrains the key and the length is checked outright.

pub fn get(&self, key: &[u8]) -> Option<&NPE2Deployer>

The deployer cached under key, if any.

pub fn contains_key(&self, key: &[u8]) -> bool

Whether anything is cached under key.

pub fn iter(&self) -> impl Iterator<Item = (&Vec<u8>, &NPE2Deployer)>

Every cached pair. Entries are verified by construction.

pub fn is_empty(&self) -> bool

Whether anything is cached at all.

Trait Implementations

impl Clone for DeployerCache

fn clone(&self) -> DeployerCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeployerCache

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

Formats the value using the given formatter.

impl Default for DeployerCache

fn default() -> DeployerCache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DeployerCache

Deserializing is a way in, so it goes through the gate, as for MetaCache.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for DeployerCache

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DeployerCache

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DeployerCache