Own Your Social Graph

ChainSocial is an on-chain social protocol. Your identity, posts, and relationships live on Base—portable, composable, and yours.

Start Building

Learn More

Who is ChainSocial for?

App Builders

Build social apps using our TypeScript SDK or REST API. Add profiles, posts, follows, and messaging to your app in minutes.

Build with SDK & API

Protocol Developers

Create plugins, custom systems, and new social primitives using MUD’s composable smart contract architecture.

Extend the protocol

Curious Explorers

Learn why on-chain social matters and how ChainSocial brings censorship-resistance, composability, and data ownership to social apps.

Understand on-chain social

Traditional social platforms lock you in. Your followers, posts, and identity belong to the platform, not you.

ChainSocial changes this:

Portable Identity — Your profile and social graph work across any app built on ChainSocial
Censorship Resistant — No single entity can delete your content or ban your account
Composable — Other developers can build on top of your posts, extend the protocol, and create new experiences
Verifiable — All social actions are on-chain and transparent

Quick Example

Create a post in three lines of code:


import { createChainSocialClient } from '@chainsocial/client'
 
const client = createChainSocialClient({ worldAddress, publicClient, walletClient })
 
await client.post.createInlinePost('Hello, on-chain world!')

Ready to dive in? The Quick Start guide gets you posting in under 5 minutes.

Architecture Overview

ChainSocial is built on MUD, a framework for building on-chain applications with structured data storage.


┌─────────────────────────────────────────────────────────────┐
│                        Your App                              │
├──────────────────┬──────────────────┬───────────────────────┤
│   SDK (viem)     │   REST API       │   Direct Contracts    │
├──────────────────┴──────────────────┴───────────────────────┤
│                     MUD World Contract                       │
├──────────────────┬──────────────────┬───────────────────────┤
│  ProfileSystem   │   PostSystem     │   FollowSystem        │
│  ContentSystem   │   ReactionSystem │   BlockSystem         │
│  MessageSystem   │   DelegationSystem│   PluginSystem       │
├──────────────────┴──────────────────┴───────────────────────┤
│                     Base Network                             │
└─────────────────────────────────────────────────────────────┘

Systems contain logic (create post, follow user, etc.) Tables store data (profiles, posts, relationships) World coordinates everything and enforces access control

What Can You Build?

Social Apps — Twitter-like feeds, forum discussions, community spaces
Creator Platforms — Subscription content, tipping, token-gated posts
DAO Tooling — Member directories, governance discussions, reputation systems
Games — Social features for on-chain games, player profiles, guilds
Curation Networks — AI or human-powered content curation and discovery