Struct CachedBuild 

pub struct CachedBuild {
    pub nodes: HashMap<String, HashMap<NodeId, NodeInfo>>,
    pub path_to_abs: HashMap<String, String>,
    pub external_refs: ExternalRefs,
    pub id_to_path_map: HashMap<String, String>,
    pub decl_index: HashMap<i64, DeclNode>,
    pub node_id_to_source_path: HashMap<i64, String>,
    pub gas_index: GasIndex,
    pub hint_index: HintIndex,
    pub doc_index: DocIndex,
    pub completion_cache: Arc<CompletionCache>,
    pub build_version: i32,
    pub content_hash: u64,
}

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<String, HashMap<NodeId, NodeInfo>>

path_to_abs: HashMap<String, String>

external_refs: ExternalRefs

id_to_path_map: HashMap<String, String>

decl_index: HashMap<i64, 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<i64, String>

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.

gas_index: GasIndex

Pre-built gas index from contract output. Built once, reused by hover, inlay hints, and code lens.

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).

Implementations

impl CachedBuild

pub fn new(ast: Value, build_version: i32) -> Self

Build the index from normalized AST output.

Canonical shape:

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

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<String, HashMap<NodeId, NodeInfo>>, path_to_abs: HashMap<String, String>, external_refs: ExternalRefs, id_to_path_map: HashMap<String, String>, build_version: i32, ) -> 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).

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.