Struct CachedBuild 

pub struct CachedBuild {

    pub nodes: HashMap<AbsPath, HashMap<NodeId, NodeInfo>>,
    pub path_to_abs: HashMap<RelPath, AbsPath>,
    pub external_refs: ExternalRefs,
    pub id_to_path_map: HashMap<SolcFileId, String>,
    pub decl_index: HashMap<NodeId, DeclNode>,
    pub node_id_to_source_path: HashMap<NodeId, AbsPath>,
    pub hint_index: HintIndex,
    pub doc_index: DocIndex,
    pub completion_cache: Arc<CompletionCache>,
    pub build_version: i32,
    pub content_hash: u64,
    pub qualifier_refs: HashMap<NodeId, Vec<NodeId>>,
    pub base_function_implementation: HashMap<NodeId, Vec<NodeId>>,
}

Pre-computed AST index. Built once when an AST enters the cache, then reused on every goto/references/rename/hover request.

All data from the raw solc JSON is consumed during new() into pre-built indexes. The raw JSON is not retained.

Fields

nodes: HashMap<AbsPath, HashMap<NodeId, NodeInfo>>

path_to_abs: HashMap<RelPath, AbsPath>

external_refs: ExternalRefs

id_to_path_map: HashMap<SolcFileId, String>

decl_index: HashMap<NodeId, DeclNode>

O(1) typed declaration node lookup by AST node ID. Built from the typed AST via visitor. Contains functions, variables, contracts, events, errors, structs, enums, modifiers, and UDVTs.

node_id_to_source_path: HashMap<NodeId, AbsPath>

O(1) lookup from any declaration/source-unit node ID to its source file path. Built from typed_ast during construction. Replaces the O(N) find_source_path_for_node() that walked raw JSON.

hint_index: HintIndex

Pre-built hint lookup per file. Built once, reused on every inlay hint request (avoids O(n²) declaration resolution per request).

doc_index: DocIndex

Pre-built documentation index from solc userdoc/devdoc. Merged and keyed by selector for fast hover lookup.

completion_cache: Arc<CompletionCache>

Pre-built completion cache. Built from sources during construction before the sources key is stripped.

build_version: i32

The text_cache version this build was created from. Used to detect dirty files (unsaved edits since last build).

content_hash: u64

FxHash of the source text this build was compiled from. Used to skip redundant rebuilds when content has not changed (e.g. format-on-save loops that re-trigger didSave with identical text).

qualifier_refs: HashMap<NodeId, Vec<NodeId>>

Qualifier reference index: maps a container declaration ID (contract/library/interface) to IdentifierPath node IDs that use it as a qualifier prefix in qualified type paths (e.g., Pool.State).

Built at cache time by following referencedDeclaration on multi-segment IdentifierPath nodes to their declaration, then reading the declaration’s scope field to find the container.

base_function_implementation: HashMap<NodeId, Vec<NodeId>>

Bidirectional implementation index built from baseFunctions/baseModifiers.

Maps each declaration ID to the set of IDs that are semantically equivalent (interface ↔ implementation). For example, if PoolManager.swap (616) has baseFunctions: [2036] (IPoolManager.swap), this will contain 616 → [2036] and 2036 → [616].

Used by textDocument/implementation, textDocument/references, and callHierarchy/incomingCalls to unify interface and implementation IDs. Empty in warm-loaded builds (from_reference_index).

Implementations

impl CachedBuild

pub fn new( ast: Value, build_version: i32, interner: Option<&mut PathInterner>, ) -> Self

Build the index from normalized AST output.

Canonical shape:

• sources[path] = { id, ast }
• contracts[path][name] = { evm, devdoc, ... }
• source_id_to_path = { "0": "path", ... }

When interner is provided, solc’s per-compilation file IDs in all src strings are translated into canonical IDs from the project-wide PathInterner. This ensures all CachedBuild instances share the same file-ID space regardless of which solc invocation produced them.

pub fn merge_missing_from(&mut self, other: &CachedBuild)

Absorb data from a previous build for files this build doesn’t cover.

For each file in other.nodes that is not already present in self.nodes, copies the node map, path mapping, and any related entries. This ensures a freshly compiled project index never loses coverage compared to the warm-loaded cache it replaces.

pub fn from_reference_index( nodes: HashMap<AbsPath, HashMap<NodeId, NodeInfo>>, path_to_abs: HashMap<RelPath, AbsPath>, external_refs: ExternalRefs, id_to_path_map: HashMap<SolcFileId, String>, build_version: i32, interner: Option<&mut PathInterner>, ) -> Self

Construct a minimal cached build from persisted reference/goto indexes.

This is used for fast startup warm-cache restores where we only need cross-file node/reference maps (not full gas/doc/hint indexes).

When interner is provided, the id_to_path_map entries are registered in the interner so that subsequent compilations will assign the same canonical IDs to the same paths.

Trait Implementations

impl Clone for CachedBuild

fn clone(&self) -> CachedBuild

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachedBuild

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

Formats the value using the given formatter.