Contract Access Control Summary

This page summarizes who can call which functions across the major contracts in the Renatus Protocol.

Bonding.sol

  • Owner: Platform admin.
  • Key Functions:
    • launch(LaunchParams calldata params): Public function used by token creators to initiate a new token.
    • setBondingTaxParams, setFee, setMaxInitialBuy, setAssetRate: Owner-only functions for platform adjustments.

RenatusFactory.sol

  • Owner: Platform admin.
  • Key Functions:
    • createPair(...): Deploys new RenatusPair for a token.
    • setBonding(address), setPairImplementation(address): Owner-only to configure main contract relationships.
  • FeeTo, FeeToSetter: Traditional factory roles for collecting fees, though often overshadowed by the bonding logic.

LiqLocker.sol

  • Owner: Platform admin.
  • Key Roles:
    • Admin: Can set authorized callers.
    • AdminFeeCollector: Can claim admin fees.
  • Authorized Callers: Typically includes the graduated token or factory.
  • Key Functions:
    • withdrawLiquidity(...), claimFees(...): Usable by any user with locked liquidity.
    • claimAdminFees(...): Only the designated adminFeeCollector can invoke.
    • registerGraduatedPosition(...), registerMigration(...): Called by authorized contracts (e.g., graduated token) to set up or manage user shares.

AgentToken.sol

  • Owner: Typically the factory (on deployment), but ownership may be transferred.
  • Pair: The pair contract can call restricted methods like graduate() or setGraduatedToken(...).
  • Key Functions:
    • Tax management: setGraduatedTaxRate, lockGraduatedTaxRate, setGraduatedTaxRecipient, etc.
    • Exclusion/inclusion management: setExcludedFromTax(...), setIncludedInTax(...), lockExclusions(), lockInclusions(), etc.
  • Immutability: Aside from graduated tax changes and address exclusions/inclusions, all other token parameters are fixed.

GraduatedToken.sol

  • Owner: Specified by the token creator at launch.
  • Key Functions:
    • migrate(): Public function for migrating old tokens to the new graduated token.
    • Inherits tax management logic from AgentToken.
  • Pair: Not relevant in the same sense as the bonding phase; the new pair is on V3, so direct calls come from the LiqLocker or authorized addresses.

Notes on Security & Trust

  1. Administrative Locks: Both AgentToken and GraduatedToken allow permanently locking certain fields (tax rate, recipients, exclusions, etc.). This fosters community trust by ensuring no post-launch surprises.
  2. Platform Admin vs. Token Creator:
    • Platform Admin controls the overall protocol, including Bonding and Factory settings.
    • Token Creator only controls their specific token’s post-graduation tax configuration.
  3. LiqLocker Access**:
    • Anyone with vested liquidity can call user functions.
    • Only authorized addresses (platform, or graduated token) can register new positions or migrations.
    • The admin fee collector is the only entity able to claim the admin’s portion of fees.

By understanding these roles and constraints, developers can integrate with Renatus Protocol confidently, knowing which calls are allowed and by whom.