Struct RpcCacheStore 

pub struct RpcCacheStore { /* private fields */ }

Clean-exit cache persistence handle.

An RpcCacheStore may internally have nothing to persist — non-fork run, --rpc.cache-size 0, or --rpc.no-cache-file. In any of those cases persist() is a no-op. Callers do not and must not branch on whether a given store is real or no-op; the whole point of this type is a single uniform persistence entry point.

Why not Drop

Persistence is clean-exit-only: callers invoke persist() explicitly on the success path. Drop also runs on panic and error unwind, so a Drop-based implementation would silently persist partial-run state. That is a correctness violation, not a style choice — do not “simplify” this type into a Drop impl.

Implementations

impl RpcCacheStore

pub fn set_external_env(&mut self, ext: ExternalEnvSnapshot)

Attach an external-env snapshot to a fixture-capture store.

Silent no-op for [RpcCacheStoreInner::ProviderCache] and no-op variants — callers use the same uniform interface regardless of which variant the builder produced, matching the persist() contract.

pub fn persist(self) -> Result<()>

Persist the cache to disk atomically. Consumes the store to enforce “persist once, then stop” — see Why not Drop on this type.

For fixture-capture stores, any external_env snapshot previously attached via Self::set_external_env is written into the envelope.

• ProviderCache: best-effort — failures are warn-logged and swallowed.
• FixtureCapture: hard error — the fixture is the primary output of capture mode.
• No-op: returns Ok(()).

Trait Implementations

impl Debug for RpcCacheStore

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

Formats the value using the given formatter.