# page.mdx

# Rally Documentation

Welcome to Rally - the first decentralized, AI-powered marketing protocol where anyone can earn by sharing campaigns with their community.

## Tweet. Engage. Earn. All On-Chain.

Rally revolutionizes how Web3 projects connect with real communities. Whether you're a top KOL or just getting started—if you've got an X account and a following, you can participate.

> 🎉 **Alpha Phase**: Currently earning Rally Points.

## Get Started

- **[Getting Started →](/getting-started)** - New to Rally? Start here to learn the basics and get your account set up.
- **[For Content Creators →](/content-creators)** - Learn how to find campaigns, complete missions, and maximize your earnings.
- **[For Projects →](/projects)** - Launch AI-powered campaigns that reach real communities and drive authentic engagement.
- **[Technical Docs →](/technical)** - Dive deep into Rally's architecture, smart contracts, and developer tools.

## Why Rally?

### For Content Creators
- **No Barriers**: Open to anyone with an X account
- **Instant Rewards**: Get paid immediately upon verification
- **Fair Distribution**: AI ensures quality engagement is rewarded

### For Projects
- **Real Communities**: Target genuine users, not bots
- **Pay for Performance**: Only pay for verified engagement
- **On-Chain Analytics**: Full transparency and attribution

## Quick Links

