Struct AccountComponent 

pub struct AccountComponent { /* private fields */ }

An AccountComponent defines a Library of code and the initial value and types of the StorageSlots it accesses.

One or more components can be used to built AccountCode and AccountStorage.

Each component is independent of other components and can only access its own storage slots. Each component defines its own storage layout starting at index 0 up to the length of the storage slots vector.

Components define the AccountTypes they support, meaning whether the component can be used to instantiate an account of that type. For example, a component implementing a fungible faucet would only specify support for AccountType::FungibleFaucet. Using it to instantiate a regular account would fail. By default, the set of supported types is empty, so each component is forced to explicitly define what it supports.

Implementations

impl AccountComponent

pub fn new( code: Library, storage_slots: Vec<StorageSlot>, ) -> Result<AccountComponent, AccountError>

Returns a new AccountComponent constructed from the provided library and storage_slots.

All procedures exported from the provided code will become members of the account’s public interface when added to an AccountCode.

Errors

The following list of errors is exhaustive and can be relied upon for expecting the call to this function. It is recommended that custom components ensure these conditions by design or in their fallible constructors.

Returns an error if:

• The number of given StorageSlots exceeds 255.

pub fn compile( source_code: impl Parse, assembler: Assembler, storage_slots: Vec<StorageSlot>, ) -> Result<AccountComponent, AccountError>

Returns a new AccountComponent whose library is compiled from the provided source_code using the specified assembler and with the given storage_slots.

All procedures exported from the provided code will become members of the account’s public interface when added to an AccountCode.

Errors

Returns an error if:

• the compilation of the provided source code fails.
• The number of storage slots exceeds 255.

pub fn from_template( template: &AccountComponentTemplate, init_storage_data: &InitStorageData, ) -> Result<AccountComponent, AccountError>

Instantiates an AccountComponent from the AccountComponentTemplate.

The template’s component metadata might contain placeholders, which can be replaced by mapping storage placeholders to values through the init_storage_data parameter.

Errors

• If any of the component’s storage entries cannot be transformed into a valid storage slot. This could be because the metadata is invalid, or storage values were not provided (or they are not of a valid type)

pub fn from_package_with_init_data( package: &Package, init_storage_data: &InitStorageData, ) -> Result<AccountComponent, AccountError>

Creates an AccountComponent from a Package using InitStorageData.

This method provides type safety by leveraging the component’s metadata to validate storage initialization data. The package must contain explicit account component metadata.

Arguments

• package - The package containing the library and account component metadata
• init_storage_data - The initialization data for storage slots

Errors

Returns an error if:

• The package does not contain account component metadata
• The package cannot be converted to an AccountComponentTemplate
• The storage initialization fails due to invalid or missing data
• The component creation fails

pub fn storage_size(&self) -> u8

Returns the number of storage slots accessible from this component.

pub fn library(&self) -> &Library

Returns a reference to the underlying Library of this component.

pub fn mast_forest(&self) -> &MastForest

Returns a reference to the underlying MastForest of this component.

pub fn storage_slots(&self) -> &[StorageSlot]

Returns a slice of the underlying StorageSlots of this component.

pub fn supported_types(&self) -> &BTreeSet<AccountType>

Returns a reference to the supported AccountTypes.

pub fn supports_type(&self, account_type: AccountType) -> bool

Returns true if this component supports the given account_type, false otherwise.

pub fn get_procedures(&self) -> Vec<(Word, bool)>

Returns a vector of tuples (digest, is_auth) for all procedures in this component.

pub fn get_procedure_root_by_name( &self, proc_name: impl TryInto<QualifiedProcedureName>, ) -> Option<Word>

Returns the digest of the procedure with the specified name, or None if it was not found in this component’s library or its library path is malformed.

pub fn with_supported_type( self, supported_type: AccountType, ) -> AccountComponent

Adds supported_type to the set of AccountTypes supported by this component.

This function has the semantics of BTreeSet::insert, i.e. adding a type twice is fine and it can be called multiple times with different account types.

pub fn with_supported_types( self, supported_types: BTreeSet<AccountType>, ) -> AccountComponent

Overwrites any previously set supported types with the given set.

This can be used to reset the supported types of a component to a chosen set, which may be useful after cloning an existing component.

pub fn with_supports_all_types(self) -> AccountComponent

Sets the AccountTypes supported by this component to all account types.

Trait Implementations

impl Clone for AccountComponent

fn clone(&self) -> AccountComponent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AccountComponent

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

Formats the value using the given formatter.

impl From<AccountComponent> for Library

fn from(component: AccountComponent) -> Library

Converts to this type from the input type.

impl From<AuthEcdsaK256Keccak> for AccountComponent

fn from(ecdsa: AuthEcdsaK256Keccak) -> AccountComponent

Converts to this type from the input type.

impl From<AuthEcdsaK256KeccakAcl> for AccountComponent

fn from(ecdsa: AuthEcdsaK256KeccakAcl) -> AccountComponent

Converts to this type from the input type.

impl From<AuthEcdsaK256KeccakMultisig> for AccountComponent

fn from(multisig: AuthEcdsaK256KeccakMultisig) -> AccountComponent

Converts to this type from the input type.

impl From<AuthRpoFalcon512> for AccountComponent

fn from(falcon: AuthRpoFalcon512) -> AccountComponent

Converts to this type from the input type.

impl From<AuthRpoFalcon512Acl> for AccountComponent

fn from(falcon: AuthRpoFalcon512Acl) -> AccountComponent

Converts to this type from the input type.

impl From<AuthRpoFalcon512Multisig> for AccountComponent

fn from(multisig: AuthRpoFalcon512Multisig) -> AccountComponent

Converts to this type from the input type.

impl From<BasicFungibleFaucet> for AccountComponent

fn from(faucet: BasicFungibleFaucet) -> AccountComponent

Converts to this type from the input type.

impl From<BasicWallet> for AccountComponent

fn from(_: BasicWallet) -> AccountComponent

Converts to this type from the input type.

impl From<NetworkFungibleFaucet> for AccountComponent

fn from(network_faucet: NetworkFungibleFaucet) -> AccountComponent

Converts to this type from the input type.

impl From<NoAuth> for AccountComponent

fn from(_: NoAuth) -> AccountComponent

Converts to this type from the input type.

impl PartialEq for AccountComponent

fn eq(&self, other: &AccountComponent) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for AccountComponent

impl StructuralPartialEq for AccountComponent