Modular, network-agnostic DeFi and AI agent infrastructure for EVM chains, with x402-powered pay-per-use deployments on Avalanche and beyond.

🏗️ Architecture Overview

HyperKit is organized as a comprehensive monorepo containing five main modules:

🤖 ai/ - AI-Powered Web3 Project Generator

Next.js application that generates complete Web3 applications using natural language prompts, powered by HyperAgent and Alith AI for seamless AI model integration, live preview, and blockchain deployment across supported networks.

Key Features:

• AI-powered code generation with Alith AI wrapper supporting multiple LLMs.
• Real-time project preview with iframe rendering.
• Automatic integration of HyperionKit blockchain components.
• File management and project publishing capabilities.
• Agent-powered prompt → contract → audit → deploy workflows.

🔗 be/ - Backend API Server

NestJS-based backend service providing API endpoints and AI agent functionality for the HyperKit ecosystem, including x402-aware flows for pay-per-use experiences.

Key Features:

• RESTful API with NestJS framework.
• AI agent service integration with Alith AI and HyperAgent.
• Optional x402-gated endpoints that can return HTTP 402 for payment flows.
• Scalable TypeScript backend architecture.
• Development and production deployment support.

🌐 fe/ - Frontend Dashboard

Main Next.js frontend application serving as the primary user interface for HyperKit, featuring wallet connectivity, DeFi operations, project management, and Avalanche pay-per-deploy flows.

Key Features:

• Wallet integration with RainbowKit and Wagmi.
• DeFi operations (swap, bridge, staking, faucet).
• "Deploy on Avalanche" UX for x402 pay-per-deploy flows.
• Google Sheets integration for data management.
• TaskOn API integration for verification systems.
• Responsive design with Tailwind CSS.

📦 npm/ - HyperionKit React Component Library

Published React component library (hyperionkit on npm) providing reusable blockchain components for rapid Web3 development.

Key Features:

• Pre-built React components (ConnectWallet, Swap, Bridge, Staking, Faucet).
• Ethers.js integration for blockchain interactions.
• TypeScript support with full type definitions.
• Rollup-based build system for optimized bundles.
• Network-agnostic components with Avalanche-ready examples.

⚡ smc/ - Smart Contracts

Hardhat-based smart contract development environment with OpenZeppelin integration for secure DeFi protocols and network profiles for Avalanche Fuji and other EVM chains.

Key Features:

• Hardhat development framework.
• OpenZeppelin contract library integration.
• TypeScript support for contract interactions.
• Comprehensive testing and deployment scripts.
• Network configurations and "recipes" for common DeFi deployments.

🌐 Network Support

HyperKit is designed to be network-agnostic and supports multiple EVM environments.

• Supported today: Hyperion, Mantle, Avalanche Fuji.
• In progress / planned: Metis, Avalanche C-Chain mainnet, and additional EVM-compatible networks.

💳 Avalanche x402 Integration

HyperKit ships with building blocks for x402-powered pay-per-use flows on Avalanche, enabling metered deployments and API access.

• x402-gated APIs can return HTTP 402 responses with payment details, which users settle on Avalanche Fuji before the action continues.
• Typical flow: request → 402 invoice → on-chain payment on Fuji → HyperAgent generates, audits, and deploys contracts → returns address, ABI, and explorer links.

x402 Impact Overview

Aspect	Previous State	With Avalanche x402
Networks	Hyperion, Mantle (Metis planned)	Hyperion, Mantle, Metis, Avalanche Fuji (C‑Chain next)
Payments	Mostly open, non-metered tooling	x402-gated pay-per-deploy and pay-per-API flows
Products	Dev tooling and templates	Pay-per-Deploy Studio and agent-ready DeFi recipes

📚 Documentation

For comprehensive documentation and guides, visit hyperionkit.xyz.

🚀 Quick Start

Prerequisites

• Node.js v18+
• pnpm v10+ (recommended) or npm/yarn
• Git

Installation

1. Clone the repository

   git clone https://github.com/HyperionKit/Hyperkit.git
   cd Hyperkit

2. Install dependencies for all modules

   pnpm install

3. Set up individual modules (optional, for specific development)

   # AI Generator
   cd ai && pnpm install && pnpm dev
   
   # Backend API
   cd be && pnpm install && pnpm start:dev
   
   # Frontend Dashboard
   cd fe && pnpm install && pnpm dev
   
   # Smart Contracts
   cd smc && pnpm install && npx hardhat compile

Development Workflow

Run specific modules:

# Run AI project generator
pnpm --filter ai dev

# Run backend API server
pnpm --filter be start:dev

# Run frontend dashboard
pnpm --filter fe dev

# Build npm package
pnpm --filter hyperionkit build

Run all development servers:

pnpm run dev

Avalanche Fuji Setup (Optional)

For Avalanche Fuji development, configure your Hardhat network and environment variables:

• Add a fuji network entry in hardhat.config.ts with RPC URL and private key.
• Ensure your frontend and backend .env files point to the same Fuji network and explorer URLs.

🛠️ Contributing

Project Structure

Hyperkit/
├── ai/          # AI-powered Web3 project generator
├── be/          # NestJS backend API server
├── fe/          # Next.js frontend dashboard
├── npm/         # HyperionKit React component library
└── smc/         # Hardhat smart contracts

Development Guidelines

1. Branch Naming: Use descriptive branches (feature/ai-generator-enhancement, fix/wallet-connection).
2. Commits: Follow conventional commits (feat:, fix:, docs:, etc.).
3. Testing: Ensure all tests pass before submitting PRs.
4. Documentation: Update relevant documentation for new features.

Module-Specific Development

AI Generator (ai/):

• Built with Next.js 15 and TypeScript.
• Uses Zustand for state management.
• Integrates with multiple AI models (e.g., GPT-4 variants) through Alith AI.
• Orchestrates HyperAgent flows for generating and deploying smart contracts.

Backend API (be/):

• NestJS framework with TypeScript.
• Integrates Alith AI and HyperAgent for agent services.
• Provides RESTful APIs for project generation, deployment, and monitoring.
• Optional x402 gateway layer for 402-aware endpoints.

Frontend Dashboard (fe/):

• Next.js 15 with App Router.
• RainbowKit + Wagmi for wallet connectivity.
• Tailwind CSS for styling.
• Avalanche Fuji deployment flows and 402 payment UX.

Component Library (npm/):

• React components with TypeScript.
• Ethers.js for blockchain interactions.
• Rollup for optimized bundling.
• Network-agnostic primitives with examples for Avalanche and other EVM chains.

Smart Contracts (smc/):

• Hardhat development environment.
• OpenZeppelin security standards.
• Comprehensive testing suite.
• Network profiles and examples for Avalanche Fuji and other supported chains.

🌁 Team and Community

• HyperKit (X, Discord, Website
• ArhonJay
• Tristan-T-Dev
• JustineDevs

💫 Contributors

🌊 License

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