---

Fate Protocol

Fate Protocol is a decentralized, perpetual prediction market that operates continuously without expiration. It replaces traditional order books with a dual-vault system—where users buy and sell bullCoins and bearCoins—enabling speculation on market trends in a fluid, always-on ecosystem.

Built with cutting-edge Web3 technologies, Fate Protocol delivers high-performance trading experiences with gas-optimized smart contracts and real-time price feeds from multiple oracle providers.

✨ Key Features

• Perpetual Market: No expiration dates; users can enter or exit positions at any time
• Dual-Vault System: Separate vaults for bullCoins and bearCoins, eliminating order book complexity
• Dynamic Fee Structure: Fixed fees on transactions automatically balance vault reserves
• DistributeOutcome Function: Community-driven reserve adjustments ensure fairness and transparency
• Self-Balancing: Automated fund redistribution between vaults based on market movements
• Multi-Chain Support: Deployed across Ethereum, Base, BNB Smart Chain, Ethereum Classic, and Polygon
• Real-Time Price Feeds: Integrated Chainlink and Hebeswap oracles for accurate market data
• Gas-Optimized Contracts: Efficient smart contract design minimizes transaction costs

---

🎬 Video Tutorials

1. Protocol Walkthrough: Fate Protocol Walkthrough

2. Interaction Tutorial: Fate Protocol Interaction Walkthrough

Technical Architecture

Frontend

• Next.js 15 with React Server Components
• TypeScript for type safety
• TailwindCSS with shadcn/ui components
• Framer Motion for animations
• Recharts for data visualization

Blockchain

• Wagmi v2 for Web3 hooks
• Ethers.js v6 for Ethereum interactions
• Viem for lightweight blockchain calls
• Rainbow-Kit supporting 10+ wallets
• TanStack React Query for data sync

Smart Contracts

• Multi-Chain: Ethereum, Base, BNB Smart Chain, Ethereum Classic and Polygon
• Oracles: Chainlink and Hebeswap price feeds
• Gas-Optimized: Minimal transaction costs
• Audited: Transparent fee structures

---

Performance Features

Frontend Optimizations

• Server Components: Reduced client-side JavaScript
• Code Splitting: Automatic route-based splitting
• Static Generation: Pre-built pages for faster loads
• Streaming: Progressive page loading

User Experience

• Skeleton Screens: Immediate loading feedback
• Optimistic Updates: Instant UI updates
• IndexedDB: Local storage for offline capability
• Mobile Optimized: Responsive touch interactions

---

Supported Networks

Fate Protocol is deployed across multiple EVM-compatible networks:

• Base - Main deployment with optimized gas costs
• BNB Smart Chain - High-performance trading environment
• Ethereum Classic - Decentralized and secure network
• Ethereum Mainnet - Primary Ethereum network
• Polygon - Polygon mainnet
• Sepolia Testnet - Ethereum testnet for development

---

Deployed Contracts

Pool Factory Contracts

Network	Contract Address	BlockScout	Status
Ethereum Classic	0x6eb2eec7bcc4096e35d7bc467e411a505c7db202	View	✅ Deployed
Sepolia Testnet	0x5fae23ab9c0b36f30bb4c6ab1d7b9c8cdbef8d18	View	✅ Deployed
Base	0x0000000000000000000000000000000000000000	-	⏳ Pending
BNB Smart Chain	0x0000000000000000000000000000000000000000	-	⏳ Pending
Ethereum Mainnet	0x0000000000000000000000000000000000000000	-	⏳ Pending
Polygon	0x0000000000000000000000000000000000000000	-	⏳ Pending

Oracle Adapter Contracts

Network	Contract Address	BlockScout	Status
Ethereum Classic	0x017cdc5ed9ba47a6a5c4414e8c66e7d7e967a83a	View	✅ Deployed
Sepolia Testnet	0x2cbd9e1ec213f5ef2c8f0703514254ff7288723e	View	✅ Deployed
Base	0x0000000000000000000000000000000000000000	-	⏳ Pending
BNB Smart Chain	0x0000000000000000000000000000000000000000	-	⏳ Pending
Ethereum Mainnet	0x0000000000000000000000000000000000000000	-	⏳ Pending
Polygon	0x0000000000000000000000000000000000000000	-	⏳ Pending

---

Getting Started

Prerequisites

• Node.js 18+
• npm/yarn/pnpm
• MetaMask or any other web3 wallet browser extension

Installation

1. Clone the Repository

git clone https://github.com/StabilityNexus/Fate-EVM-Frontend.git
cd Fate-EVM-Frontend

2. Install Dependencies

Using your preferred package manager:

npm install
# or
yarn install
# or
pnpm install

3. Run the Development Server

Start the app locally:

npm run dev
# or
yarn dev
# or
pnpm dev

4. Open your Browser

Navigate to http://localhost:3000 to see the application.

---

Project Structure

src/
│   ├── [pool]/            # Pool interactions
│   ├── createPool/        # Pool creation
│   ├── explorePools/      # Pool discovery
│   └── portfolio/         # User portfolio
├── components/             # UI components
│   ├── Explore/          # Pool exploration
│   ├── FatePoolCard/     # Pool cards
│   ├── Forms/            # Form components
│   └── ui/               # Base components
├── lib/                  # Contract Interaction logic
└── utils/                # Utilities & configs
    ├── abi/              # Contract ABIs
    └── chains/           # Chain configs

---

Deployment

GitHub Pages

1. Push to main branch
2. GitHub Actions auto-deploys
3. Available at GitHub Pages URL

Manual Build

npm run build
npm run start

Contributing

We welcome contributions of all kinds! To contribute:

1. Fork the repository and create your feature branch (git checkout -b feature/AmazingFeature).
2. Commit your changes (git commit -m 'Add some AmazingFeature').
3. Run the development workflow commands to ensure code quality:
   • npm run lint
4. Push your branch (git push origin feature/AmazingFeature).
5. Open a Pull Request for review.

If you encounter bugs, need help, or have feature requests:

• Please open an issue in this repository providing detailed information.
• Describe the problem clearly and include any relevant logs or screenshots.

We appreciate your feedback and contributions!

© 2025 The Stable Order.