dFun Synthetics Contracts

A comprehensive decentralized exchange (DEX) protocol for synthetic asset trading built on Solidity. This project provides a complete infrastructure for trading synthetic assets with advanced features including order management, position tracking, liquidation, and fee distribution.

Contact

If you are interested in building perp dex trading dapp, Contact here: Telegram | Twitter

🚀 Features

• Synthetic Asset Trading: Trade synthetic versions of popular assets (BTC, ETH, USDC, USDT, etc.)
• Advanced Order Management: Support for limit orders, market orders, and stop-loss orders
• Position Management: Track and manage long/short positions with leverage
• Liquidation System: Automated liquidation of undercollateralized positions
• Oracle Integration: Real-time price feeds for accurate asset pricing
• Fee Distribution: Automated fee collection and distribution system
• Role-Based Access Control: Secure multi-role permission system
• Cross-Chain Support: Deployed on NeoX and NeoXT4 networks

📁 Project Structure

contracts/
├── access/          # Access control and role management
├── adl/            # Automated Dealer Liquidation
├── bank/           # Banking and vault functionality
├── callback/       # Callback mechanisms
├── chain/          # Chain-specific utilities
├── config/         # Configuration management
├── data/           # Data storage and management
├── deposit/        # Deposit handling
├── error/          # Custom error definitions
├── event/          # Event emission utilities
├── exchange/       # Core exchange functionality
├── external/       # External contract integrations
├── feature/        # Feature flags and toggles
├── fee/            # Fee calculation and distribution
├── gas/            # Gas optimization utilities
├── liquidation/    # Liquidation mechanisms
├── market/         # Market management
├── mock/           # Mock contracts for testing
├── nonce/          # Nonce management
├── oracle/         # Price oracle integration
├── order/          # Order management system
├── position/       # Position tracking and management
├── pricing/        # Price calculation utilities
├── reader/         # Data reading utilities
├── referral/       # Referral system
├── role/           # Role-based access control
├── router/         # Exchange router functionality
├── subaccount/     # Subaccount management
├── swap/           # Swap functionality
├── token/          # Token contracts
├── tokens/         # Token implementations
├── utils/          # Utility functions
└── withdrawal/     # Withdrawal handling

🛠️ Technology Stack

• Solidity: ^0.8.26
• Hardhat: Development framework
• Foundry: Additional testing framework
• OpenZeppelin: Security libraries
• TypeScript: Development language
• Ethers.js: Ethereum interaction library

🚀 Quick Start

Prerequisites

• Node.js (v16 or higher)
• pnpm or npm
• Git

Installation

1. Clone the repository:

git clone https://github.com/L9T-Development/DeXFun-smart-contract-hyperliquid.git
cd DeXFun-smart-contract-hyperliquid

2. Install dependencies:

pnpm install
# or
npm install

3. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

Development

1. Compile contracts:

npx hardhat compile

2. Run tests:

npx hardhat test

3. Start local development network:

npx hardhat node

4. Deploy contracts:

npx hardhat deploy --network localhost

🌐 Supported Networks

• NeoX Mainnet (Chain ID: 47763)
• NeoXT4 Testnet (Chain ID: 12227332)
• Hardhat Local (Chain ID: 31337)

📋 Available Scripts

• npm run test - Run test suite
• npm run compile - Compile contracts
• npm run deploy - Deploy contracts
• npm run verify - Verify contracts on block explorer
• npm run lint - Run linting
• npm run fork:neoxt4 - Fork NeoXT4 testnet

🏗️ Core Components

Exchange Router

The main entry point for all trading operations, handling deposits, withdrawals, orders, and swaps.

Market System

Manages synthetic asset markets with configurable parameters for each trading pair.

Order Management

Comprehensive order system supporting:

• Limit orders
• Market orders
• Stop-loss orders
• Conditional orders

Position Management

Track and manage leveraged positions with:

• Real-time P&L calculation
• Margin requirements
• Position sizing

Oracle System

Secure price feed integration with:

• Multiple price sources
• Price validation
• Fallback mechanisms

Liquidation Engine

Automated liquidation system for:

• Undercollateralized positions
• Risk management
• Market stability

🔐 Security Features

• Reentrancy Protection: Global reentrancy guards
• Access Control: Role-based permissions
• Input Validation: Comprehensive parameter validation
• Oracle Security: Multiple price source validation
• Upgrade Safety: Immutable core contracts with proxy patterns

📊 Token Support

Synthetic Tokens

• FUNGAS (Synthetic Gas)
• FUNETH (Synthetic Ethereum)
• FUNBTC (Synthetic Bitcoin)
• FUNUSDC (Synthetic USD Coin)
• FUNUSDT (Synthetic Tether)

Native Tokens

• WGAS (Wrapped Gas)
• WETH (Wrapped Ethereum)
• WBTC (Wrapped Bitcoin)
• USDC (USD Coin)
• USDT (Tether)

🧪 Testing

The project includes comprehensive test coverage:

# Run all tests
npm run test

# Run specific test file
npx hardhat test test/market/Market.test.ts

# Run with gas reporting
REPORT_GAS=true npm run test

📝 Deployment

Local Development

npx hardhat deploy --network localhost

Testnet Deployment

npx hardhat deploy --network neoXT4

Mainnet Deployment

npx hardhat deploy --network neoX

🔧 Configuration

Environment Variables

• ACCOUNT_KEY: Private key for deployment
• NEOX_T4_ACCOUNT_KEY: NeoXT4 specific private key
• ACCOUNT_KEY_FILE: Path to key file
• REPORT_GAS: Enable gas reporting

Network Configuration

Networks are configured in hardhat.config.ts with:

• RPC endpoints
• Chain IDs
• Gas settings
• Account management

📚 Documentation

• Architecture Overview
• API Reference
• Deployment Guide
• Security Audit

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📄 License

This project is licensed under the BUSL-1.1 License - see the LICENSE file for details.