Protocol Architecture πŸ“Š

HFDX follows a modular design with separation-of-concerns, ensuring each protocol component is auditable, maintainable, and upgradable without compromising system integrity.

Core components:

Component
Function

User Wallet

Asset custody, transaction signing

HFDX Router

Centralized execution gateway for all trades

Margin Engine

Risk, leverage, and margin computation

Liquidity Pool

Capital provisioning and loss absorption

Funding Module

Funding rate computation and periodic settlement

Oracle System

Provides external price indices

Liquidation Module

Force closes positions under margin breach

LLN Manager

Lifecycle management of Liquidity Loan Notes

System Architecture Flow:

                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    β”‚ User Wallet β”‚
                    β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
                           β”‚
                           β–Ό
                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    β”‚   Router    β”‚
                    β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
                           β”‚
            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
            β”‚                             β”‚
            β–Ό                             β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚ Margin Engine β”‚            β”‚ LLN Manager β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜            β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
            β”‚                           β”‚
            β–Ό                           β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚          Liquidity Pool                   β”‚
    β”‚              ◄──────►                     β”‚
    β”‚          Funding Module                   β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β”‚
                        β–Ό
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚ Liquidation Moduleβ”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

This architecture ensures clear separation between:

  • User interaction β€” Router & Wallet

  • Risk calculation and margin enforcement β€” Margin Engine

  • Capital management β€” Liquidity Pool & LLN Manager

  • External data integration β€” Oracle System

  • Position resolution β€” Liquidation Module

The modularity allows for incremental upgrades while preserving immutable core logic.

Last updated