# Campaign Lifecycle Understanding the complete lifecycle of a campaign helps you manage it effectively from creation to completion. ## Campaign Stages ### 1. Pending Stage **Status**: Campaign created but not yet started **Characteristics:** - Start time in the future - No purchases allowed - Visible on platform - Can be updated by creator **Creator Actions:** - ✅ Update campaign details - ✅ Modify start/end times - ✅ Adjust floor/ceiling - ✅ Change funds recipient - ✅ Promote upcoming launch - ✅ Cancel if needed **Supporter Actions:** - View campaign details - Follow for updates - Share with others - Prepare to back **Duration**: From creation until start time ### 2. Active Stage **Status**: Campaign accepting funds **Characteristics:** - Between start and end time - Purchases enabled - Real-time progress tracking - Token supply growing - Cannot modify core parameters **Creator Actions:** - ✅ Monitor progress - ✅ Post updates - ✅ Respond to questions - ✅ Promote campaign - ✅ Engage community - ✅ Add collaborators - ✅ Extend deadline (once) - ⚠️ Cancel (with conditions) **Supporter Actions:** - Purchase tokens with USDC - Track progress - Ask questions - Share campaign - Increase backing **Progress Tracking:** ``` Current Raised: $45,000 USDC Floor Target: $50,000 USDC Progress: 90% Time Remaining: 15 days ``` **Duration**: From start time until end time or ceiling reached ### 3. Grace Period **Status**: Deadline passed, floor not reached **Characteristics:** - 24-hour extension window - No new purchases - Can extend or finalize as failed - Automatic after deadline **Creator Actions:** - **Option A**: Extend campaign (if extensions available) - Set new end time - Continue fundraising - Maximum 1 extension (default) - **Option B**: Finalize as failed - Accept campaign didn't succeed - Trigger refund process - Supporters get USDC back **Supporter Actions:** - Wait for creator decision - Prepare for refund if failed - No new purchases allowed **Duration**: 24 hours after deadline **Example:** ``` Campaign ended: Jan 15, 2025 23:59:59 UTC Raised: $45,000 / $50,000 (90%) Grace period: Jan 16, 2025 00:00:00 - 23:59:59 UTC Creator must: Extend or finalize by Jan 16, 2025 23:59:59 UTC ``` ### 4. Success Stage **Status**: Floor reached, awaiting finalization **Characteristics:** - Raised ≥ Floor amount - Deadline passed or ceiling reached - Funds locked in contract - Token supply locked - Awaiting creator to claim funds **Creator Finalize Grace Period:** - **Duration**: 2 weeks from deadline - **Purpose**: Give creator time to decide - **Options**: 1. Claim funds and proceed 2. Cancel and refund supporters **After Grace Period:** - Anyone can finalize campaign - Prevents indefinite limbo - Protects supporter interests **Creator Actions:** - **Claim Funds**: 1. Click "Finalize Campaign" 2. Confirm transaction 3. Funds sent to recipient address 4. Token graduates to full features - **Or Cancel**: 1. Click "Cancel Campaign" 2. Confirm cancellation 3. Supporters get refunds 4. Token supply remains locked **Supporter Actions:** - Wait for finalization - Cannot trade yet - Cannot get refunds (unless cancelled) - Tokens held in wallet **Duration**: Up to 2 weeks, then public finalization ### 5. Graduated Stage **Status**: Campaign finalized successfully **Characteristics:** - Funds claimed by creator - Token supply permanently locked - Full platform features activated - Trading enabled - DeFi features available **Token Features Activated:** - ✅ **Trading**: Buy/sell on marketplace - ✅ **Lending**: Deposit USDC to earn interest - ✅ **Borrowing**: Use tokens as collateral - ✅ **Contests**: Participate in trading competitions - ✅ **Dividends**: Receive revenue distributions - ✅ **Governance**: Vote in surveys (if enabled) **Creator Actions:** - Post production updates - Distribute dividends - Create surveys - Manage token economics - Engage community - Schedule redemption events **Supporter Actions:** - Trade tokens freely - Provide liquidity - Borrow against tokens - Compete in contests - Claim dividends - Participate in governance **Duration**: Indefinite (permanent) ### 6. Failed Stage **Status**: Campaign did not reach floor **Characteristics:** - Deadline passed - Raised < Floor amount - Grace period expired - Refunds available **Creator Actions:** - Learn from experience - Analyze what went wrong - Plan next campaign - Communicate with supporters **Supporter Actions:** - Claim refunds - Receive full USDC back - No tokens retained - No fees charged **Refund Process:** 1. Visit campaign page 2. Click "Claim Refund" 3. Confirm transaction 4. Receive USDC back **Duration**: Refunds available indefinitely ### 7. Cancelled Stage **Status**: Campaign manually cancelled **Characteristics:** - Cancelled by creator or screener - Refunds available immediately - Token supply locked - No graduation **Cancellation Reasons:** - Creator decision - Project no longer viable - Screener intervention - Terms violation - Fraud prevention **Creator Actions:** - Communicate reason - Apologize to supporters - Learn from experience **Supporter Actions:** - Claim refunds - Receive full USDC back - No penalties **Duration**: Refunds available indefinitely ## State Transitions ### Visual Flow ``` ┌─────────────┐ │ PENDING │ (Before start time) └──────┬──────┘ │ Start time reached ▼ ┌─────────────┐ │ ACTIVE │ (Accepting funds) └──────┬──────┘ │ ├─────► Ceiling reached ──────┐ │ │ └─────► Deadline passed │ │ │ ▼ │ ┌──────────────┐ │ │ GRACE PERIOD │ │ └──────┬───────┘ │ │ │ ┌─────────────┼────────────┐ │ │ │ │ │ ▼ ▼ ▼ ▼ ┌────────┐ ┌─────────┐ ┌──────────┐ │ FAILED │ │ EXTEND │ │ SUCCESS │ └────────┘ └────┬────┘ └────┬─────┘ │ │ └──► ACTIVE │ Finalize │ ┌─────────┼──────────┐ │ │ ▼ ▼ ┌──────────┐ ┌───────────┐ │ GRADUATED│ │ CANCELLED │ └──────────┘ └───────────┘ ``` ## Timeline Examples ### Example 1: Successful Campaign (No Extension) ``` Day 0: Campaign created (Pending) Day 1: Campaign starts (Active) Day 30: Reached floor ($50k) Day 45: Reached ceiling ($200k) - Auto-conclude Day 45: Creator finalizes - Graduates Day 46+: Trading, lending, contests active ``` ### Example 2: Successful Campaign (With Extension) ``` Day 0: Campaign created (Pending) Day 1: Campaign starts (Active) Day 60: Deadline reached - $45k raised (90%) Day 60-61: Grace period Day 61: Creator extends 30 days Day 61-91: Campaign active again Day 75: Reached floor ($50k) Day 91: Deadline - Campaign success Day 91-105: Creator finalize grace period Day 100: Creator finalizes - Graduates ``` ### Example 3: Failed Campaign ``` Day 0: Campaign created (Pending) Day 1: Campaign starts (Active) Day 60: Deadline reached - $30k raised (60%) Day 60-61: Grace period Day 61: Creator finalizes as failed Day 62+: Supporters claim refunds ``` ### Example 4: Cancelled Campaign ``` Day 0: Campaign created (Pending) Day 1: Campaign starts (Active) Day 15: $20k raised (40%) Day 15: Creator cancels (project issues) Day 16+: Supporters claim refunds ``` ## Key Milestones ### Campaign Progress **25% Funded** - Early momentum indicator - Share milestone with community - Increase marketing efforts **50% Funded** - Halfway point - Reassess strategy - Celebrate with supporters **75% Funded** - Success likely - Plan for graduation - Prepare post-campaign activities **100% Funded (Floor)** - Campaign guaranteed success - Can still accept more (if overage allowed) - Begin production planning **Ceiling Reached** - Maximum funding achieved - Campaign auto-concludes - Finalize immediately ## Time Limits ### Maximum Campaign Duration - **270 days** (9 months) from initial start - Includes all extensions - Hard limit enforced by contract ### Extension Limits - **Default**: 1 extension allowed - **Configurable**: Platform can adjust - **Tracking**: `extensionCount` per campaign ### Grace Periods - **Post-Deadline**: 24 hours - **Creator Finalize**: 2 weeks - **Refund Claims**: No time limit ## Status Checks ### On-Chain Status Query campaign status: ```solidity // Status values 1 = PENDING 2 = ACTIVE 3 = SUCCESS 4 = FAILED 5 = CANCELLED ``` ### Frontend Display Campaign page shows: - Current status badge - Progress bar - Time remaining - Amount raised - Supporter count - Recent purchases ### Notifications Supporters receive notifications for: - Campaign starts - Milestones reached - Deadline approaching - Campaign succeeds - Campaign fails - Refunds available - Token graduates ## Managing Transitions ### As Creator **Before Start:** - Finalize all details - Prepare marketing materials - Build anticipation - Test everything **During Active:** - Monitor daily - Post updates weekly - Respond quickly - Maintain momentum **At Deadline:** - Assess results - Decide on extension - Communicate plans - Act within grace period **After Success:** - Finalize promptly - Thank supporters - Begin production - Plan dividend strategy **If Failed:** - Analyze reasons - Communicate honestly - Learn lessons - Consider relaunch ### As Supporter **During Active:** - Back early for momentum - Share with network - Ask questions - Track progress **At Deadline:** - Wait for creator decision - Check for extensions - Prepare for outcome **After Success:** - Hold or trade tokens - Explore DeFi features - Participate in contests - Await dividends **If Failed:** - Claim refund promptly - Provide feedback - Support future attempts ## Common Questions **Q: Can I cancel an active campaign?** A: Yes, but supporters get full refunds. Only cancel if absolutely necessary. **Q: What happens if I don't finalize a successful campaign?** A: After 2 weeks, anyone can finalize it for you. **Q: Can I extend multiple times?** A: Default is 1 extension. Platform may adjust this limit. **Q: How long do refunds take?** A: Instant - supporters claim directly from contract. **Q: Can I change the floor during active campaign?** A: No, floor is locked once campaign starts. **Q: What if ceiling is reached before deadline?** A: Campaign auto-concludes at ceiling. Finalize to graduate. **Q: Can supporters trade tokens before graduation?** A: No, trading activates only after successful finalization. **Q: Is there a fee to finalize?** A: Only gas fees (transaction cost). --- **Next Steps:** [Learn Campaign Management →](managing-campaigns.md)