← back

how to use basechan

everything you need to know

📊 BaseChan by the Numbers

🪙
0 BCHAN
Total Supply
Fixed supply token
💰
0 BCHAN
Community Cost
One-time creation fee
🔥
25%
Burn Rate
Deflationary mechanism
🏊
41.67%
Liquidity Boost
Automated liquidity addition
0
Character Limit
Per message
Base
Network
L2 scaling solution

Getting Started

BaseChan is a decentralized message board where your wallet address is your username. No sign-ups, no passwords - just connect your wallet and start messaging.

BaseChan operates on the Base blockchain, providing permanent, censorship-resistant communication with built-in community creation and tokenomics.

Wallet Connection

Click "Connect Wallet" to link your Ethereum wallet. We support MetaMask, Coinbase Wallet, and other Web3 wallets. Your wallet address becomes your identity on BaseChan.

Make sure you have some ETH on Base network for gas fees. You can bridge ETH from Ethereum mainnet using the official Base bridge.

💡 Pro Tip: Get a Basename (like yourname.base.eth) for easier identification in messages and mentions!

Posting Messages

Type your message (up to 128 characters) and hit send. Each message is permanently stored on Base blockchain. Gas fees apply for each message posted.

Messages are immutable once posted - they cannot be edited or deleted. Think carefully before posting!

Fast & Cheap

Base L2 provides sub-second confirmation and low gas fees

🔒

Permanent

Messages are immutably stored on blockchain forever

🌐

Censorship Resistant

No central authority can remove your messages

@ Mentions

Mention other users by typing @ followed by their wallet address. Mentioned users will receive a notification in their inbox.

Example: @0x1234...5678 or @username.base.eth

You can also mention ENS names and Basenames for easier communication.

Inbox & Notifications

Click the inbox icon to see messages where you've been mentioned. The blue badge shows your unread mention count.

Mention notifications are only visible within the specific chat/community where they occurred - they are not displayed globally across all communities.

Notifications are sent automatically when someone mentions your wallet address. Check your inbox regularly to stay updated on conversations.

⚠️ Important: Mentions are community-specific and don't cross between different message boards.

Searching

Use the search bar to find specific messages or filter by wallet addresses. Search works across all message content and sender addresses.

You can search for specific words, wallet addresses, or ENS names to find relevant conversations quickly.

Communities

Create your own community by paying 300,000 BCHAN tokens. Communities get their own message board and mention system, providing focused discussion spaces.

Community creation is permanent and cannot be undone. Choose your community name and description carefully.

🎯 Community Benefits:

  • Dedicated message board
  • Separate mention system
  • Community ownership
  • Automated token economy

👑 Community Management

As a community owner, you have control over certain aspects of your community. Community settings are stored on IPFS and can be updated by the community owner.

📝 Updatable Information

  • Community description
  • Community guidelines
  • Social media links
  • Community logo/avatar
  • Token gating settings

🔒 Immutable Settings

  • Community name
  • Contract addresses
  • Creation timestamp
  • Original creator address
  • Core contract functions

🛠️ How to Update Community Info:

  1. Connect Wallet: Use the same wallet that created the community
  2. Access Admin Panel: Visit your community page and look for admin controls
  3. Update Metadata: Edit description, links, or guidelines
  4. Upload to IPFS: New metadata is uploaded to IPFS automatically
  5. Update Contract: Community contract is updated with new IPFS hash
⚠️ Important: Only the original community creator wallet can update community settings. Admin functions require gas fees for blockchain transactions.
💻Community Admin Functionssolidity

🔐 Token Gating Communities

Token gating allows communities to restrict access based on token ownership. While the smart contracts deploy as public, token requirements are enforced by the frontend and stored in community metadata.

👥

Access Control

Require specific tokens to view or join the community

✍️

Posting Permissions

Restrict who can post messages based on token holdings

⚖️

Flexible Requirements

Set minimum token amounts or use specific NFT collections

🔄 Token Gating Types

PublicNo restrictions
Token HoldersERC-20 requirement

🎯 Frontend Enforcement

Token gating is checked when users try to access community content. The app verifies token balances before displaying messages or allowing posts.

📡 Real-time Verification

Token requirements are checked in real-time against the user's connected wallet, ensuring up-to-date access control.

🔧 Metadata Storage

