Module namespaced_storage 

ERC-7201 namespaced storage layouts.

solc’s storageLayout output only covers conventional storage. Namespaces declared with @custom:storage-location erc7201:<id> are computed with Solar and appended to it, so storage decoding labels namespaced fields as <id>.<field>.

Re-exports

use alloy_primitives::U256; 🔒

use eyre::Result; 🔒

use foundry_compilers::ArtifactId; 🔒

use foundry_compilers::ProjectCompileOutput; 🔒

use foundry_compilers::artifacts::Remapping; 🔒

use foundry_compilers::artifacts::Sources; 🔒

use foundry_compilers::artifacts::StorageLayout; 🔒

use path_slash::PathExt; 🔒

use solar::ast::NatSpecKind; 🔒

use solar::interface::ColorChoice; 🔒

use solar::interface::Session; 🔒

use solar::interface::config::CompileOpts; 🔒

use solar::interface::config::ImportRemapping; 🔒

use solar::interface::source_map::FileLoader; 🔒

use solar::interface::source_map::FileName; 🔒

use solar::interface::source_map::SourceMap; 🔒

use solar::sema::Compiler; 🔒

use solar::sema::CompilerRef; 🔒

use solar::sema::Gcx; 🔒

use solar::sema::hir; 🔒

use solar::sema::output::StorageLayoutOutput; 🔒

use std::collections::BTreeMap; 🔒

use std::collections::HashMap; 🔒

use std::io; 🔒

use std::ops::ControlFlow; 🔒

use std::path::Path; 🔒

use std::path::PathBuf; 🔒

use std::sync::Arc; 🔒

Structs

NoFileLoader 🔒

Rejects filesystem access, so Standard JSON imports only resolve to the supplied sources.

StorageNamespace 🔒

A storage namespace declared by a struct in a contract or one of its bases.

Constants

ANNOTATION 🔒

The NatSpec tag content that marks a namespace; cheap to search for in source text.

Functions

collect_storage_layouts 🔒

Returns namespaces declared in contract and its linearized bases, once per declaration.

contracts_by_source 🔒

Maps (source, name) to contracts, with sources relative to root and slash-separated.

extend_storage_layout

Appends the ERC-7201 namespaces of contract and its bases to its storage layout.

extend_storage_layouts

Returns layouts with the ERC-7201 namespaces of each contract appended.

find_contract

Returns the contract name declared in the source path, relative to root.

has_annotation 🔒

Returns whether source mentions an ERC-7201 storage location.

has_annotations

Returns whether any parsed source mentions an ERC-7201 storage location.

lower

Lowers the parsed sources to HIR unless that has already happened.

merge_storage_namespaces 🔒

Merges namespaces, rejecting duplicate declarations before layout is modified.

parse_namespace 🔒

parse_standard_json

Parses Standard JSON sources, keyed by source unit name, without touching the filesystem.

project_storage_layouts

Returns the storage layouts of output’s artifacts with ERC-7201 namespaces appended.

scope_layout 🔒

Scopes type IDs to namespace and attributes every entry to contract.

solar_error 🔒

storage_namespace 🔒

Returns the ERC-7201 namespace declared by a struct’s @custom:storage-location tag.