> 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

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**.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://clipit.gitbook.io/clipit-docs/clipit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.