Token gating settings are stored in IPFS metadata and can be updated by community owners without deploying new contracts.

⚡ Gas Efficient

No additional gas costs for token checks - verification happens off-chain using standard RPC calls.

💻Token Gating Configuration Examplejson
💡 Pro Tip: Start with a lower token requirement and increase it as your community grows. You can always update token gating settings as a community owner!
🔧 Technical Note: While smart contracts are deployed as public, the BaseChan frontend enforces token gating requirements. Direct contract interaction may bypass these restrictions.

Token Allocation

BCHAN token is used for community creation and platform governance. Total supply: 100,000,000 BCHAN

💰 How Your 300k BCHAN Tokens Are Split

When you create a community, your 300,000 BCHAN tokens are automatically allocated as follows:

25%

🔥 Burn (Deflationary)

0 BCHAN

Permanently removed from circulation, reducing total supply and creating deflationary pressure.

42%

🏊 Liquidity Pool

0 BCHAN

Added to Uniswap V4 BCHAN/WETH pool via BaseChanLiquidityManager. Half is auto-swapped to WETH for balanced liquidity.

33%

👥 Team Wallet

0 BCHAN

Sent to basechan.base.eth for development, marketing, and ecosystem growth.

⚙️ How The Smart Contract Works

💻Community Factory - Token Distributionsolidity
1

Token Collection

Community Factory collects 300k BCHAN from community creator

2

Automatic Burning

75k BCHAN sent to burn address (0x000...dEaD), permanently removing from circulation

3

Uniswap V4 Liquidity

125k BCHAN sent to BaseChanLiquidityManager which:

  • Swaps 62.5k BCHAN → WETH using Uniswap V4 Router
  • Adds balanced liquidity (62.5k BCHAN + WETH) to V4 pool
  • Uses hooks for concentrated liquidity around current price
4

Team Allocation

100k BCHAN sent to basechan.base.eth for ecosystem development

5

Community Creation

Deploys new MessageBoard and Mentions contracts for your community

💎 Token Details:

  • Community Creation: 0 BCHAN
  • Trading on Uniswap V4
  • Contract: 0x23d1decae4e325fe3e43cf518784384c4eb05aa8

🏊 Liquidity Manager Deep Dive

The BaseChanLiquidityManagerV4Real is the heart of our automated liquidity system. Every time someone creates a community, it automatically adds liquidity to improve trading for everyone.

🔄 Hybrid V3/V4 Approach

Uses Uniswap V3 for swapping, then adds to V4 pools for advanced features and lower fees.

⚡ Automated Execution

Zero manual intervention - everything happens in a single transaction when creating communities.

🎯 Balanced Liquidity

Always maintains 50/50 BCHAN/ETH ratio for optimal trading efficiency.

🛡️ Security Features

Reentrancy protection, owner controls, and emergency withdrawal functions.

💻Main Liquidity Functionsolidity
💻Uniswap V3 Swap Implementationsolidity

📈 Liquidity Addition Flow

125,000 BCHANFrom Community Factory
Split 50/5062.5k each direction
62.5k BCHANReady for pool
62.5k → ETHVia Uniswap V3
V4 PoolBalanced liquidity added
🔧 Technical Note: The V4 pool integration is simplified for demonstration. Production systems require proper liquidity delta calculations based on current pool state.

Contract Addresses

All BaseChan smart contracts are deployed on Base mainnet and fully verified on BaseScan.

BCHAN Token✓ Verified
0x23d1decae4e325fe3e43cf518784384c4eb05aa8
🔍
BaseChanCommunityFactory✓ Verified
0xd3EE6AF0451Fa57bF6027884015e6Caeafd3fa64
🔍
BaseChanLiquidityManagerV4Real✓ Verified
0x27CE05B75C5CCB01ADfc307597E6E438d5B0c8a2
🔍
Original MessageBoard (base community)✓ Verified
0x79343e05a90b50c47fb7a1ac54e18146fdb9a556
🔍

🌐 Network Information

Network: Base Mainnet
Chain ID: 8453
RPC: https://mainnet.base.org
Explorer: basescan.org

📝 Important Notes:

  • BaseChanCommunityMessageBoard and BaseChanCommunityMentions contracts are deployed individually per community
  • All contracts are immutable and cannot be upgraded
  • Community creation deploys 2 new contracts per community
  • Gas costs are optimized for Base L2 network