---

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. See CONTRIBUTING.md for development setup, coding style, and the pull request process.

Questions and ideas are welcome in our Discord channel. If you hit a bug, please open an issue with clear steps to reproduce and any relevant logs or screenshots.

© 2025 The Stable Order.