SAC Admin

[brozorec]

The current token::StellarAssetClient in "soroban_sdk" provides built-in support for managing SAC (Stellar Asset Contract) administrative tasks. However, some use cases require more flexible or customized logic.

To address this, we will implement a dedicated SAC Admin module to which the admin tasks can be delegated to and that replicates the admin functionality of token::StellarAssetClient. This allows developers to define custom rules on top of that (e.g., role-based access, 2-step admin transfers, mint rate limits, upgradeability) while maintaining compatibility with SACs.

Interface

pub trait SACAdmin {
  fn admin(env: Env) -> Address;
  fn set_admin(env: Env, new_admin: Address);
  fn set_authorized(env: Env, id: Address, authorize: bool);
  fn mint(env: Env, to: Address, amount: i128);
  fn clawback(env: Env, from: Address, amount: i128);
}

Events

• ["set_admin", admin: Address, sep0011_asset: String], data = new_admin: Address
• ["set_authorized", admin: Address, id: Address, sep0011_asset: String], data = authorize: bool
• ["mint", admin: Address, to: Address, sep0011_asset: String], data = amount: i128
• ["clawback", admin: Address, from: Address, sep0011_asset: String], data = amount: i128

Notes

This module is incompatible with our stellar_contracts::fungible which is meant only for "pure" contract tokens, while this one must be used only for SACs.

---

For more context, see:

• https://developers.stellar.org/docs/build/guides/tokens/custom-sac-admin
• https://github.com/stellar/stellar-protocol/blob/master/core/cap-0046-06.md