Revolutionary decentralized exchange combining ERC-20 and ERC-223 token standards with advanced AI-driven trading features, cross-chain capabilities, and institutional-grade functionality.
- Quick Start
- Key Features
- Important Resources
- Architecture
- Documentation
- Competitive Advantages
- Roadmap
- Contributing
- License
- Node.js 18+
- npm or yarn
- MetaMask or compatible wallet
# Clone the main contracts repository
git clone https://github.com/EthereumCommonwealth/Dex223-contracts.git
# Clone the UI repository
git clone https://github.com/EthereumCommonwealth/Dex223-UI.git
# Navigate to UI directory
cd Dex223-UI
# Install dependencies
npm install
# Start development server
npm run dev- Live Test App - Try Dex223 features on testnet
- Swap Interface - Test Dex223 Swap and Liquidity Provision
- Get Free Test Tokens: Click "Get free tokens" button on any Dex223 test page
| Token Standards | Multi-Chain | AI-Powered | Performance |
|---|---|---|---|
| ERC-20 + ERC-223 | 50+ EVM Chains | Smart Order Routing | 15% Cheaper Gas |
| Future-Proof | Cross-Chain Swaps | Predictive Analytics | EIP-1559 Support |
| Auto-Conversion | Atomic Execution | Risk Assessment | MEV Protection |
- Dual Token Support: Seamless ERC-20 and ERC-223 token trading
- Future-Proof: ERC-223 provides enhanced security and efficiency
- Backward Compatibility: Safe migration path from ERC-20 to ERC-223
- Auto-Conversion: Convert between token standards with one click
Dex223 supports 50+ EVM-compatible blockchains including:
Layer 1 Networks (Click to expand)
- Ethereum Mainnet & Sepolia: Primary blockchain support
- Binance Smart Chain (BSC): High-performance DeFi chain
- Polygon: Low-cost transactions
- Avalanche: Fast finality and low fees
- Fantom: High-speed transactions
- Cronos: Crypto.com ecosystem
- Harmony: Cross-shard transactions
- Celo: Mobile-first blockchain
- Moonbeam & Moonriver: Polkadot ecosystem
- Astar & Shiden: Polkadot parachains
- Gnosis Chain: DAO-governed chain
- Klaytn: Korean blockchain platform
- Velas: AI-optimized blockchain
- IoTeX: IoT-focused blockchain
- Oasis: Privacy-focused blockchain
- Evmos: Cosmos EVM chain
- Canto: DeFi-focused chain
- Kava: DeFi lending platform
- OKX Chain: Exchange-backed chain
- Conflux: Tree-graph consensus
- Metis: Layer 2 solution
- Boba Network: Layer 2 scaling
- Aurora: NEAR Protocol EVM
- Chiliz: Sports & entertainment
Layer 2 Networks (Click to expand)
- Arbitrum One & Nova: Optimistic rollups
- Optimism: Ethereum scaling solution
- Base: Coinbase-backed L2
- zkSync Era: Zero-knowledge rollup
- Polygon zkEVM: ZK-powered scaling
- Linea: ConsenSys L2 solution
- Mantle: Modular L2
- Scroll: ZK-rollup scaling
- Immutable X: NFT-focused L2
- Loopring: ZK-rollup DEX
- Smart Order Routing: AI-optimized trade execution
- Predictive Analytics: ML-powered price predictions
- Risk Assessment: AI-driven token risk scoring
- Personalized Recommendations: User-specific trading insights
- Spot Trading: Traditional token swaps
- Margin Trading: Leveraged trading capabilities
- Liquidity Provision: Earn from providing liquidity
- Portfolio Management: Comprehensive position tracking
- 15% Cheaper Gas: Optimized gas usage compared to competitors
- EIP-1559 Support: Modern gas fee model
- Custom Gas Settings: Speed vs. cost optimization
- MEV Protection: Advanced order protection
| Development | Testing | Community | Documentation |
|---|---|---|---|
| Latest Report | Test App | Telegram | Architecture |
| GitHub Repo | Swap Interface | Discord | Security |
| White Paper | Faucets | Roadmap |
- Latest Dex223 Development Report (1/1/2025) - Most recent development progress and updates
- Test Application - Try Dex223 features on testnet
- Swap Interface - Test Dex223 Swap and Liquidity Provision
- Get Free Test Tokens: Click "Get free tokens" button on any Dex223 test page
- Chainlink Sepolia Faucet - Get SepoliaETH test tokens
- Alchemy Sepolia Faucet - Alternative SepoliaETH faucet
- Twitter - Follow for latest updates
- Telegram - Join our community
- YouTube - Video content and tutorials
- Reddit - Community discussions
- Discord - Developer and user community
- Tokenomics - Token economics and distribution
- Medium Blog - Technical articles and updates
- GitHub Repository - Source code and development
- Ethereum Commonwealth - Community governance
- Roadmap Issues - Development roadmap tracking
- Pitch Deck - Project presentation
- Encapsulated Margin Trading Concept - Learn about our innovative trading approach
- Where to Buy - Official trading platform
- Market Valuation - CoinMarketCap listing and details
- ERC-20 Issues - Understanding ERC-20 limitations
- ERC-20 Live Losses Calculator - Real-time ERC-20 token loss tracking
- ERC-223 Official Documentation - Ethereum Improvement Proposal
- ERC-223 Developer Docs - Official Ethereum documentation
- Financial Transparency - Financial reporting and transparency
- White Paper (DRAFT) - Technical white paper
- Coinbase Onramp/Offramp API - Fiat onramp integration reference
- Email: Contact@Dex223.io
Dex223 is organized into multiple repositories for better maintainability:
- Dex223-contracts - Smart contracts (GPL-3.0)
- Dex223-UI - Frontend application
- dex223-liquidations-engine - Liquidation engine
dex223/
├── apps/
│ ├── web/ # Main DEX application
│ │ ├── app/ # Next.js 15 App Router
│ │ ├── components/ # React components
│ │ ├── hooks/ # Custom React hooks
│ │ ├── stores/ # Zustand state management
│ │ ├── lib/ # Utility functions
│ │ ├── types/ # TypeScript type definitions
│ │ └── public/ # Static assets
│ └── blog/ # Content platform
├── packages/
│ ├── ui/ # Shared component library
│ │ ├── components/ # Reusable UI components
│ │ ├── stories/ # Storybook stories
│ │ └── index.ts # Component exports
│ ├── tailwind-config/ # Tailwind CSS configuration
│ ├── typescript-config/ # TypeScript configuration
│ └── sdk/ # Blockchain SDK
├── docs/ # Documentation
├── contracts/ # Smart contracts
├── scripts/ # Build and deployment scripts
└── tools/ # Development tools
- Frontend: Next.js 15, React 18, TypeScript
- Styling: Tailwind CSS with custom design system
- State Management: Zustand (client), React Query (server)
- Blockchain: Wagmi + Viem for Ethereum interactions
- Internationalization: next-intl (EN/ES/ZH support)
- UI Components: Custom library with Storybook integration
| Contract | Address | Description |
|---|---|---|
| WETH9 | 0xb16F35c0Ae2912430DAc15764477E179D9B9EbEa | Wrapped Ether |
| TOKEN_CONVERTER | 0xe831FDB60Dc18c264f1B45cadAFD5f2f2993EE83 | ERC-20 to ERC-223 converter |
| POOL_LIBRARY | 0x1bc27faa75002e1f034e57c9e62236c2e0f7ed16 | Pool calculation library |
| FACTORY | 0x3BD240DC11601223e35F2b803905b832c2798c2c | Pool factory contract |
| SWAP_ROUTER | 0x6d1a12d5921692f240CcDD9d4b7cAc2cCeD1BEd2 | Swap routing contract |
| POSITION_MANAGER | 0x091249267d085055fa2f281fa3f6c0cf4bf70bae | Position management |
| POOL_USDC_WETH | 0x3B2E627DbDd6B8cc2CbA9B71154b32C9bb5Ed5d3 | USDC/WETH liquidity pool |
| Contract | Address | Description |
|---|---|---|
| CORE_AUTOLISTING | 0x5c24027303865b744f2794945aee88eA56F1F5ee | Core auto-listing contract |
| FREE_AUTOLISTING | 0x8D13f2795228aB18faeFBdF9461E7E46b5853Bc5 | Free auto-listing contract |
| AUTOLISTINGS_REGISTRY | 0xF3129265872004bD235de4Ac5e312254D962cC38 | Auto-listing registry |
| Strategic | Technical | Security | Planning |
|---|---|---|---|
| Competitive Analysis | Architecture Guide | Security Guide | Future Roadmap |
| AI Integration Guide | Multi-Chain Config | UI Structure | Smart Contracts |
| Feature | Dex223 | Uniswap | Sui | Hyperliquid |
|---|---|---|---|---|
| Token Standards | ✅ ERC-20 + ERC-223 | ❌ ERC-20 only | ❌ Sui native | ❌ N/A |
| Trading Types | ✅ Spot + Margin | ❌ Spot only | ❌ Spot | ✅ Perpetuals |
| Gas Optimization | ✅ Advanced (15% cheaper) | ❌ Basic | ❌ Different model | ✅ Off-chain |
| Auto-Listing | ✅ Yes | ❌ No | ❌ Limited | ❌ N/A |
| Multi-Chain | ✅ Yes | ❌ Limited | ❌ No | ✅ Yes |
| AI Features | ✅ Comprehensive | ❌ None | ❌ None | ❌ Limited |
| Phase | Timeline | Focus | Status |
|---|---|---|---|
| Phase 1 | Q1 2026 | AI Integration | Planning |
| Phase 2 | Q2 2026 | Cross-Chain Features | Planning |
| Phase 3 | Q3 2026 | Social Trading | Planning |
| Phase 4 | Q4 2026 | Institutional Features | Planning |
| Phase 5 | Q1 2027 | Mobile Experience | Planning |
| Phase 6 | Q2 2027 | Sustainability | Planning |
| Phase 7 | Q3 2027 | Advanced DeFi | Planning |
| Phase 8 | Q4 2027 | Gamification | Planning |
| Phase 9 | Q1 2028 | Analytics & Research | Planning |
Detailed Roadmap (Click to expand)
- Smart Order Routing AI
- Predictive Price Analytics
- Risk Assessment Engine
- Personalized Trading Recommendations
- Atomic Cross-Chain Swaps
- Cross-Chain Liquidity Aggregation
- Native Token Support Across Chains
- Unified Cross-Chain Portfolio
- Copy Trading Platform
- Trader Leaderboards
- Social Trading Communities
- Performance Analytics
- OTC Trading Desk
- Advanced Order Types
- Institutional APIs
- Compliance Tools
- Progressive Web App
- Voice Trading
- Gesture Controls
- Mobile Optimization
- Carbon-Neutral Trading
- Green Features
- Staking Integration
- Environmental Tracking
- Flash Loan Integration
- MEV Protection
- DeFi Primitives
- Insurance Products
- Trading Competitions
- NFT Integration
- Achievement System
- Reward Mechanisms
- On-Chain Analytics
- Research Platform
- Advanced Metrics
- Educational Content
We welcome contributions from the community! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
# Install dependencies
npm install
# Run development server
npm run dev
# Run tests
npm test
# Build for production
npm run buildThis project is licensed under the GPL-3.0 License - see the LICENSE file for details.
- Smart Contracts: GPL-3.0 License
- Frontend UI: GPL-3.0 License
- Documentation: MIT License (this repository)
- All smart contracts are open source under GPL-3.0
- Frontend application is open source under GPL-3.0
- Documentation is provided under MIT License for maximum accessibility
- Commercial use requires compliance with GPL-3.0 terms
Made with love by the Dex223 Team
