Documentation

Genesis 2.0 Documentation

Complete guide to AI-powered smart contract generation, MCP servers, multi-agent systems, and the NullShot framework

Introduction

Genesis 2.0 is an AI-powered smart contract generation platform that leverages multi-agent AI systems, Model Context Protocol (MCP) servers, and the NullShot framework to create production-ready dApps.

Multi-Agent AI

Specialized agents working together

MCP Integration

Standardized tool protocol

Edge Deployment

Powered by Cloudflare Workers

Quick Start

1

Sign Up

Create your Genesis account

2

Describe Your dApp

Tell the AI what you want to build

3

Review Plan

Approve the generated development plan

4

Generate & Deploy

Watch as your contract is built and deployed

Model Context Protocol (MCP) Servers

What is MCP?

The Model Context Protocol (MCP) is an open protocol that enables AI applications to securely access external data sources and tools. In Genesis, MCP servers act as the bridge between our AI agents and blockchain operations.

MCP servers expose tools that agents can call: • deploy_contract: Deploy contracts to Sepolia testnet • verify_source: Verify contract source code • analyze_security: Perform security analysis

Genesis MCP Tools

deploy_contract

Deploys Solidity contracts to Sepolia testnet with automatic transaction handling.

verify_source

Verifies contract source code on Etherscan-compatible block explorers for transparency.

analyze_security

Performs comprehensive AI-powered security analysis to detect vulnerabilities.

Multi-Agent AI System

Architect Agent

Analyzes requirements and creates detailed implementation plans with step-by-step breakdowns.

  • • Requirement analysis
  • • Architecture planning
  • • Component identification

Engineer Agent

Generates production-ready Solidity code following best practices and standards.

  • • Code generation
  • • Best practices
  • • OpenZeppelin integration

Security Analyst

Reviews contracts for vulnerabilities and security issues before deployment.

  • • Vulnerability detection
  • • Security scoring
  • • Recommendations

Optimizer Agent

Optimizes gas usage and improves code efficiency.

  • • Gas optimization
  • • Storage layout
  • • Performance tuning

Project Sessions

Multi-Project Management

Genesis supports multiple project sessions, similar to Cursor or Bolt. Each project maintains its own:

💬 Chat History

All conversations are saved per project. Switch between projects without losing context.

📁 Generated Files

Contracts, frontend code, and configs are organized by project.

📤 Uploaded Files

PDFs and images uploaded for context stay with their project.

⚙️ Project Settings

Each project can have its own configuration and metadata.

How to Use:

  1. Click "New Project" in the dashboard
  2. Give your project a name and description
  3. Start chatting with the AI about your dApp
  4. Switch between projects anytime from the sidebar
  5. All your work is automatically saved

File Uploads & Context

Document Upload (PDF/TXT)

Upload documentation, whitepapers, or specifications to give the AI more context about your project.

Supported Formats:

  • • PDF - Technical documentation, whitepapers
  • • TXT - Plain text specifications, requirements

Pro Tip: Upload your project requirements or existing contract documentation to help the AI understand your specific needs better.

Image Upload

Upload UI mockups, wireframes, or design references for frontend generation.

Use Cases:

  • • UI/UX mockups for frontend generation
  • • Architecture diagrams for system design
  • • Design references for styling

Environment Variables

Secure API Key Management

Store your API keys securely and use them for dApp generation. All values are encrypted at rest.

🔐 Encrypted Storage

All API keys are encrypted using AES-256 before storage.

🔑 Your Keys, Your Control

Use your own AI provider keys for generation.

Supported Keys:

  • • GEMINI_API_KEY - Google AI for generation
  • • TAVILY_API_KEY - Web search integration
  • • DEPLOYER_PRIVATE_KEY - Ethereum deployment
  • • Custom keys for your specific needs

Security Note: Never share your API keys. Genesis encrypts them, but you should still rotate keys regularly and use keys with appropriate permissions.

Full-Stack dApp Generation

Complete Project Generation

Genesis doesn't just generate smart contracts - it builds complete, production-ready dApps with frontend, backend, and deployment scripts.

📜 Smart Contracts

  • • Solidity contracts
  • • Test files
  • • Deployment scripts
  • • Security analysis

🎨 Frontend

  • • React/Next.js
  • • TypeScript
  • • Tailwind CSS
  • • Web3 integration

⚙️ Backend

  • • API routes
  • • Database schemas
  • • Authentication
  • • Integration code

Generation Workflow:

  1. Planning: AI analyzes your requirements and creates a detailed plan
  2. Architecture: Designs the system structure and component relationships
  3. Code Generation: Generates all files (contracts, frontend, backend)
  4. Security Analysis: Scans for vulnerabilities and suggests improvements
  5. Integration: Creates connection code between components
  6. Documentation: Generates README and setup instructions

API Reference

Projects API

POST /api/projects

Create a new project

{
  "name": "My NFT Marketplace",
  "description": "A marketplace for trading NFTs"
}

GET /api/projects

List all user projects

GET /api/projects/:id

Get project details

DELETE /api/projects/:id

Delete a project

Messages API

POST /api/projects/:id/messages

Add a message to project chat

{
  "role": "user",
  "content": "Add a minting function to the contract"
}

GET /api/projects/:id/messages

Get project chat history

Files API

POST /api/projects/:id/files

Add a generated file to project

{
  "name": "Token.sol",
  "path": "contracts/Token.sol",
  "content": "pragma solidity...",
  "type": "contract",
  "language": "solidity"
}

GET /api/projects/:id/files

Get all project files

NullShot Framework

What is NullShot?

NullShot is a TypeScript agent framework designed for Cloudflare Workers. It provides a standardized way to build, deploy, and manage AI agents at the edge.

Key Features:

  • • Edge deployment on Cloudflare Workers
  • • Multi-AI provider support (OpenAI, Anthropic, Gemini, etc.)
  • • Durable Objects for state management
  • • Streaming responses for real-time interaction
  • • Built-in MCP server integration

© 2024 Genesis. All rights reserved.