🤖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 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 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