Struct FaucetMetadataConfigNote 

pub struct FaucetMetadataConfigNote { /* private fields */ }

A FaucetMetadataConfig note: triggers a token metadata admin action on the faucet that consumes it.

A single note script dispatches on a selector in the note’s storage to one of the faucet’s metadata setters (set_max_supply, set_description, set_logo_uri, set_external_link). Authorization is enforced by those procedures through the account-wide Authority component against the note sender, so the note carries no assets and its authorization is bound to sender at creation time.

See FaucetMetadataConfig for which actions apply to which faucet kind.

The note is always public and tagged for target — the faucet whose metadata is being managed. The sender is the account authorized for the action per the target’s Authority configuration (the owner under Authority::OwnerControlled, or a role member under Authority::RbacControlled).

The note is bound to target by a NetworkAccountTarget attachment: the script asserts that the consuming account matches that target before dispatching, so the note cannot be consumed by a third-party account that merely accepts its sender.

Construct one with the builder; convert it into a protocol Note infallibly via Note::from.

Implementations

impl FaucetMetadataConfigNote

pub fn builder() -> FaucetMetadataConfigNoteBuilder

Builds a new FaucetMetadataConfigNote that applies config to target.

Errors

Returns an error if:

• target is not a public account (the note is bound to it via a NetworkAccountTarget, which requires a public target).
• the attachments carry a NetworkAccountTarget for an account other than target.
• the attachments exceed their protocol limit (see NoteAttachments::new); the target attachment occupies one of the available slots when the caller does not supply it.

impl FaucetMetadataConfigNote

pub const MAX_NUM_STORAGE_ITEMS: usize

Upper bound on the number of storage items of a FaucetMetadataConfig note.

The layout is variable: SetMaxSupply uses 2 items ([selector, new_max_supply]), while the three string actions use 32 ([selector, 0, 0, 0, value(28)]).

pub fn script() -> NoteScript

Returns the script of the FaucetMetadataConfig note.

pub fn script_root() -> NoteScriptRoot

Returns the FaucetMetadataConfig note script root.

pub fn sender(&self) -> AccountId

Returns the account ID of the note’s sender (the account authorized for the action).

pub fn target(&self) -> AccountId

Returns the account ID of the managed faucet (the account the note is tagged for).

pub fn config(&self) -> &FaucetMetadataConfig

Returns the metadata action carried by the note.

pub fn serial_number(&self) -> Word

Returns the note’s serial number.

pub fn attachments(&self) -> &NoteAttachments

Returns the attachments carried by the note.

Trait Implementations

impl Clone for FaucetMetadataConfigNote

fn clone(&self) -> FaucetMetadataConfigNote

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FaucetMetadataConfigNote

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

Formats the value using the given formatter.

impl From<FaucetMetadataConfigNote> for Note

fn from(note: FaucetMetadataConfigNote) -> Note

Converts to this type from the input type.

impl NoteConsumptionCost for FaucetMetadataConfigNote

fn consumption_cycles() -> u32

Cycles of the canonical network-account transaction consuming this note (maximum across the benchmarked execution paths - an estimate, not a worst case).

fn created_notes() -> Vec<NoteScriptRoot>

Script roots of all the notes this note’s consumption is expected to create.