For the complete documentation index, see llms.txt. This page is also available as Markdown.

FXD Smart Contract Architecture

FXD Stablecoin Smart Contract System Design
FXD Stablecoin Smart Contract Architecture

Fathom Protocol Smart Contract Architecture

The structure comprises distinct modules, each responsible for a set of defined operations.

Core Components

  1. Proxy Module: Interfaces for the core contracts of the protocol.

    • ProxyWallet: Calls functions within the FathomProxyActions contract for user interactions.

    • ProxyActionsStorage: Stores the address of the FathomProxyActions contract.

    • ProxyWalletRegistry: Oversees the creation of proxy wallets owned by users.

  2. Position Module: Handles the creation and tracking of user positions.

    • PositionManager: Initiates user positions and maintains a record of them.

  3. Stablecoin Core Module: Central to the management of the FXD stablecoin's lifecycle.

    • BookKeeper: Monitors and manages each position's locked collateral and debt share.

    • CollateralPoolConfig: Manages configurations for collateral pools.

    • StablecoinAdapter: Oversees the minting and burning functions of the FathomStablecoin contract.

  4. StableSwapModule: Supports the provision of liquidity and the execution of FXD<->xUSDT 1:1 swaps.

    • StableSwapModuleWrapper: Integrates and administers the protocol's liquidity pools.

  5. Price Module: Delivers accurate price information for assets.

    • PriceFeed: Gathers price data from price source and feeds it into the protocol.

    • PriceOracle: Transforms raw price from PriceFeed to include a safety margin, using the LTV ratio.

  6. Liquidation Module: Maintains the protocol's financial health by managing under-collateralized positions.

    • LiquidationEngine: Carries out the liquidation process according to predefined rules.

    • FixedSpreadLiquidationStrategy: Directs liquidation activities, ensuring consistency through a fixed spread.

  7. Emergency Module: Pause or Terminate the protocol.

    • ShowStopper: Stops and terminates the whole protocol and executes the emergency shutdown process to return collateral

    • AdminControls: Pauses the protocol at once.

Last updated