🐔 Cluck Norris
"We took the hard knocks so you don't have to."
Cluck Norris (clucknorris.app) is a live Solana platform. What we're working toward: educate, build, earn.
- Educate — a free crypto school, the School of Crypto Hard Knocks: courses, a hands-on LP Lab, a reference library, live token data and an AI tutor, in multiple languages, no signup.
- Build — forensics, holder analysis, non-custodial locking and campaign tools that projects use to strengthen their communities.
- Earn — reward programs whose terms and payouts any holder can verify without trusting us.
Open source, live on mainnet. The heavy tools stay free while you hold ~$10 of CLKN (or a small SOL pass) — the token is the key that unlocks them, not a play for its own sake.
Everything that teaches is free. No signup, no wallet connect to learn, no subscription. The heavy tools (X-Ray, Holders, Trace) cost real money to run — hold about $10 worth of CLKN (in the Seeker app, about $20 of SKR opens the same door) and they are all free; otherwise 0.05 SOL unlocks the lot for 7 days. The safety basics — Wallet Checkup, Firepit, the Locker Room — and the airdropper stay free for everyone.
Live at clucknorris.app.
🆓 The school
Three tracks, all free, in multiple languages — today English · Español · हिन्दी · Italiano · Português · Tiếng Việt · 中文, with more being added — and read-aloud audio on every lesson.
| Track | Size | For |
|---|
| 🥚 The Incubator | 7 lessons | Total beginners — wallets, tokens, on/off-ramps, DEXs, liquidity, market cap, not getting drained |
| 🏫 School of Hard Knocks | 21 lessons | The core course, belt-ranked Freshman → Emeritus |
| ⚗️ LP Lab | 15 lessons | Liquidity providing in depth — impermanent loss, ranges, fees, bins, DLMM shapes, laddering, checking the token before you LP it — with interactive calculators throughout |
Plus 📚 the Library (glossary + deep dives across Survival / Research / Concepts) and 🤖 Ask Cluck, a Claude-powered tutor embedded in every lesson, live in the Telegram group, and standalone at /ask-cluck.
Finish the full curriculum, drop a Solana address, and you get a permanent, shareable /transcript page (/transcript/<your-slug> once issued) plus an on-chain graduation NFT. Learning itself stays walletless — the address is only for the transcript and the NFT. (A CLKN graduate airdrop existed briefly; it was taken down after wallet-farming abuse.)
A "where do I start?" concierge meets newcomers on the landing page and in the Telegram group, so a feature-rich app doesn't overwhelm a first-timer.
🛡 Guardrails first
Most token utilities assume you already know what you're doing. This one makes you understand first.
- Every paid tool requires an explicit "I understand" before payment instructions appear
- The airdropper ships with an inline lesson on how airdropping actually works
- Every action page carries a stay-safe checklist — verify the URL, never share a seed phrase, read every wallet popup, no custody
- The send screen shows a wallet-popup pre-flight so you can sanity-check the numbers before your wallet asks you to approve them
First-timers are the target user. The guardrails are the point, not decoration.
🔨 The tools
No wallet connect, no account.
- 🩻 Wallet X-Ray — paste any Solana address and get its whole story: the funding origin as far as observed transfers show — traced back to its first transaction (dust filtered, exchange hot-wallets identified); it shows transfers, not ultimate ownership or intent, every buy/sell/transfer across every token, and a behavior read — bot cadence, fast-flip dumping, CEX cash-out, LP, or diamond hands. Searchable timeline, charts, a deep-scan mode for heavy wallets, and a built-in AI you can ask about any single transaction.
- 👥 Holders — who really holds a token. Separates wallet addresses from LP pools, lock escrows and program accounts (address classification, not personhood — one person can hold many wallets); measures supply concentration on classified wallets only (a raw top-10 counts pool vaults as whales — they aren't); and exports any slice as an airdrop-ready CSV. Filter to any group and hand it straight to the airdropper.
- 🔍 Trace — wallet × token history: every transaction between one wallet and one mint in order, with running balance, counterparty flow map, and one-hop follow-the-money.
- 🛡 Wallet Checkup — read-only scan for the things that actually drain people: lingering delegate approvals, honeypot / can't-sell holdings, and tokens whose dev can still mint or freeze. Find an approval on your own wallet and you can revoke it right there, signing yourself. (The old Security Coop merged into this page;
/security-coop still resolves here.)
- 🎒 Bags Hub — live launches, near-graduation and recently-graduated feeds, backed by our own 48h graduation tracker.
The rule across all of them: a claim has to be backed by something you can open yourself — a transaction, an account, a launchpad API. Every signal is on-chain evidence, not a verdict, and we label a wallet "creator" or "team" only when a launchpad confirms it, never on inference.
💎 Paid tools
Hold CLKN and they're free. Don't, and there's a small one-click SOL price. No
subscriptions, no accounts.
| Tool | Cost |
|---|
| 💰 Batch airdrop sender | Free for everyone — no pass, no hold (since 2026-09-22); you pay only Solana's own fees and rent |
| 🔬 Premium Forensics | Holder-gated on a live 2,000,000 CLKN balance |
| 🔎 Listing Checkup — a project's listings vs. its own on-chain record, with a fix link for each mismatch | Free preview (on-chain metadata, CoinGecko, GeckoTerminal, DexScreener, Jupiter) · full sweep (+ Solscan, Rugcheck, pump.fun, CoinMarketCap, Birdeye, byte-level logo compare, shareable report) on the unified tools pass |
| 🥚 The Hatchery — guided token creator | 0.1 SOL, or the CLKN equivalent at a ~30% discount · free above the live holder threshold at /api/hatchery/config |
The heavy tools — Wallet X-Ray, Holders, Trace — share one pass: hold about $10 worth of
CLKN (computed from the live price, never a fixed token count — /api/tool-gate/config is the
source of truth; the Seeker app also opens it on about $20 of SKR) and all of them are free;
otherwise 0.05 SOL buys a 7-day pass to all of them. Every page previews free; the gate fires on
RUN. The airdropper is outside the pass since 2026-09-22 — free for everyone, on every platform.
The Hatchery is the one place you can still pay in CLKN, and it's deliberately ~30%
cheaper than the SOL price. The token amount is computed live from the CLKN price so it
holds that discount as the market moves — check /api/hatchery/config for today's figure
rather than quoting a number. It isn't a manual send: the CLKN transfer is an instruction
inside the same mint transaction your wallet already signs, so there's nothing to copy
and nothing to wait for.
Extra AI tutoring used to be a paid unlock too. It isn't any more — Ask Cluck has a
free daily allowance and that's the whole offer.
Premium Forensics adds recipient-dump tracing, money-flow and cash-out mapping, a creator "rap sheet", wallet P&L, and a neutral shared-funding cluster map. Nothing is fabricated when a source is unavailable — every report states what it could and couldn't compute.
🥚 Connect-wallet tools
Two places you do connect — not to hand anything over, but to sign your own transactions. Keys never touch the server.
- The Hatchery — a guided SPL token creator that explains every mint-time decision (supply, decimals, metadata, mint/freeze authority), stores metadata permanently on Arweave, and deliberately stops before liquidity. Minting a token is not launching a project, and a token with no pool can't rug anyone. 0.1 SOL, or CLKN at a discount; free above the live holder threshold published at
/api/hatchery/config.
- The Jup Locker Room — free, non-custodial token locking for any Solana project, built directly on the open-source Jupiter Lock program, Token-2022 mints included. Because it calls the program directly, the whole flow is ours: every field is explained in plain English before you sign, so a first-time team can prove they can't dump without needing to already understand vesting. No fee — users pay only network gas, and tokens go into the audited Jupiter escrow, never through us. Every lock carries a
locked via clucknorris.app memo, and each project gets a shareable Lock of Fame page to broadcast the receipt.
🔐 How access works
Connect a wallet and the gate resolves itself: hold about $10 of CLKN (checked against
the live price — no fixed window) and the heavy tools are free. If you don't, one click
sends 0.05 SOL and unlocks all of them for 7 days. Where the gate is ownership rather than payment — Premium Forensics, and
proving a transcript is yours — you sign a one-line message instead. That's a
signature, not a transaction: no tokens move, no spending approval is granted, and
nothing lingers afterward.
What we tried before, and why it's gone
Until July 2026 every paid door worked without a wallet connect at all. The app minted
a unique amount like 100.347 CLKN, you sent exactly that from any wallet, and the
server matched the decimal to your session and read your address out of the
transaction. It was replay-guarded, anti-tampered, and it worked exactly as designed.
Almost nobody used it. The idea was that skipping the connect prompt removed friction —
but copying an exact amount into a wallet by hand, sending it, and waiting for the chain
turned out to be more friction than the popup it avoided, not less. So we retired it.
We're saying that plainly rather than quietly deleting it, because the reasoning is the
point: we don't yet know whether the manual send was the limiting step or whether the
tools simply need more exposure. Simplifying is how we find out. The implementation
lives in git history, not in the running app — the endpoint was deleted once nothing
depended on it — so if the simpler version doesn't move the needle, bringing it back is
a revert, not a rebuild. Being early to an idea and
being wrong about it look identical from the inside; we'd rather test it than defend
it.
- SOL payments are verified against an on-chain minimum the server clamps up to, so a tampered client can't bless a dust payment as a full one
- Ownership signatures must name the signing wallet and carry a fresh nonce, so a captured signature can't be replayed later
- A proof of ownership is never a proof of holdings: Premium Forensics re-reads the live CLKN balance on every single run, so a proof issued to an empty wallet buys nothing
Holding is what earns the free tier, and it's read live from the chain at the moment
you connect — not from a receipt, and not from anything you can hand us.
💧 The Liquidity Engine — paused since 2026-09-05
An operator-run concentrated-liquidity service we have run for four partner tokens (POKE, CUNA, DNC, ROSE); paused by the owner since 2026-09-05 while the public dashboard is built; not self-serve.
Most "volume bots" wash-trade: the operator buys and sells their own token through wallets they control to fake activity. This is the opposite — a concentrated-liquidity market maker that puts real two-sided depth into a token's pools, so real buyers and sellers get tighter spreads and less price impact, and fees come from genuine trades.
Two layers: non-custodial position builders (the server builds unsigned open/close/collect transactions, the operator signs them) and an autonomous vault funded from a dedicated hot wallet whose key lives only in the server environment — unset means the whole thing is off, a safe no-op, and the code default is off besides. Guardrails throughout: anti-thrash intervals, daily action caps, slippage and price-impact ceilings, an anomaly guard, and a one-flag kill switch.
The idea under test is multi-quote: pairing a token against several quote assets (USDC + SOL + JUP) means each quote's own volatility dislocates the token's price across pools, and third-party arbitrageurs trade it back into line — producing genuine two-way volume the project never generated itself.
Status, honestly: every engine is paused today, so the multi-quote pools' on-chain volume reads zero — that's the paused state, not a failed idea. The recorded history from when it was running will show on the dashboard at /liquidity-engine once it ships. Impermanent loss is real and the big-sell scenario is real; we'd rather under-promise and let the on-chain record speak. Runs on Orca Whirlpools, with Raydium CLMM and Meteora DLMM adapters built to the same interface.
📣 Community & automation
The product reaches into Telegram and X, not just the website.
- Cluck's Lesson — short crypto-safety micro-lessons written by Claude, posted daily on a fixed UTC schedule, rotating through the real curriculum without repeating until the set is exhausted
- Ask Cluck, in-chat — reply to any lesson and the bot answers in thread. Strictly educational: it declines price and buy/sell questions and ends every reply with a not-financial-advice line
- Buy / sell alerts — a 30-second poller posts every real CLKN trade with USD value, price, market cap and route, plus a ~12-minute reconciliation sweep that recovers anything a transient hiccup dropped, durably de-duped so it can never double-post
- Lock celebrations — a new lock is detected on-chain, composed, illustrated and posted to X and Telegram, with a progress tracker toward the next supply-locked milestone
- Slash commands —
/guide, /walletxray, /trace, /holders, /securitycoop, /buyspecial, /hatchery, /bags, /liquidity, /tools, via a secret-validated webhook
- 📱 Solana Seeker dApp Store — the Seeker app (next section): the school bundled on the device and a toolkit that signs through Mobile Wallet Adapter. The listing's first version (May 2026) was a shell that loaded the live site; the Seeker edition replaces it.
📱 The Seeker app — and how to test it
Built for the Solana Mobile CLOCK IN hackathon (2026-09-14 → 2026-10-09). It is this repo's
seeker.html + src/seeker/*, bundled as a pinned release (store-seeker-v*) and packaged by
clucknorrisapp/CLKN-SEEKER (Capacitor, the
CluckMWA plugin, signing) — the packaging work lives on that repo's claude/seeker-integration
branch. Package app.clucknorris.school; the APK is attached to a GitHub release there and
linked from the hackathon submission.
Bottom bar: School · Toolkit · Daily · Swap · Ask — places you go every day. The school is
first.
- No wallet needed: the school (64 lessons, four courses, ten languages, works in airplane
mode), the Library, the Solana Room, Ask Cluck, the Daily, Listing Checkup, Wallet Checkup on a
pasted address.
- Connect a wallet (Mobile Wallet Adapter, signed on the phone, non-custodial): Swap (SOL,
SKR, CLKN, USDC — rate, minimum received and price impact shown before you sign, and the
transaction is checked and simulated before the wallet is asked), Rent Reclaim, Firepit,
Project Burn, the Locker Room, the Airdropper, Revoke inside Wallet Checkup.
- The tools pass (X-Ray, Holders, Trace): free on a CLKN or SKR holding, or pay once in SOL
or in SKR for seven days; every figure is served live, none is in the app.
- What to look for: every action that costs money names its consequence before the wallet
opens; a transaction that did not land is reported as not landed, never as done; a lost
wallet reply never unlocks the form for a second attempt.
Tests a judge can run from this repo without a device: node scripts/seeker-app-boot-test.cjs
(renders every screen headless), and the unit suites scripts/seeker-*-test.cjs (swap verify
and simulate, pending-attempt guards, revoke, the SKR pass, i18n coverage). CI runs them on every
push.
⚙️ Tech
| Layer | Choice |
|---|
| Frontend | React + Vite (the school) · vanilla HTML + inline JS (tool pages) |
| Backend | Node.js + Express on Railway, auto-deployed from main |
| AI | Anthropic Claude — tutor, lessons, forensic narration |
| Solana RPC | Helius (DAS + enhanced transactions), with automatic failover to backup endpoints and a public node |
| Token data | Bags.fm · DexScreener · GeckoTerminal · Bubblemaps · Jupiter · Solana Tracker · Solscan |
| Liquidity venues | Orca Whirlpools · Raydium CLMM · Meteora DLMM — one engine, per-venue adapters |
| Persistence | Railway volume at /data — consumed payment signatures, transcripts, schedulers, analytics; survives redeploys |
| Wallet signing | Phantom · Solflare · Backpack · OKX · Jupiter + 6 more, all non-custodial |
| Security | per-IP rate limiting · default-deny RPC method allow-list · replay-proof payments · XSS output escaping · HSTS / X-Frame-Options / Referrer-Policy |
Admin, operator and holder-gated routes return 404 rather than 401, so probing them tells you nothing.
Two of the hardening items above shipped as fixes to findings from our security-scan partner
RootCrak (X: @ro0TCr4k): a
Cloudflare WAF/CDN cutover and a CF_ORIGIN_SECRET origin lockdown that 403s any request that
didn't traverse the WAF. Both are live since 2026-08-04.
Public API: /api/wallet-xray · /api/snapshot (the holder engine) · /api/trace · /api/wallet-checkup · /api/token-overview · /api/ask-cluck · /api/verify-sol-payment · /api/premium-verify-sig · /api/hatchery/* · /api/security-coop/* · /api/holders, /api/locks, /api/fees, /api/supply · /api/bags-* · /api/helius-rpc, /api/helius-tx (keys hidden server-side) · /api/credential/:slug, /api/school-stats — /api/wallet-xray, /api/snapshot and /api/trace require the unified tools pass server-side; the page's free preview stays free, RUN needs the pass.
CI
develop auto-deploys to a Railway staging service and main to production — promoted only on the owner's explicit go — but nothing sits between main and live, so the gate is a set of cheap tripwires, each of which exists because something got past the previous ones:
node --check on every backend entrypoint and lib- undefined-JSX-component guard — an undefined component compiles fine and only throws at runtime; one shipped and left the LP Lab blank in production for a day
- curriculum count guard — the landing page advertised "72 exams · 6 beginner lessons" when the truth was 70 and 7
- render smoke test — opens every screen and all 43 lessons in headless Chromium, failing on an uncaught error or a blank page
- level-geometry guard for the game — jumpability, no floating fixtures
- liquidity-engine decision simulator — replays thousands of ticks against the real gate logic; every scenario is a past live incident
- visual-regression gate for the game — boots the server and pixel-diffs the title, HUD, characters and a creature against committed baselines, the render-broke-but-built-clean class nothing above can see
🪙 The token
Cluck Norris (CLKN) — Solana SPL, partnered to the FireChicken community.
- Mint:
DW6DF2mjtyx67vcNmMhFm9XdxAwREurorghZcS3CBAGS
- Trade: bags.fm · Jupiter
- Project fee: ~1% of every CLKN trade — real SOL revenue, 100% reinvested into buying CLKN on the chart
- Liquidity: Meteora DAMM V2 (
64WXkHM4zyWUkYy32TfUeBV5wDAfdcUGDxe5ntM4xaTd, the canonical chart), plus project-run Orca pools across a multi-quote layout (CLKN/USDC · CLKN/SOL · CLKN/JUP), paused since 2026-09-05
- Mint and freeze authority are renounced. A meaningful share of supply is locked across Jupiter Lock and other locks — verifiable by anyone, and every new lock is announced with the on-chain numbers
🤝 Ecosystem
- 🎮 Normie Quest — a complete crypto-education platformer (original pixel art, 12 worlds, boss fights themed on real market lessons, leaderboards, playtest telemetry) built under Cluck Norris production for the NORMIE community — a separate project with its own token. It's the proof the stack white-labels beyond our own. Public since 2026-08-22 at /normie-quest-x7: worlds 1-3 are free, the rest unlock at live-priced NORMIE holder tiers rendered from
/api/nq/wallet/config (never a fixed dollar figure quoted here). Reward/prize terms with the NORMIE team remain unagreed, so nothing about those is promised.
- 🔒 The Locker Room as shared infrastructure — any project locks free, gets a public Lock of Fame page, and can broadcast the receipt. The on-chain memo makes the relationship verifiable rather than claimed.
- Building through the bear. The tools, the school, the game and the lock infrastructure are being hardened now, so they're standing when the cycle turns.
🔥 The pitch, in one breath
A free crypto school disciplined enough to be useful, wrapped around forensic tools that tell you what's on-chain and refuse to tell you why — with every heavy tool free to anyone holding ~$10 of the token (or a small SOL pass).
Learn fast. Avoid rugs. Survive the schoolyard.
📄 License
MIT. Fork it, fork the model, build your own school. Just don't expect the bird to be impressed.
Cluck Norris doesn't teach softly. 🐔
