> For the complete documentation index, see [llms.txt](https://clipit.gitbook.io/clipit-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clipit.gitbook.io/clipit-docs/clipit.md).

# CLIPIT

PUMPFUN CREATOR-FEE FUELED, HOURLY VIEW REWARDS

A **Pump.fun-native** token where **trading fees fund hourly SOL payouts** to clippers of pumpfun streamers.\
Streamers must **hold $CLIPIT** to make their clips eligible, and **the more they hold, the higher the multiplier** their clippers receive.\
Clippers race each hour to top the leaderboard. Traders fuel the pool.

X Account: <https://x.com/CLIPITSOL>

***

### TL;DR

* **Fees → Pool:** Pumpfun creator fees accumulate into the **dev wallet**.
* **Hourly Tournament:** Every hour, the pot is **split among top clips** by **weighted views**.
* **Eligibility:** Only clips **about streamers who hold $CLIPIT** are eligible.
* **Multipliers:** Streamer holdings set clipper **multipliers** (bigger bag ⇒ bigger weight).
* **Payouts:** Winners get **paid in SOL** automatically.&#x20;

***

### Roles & Incentives

* **Traders** — trade the coin → generate fee flow → bigger hourly pot → more attention → reflexivity.
* **Streamers** — buy/hold $CLIPIT to **unlock** and **boost** payouts for clippers of *their* content. Compete up the tier ladder.
* **Clippers** — post streamer clips to TikTok/Shorts, **earn SOL** each hour based on performance and the streamer’s tier.

***

### Core Mechanics

#### Hourly Collection

* Let **creator fees** flow into a **SOL vault** continuously.
* At **HH:59**, snapshot the vault growth for that hour → define **Hourly Pot**.
* Optionally apply **Hourly Cap** and **Reserve Buffer**.

#### Eligibility Rules

* A submitted clip is **eligible** only if:
  1. It’s linked to a **whitelisted streamer** in the program;
  2. That streamer **holds ≥ Tier-1** amount of $CLIPIT at the end of the hour;
  3. The post was **published within the hour** and **metrics are verifiable** (API/webhook).

#### Streamer Tier Ladder (0–15M)

| Tier   | Streamer $CLIPIT Holdings |      Multiplier |
| ------ | ------------------------: | --------------: |
| Tier 0 |                         0 | 0× (ineligible) |
| Tier 1 |                        1M |              1× |
| Tier 2 |                        3M |              2× |
| Tier 3 |                        5M |              4× |
| Tier 4 |                       10M |              8× |
| Tier 5 |                       15M |             12× |

> Tiers can be changed by governance/owner settings; the cap at **15M** per streamer creates competition without runaway inflation.

#### Weighted Views & Split

* For each eligible clip in the hour:
  * **WeightedViews = RawViews × StreamerMultiplier**
* Hourly pot splits **pro-rata**:
  * **Payoutᵢ = HourlyPot × (WeightedViewsᵢ / Σ WeightedViews)**

***

### Concrete Numbers (Worked Example)

**Assumptions**

* **Total Supply:** 1,000,000,000 $CLIPIT
* **Hourly Pot:** 2.0 SOL (from that hour’s fees)
* **Tiers:** as table above

**This hour’s submissions**

* Clipper A → 50k views about Streamer X (holds **10M**, Tier 4 → **8×**)\
  → Weighted = 50k × 8 = **400k**
* Clipper B → 30k views about Streamer Y (holds **3M**, Tier 2 → **2×**)\
  → Weighted = 30k × 2 = **60k**
* Clipper C → 20k views about Streamer Z (holds **1M**, Tier 1 → **1×**)\
  → Weighted = 20k × 1 = **20k**

**Totals**

* Σ Weighted = **480k**

**Payouts**

* A: 2.0 × (400 / 480) = **1.667 SOL**
* B: 2.0 × (60 / 480) = **0.250 SOL**
* C: 2.0 × (20 / 480) = **0.083 SOL**

> **Interpretation:** Streamers with larger $CLIPIT holdings **attract more clippers** (and those clippers win bigger).\
> Streamers compete to climb tiers; traders see persistent demand; clippers play an hourly game.

***

### Program Setup

#### For the Creator (Program Owner)

1. **Register Program**
   * Set **Token CA**, **Dev/Payout Wallet**, **Hourly Cap**, optional **Reserve %**.
2. **Verify Ownership**
   * Sign a nonce with the dev wallet to lock settings to you.
3. **Add Streamers**
   * Whitelist streamer handle + their public wallet for **holdings checks**.
4. **Turn On**
   * The worker starts hourly cycles (collect → score → split → pay).

#### For Streamers

* **Buy/Hold $CLIPIT** to **unlock** and **boost** payouts for clippers of your content.
* The system snapshots your holdings **end-of-hour** (reduce last-minute gaming with a **twap** option).

#### For Clippers

* Pick a **whitelisted streamer** (higher tier = bigger potential).
* Post to **TikTok/Shorts** during the hour; submit link.
* Earn **SOL** automatically if you rank.

***

### Token & Fee Flows

* **$CLIPIT** is **utility for streamers** (tier access) and a **speculative asset for traders**.
* **Fees** from trading (creator rewards) → **SOL Payout Vault** → **hourly clipper payouts**.
* No buybacks; all value delivery is **paid out in SOL** to **reward distribution**.

***

### Anti-Fraud & Integrity

* **Metric verification:** aggregate from platform APIs/partners; flag bot/spam traffic; apply only **verified views**.
* **Sybil controls:** per-account caps, unique post constraints (no dupes), device/IP heuristics, cooldowns.
* **Holdings snapshot:** use **end-of-hour TWAP** (e.g., 3–5 randomized checks) to minimize flash-hold exploits.
* **Moderation:** denylist sources/tags, manual overrides for obvious abuse.
* **Transparency:** publish hourly pot, distribution list, and associated **tx signatures**.

***

### MVP Architecture

**Services**

* **Collector** — monitors dev wallet / Pumpfun creator fees → records `fee_collections` per hour.
* **Holdings Oracle** — RPC job to snapshot streamer `$CLIPIT` balances → maps to multipliers.
* **Ingest** — accepts clip submissions; validates links and timestamps.
* **Scorer** — fetches view metrics; computes **WeightedViews**; allocates payouts.
* **Payout** — sends SOL to winners; persists `tx_sig`; retries on failure.
* **Leaderboard API** — exposes current hour’s live pot, countdown, top weighted clips, streamer tiers.

**Key Tables**

* `creators(program_id, token_ca, dev_wallet, hourly_cap_sol, reserve_percent, base_rules)`
* `streamers(program_id, handle, wallet, status, multiplier_mode, fixed_multiplier)`
* `holdings_snapshots(streamer_id, slot, balance_clipit, multiplier)`
* `clips(program_id, streamer_id, clipper_wallet, url, hour_bucket)`
* `metrics(clip_id, hour_bucket, verified_views, verified_engagement)`
* `fee_collections(program_id, hour_bucket, sol_collected)`
* `payouts(program_id, hour_bucket, clip_id, clipper_wallet, sol_amount, tx_sig)`

**Minimal API Sketch**

```http
POST /api/creator/init
POST /api/creator/verify
POST /api/streamers        # add/list/remove
POST /api/clip/submit
GET  /api/leaderboard      # current hour status
```

**Hourly Job (internal)**

1. close period → freeze submissions
2. refresh holdings → compute multipliers
3. fetch/verify metrics
4. compute weighted shares → allocate payouts
5. execute SOL transfers → publish results

***

### Governance & Safety Switches

* **Update tiers & multipliers** (with timelock).
* **Adjust hourly cap / reserve** dynamically.
* **Pause a streamer** (eligibility off) or **pause program** (emergency stop).
* **Quarantine hour** (re-score if metrics partner flags anomalies).

***

### Risk Notes

* **Payout variability:** low trading hours = smaller pots; consider a **rolling reserve** to smooth.
* **Platform policy:** ensure clips are **authorized** by streamers; keep a clear opt-in path.
* **Oracle trust:** metric sources must be resilient to inflation/botting; keep audit trails.

***

### Roadmap&#x20;

* **Twitter Badges for Clippers** — boost splits or grant allowlists.
* **On-chain Escrow Module** — verifiable reserves for transparency.
* **Partner Pools** — allow third-party sponsors to inject extra SOL into hourly pots.
* **Multi-platform Oracles** — redundancy across TikTok/YouTube/Instagram.

***

### FAQ

**Q: Do streamers get paid?**\
**A:** No. **Clippers** get SOL. **Streamers** buy/hold $CLIPIT to unlock/boost payouts *for their clippers* (so more people choose to clip them).

**Q: What if a streamer dumps before hour end?**\
**A:** Eligibility and multiplier are based on **end-of-hour (or TWAP) holdings**. Dropping below Tier-1 makes their clips ineligible for that hour.

**Q: Can one clip drain the entire pot?**\
**A:** No—use **per-clip and per-wallet caps** plus **reserve rules**.

**Q: Why SOL payouts instead of token?**\
**A:** **Simplicity + credibility.** No sell pressure on $CLIPIT from rewards; the token’s demand is driven by **streamer competition**.

***