- [Browse Active Campaigns](https://app.rally.fun/campaigns)
- [Join Discord Community](https://discord.gg/rally)
- [Technical Documentation](/technical)

## Join the Community

- **Discord**: Connect with other Rally users
- **X/Twitter**: [@RallyOnChain](https://x.com/RallyOnChain)
- **GitHub**: Contribute to Rally's development

---

Built with ❤️ on [GenLayer](https://genlayer.com)


# getting-started/page.mdx

# Getting Started with Rally

Welcome to Rally! This guide will help you understand the platform and get started earning rewards through social media engagement.

## What You'll Learn

- How Rally works and why it's different
- Setting up your Rally account
- Connecting your X (Twitter) account
- Participating in your first campaign
- Understanding rewards and payouts

## Prerequisites

To use Rally, you'll need:

1. **An X (Twitter) Account** - Rally campaigns are currently focused on X/Twitter engagement
2. **A Web3 Wallet** - MetaMask, WalletConnect, or any compatible wallet (needed for claiming rewards)
3. **Some ETH for Gas** - Small amounts needed for claiming rewards (varies by chain)

## Quick Start

### 1. Log in with X (Twitter)

Visit [app.rally.fun](https://app.rally.fun) and click "Log in with X" to authenticate your Twitter account. This is your primary identity on Rally.

### 2. Browse Available Campaigns

Once logged in, explore active campaigns from top Web3 projects. You can browse and participate without connecting a wallet!

### 3. Connect Your Wallet (Optional)

When you're ready to claim rewards, connect your Web3 wallet using the connect button. You can participate in campaigns before connecting a wallet.

### 4. Complete Your First Mission

Choose a campaign, follow the mission requirements, post on X, and submit your entry for AI verification.

### 5. Earn Rally Points & Claim Rewards

**During Alpha Phase**: You're earning Rally Points.

**Rewards Process**: Once your submission is verified AND the campaign's distribution period is finalized, you can claim your rewards on-chain.

## Platform Overview

Rally is built on two key innovations:

1. **Open Participation** - No applications, no gatekeeping. If you have an X account, you can participate.
2. **AI Verification** - Intelligent contracts analyze engagement quality, ensuring fair rewards for authentic participation.

## Next Steps

- [For Content Creators](/content-creators) - Learn how to maximize your earnings
- [Understanding Scoring](/scoring-system) - See how AI evaluates content
- [Browse Campaigns](https://app.rally.fun/campaigns) - Start earning today

## Need Help?

- Join our [Discord community](https://discord.gg/rally) for support
- Visit our [Resources](/resources) for helpful links and guides
- Follow [@RallyOnChain](https://x.com/RallyOnChain) for updates


# content-creators/page.mdx

# Overview

Turn your social influence into earnings with Rally. Whether you're a seasoned KOL or just starting out, Rally provides equal opportunities for everyone to earn through authentic engagement.

## How Content Creators Earn on Rally

Rally democratizes access to Web3 marketing opportunities. Here's what makes it special:

- **No Gatekeepers**: No forms, no approvals, no minimum follower requirements
- **Instant Rewards**: Get paid immediately after AI verification
- **Fair Distribution**: Quality engagement is rewarded, not just follower count
- **Multiple Chains**: Earn tokens across various blockchain networks

## Getting Started

### Key Topics

- **Finding Campaigns** - Browse active campaigns at [app.rally.fun](https://app.rally.fun)
- **Completing Missions** - Follow campaign briefs and submit quality content
- **Earning Rewards** - Understand the scoring system and maximize your points
- **Rally Points** - Alpha phase rewards

## Types of Missions

Rally currently supports two mission types:

### Tweet Missions
Create original posts about projects. These can include:
- Single tweets
- Twitter articles 
- Thread posts
- Any format specified in the campaign briefing

**Note**: While your posts can include images, they are not included in the AI evaluation process.

### Refer Missions
Refer other content creators to campaigns and earn **10% of their future Campaign Points** - not just from the campaign you referred them to, but from **any campaign** they participate in! [Learn more about the referral system →](/referral-system)

## Reward System

### Understanding Rally Points vs Scoring

**Rally Points**: The rewards you earn during the Alpha phase. These are your actual earnings!

**Scoring System**: The AI-powered evaluation system that analyzes your tweets and assigns Campaign Points based on quality, relevance, and engagement. Higher Campaign Points lead to more Rally Points. [Learn more about how scoring works →](/scoring-system)

### Alpha Phase: Rally Points
During the Alpha phase, you're earning Rally Points. Build your point balance now for future rewards!

### Token Rewards
Once campaigns finalize their distribution periods, you can claim tokens directly to your wallet. No manual approvals needed - just verified engagement and on-chain settlement.

### Leaderboards
Track your performance and compete with other content creators for bonus rewards. Top performers may receive additional Rally Points!

## Referral Program

<Callout type="info">
🚀 **Boost Your Earnings**: Refer other content creators and earn 10% of their Campaign Points from every campaign they join. You can also refer projects and earn 10% of RLY rewards from their campaigns. [Get your referral link →](/referral-system)
</Callout>

## Best Practices

1. **Be Authentic**: Genuine engagement performs better than generic posts
2. **Understand the Project**: Research before posting for higher quality content
3. **Follow Guidelines**: Each mission has specific requirements - read carefully
4. **Engage Your Community**: Your followers' interactions can boost your rewards
5. **Stay Active**: Consistent participation leads to better opportunities

## Common Questions

**Do I need a large following?**
No! Rally rewards quality engagement, not just reach. Smaller accounts with engaged audiences often perform very well.

**How quickly do I get paid?**
During Alpha, you earn Rally Points immediately after AI verification. Token rewards can be claimed once the campaign's distribution period is finalized.

**Can I participate in multiple campaigns?**
Yes! Participate in as many campaigns as you like, as long as you meet the requirements.

**What chains are supported?**
Rally currently supports **Base** and **zkSync Era**, with more chains coming soon.

## Ready to Start Earning?

1. [Log in with X](https://app.rally.fun) to get started
2. Browse active campaigns on the platform
3. Complete your first mission
4. Track your Rally Points on the leaderboard

Join thousands of content creators already earning with Rally!


# projects/page.mdx

# Overview

Launch smarter Web3 marketing campaigns powered by AI. Rally helps projects connect with real communities through authentic, verified engagement.

## Why Projects Choose Rally

Traditional influencer marketing is broken. Rally fixes it with:

- **Real Communities, Not Bots**: AI verification ensures authentic engagement
- **Pay for Performance**: Only pay for verified, quality participation
- **Full Transparency**: On-chain analytics and attribution
- **Automated Operations**: Set it and forget it with AI-powered settlement
- **Global Reach**: Access content creators across all time zones and languages

## How It Works

<Steps>

### Design Your Campaign

Set objectives, define missions, and configure reward parameters through our intuitive interface.

### Fund Your Campaign

Deposit tokens into the smart contract. Funds are only released for verified engagement.

### Launch & Monitor

Your campaign goes live immediately. Track performance with real-time analytics.

### AI Verification

Intelligent contracts analyze each submission for quality and authenticity using our sophisticated scoring system. [Learn how the scoring system works →](/scoring-system)

### Automatic Distribution

Rewards are distributed on-chain to verified content creators - no manual processing needed.

</Steps>

## Campaign Types

### Awareness Campaigns
Build brand recognition with tweet missions that introduce your project to new audiences.

### Community Growth
Drive meaningful engagement with reply and discussion missions that spark conversations.

### Product Launches
Generate buzz around new features or token launches with coordinated campaign blasts.

### Educational Content
Reward users for creating threads and detailed content that explains your project.

## Key Features

- **🤖 AI-Powered Verification** - GenLayer's intelligent contracts ensure only quality engagement is rewarded through our [advanced scoring system](/scoring-system)
- **⛓️ Multi-Chain Support** - Deploy campaigns on Base and zkSync Era, with more chains coming soon
- **📊 Real-Time Analytics** - Track impressions, engagement, and ROI with on-chain attribution
- **🎯 Flexible Missions** - Create custom missions tailored to your campaign objectives

## Alpha Partner Program

Join Rally's Alpha Partner Program and be first to run decentralized marketing campaigns with:

- **0% fees during Alpha**: No platform fees while in Alpha phase
- **Token incentive matching**: Additional rewards for your campaigns
- **Featured placement + co-marketing**: Premium visibility for your campaigns
- **Early influence on product roadmap**: Shape the future of Rally

{/* Apply to Join Alpha Partner Program link coming soon */}

## Campaign Pricing

Rally operates on a simple, transparent fee structure:

- **Platform Fee**: 3% of distributed rewards
- **No Setup Fees**: Free to create and launch campaigns
- **No Hidden Costs**: Gas fees clearly displayed
- **Pay As You Go**: Only pay for actual engagement

## Referral Program

<Callout type="info">
💡 **Earn from Referrals**: Know other projects that could benefit from Rally? Refer them and earn 10% of the Rally Point rewards allocated to their campaigns. [Learn more about referrals →](/referral-system)
</Callout>

## Getting Started

1. [Create your first campaign](/projects/create-campaign)
2. Configure your campaign settings
3. Set up your missions
4. Launch and monitor performance

## Resources

- [Campaign Creation Guide](/projects/create-campaign)
- [How Scoring Works](/scoring-system)
- [Platform Overview](/getting-started)

Ready to revolutionize your Web3 marketing? [Start creating →](/projects/create-campaign)


# projects/create-campaign/page.mdx

# Create Your First Campaign

Launch your Rally campaign in 5 simple steps. This guide walks you through each stage of the campaign creation process.

## Before You Start

<div className="bg-card rounded-lg border p-6">
  <h3 className="text-lg font-semibold mb-4">Prerequisites Checklist</h3>
  <div className="space-y-2">
    <div>✓ **X (Twitter) Account** - Must be logged in</div>
    <div>✓ **Web3 Wallet** - Connected with sufficient funds</div>
    <div>✓ **Campaign Budget** - Tokens ready for rewards</div>
    <div>✓ **Clear Goals** - Know what you want content creators to do</div>
    <div>✓ **Target Audience** - Decide if you want everyone or specific creators (verified, follower requirements, whitelist)</div>
  </div>
</div>

## Campaign Creation Overview

Rally's campaign creation process includes these key steps:

<div className="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">1️⃣ Basic Details</h4>
    <p className="text-sm text-muted-foreground">Campaign name, description, knowledge base</p>
  </div>
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">2️⃣ Budget & Duration</h4>
    <p className="text-sm text-muted-foreground">Token rewards and campaign timeline</p>
  </div>
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">3️⃣ Missions</h4>
    <p className="text-sm text-muted-foreground">Tasks for content creators to complete</p>
  </div>
  <div className="bg-card rounded-lg border p-4 border-primary">
    <h4 className="font-semibold mb-2">🎯 4️⃣ Targeting</h4>
    <p className="text-sm text-muted-foreground font-semibold">Choose who can participate: verified accounts, follower ranges, or whitelist</p>
  </div>
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">5️⃣ Review & Deploy</h4>
    <p className="text-sm text-muted-foreground">Confirm settings and launch on-chain</p>
  </div>
</div>

---

## Step 1: Basic Details
*Tell us about your campaign*

<div className="bg-card rounded-lg border p-6 mt-4">

**Campaign Name**  
Your campaign's public title. Make it clear and memorable.
- ✅ Good: "Share Our DeFi Launch"
- ❌ Avoid: "Campaign #3"

**Short Description**  
A brief overview that explains your campaign's purpose to content creators.
> Example: "Help us introduce our new yield farming feature to the DeFi community"

**Knowledge Base** ⚠️ *Most Important Field*  
This is what AI uses to verify tweet accuracy. Be comprehensive!

<Callout type="warning">
**Critical**: The Knowledge Base directly impacts submission quality. AI evaluates all tweets against this information.
</Callout>

<details>
<summary>📖 How to Write an Effective Knowledge Base</summary>

```markdown
## Project Overview
[Your project name] is [what it does] that enables [who it helps] 
to [achieve what outcome] through [key mechanism].

## Key Features
- Feature 1: [Description and benefit]
- Feature 2: [Description and benefit]
- Feature 3: [Description and benefit]

## Technical Details
- Token: [Symbol, type, contract]
- Networks: [List supported chains]
- Smart Contracts: [Audit status]
- TVL/Volume: [If impressive]

## Target Users
- Primary: [Main user type and why they care]
- Secondary: [Other users and benefits]

## Important Facts
- [Specific numbers, dates, milestones]
- [Unique achievements or partnerships]
- [Security features or guarantees]
```

**Essential Sections:**
✓ Project description with clear value prop  
✓ Specific features and benefits  
✓ Technical specifications  
✓ Target audience and use cases  
✓ Verifiable facts and figures  
✓ Do's and don'ts for content  

**Remember:** No links - paste actual content. Be specific, not vague.
</details>

**Campaign Style**  
Define the tone and voice you want content creators to use.
> Examples: "Professional and educational" or "Friendly and accessible"

**Campaign Rules**  
Set clear boundaries for submissions.
- Required elements (hashtags, mentions)
- Prohibited content (false claims, offensive language)
- Format requirements (minimum length, language)

</div>

---

## Step 2: Pot & Duration
*Set your budget and timeline*

<div className="bg-card rounded-lg border p-6 mt-4">

**Network & Token**  
Choose where to distribute rewards:
- Networks: Base, zkSync Era
- Tokens: Select from available options on each network

**Budget Configuration**

| Field | Description | Example |
|-------|-------------|---------|  
| **Total Amount** | Your entire campaign budget | 20,000 USDC |
| **Number of Periods** | How many distribution cycles | 10 periods |
| **Period Duration** | Days per period | 7 days |
| **Rewards per Period** | Auto-calculated | 2,000 USDC |

**Timeline**  
- Start Date: Today or schedule for future
- End Date: Automatically calculated
- Total Duration: Periods × Duration = Campaign length

</div>

---

## Step 3: Missions
*Create activities for participants*

<div className="bg-card rounded-lg border p-6 mt-4">

**What are Missions?**  
Missions are different tweet activities within your campaign. Create multiple missions upfront, then activate them strategically across periods.

<Callout type="info">
💡 **Example**: If 3 missions are active, each content creator can submit 3 different tweets per period
</Callout>

**For Each Mission:**

📝 **Title** - Clear, descriptive name  
📋 **Description** - What content creators should create  
📏 **Rules** - Specific requirements (hashtags, length, topics)  
🔄 **Status** - Toggle active/inactive per period  

**Mission Planning Strategy:**
```
Weeks 1-2: "Introduction Mission" ✅ Active
Weeks 3-4: "Tutorial Mission" ⏸️ Activate later  
Weeks 5-6: "Success Stories" ⏸️ Activate later
```

<Callout type="warning">
⚠️ Submissions are evaluated against BOTH campaign rules AND mission rules
</Callout>

</div>

---

## Step 4: Targeting on X
*Choose your content creators*

<div className="bg-card rounded-lg border p-6 mt-4">

**Option 1: Open to Everyone**
- ☑️ All Rally users can participate
- 🔷 Verified users only (optional)
- 📊 Follower requirements:
  - Minimum: Set a floor (0 = no minimum)
  - Maximum: Set a cap (0 = no maximum)

**Option 2: Whitelist Only**
- 📋 Specific Twitter usernames only
- Perfect for: Beta testers, community rewards, targeted campaigns
- Easy input: Paste any list format (comma, space, or line separated)

</div>

---

## Step 5: Confirm & Create
*Review and deploy on-chain*

<div className="bg-card rounded-lg border p-6 mt-4">

**Final Review**
- ✓ Campaign details correct?
- ✓ Budget and timeline confirmed?
- ✓ Missions properly configured?
- ✓ Targeting parameters set?

**Deploy Your Campaign**
1. Click "Create Campaign"
2. Connect to GenLayer network
3. Approve transaction in wallet
4. Wait for on-chain confirmation
5. Campaign is created and scheduled!

<Callout>
🚀 Your campaign will go live automatically on the start date you selected
</Callout>

</div>

---

## What Happens Next?

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 mt-4">
  <div className="bg-card rounded-lg border p-6">
    <h3 className="text-lg font-semibold mb-4">📊 After Creation</h3>
    <div className="space-y-1">
      <div>• Campaign scheduled for start date</div>
      <div>• Visible in campaign listings</div>
      <div>• Goes live automatically when scheduled</div>
      <div>• Real-time analytics once active</div>
    </div>
  </div>
  
  <div className="bg-card rounded-lg border p-6">
    <h3 className="text-lg font-semibold mb-4">🤖 Automatic Processing</h3>
    <div className="space-y-1">
      <div>• AI verifies each submission</div>
      <div>• Campaign Points calculated for each user</div>
      <div>• After period ends, Campaign Points converted to reward shares using distribution curve</div>
      <div>• Users can claim their rewards on-chain</div>
      <div>• No manual intervention needed</div>
    </div>
  </div>
</div>

## Quick Tips for Success

**Knowledge Base** → More detail = Better submissions  
**Rewards** → Competitive budgets attract quality creators  
**Missions** → Start with 1-2, add more as you learn  
**Targeting** → Begin broad, refine based on results  

## FAQs

<details>
<summary>Can I edit my campaign after creation?</summary>
- **Campaign Details**: Immutable (name, description, budget, duration, etc.)
- **Targeting Parameters**: Can be updated anytime (follower requirements, verification status, whitelist)
- **Missions**: Can toggle on/off between periods
</details>

<details>
<summary>Can I terminate my campaign?</summary>
Yes, you can terminate a campaign, which will:
- Stop the campaign from the next period onwards
- The current period continues if already started (cannot be aborted)
- Unused budget can be withdrawn after termination
</details>

<details>
<summary>When are rewards distributed?</summary>
Automatically at the end of each period, after AI verification completes.
</details>

<details>
<summary>What if I have unused budget?</summary>
Withdraw any undistributed rewards after campaign completion or termination.
</details>

---

<div className="flex justify-center mt-8">
  <a href="https://app.rally.fun/campaigns/manage/create" className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-lg font-medium text-primary-foreground hover:bg-primary/90">
    Create Your Campaign →
  </a>
</div>


# scoring-system/page.mdx

# Rally Scoring System

The Rally scoring system uses AI-powered evaluation to ensure fair and transparent reward distribution based on content quality and engagement.

## TLDR

- **Quality Gates**: Submissions must pass 4 AI-evaluated gates (alignment, accuracy, compliance, originality)
- **Dual Scoring**: Fixed quality component + dynamic engagement metrics determine your Campaign Points
- **Metric Weights**: Each of the 11 metrics has a weight (0–1); 0 disables it, higher means more impact
- **Fair Distribution**: Projects choose reward distribution curves (Balanced, Default, or Extreme)
- **Refresh Engagement**: Update engagement metrics in later periods for additional Campaign Points
- **Multi-LLM Consensus**: All evaluations use multiple AI models for fairness

## Overview

The scoring system evaluates tweets across multiple dimensions, combining intrinsic quality metrics with real-time engagement data to calculate fair rewards. Campaign Points determine a content creator's share of the rewards pot — higher points mean higher rewards. During the Alpha phase, these rewards are distributed as Rally Points.

## Categories of Evaluation

At a glance, Rally evaluates content across 3 categories (11 total metrics):

- **Gates (4, scored 0–2 each)**: Content Alignment, Information Accuracy, Campaign Compliance, Originality & Authenticity. Submissions must pass all gates (score > 0) to be eligible for rewards.
- **Quality Metrics (2, scored 0–5)**: Engagement Potential, Technical Quality. These capture intrinsic quality beyond the gates.
- **Engagement Metrics (5, dynamic)**: Retweets, Likes, Replies, Quality of Replies (AI-evaluated), Followers of Repliers. These update over time based on real audience interaction.

## Reward Distribution Curves

Projects select how sharply rewards concentrate among top-performing creators:

- **Balanced**: ~25% of rewards to the top 10%
- **Default**: ~90% of rewards to the top 10%
- **Extreme**: ~99% of rewards to the top 10%

These curves are implemented in the scoring formula via alpha (α). Higher α concentrates rewards more among top performers; lower α spreads them more evenly. See the math section for the exact mapping.

## Weights (0–1 per metric)

Each of the 11 metrics can be assigned a weight from 0 to 1:

- **1.0**: Maximum importance
- **0.0**: Metric is completely turned off (does not affect scoring)
- Values in between scale the metric’s relative impact

Weights are visible to campaign managers in the setup wizard and to content creators in the campaign briefing, so priorities are transparent. Projects can tailor these per campaign. For example:

- To emphasize quality over engagement, lower the weights for engagement metrics (RT, LK, RP, QR, FR) and raise the weights for EP and TQ.
- If uniqueness is not a priority, set the Originality & Authenticity gate weight to 0 to turn it off. Turning a gate off means it will not disqualify submissions and will not influence the gate multiplier.

## Refresh Engagement (Overview)

Refresh Engagement allows content creators to update engagement metrics for prior submissions in later periods to capture ongoing performance.

- After the initial submission in a period, a transaction can be submitted in subsequent periods to refresh engagement metrics for that submission
- The quality component remains fixed from the first submission; only engagement metrics are refreshed
- The refresh credits only the positive difference versus the previous baseline, rewarding genuine growth in engagement

## Detailed Metrics

## Gates (pass/fail with quality)

Submissions must pass through four quality gates. Each gate scores from 0-2:
- **0** = Fail (disqualifies the submission)
- **1-2** = Pass with quality rating

### 1. Content Alignment (0–2)
How well the content aligns with the campaign's message and values:
- Message accuracy
- Correct terminology usage
- Brand consistency
- Target audience fit

### 2. Information Accuracy (0–2)
Factual correctness of the content:
- Technical accuracy
- Consistency with official materials
- Accurate data and statistics
- Proper context

### 3. Campaign Compliance (0–2)
Adherence to campaign rules:
- Required hashtags and mentions
- Format requirements
- Style guidelines
- Necessary disclosures

### 4. Originality & Authenticity (0–2)
Uniqueness and authentic voice:
- Fresh perspective
- Personal insights
- Natural language
- Creative expression

## Quality Metrics

Beyond the gates, two additional quality metrics are evaluated:

### Engagement Potential (0–5)
- Hook effectiveness
- Call-to-action quality
- Content structure
- Conversation potential

### Technical Quality (0–5)
- Grammar and spelling
- Formatting and structure
- Platform optimization
- Media integration

## Engagement Metrics

These metrics update over time based on content performance:

### Direct Metrics (dynamic)
- **Retweets (RT)** - Amplification of the message (log-scaled)
- **Likes (LK)** - Audience appreciation (log-scaled)
- **Replies (RP)** - Conversation generation (log-scaled)

### Advanced Metrics (dynamic)
- **Quality of Replies (QR)** - AI analysis of reply quality (0–1)
- **Followers of Repliers (FR)** - Reach of engaged audience (log-scaled)

### Thread Scoring
For multi-tweet threads, we use the **peak performance** of any tweet in the thread for each metric.
Ranges and scaling:
- RT, LK, RP: counted via log(R+1), log(L+1), log(RP+1)
- QR: 0–1 AI score reflecting relevance, civility, informativeness
- FR: log(Followers+1) for accounts that replied

## Score Calculation (Full Math)

### The Complete Formula

The scoring system uses a multi-step calculation:

#### Step 1: Gate Pass & Multiplier
```
gate_pass = min(G₁, G₂, G₃, G₄) > 0
g_star = avg(G₁, G₂, G₃, G₄)
M_gate = 1 + β × (g_star - 1)
```
Where G₁-G₄ are the four gate scores (0-2) and β = 0.5

#### Step 2: Campaign Points (Q Score)
```
Campaign_Points = M_gate × Σ(W[i] × normalized_metrics[i])
```
Where:
- W is the vector of metric weights in [0,1] for the 11 metrics (W[i]=0 turns a metric off; higher values increase impact)
- Normalized metrics include: EP, TQ, log(RT+1), log(LK+1), log(RP+1), QR, log(FR+1)

#### Step 3: Period Accumulation (Refresh Engagement)
- New submissions: `user_Q[period] += Campaign_Points`
- Refresh Engagement: `user_Q[period] += max(0, Q_current - Q_baseline)`

#### Step 4: Final Distribution (Distribution Curves)
```
S_user = max(user_Q[period], 0)^α
share_user = S_user / Σ(S_all_users)
rewards_user = share_user × total_rewards
```
Where α corresponds to the selected curve:
- Balanced → α = 1.0
- Default → α = 3.0
- Extreme → α = 8.0

Higher α values increase concentration (more to the very top performers), while lower α values distribute rewards more broadly.

### The Formula (Simplified)

1. **Gate Multiplier**: Exceptional gate performance (scores >1) provides a bonus
2. **Campaign Points**: Weighted combination of all metrics
3. **Period Accumulation**: Scores accumulate throughout the campaign period
4. **Final Distribution**: At period end, rewards are distributed based on relative performance


## Refresh Engagement System

Content creators can refresh engagement in later periods to capture additional performance:
- Quality component remains fixed from first submission
- Only engagement metrics are updated
- You earn the **difference** between new and old Campaign Points
- Prevents gaming through repeated refreshes

## Tips for High Scores

### Quality Tips
1. **Research the campaign** thoroughly before tweeting
2. **Be authentic** - use a distinctive voice and perspective
3. **Follow all requirements** exactly
4. **Add value** - don't just repeat talking points

### Engagement Tips
1. **Post at optimal times** for the intended audience
2. **Engage with replies** to boost conversation
3. **Create compelling hooks** to grab attention
4. **Use threads** strategically - the best-performing tweet counts

## Distribution Curves (at a glance)

Projects choose the model that best fits their goals. At a high level:
- **Balanced**: ~25% of rewards to the top 10% of content creators
- **Default**: ~90% of rewards to the top 10% of content creators
- **Extreme**: ~99% of rewards to the top 10% of content creators

## Important Notes

- **Images are not evaluated** - Focus on text content
- **Quality component is permanent** - The first submission is the baseline
- **Engagement updates** - Check back to resubmit high-performing tweets
- **Period-based distribution** - Rewards distributed at campaign period end

## Technical Details

For developers and projects wanting deeper understanding:

- Scores stored as "atto" values (×10^18) for precision
- Vector similarity used for originality comparison
- Non-deterministic LLM calls use consensus validation
- Maximum 2-point variance allowed between validators

---

*This scoring system ensures fair rewards for quality content while preventing spam and low-effort submissions. The goal is to support campaigns and audiences with valuable, engaging content.*

# referral-system/page.mdx

# Referral System

Rally's referral system rewards you for bringing new users to the platform - whether they're content creators or projects. Earn ongoing rewards from everyone you refer!

## How It Works

The referral system creates a win-win ecosystem where everyone benefits from growing the Rally community.

### Your Unique Referral Link

Find your personal referral link at [waitlist.rally.fun](https://waitlist.rally.fun). Share this link to start earning from your referrals.

## Referral Rewards

### Referring Content Creators

When you refer someone who becomes a content creator:

<div className="bg-card rounded-lg border p-6 mb-4">
  <h3 className="text-lg font-semibold mb-4">🎯 10% Campaign Points Share</h3>
  <p>You earn <strong>10% of their Campaign Points</strong> from <strong>every campaign</strong> they participate in - not just the first one!</p>
  
  <div className="mt-4 p-4 bg-muted rounded">
    <p className="text-sm"><strong>Example:</strong> If your referral earns 1,000 Campaign Points in a campaign, you automatically receive 100 Campaign Points as a bonus.</p>
  </div>
</div>

This creates a passive income stream as your referrals continue to participate in campaigns.

### Referring Projects

When you refer a project that creates campaigns:

<div className="bg-card rounded-lg border p-6 mb-4">
  <h3 className="text-lg font-semibold mb-4">💰 10% Rally Point Rewards</h3>
  <p>You earn <strong>10% of the Rally Point rewards</strong> allocated to campaigns created by projects you refer.</p>
  
  <div className="mt-4 p-4 bg-muted rounded">
    <p className="text-sm"><strong>Note:</strong> These RLY rewards are additional incentives provided by Rally's tokenomics on top of the project's own token distribution. The exact allocation varies by campaign.</p>
  </div>
</div>

## Benefits of the Referral System

### For You (The Referrer)
- **Passive Income**: Earn from your network's ongoing activity
- **No Limits**: Refer as many users as you want
- **Permanent Rewards**: Your referral connection lasts forever
- **Dual Earning**: Benefit from referring both creators and projects

### For Content Creators
- **Easy Onboarding**: Join through a trusted connection
- **No Impact on Earnings**: Referral rewards don't reduce their earnings
- **Community Support**: Get help from the person who referred you

### For Projects
- **Trusted Introduction**: Connect through existing relationships
- **No Additional Cost**: Referral rewards come from Rally, not your budget
- **Quality Assurance**: Referrers often help their connections succeed

## How to Maximize Your Referrals

### Best Practices

1. **Target the Right Audience**
   - Content creators with engaged X (Twitter) followings
   - Web3 projects looking for authentic marketing
   - Active community members in crypto spaces

2. **Educate Your Referrals**
   - Share how Rally works
   - Explain the benefits for them
   - Offer to help with their first campaign or mission

3. **Build Long-term Relationships**
   - Support your referrals' success
   - Share tips and strategies
   - Create a network effect

### Referral Strategies

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 mt-4">
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">🐦 For Twitter/X</h4>
    <ul className="text-sm space-y-1">
      <li>• Share success stories</li>
      <li>• Post about high-reward campaigns</li>
      <li>• Engage with Web3 communities</li>
      <li>• Use relevant hashtags</li>
    </ul>
  </div>
  
  <div className="bg-card rounded-lg border p-4">
    <h4 className="font-semibold mb-2">💬 For Discord/Telegram</h4>
    <ul className="text-sm space-y-1">
      <li>• Join Web3 project servers</li>
      <li>• Participate in marketing discussions</li>
      <li>• Share in appropriate channels</li>
      <li>• Offer value before promoting</li>
    </ul>
  </div>
</div>

## Tracking Your Referrals

Monitor your referral performance:

1. **Visit Your Account**: Go to [waitlist.rally.fun](https://waitlist.rally.fun)
2. **View Referral Stats**: See total referrals and earnings
3. **Track Performance**: Monitor ongoing rewards from your network

## Important Details

### Referral Attribution
- Referrals are permanently linked to your account
- Attribution happens when someone signs up using your link
- The connection cannot be changed later

### Reward Distribution
- **Campaign Points**: Added to your account automatically
- **Token Rewards**: Claimable when the referred project's campaigns complete
- **Timing**: Rewards follow the same schedule as regular earnings

### Terms & Conditions
- No self-referrals allowed
- Spam or misleading promotion is prohibited
- Rally reserves the right to adjust the program
- All referrals must comply with platform rules

## FAQs

<details>
<summary>Can I refer myself or create multiple accounts?</summary>
No, self-referrals are not allowed and will be detected. Each person should have only one account.
</details>

<details>
<summary>Is there a limit to how many people I can refer?</summary>
No limits! Refer as many legitimate users as you want.
</details>

<details>
<summary>When do I receive my referral rewards?</summary>
- **Campaign Points**: Immediately when your referral earns them
- **Token Rewards**: When campaigns complete their distribution periods
</details>

<details>
<summary>What if my referral stops using Rally?</summary>
You keep all rewards already earned. If they return and participate again, you'll continue earning from their activity.
</details>

## Start Referring Today

Ready to build your referral network?

<div className="flex justify-center mt-8">
  <a href="https://waitlist.rally.fun" className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-lg font-medium text-primary-foreground hover:bg-primary/90">
    Get Your Referral Link →
  </a>
</div>

---

*The Rally referral system is designed to reward community builders. By sharing Rally with others, you're not just earning rewards - you're helping build the future of Web3 marketing.*


# technical/page.mdx

# Overview

Dive deep into Rally's architecture, smart contracts, and integration options. This section is for developers, auditors, and technical teams.

## Architecture Overview

Rally is built on a unique multi-chain architecture that combines:

- **EVM Chains**: Enables projects to distribute tokens directly in their own ecosystems where their communities already live
- **GenLayer**: For AI-powered intelligent contracts and verification
- **Bridge System**: Built on LayerZero for seamless cross-chain communication

<Callout type="info">
Rally's architecture enables both the security of established chains and the innovation of AI-powered verification.
</Callout>

## Core Components

### Smart Contracts (EVM)
Traditional Solidity contracts handle:
- Campaign creation and management
- Token escrow and distribution
- User registration and XID verification
- Multi-chain deployment

{/* Smart Contract documentation coming soon */}

### Intelligent Contracts (GenLayer)
Python-based contracts that leverage AI for:
- Content quality analysis
- Engagement verification
- Spam detection
- Dynamic reward calculation

{/* Intelligent Contract documentation coming soon */}

### Cross-Chain Bridge
Synchronizes state between chains:
- Message passing protocol
- State verification
- Atomic operations
- Fault tolerance

{/* Bridge documentation coming soon */}

## Technology Stack

Rally leverages cutting-edge technology across four key components:

### Intelligent Contracts
AI-powered contracts on GenLayer that handle:
- Content quality verification
- Engagement analysis
- Reward distribution logic
- Anti-spam mechanisms

### Smart Contracts
Traditional EVM contracts managing:
- Campaign creation and escrow
- Token distribution
- Cross-chain operations
- User authentication

### Bridge
Cross-chain communication layer enabling:
- State synchronization
- Message passing
- Multi-chain deployments
- Unified user experience

### App
Full-stack application providing:
- User interface for participants and projects
- Analytics and reporting
- Wallet integration

## Security

Rally prioritizes security through:

- **Multi-LLM Consensus**: Submissions are verified by multi-LLM consensus on [GenLayer](https://genlayer.com)
- **Escrow Protection**: Funds are held in escrow smart contracts, ensuring fair rules for content creators

### Multi-Chain Architecture

Rally's multi-chain architecture orchestrates three key blockchain environments to deliver AI-powered marketing campaigns:

**GenLayer (AI Verification Layer)**
- Hosts Python-based intelligent contracts that leverage LLM consensus
- `CampaignFactory.py` deploys and manages campaign instances
- `CampaignIC.py` calculates submission scores using AI evaluation
- `XID.py` verifies X (Twitter) account ownership and authenticity
- `BridgeSender.py` stores messages for cross-chain communication

**ZKSync Era Chain**
- Acts as the central routing hub for all cross-chain messages
- `BridgeForwarder.sol` receives messages from Bridge Service and routes them:
  - Locally to ZKSync contracts
  - Cross-chain to Base via LayerZero
- Provides token distribution
- Maintains synchronized user registries and campaign rewards distributions

**Base Chain**
- `BridgeReceiver.sol` processes incoming LayerZero messages
- Provides token distribution
- Maintains synchronized user registries and campaign rewards distributions

**Message Flow Architecture**
1. GenLayer intelligent contracts generate verification results
2. `BridgeSender.py` stores messages for the Bridge Service
3. Bridge Service (off-chain relayer) picks up messages and calls `BridgeForwarder.sol` on ZKSync
4. `BridgeForwarder.sol` determines the destination:
   - Local ZKSync execution for L2 operations
   - LayerZero bridge to Base
5. Target chain contracts execute the requested operations

```mermaid
graph TB
    subgraph "GenLayer"
        subgraph "Intelligent Contracts"
            GEN_CF[CampaignFactory.py<br/>Campaign Deployment]
            GEN_IC[CampaignIC.py<br/>Submissions Score Calculation]
            GEN_XID[XID.py<br/>X User Verification]
            GEN_BS[BridgeSender.py<br/>Stores Bridge Messages]
        end
    end
    
    subgraph "Bridge Service"
        BS[Bridge Service<br/>Off-chain Relayer]
    end
    
    subgraph "ZKSync Era"
        subgraph "Smart Contracts"
            ZK_BF[BridgeForwarder.sol<br/>Routes Messages]
            ZK_CF[CampaignFactory.sol<br/>Campaign Deployment]
            ZK_C[Campaign.sol<br/>Token Distribution]
            ZK_XID[XID.sol<br/>X User Registry]
        end
    end
    
    subgraph "LayerZero"
        LZ[LayerZero Endpoints<br/>Cross-Chain Bridge]
    end
    
    subgraph "Base Chain"
        subgraph "Smart Contracts"
            BASE_BR[BridgeReceiver.sol<br/>Receives LayerZero Messages]
            BASE_CF[CampaignFactory.sol<br/>Campaign Deployment]
            BASE_C[Campaign.sol<br/>Token Distribution]
            BASE_XID[XID.sol<br/>X User Registry]
        end
    end
    
    %% GenLayer Internal Flow
    GEN_CF ==> |Create Campaign| GEN_IC
    GEN_IC ==> |Bridge period distribution| GEN_BS
    GEN_XID ==> |Bridge user to chain| GEN_BS
    
    %% Bridge Flow
    GEN_BS ==>|Send Message| BS
    BS ==>|Send Message| ZK_BF
    
    %% BridgeForwarder Decision
    ZK_BF ==>|Update Period Distribution| ZK_C
    ZK_BF ==>|Register User Wallet| ZK_XID
    ZK_BF ==>|Bridge to Base| LZ
    
    %% LayerZero to Base
    LZ ==>|Cross-Chain| BASE_BR
    BASE_BR ==>|Update Period Distribution| BASE_C
    BASE_BR ==>|Register User Wallet| BASE_XID
    
    %% Contract interactions on Base
    BASE_CF ==> |Create Campaign| BASE_C
    BASE_XID ==> |Check registered user| BASE_C
    
    %% Contract interactions on ZKSync
    ZK_CF ==> |Create Campaign| ZK_C
    ZK_XID ==> |Check registered user| ZK_C

```

## Advanced Topics

- GenLayer Integration (coming soon)
- Analytics Integration (coming soon)

## Questions?

- Security concerns: security@rally.fun
- Partnership inquiries: partners@rally.fun

# technical/public-api/page.mdx

# Public API

Public endpoints for integrating Rally stats into your website, dashboard, or application. No authentication required.

## Base URL

| Environment | URL |
|-------------|-----|
| Production | `https://rally.genlayer.com/api/public` |
| Staging | `https://rally-staging.vercel.app/api/public` |

## Endpoints

### GET /stats

Platform-wide statistics for public display.

**Authentication**: None required

**Example Request**:

```bash
curl https://rally.genlayer.com/api/public/stats
```

**Response**:

```json
{
  "success": true,
  "data": {
    "activeCampaigns": 5,
    "totalParticipants": 1234,
    "totalSubmissions": 5678,
    "totalImpressions": 2500000
  }
}
```

**Response Fields**:

| Field | Type | Description |
|-------|------|-------------|
| `activeCampaigns` | number | Currently active campaigns (not ended, not deleted) |
| `totalParticipants` | number | Unique users who have submitted across all campaigns |
| `totalSubmissions` | number | Total tweet submissions across all campaigns |
| `totalImpressions` | number | Total Twitter/X impressions across all campaign periods |

## Usage Examples

### JavaScript/TypeScript

```typescript
async function getRallyStats() {
  const response = await fetch('https://rally.genlayer.com/api/public/stats');
  const { data } = await response.json();

  console.log(`${data.totalImpressions.toLocaleString()} impressions generated`);
  console.log(`${data.totalParticipants.toLocaleString()} participants`);

  return data;
}
```

### React Component

```tsx
function RallyStats() {
  const [stats, setStats] = useState(null);

  useEffect(() => {
    fetch('https://rally.genlayer.com/api/public/stats')
      .then(res => res.json())
      .then(({ data }) => setStats(data));
  }, []);

  if (!stats) return <div>Loading...</div>;

  return (
    <div>
      <p>{stats.totalImpressions.toLocaleString()} impressions</p>
      <p>{stats.totalParticipants.toLocaleString()} participants</p>
      <p>{stats.activeCampaigns} active campaigns</p>
    </div>
  );
}
```

## Rate Limiting

Standard rate limits apply. For high-traffic integrations, consider caching responses on your end.

## Data Freshness

Statistics are updated when campaign metrics are aggregated, typically every few hours. The data represents cumulative totals across all Rally campaigns.


# resources/page.mdx

# Resources

Find official Rally resources and links to connect with the platform and community.

## Official Resources

### Rally Platform
- **[Waitlist.rally.fun](https://waitlist.rally.fun)** - Website for signing up to the waitlist and earning referral points
- **[App.rally.fun](https://app.rally.fun)** - Main Platform for browsing campaigns and participating

### Social Media
- **[X/Twitter: @RallyOnChain](https://x.com/RallyOnChain)** - Latest updates and announcements

## More Resources Coming Soon

We're building out additional resources including:
- Documentation and guides
- Community channels
- Developer tools
- Educational content

Check back soon for updates!