Introduction

CloudCandy Documentation

CloudCandy is an on-chain reward and token distribution infrastructure engineered for Web3 communities, digital creators, and protocols. The network combines predictable streak schedules, cryptographic whitelist gating, and self-hosted campaign deployments.

Automated Retention

Seven-day cyclical reward schedule optimized for continuous protocol engagement.

Whitelist Protocol

Deterministic validation guaranteeing claims are strictly bounded to verified addresses.

Share Candy Pools

Decentralized self-service portal to provision and fund targeted community token drops.

Architecture

System Architecture

CloudCandy decouples authentication, identity verification, and ledger state updates into separate routines. State transitions are processed via server-side routines to ensure atomicity and eliminate client-side manipulation.

1. Session Validation   -> Authenticated via HTTP-only identity cookies
2. Permission Matcher   -> Case-insensitive lookup against the whitelist table
3. Interval Check       -> 24-hour timestamp verification per wallet account
4. Atomic Execution     -> Server mutation updates token balance & streak step
5. Cache Invalidation   -> Incremental state delivered back to client view
Access Governance

Whitelist Protocol

During initial rollout phases, all claim endpoints inspect incoming calls against an indexed directory. Requests from non-registered addresses are terminated at the API boundary.

Verified Allocation

Distribution balances are protected and reserved exclusively for early registered contributors.

Anti-Sybil Defense

Direct mapping ensures each authorized record maintains independent cooldown intervals.

Token Distribution

Reward Distribution

Allocation quotas are divided across recurring check-in tiers and single-instance verification milestones.

CategoryAllocationInterval
Daily Check-in20 - 250 $CANDY24 Hours
Follow Official Channel100 $CANDYSingle Instance
Announcement Repost75 $CANDYSingle Instance
Documentation Verification50 $CANDYSingle Instance
Retention Schedule

Check-in Mechanism

Check-in tiers progress consecutively over a 7-day period. Consistent execution unlocks higher unit payouts, reaching the highest bonus on Day 7 before recycling to Day 1.

Day 1+20$CANDY
Day 2+30$CANDY
Day 3+50$CANDY
Day 4+70$CANDY
Day 5+100$CANDY
Day 6+140$CANDY
Day 7+250Bonus Tier
Coming Soon

Share Candy Protocol

Share Candy is an upcoming module designed for decentralized campaign creation. Project creators, communities, and developers will be able to provision custom distribution pools, define eligibility parameters, and share reward links directly.

Planned Features

Custom Pool Creation

Deposit reward balances and configure distribution parameters including total supply and per-claim allowances.

Dedicated Campaign Links

Generate unique URLs for direct distribution across social platforms, documentation, and external portals.

Access Conditions

Support for custom verification requirements, including passphrase entry, task completion, and address whitelisting.

Analytics Dashboard

Real-time monitoring of claim velocity, remaining pool balance, and participant metrics.