Community Coins

1. Introduction

Community Coins create coins around interests, projects, and news you believe in. Each coin makes community-building fun, rewarding, and super simple. • Launch: Create your coin with a single post, share with friends, raise ETH to successfully launch the forum. • Earn: After the coin graduates, member earn tokens by posting, with 0.15% of your community tokens rewarded weekly after • Grow: Make cool decisions together using the shared treasury and reward the people who make it happen.

Built on Base, Community Coins turn passive holders into real members.

2. Default Parameters for Community Coin Configuration

Token Distribution

Parameter
Value
Description

Bonding Curve Supply

65%

Percentage of tokens sold via bonding curve

Liquidity Allocation

12.5%

Percentage of tokens allocated to liquidity on launchpad (if cap reached)

Treasury Allocation

15%

Percentage of tokens held by the treasury

Contest Allocation

7.5%

Percentage of tokens deposited into autogenerated contest

Fee Structure

Parameter
Value
Description

Uniswap Launch Fee

0.4%

Percentage of Uniswap pool token amount

Additional Liquidity Fee

0.8%

Percentage of raised liquidity from the $25k pool (~$200)

Protocol Trading Fee

1%

General Launchpad protocol fee on each buy/sell transaction

Token Launch Fee

0.0004440 ETH

One-time fee for token launch

Contest Configuration

Parameter
Value
Description

Prize Distribution

1st: 50%, 2nd: 35%, 3rd: 15%

Distribution percentages for contest winners

Contest Type

Recurring

Contest automatically renews

Contest Duration

7 days

Default length for recurring token contests

Content Topic

General

Default topic category

Voting Mechanism

Weighted

Voting power determined by token holdings

Vote Weight

100 Tokens = 1 Vote

Default voting power ratio

Weekly Prize Share

0.15%

Percentage of total supply distributed per week

Contest Manager

LPContestManager

Address that creates and manages contests

Community ID

[Token Address]

ID derived from the community token

Governance Parameters

Parameter
Value
Description

Quorum

12.5%

Minimum percentage of token supply required for governance decisions

Voting Delay

0.5 days

Time between proposal submission and voting start

Voting Period

2 days

Duration of the voting period

Bonding Curve Parameters

Parameter
Value
Description

Total Supply

1,000,000,000

Maximum token supply (1B tokens)

Min Initial Liquidity

0.00000000001 ETH

Minimum starting liquidity (1E8 wei)

Initial Liquidity

4.167 ETH

Initial liquidity amount (creates first sale at $1000 market cap)

Connector Weight

830,000

Parameter controlling the shape of the curve

3. Key Components

Bonding Curve

The CurveManager contract implements a bonding curve mechanism that determines token pricing based on supply. Each community coin uses a specific curve implementation to create a predictable pricing model.

┌───────────────┐     ┌─────────────┐     ┌───────────────┐
│ CurveManager  │────▶│ CurveLogic  │────▶│ Token Pricing │
└───────────────┘     └─────────────┘     └───────────────┘

The CurveManager contract handles:

  • Creation and management of different curve implementations

  • Price calculations based on token supply and demand

  • Security controls to prevent manipulation

Recurring Contest System

Community coins automatically fund recurring contests to drive community engagement. The contest system distributes rewards to content creators and voters based on configured parameters.

┌──────────────┐     ┌───────────────┐     ┌───────────────────┐
│ ContestToken │────▶│ ContestManager│────▶│ Prize Distribution│
└──────────────┘     └───────────────┘     └───────────────────┘

The Contest system includes:

  • Weekly content contests with configured prize pools

  • Voting mechanisms based on token holdings

  • Automated reward distribution to winners and voters

Token Governance

Each community token is paired with a governance contract that enables community decision-making with the following workflow:

┌────────────┐     ┌─────────────┐     ┌──────────┐     ┌────────────┐
│ Proposal   │────▶│ Voting Delay│────▶│ Voting   │────▶│ Execution  │
└────────────┘     └─────────────┘     └──────────┘     └────────────┘

The CommonGovernor contract provides:

  • Proposal submission functionality

  • Voting mechanisms with configured parameters

  • Execution of approved proposals

4. Technical Implementation

CommunityStake Contract

The CommunityStake contract is a core component that manages buying and selling of community stake tokens using the bonding curve mechanism.

Key Functions:

  • buyStake: Allows users to purchase community stake tokens with ETH or ERC20 tokens

  • sellStake: Allows users to sell community stake tokens back to the contract

  • getPrice: Calculates the current price of tokens based on supply and the bonding curve

Rules:

  • All transactions are subject to protocol and namespace fees

  • Token purchases and sales use the bonding curve for price determination

  • The first token can only be purchased by the community owner or factory contract

Token Trading Flow

The token trading process follows this sequence:

  1. CommunityStake contract determines if the namespace and token ID are whitelisted

  2. Contract calculates the current price using the CurveManager's implementation

  3. Buyer sends sufficient ETH or tokens to cover the purchase price plus fees

  4. Contract mints community stake tokens to the buyer

  5. Collected fees are distributed to protocol and namespace fee destinations

For a complete technical specification of the token trading flow, please refer to the official documentation.

5. CurveManager Implementation

The CurveManager contract handles the bonding curve logic that determines token pricing. It implements access control mechanisms to manage curve creation and updates.

Roles:

  • CURVE_MASTER: Can create, update, and manage curves

  • TRADE_MASTER: Can freeze curves to prevent trading

Functions:

  • createCurve: Creates a new bonding curve with specified parameters

  • updateCurve: Updates an existing curve if not vetted as immutable

  • freezeCurve: Temporarily pauses trading on a specific curve

  • calculatePrice: Delegates to the curve's logic contract to determine token price

The bonding curve system is designed to provide:

  • Predictable price increases as supply decreases

  • Liquidity for community tokens at all times

  • Customizable curve parameters for different community needs

6. Additional Resources

For further technical details on contract implementations, please refer to:

For integration guidance and detailed API documentation, please visit docs.common.xyz.

PreviousIndex EcosytemNextCustom Domain

Last updated

Was this helpful?