Struct TIP20Factory 

pub struct TIP20Factory {
    address: Address,
    storage: StorageCtx,
}

Fields

address: Address

storage: StorageCtx

Implementations

impl TIP20Factory

pub fn new() -> Self

Creates an instance of the precompile.

Caution: This does not initialize the account, see Self::initialize.

fn __new(address: Address) -> Self

fn __initialize(&mut self) -> Result<()>

fn emit_event(&mut self, event: impl IntoLogData) -> Result<()>

pub fn emitted_events(&self) -> &Vec<LogData>

Available on crate features test-utils only.

pub fn clear_emitted_events(&mut self)

Available on crate features test-utils only.

pub fn assert_emitted_events(&self, expected: Vec<impl IntoLogData>)

Available on crate features test-utils only.

impl TIP20Factory

pub fn initialize(&mut self) -> Result<()>

Initializes the TIP-20 factory precompile.

pub fn get_token_address(&self, call: getTokenAddressCall) -> Result<Address>

Computes the deterministic address for a token given sender and salt. Reverts if the derived address falls within the reserved range (lower 8 bytes < RESERVED_SIZE).

Errors

• AddressReserved — the derived address is in the reserved range

pub fn is_tip20(&self, token: Address) -> Result<bool>

Returns true if token has the correct TIP-20 prefix and has code deployed.

pub fn create_token( &mut self, sender: Address, call: createTokenCall, ) -> Result<Address>

Deploys a new TIP-20 token at a deterministic address derived from sender and salt.

Validates that the token does not already exist, the quote token is a deployed TIP-20 of a compatible currency, and the derived address is outside the reserved range. Initializes the token via TIP20Token::initialize.

Errors

• TokenAlreadyExists — a TIP-20 is already deployed at the derived address
• InvalidQuoteToken — quote token is not a deployed TIP-20 or has incompatible currency
• AddressReserved — the derived address is in the reserved range

pub fn create_token_reserved_address( &mut self, address: Address, name: &str, symbol: &str, currency: &str, quote_token: Address, admin: Address, ) -> Result<Address>

Deploys a TIP-20 token at a reserved address (lower 8 bytes < RESERVED_SIZE). Used during genesis or hardforks to bootstrap protocol tokens like pathUSD.

Errors

• InvalidToken — address does not have the TIP-20 prefix
• TokenAlreadyExists — a TIP-20 is already deployed at address
• InvalidQuoteToken — quote token is invalid, not deployed, or has incompatible currency; pathUSD must use Address::ZERO as quote token
• AddressNotReserved — the address is outside the reserved range

impl TIP20Factory

pub fn create_precompile(cfg: &CfgEnv<TempoHardfork>) -> DynPrecompile

Creates the EVM precompile for this type.

Trait Implementations

impl ContractStorage for TIP20Factory

fn address(&self) -> Address

Contract address.

fn storage(&self) -> &StorageCtx

Contract storage accessor.

fn storage_mut(&mut self) -> &mut StorageCtx

Contract storage mutable accessor.

fn is_initialized(&self) -> Result<bool>

Returns true if the contract has been initialized (has bytecode deployed).

impl Default for TIP20Factory

fn default() -> Self

Returns the “default value” for a type.

impl Precompile for TIP20Factory

fn call(&mut self, calldata: &[u8], msg_sender: Address) -> PrecompileResult

Dispatches an EVM call to this precompile.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 20 bytes