Struct AddressTable 

pub struct AddressTable { /* private fields */ }

Tracks addresses for compact index-based referencing in the command stream.

Each address is assigned a sequential index in insertion order (0..MAX_INDEXED_ADDRESSES − 1). Sentinel indices (0xFC–0xFF) resolve to the 4 protocol roles (PM / SELF / WETH / NATIVE) without SET_ADDRESS or TLOAD, saving ~476 gas per use. The table is built during preprocessing and referenced during execution.

Implementations

impl AddressTable

pub fn new() -> Self

Build a new table. NATIVE_ADDRESS (address(0)) always resolves to SENTINEL_NATIVE without an explicit Self::add — the table is pre-seeded with sentinel_map[NATIVE_ADDRESS] = 0xFF (and the same for ZERO_ADDRESS, the same address).

pub fn with_sentinels( weth: Option<Address>, executor: Option<Address>, pool_manager: Option<Address>, ) -> Self

Build a table pre-seeded with the protocol sentinels: pool_manager → SENTINEL_PM, executor → SENTINEL_SELF, weth → SENTINEL_WETH. Any None sentinel is simply not registered.

pub fn add(&mut self, addr: Address) -> Result<u8, EncoderError>

Add an address, returning its index. Idempotent for duplicates.

Sentinel addresses (WETH, PM, executor, NATIVE) return their fixed sentinel index without adding to the table.

Errors

Returns EncoderError::AddressTableFull if the table already holds MAX_INDEXED_ADDRESSES entries and addr is neither a sentinel nor already present.

pub fn index_of(&self, addr: Address) -> Option<u8>

Return the table index (or sentinel index) for addr, or None if addr was never added and is not a sentinel.

pub fn contains(&self, addr: Address) -> bool

true if addr is a sentinel or a table entry.

pub fn addresses(&self) -> &[Address]

Return only table addresses (not sentinels) for SET_ADDRESS encoding, in insertion order.

Trait Implementations

impl Debug for AddressTable

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

Formats the value using the given formatter.

impl Default for AddressTable

fn default() -> Self

Returns the “default value” for a type.