🚀 OpenPhron

Where AI meets blockchain, and smart contracts become reality.

OpenPhron is a cutting-edge marketplace that bridges the gap between AI-powered oracles and smart contract development. Think of it as your one-stop shop for discovering AI oracles and building blockchain applications with the power of AI assistance.

✨ What Makes It Special?

OpenPhron isn't just another blockchain platform—it's a complete ecosystem that empowers developers and creators to:

• Browse & Discover: Explore a curated marketplace of AI oracles ready to power your dApps
• Create with AI: Build smart contracts from your ideas using our AI-powered contract builder
• Go Multi-Chain: Deploy across 30+ blockchain networks (Ethereum, Polygon, Arbitrum, Base, and many more)
• Subscribe & Integrate: Easily subscribe to oracles and integrate them into your contracts
• Share & Collaborate: Share your contracts with others and collaborate on projects

🎯 Key Features

🤖 AI Oracle Marketplace

• Browse a comprehensive library of AI-powered oracles
• View detailed oracle information and capabilities
• Create and contribute your own oracles to the marketplace
• Subscribe to oracles for use in your smart contracts

📝 Smart Contract Builder

• AI-Powered Creation: Describe your idea, and let AI help you build the contract
• Workflow Modes: Choose between basic and advanced workflows based on your needs
• Real-time Preview: See your contract code as it's being generated
• Multi-Chain Deployment: Deploy to your preferred blockchain network
• Contract Management: Organize, share, and manage your contracts from a unified dashboard

🔗 Multi-Chain Support

We support a massive list of blockchain networks:

• Ethereum Ecosystem: Mainnet, Sepolia, Holesky
• Layer 2s: Arbitrum, Base, Optimism, Polygon zkEVM, zkSync
• Alternative Chains: BSC, Avalanche, Fantom, Cronos, Gnosis, and more
• Custom Networks: PhronAI, Berachain, Tron, Starknet, and others

🔐 Security & Authentication

• Wallet-based authentication using RainbowKit
• Secure signature verification
• API key management for backend services

🛠️ Tech Stack

OpenPhron is built with modern, battle-tested technologies:

• Frontend: React 19, TypeScript
• Styling: Tailwind CSS, SCSS, Radix UI components
• Blockchain: Wagmi, Viem, RainbowKit, Thirdweb SDK
• State Management: React Context API, TanStack Query
• Forms: React Hook Form with Zod validation
• UI Components: Radix UI, Material-UI, shadcn/ui
• Build Tool: Create React App

📦 Installation

Getting started with OpenPhron is straightforward:

Prerequisites

• Node.js (v16 or higher recommended)
• npm or yarn package manager
• A wallet extension (MetaMask, WalletConnect, etc.)

Setup Steps

1. Clone the repository

   git clone https://github.com/idealbridgex/openphron-frontend
   cd openphron-frontend

2. Install dependencies

   npm install
   # or
   yarn install

3. Configure environment variables

   Create a .env file in the root directory with the following variables:

   REACT_APP_SERVER_URL=http://localhost:9001/api
   REACT_APP_DEPLOY_URL=http://localhost:9002/contract
   REACT_APP_RECIPIENT=0xYourRecipientWalletAddress
   REACT_APP_AMOUNT=1000000000000000000

   Note: Update the URLs and addresses according to your backend setup.

4. Start the development server

   npm start

   The app will open at http://localhost:3000 🎉

📁 Project Structure

openphron-frontend/
├── src/
│   ├── AImarketplace/          # AI Oracle marketplace features
│   │   ├── components/          # Oracle-related UI components
│   │   ├── pages/               # Oracle list, detail, creation pages
│   │   ├── hooks/               # Custom hooks for oracle operations
│   │   └── blockchain/          # Blockchain contracts and configs
│   ├── smartcontract-builder/   # Smart contract creation tools
│   │   ├── components/          # Contract builder components
│   │   ├── pages/               # Main builder pages
│   │   └── hooks/               # Contract-related hooks
│   ├── api-key/                 # API key management
│   ├── components/              # Shared components
│   ├── config/                  # App configuration
│   └── App.tsx                  # Main app component
├── public/                      # Static assets
└── package.json

🚦 Getting Started

Once you have the app running:

1. Connect Your Wallet: Click the connect button and select your preferred wallet
2. Explore Oracles: Navigate to the Oracle marketplace to browse available AI oracles
3. Create Contracts: Head to the Agent/Workflow section to start building smart contracts
4. Manage Subscriptions: Subscribe to oracles you want to use in your contracts

🤝 Contributing

We welcome contributions! Whether it's:

• 🐛 Bug fixes
• ✨ New features
• 📚 Documentation improvements
• 🎨 UI/UX enhancements

Feel free to open an issue or submit a pull request. Let's build something amazing together!

📄 License

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

🔮 What's Next?

OpenPhron is continuously evolving. We're working on:

• Enhanced AI capabilities for contract generation
• More oracle integrations
• Improved developer experience
• Additional blockchain network support

💬 Connect With Us

• GitHub: idealbridgex/openphron-frontend
• Found a bug? Have a feature request? Open an issue

---

Built with ❤️ by the OpenPhron team

Making blockchain development accessible, one contract at a time.