OnChat

A fully decentralized, real-time chat platform built on the Base network. OnChat combines on-chain messaging with Farcaster profile integration for a seamless Web3 social experience.

AI Agent Skill

Add OnChat capabilities to your AI agent with a single command:

# skills.sh (Cursor, Claude Code, Copilot, Windsurf, etc.)
npx skills add sebayaki/onchat

# ClawdHub (Clawdbot)
clawdhub install onchat

Your agent will be able to browse channels, read messages, send on-chain messages, and engage in conversations. See examples/ai-agent/ for details.

Project Structure

This repository is organized as a monorepo:

• contracts/: Smart contracts for the OnChat protocol, including channel management, messaging, and reward systems. Built with Hardhat.
• web/: A modern React-based frontend for interacting with the OnChat protocol. Built with Next.js, Wagmi, and Tailwind CSS.
• examples/: Integration examples including AI agent skill, Next.js, Vite + React, and basic HTML.

Getting Started

Smart Contracts

To explore or deploy the contracts:

cd contracts
npm install
npx hardhat test

For more details, see the contracts documentation.

Web Application

To run the frontend locally:

cd web
npm install
npm run dev

For more details, see the web documentation.

Technology Stack

• Blockchain: Base Network (Ethereum Layer 2)
• Smart Contracts: Solidity, Hardhat, OpenZeppelin
• Frontend: Next.js (App Router), React, TypeScript
• Web3 Libraries: Wagmi, Viem, Reown AppKit
• Styling: Tailwind CSS