> For the complete documentation index, see [llms.txt](https://docs.common.xyz/commonwealth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.common.xyz/commonwealth/community-overview-1/farcaster-contests/farcaster-contestbot.md).

# Farcaster ContestBot

## Common Farcaster ContestBot User Documentation

### Introduction

The **ContestBot** on Farcaster allows users to create and manage contests effortlessly by simply prompting **@contestbot**. The bot manages all contest logistics, from prize distribution to voting, making it easy to engage and reward community participation.

### How to Start a Contest

1. **Prompt the Bot**
   * Mention **@contestbot** in a cast with the title of the contest and the token address you want to use for funding.
   * Example:

     ```
     Hey @contestbot, launch a Best Memes Only contest! Fund it with 0x429ae85883f82203D736e8fc203A455990745ca1 on Base.
     ```
2. **ContestBot will reply** with a contest frame, officially launching the contest.
3. **Users can enter** by replying to the original cast with their contest submission.

### Prize Distribution

All contests follow a **pre-set prize structure**:

* **First, a 10% fee** is deducted for Common's platform maintenance.
* **From the remaining amount, 10% is allocated to voters.**
* **The final prize pool (remaining 90%) is divided as follows:**
  * 🥇 **1st Place:** 50%
  * 🥈 **2nd Place:** 30%
  * 🥉 **3rd Place:** 20%

#### **Example Breakdown:**

If a contest is funded with **100 USDC**:

* **10 USDC** goes to platform fees.
* **10% of remaining 90 USDC** (9 USDC) is distributed among voters.
* **Final prize pool of 81 USDC** is split:
  * 1st place: 40.5 USDC
  * 2nd place: 24.3 USDC
  * 3rd place: 16.2 USDC

### Funding a Contest

* **You must join the** [**ContestBot Community**](https://common.xyz/cw-contest-bot/discussions?tab=all) **on Common** for the **fund** button to appear.
* **You need to approve two transaction requests via your wallet** to fund the contest.
* **Any user with a connected wallet** can contribute to the prize pool once the contest is live.

### Contest Management

* All contests are **owned and managed** by **@contestbot** within a dedicated **Common community**.
* **@contestbot acts as the admin**, ensuring automation, fairness, and seamless execution.

### Entering and Voting

* **Entries:** Any reply to the contest cast containing the contest frame is considered a contest submission.
* **Voting:**
  * Users can vote by adding the **“Upvote Content”** action on Warpcast.
  * **One Token = One Vote:** Only users who hold the contest’s funding token can vote.
  * **10% of the prize pool is allocated to voters** to encourage community participation.

### Summary

* Start a contest by prompting **@contestbot** with a title and token address.
* Pre-set **prize distribution** ensures fairness.
* **You must join the** [**ContestBot Community**](https://common.xyz/cw-contest-bot/discussions?tab=all) **on Common to fund contests.**
* **Any user can fund** a contest but must **approve two transactions** in their wallet.
* **All contests are bot-managed** within a Common community.
* **Prize breakdown ensures fairness, with 10% going to voters and a structured prize split.**

The **ContestBot** makes running contests seamless, transparent, and fun—so you can focus on engaging your community and rewarding creativity!

👉 **Join the bot on Warpcast:** [@contestbot](https://warpcast.com/contestbot)