soroban_sdk::token

Trait StellarAssetInterface

Source 
pub trait StellarAssetInterface {
    // Required methods
    fn set_admin(env: Env, new_admin: Address);
    fn admin(env: Env) -> Address;
    fn set_authorized(env: Env, id: Address, authorize: bool);
    fn authorized(env: Env, id: Address) -> bool;
    fn mint(env: Env, to: Address, amount: i128);
    fn clawback(env: Env, from: Address, amount: i128);
}
Expand description

Interface for admin capabilities for Token contracts, such as the Stellar Asset Contract.

Required Methods§

Source

fn set_admin(env: Env, new_admin: Address)

Sets the administrator to the specified address new_admin.

§Arguments
  • new_admin - The address which will henceforth be the administrator of this token contract.
§Events

Emits an event with topics ["set_admin", admin: Address], data = [new_admin: Address]

Source

fn admin(env: Env) -> Address

Returns the admin of the contract.

§Panics

If the admin is not set.

Source

fn set_authorized(env: Env, id: Address, authorize: bool)

Sets whether the account is authorized to use its balance. If authorized is true, id should be able to use its balance.

§Arguments
  • id - The address being (de-)authorized.
  • authorize - Whether or not id can use its balance.
§Events

Emits an event with topics ["set_authorized", id: Address], data = [authorize: bool]

Source

fn authorized(env: Env, id: Address) -> bool

Returns true if id is authorized to use its balance.

§Arguments
  • id - The address for which token authorization is being checked.
Source

fn mint(env: Env, to: Address, amount: i128)

Mints amount to to.

§Arguments
  • to - The address which will receive the minted tokens.
  • amount - The amount of tokens to be minted.
§Events

Emits an event with topics ["mint", admin: Address, to: Address], data = amount: i128

Source

fn clawback(env: Env, from: Address, amount: i128)

Clawback amount from from account. amount is burned in the clawback process.

§Arguments
  • from - The address holding the balance from which the clawback will take tokens.
  • amount - The amount of tokens to be clawed back.
§Events

Emits an event with topics ["clawback", admin: Address, to: Address], data = amount: i128

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§