Core concepts

Everything in Coin Community reduces to four objects: communities, messages, users, and wallets.

Communities

A community is a room keyed by an on-chain token address. Every token on pump.fun automatically has one. Read community metadata with getCommunity, list recent messages with getMessages (or getMessagesPublic without auth), and browse top communities by activity with getTopCommunities.

Messages

Messages belong to exactly one community. A message includes text content and an optional media URL (must be uploaded via uploadCommunityMedia first). Messages can be liked and replied to; replies are messages with a non-null parentMessageId.

Field	Type	Description
`content`	string	Message text
`chainId`	ChainId	Chain the posting wallet is on
`walletAddress`	string	Wallet used to post (must be linked)
`mediaUrl`	string?	URL from `uploadCommunityMedia`

Users

Users authenticate via Twitter OAuth. A user has a display name, a profile image, a Twitter follower count (synced periodically), and an in-platform social graph (follow/following). Users can link multiple wallets across EVM and Solana chains.

Wallets

Wallets are linked via a signed challenge:

Call walletChallenge to get a nonce.
Sign the message field with the wallet.
Call linkWallet with the signature.

Supported chain types: 'evm' (Ethereum, Base, BSC) and 'svm' (Solana).