Documentation & whitepaper
How it works
A complete description of the trend-intelligence engine, the scoring model, the concept generator and the launch pipeline, followed by the whitepaper for $GROK, the native Pump.fun token.
01
Overview
TREND → COIN watches the internet for narratives that are beginning to accelerate, measures how early or saturated each one is, and turns the strongest opportunities into original token concepts that can be launched on Pump.fun in a single approval.
The launcher is not the product. Pump.fun is the execution layer, and it is deliberately the least interesting part of the system. The defensible piece is the intelligence and creative engine in front of it: deciding what is worth building and then producing something original enough to be worth launching.
In one sentence
TREND → COIN finds attention while it is forming, turns it into original launchable ideas, and gives you an AI team to take the best idea from narrative to Pump.fun.02
The problem
Attention moves faster than the tooling around it. By the time a narrative is legible enough that you are confident in it, the idea space is usually already flooded with tokens competing for the same joke.
The naive fix is a trending-topics list, but that actively misleads. The loudest topic is normally the worst one to build on, because volume and saturation rise together. What matters is the gap between how much attention a narrative is gaining and how much of the idea space is already taken.
Closing that gap requires two things a feed cannot give you: a score that punishes crowding, and a way to produce an original idea fast enough that being early still means something.
03
The core loop
- 01
Discover
The board ranks live narratives by acceleration and crowding rather than raw popularity. Each row shows velocity, lifecycle stage, a 32-point attention curve and an Opportunity Score. - 02
Understand
Opening a trend explains in plain English why it is moving, who is driving it, how early it is, how many competing tokens already exist, and whether the engine thinks it is worth building on at all. - 03
Generate
The concept engine returns three original concepts from three deliberately different creative angles, each with a name, ticker, artwork, description, lore, X bio, launch post and follow-ups. - 04
Build
Choosing a concept switches into build mode: identity, artwork and token metadata are assembled into a reviewable package. - 05
Approve
Every field stays editable up to the moment of signing. Nothing is committed until you approve the transaction in your own wallet. - 06
Launch
The token is created on Pump.fun and the mint address and signature are returned.
Where the human stays
The engine can research, generate, assemble and prepare. It never signs. Wallet approval is the only path to a financial action, and it cannot be automated away.04
Opportunity Score
The best opportunity is not the most popular trend. It is a narrative with rapidly growing attention that has not yet been flooded with competing tokens. Four inputs feed the score:
| Metric | What it measures |
|---|---|
| Trend | Total attention the narrative is receiving right now. |
| Growth | How quickly mentions, searches and engagement are accelerating. |
| Memeability | How naturally the topic becomes a memorable visual, character or joke. |
| Saturation | How many related tokens already launched, and how crowded the idea space is. |
Attention, growth and memeability form a weighted base. Saturation is applied as a multiplier, not another additive term, because a crowded narrative should not be rescued by being loud. The penalty is cubic, so a lightly covered topic stays near its base score while a cooked one collapses.
base = 0.35·trend + 0.35·growth + 0.30·memeability
penalty = 1 - 0.7·(saturation / 100)³
score = base × penaltyWhy the shape matters
Two narratives with almost identical attention can score completely differently:
| Narrative | Trend | Growth | Meme | Saturation | Score |
|---|---|---|---|---|---|
| AI Employees | 96 | 94 | 91 | 27 | 93 |
| Old Meme Revival | 97 | 41 | 99 | 98 | 27 |
The second narrative has the highest raw attention on the board and the lowest opportunity. Growth has stalled and 178 tokens are already fighting over the same joke. That inversion is the entire point of the model: it is a decision engine, not a popularity meter.
Implemented in src/lib/trends/score.ts.
05
The concept engine
When a trend is selected, the engine does not copy the person, company or meme that is trending. It extracts the underlying narrative and builds something new on top of it. For "AI Employees" the raw material is an autonomous agent that has a job, not any specific company that shipped one.
The originality constraint
This is enforced in the system prompt, not added as a disclaimer. The engine will not:
- Name a concept after a real person, company, product or existing token.
- Imply endorsement, affiliation, ownership or insider access.
- Recreate an existing mascot or a brand's existing character.
- Use a real person's likeness, catchphrase or handle as the identity.
Three angles, not three variations
| Angle | Stance |
|---|---|
| Comedy / Meme | The joke-first read. Absurd, specific, immediately shareable. |
| Clean / Startup | The earnest read. Confident, minimal, sounds like a real product. |
| Character / Lore | A persona with an ongoing story and its own voice. |
Each concept ships with a name, ticker, description, narrative lore, a concrete art brief, an X bio, a launch post and two follow-up posts, so the project has somewhere to go after the first hour.
Model providers
Generation runs on either Claude or DeepSeek behind a single interface. Claude enforces the output schema natively; DeepSeek has JSON mode but no strict schema mode, so the shape is taught in the prompt and validated at runtime. Every provider's output passes the same validator, so a malformed response surfaces as a clean error rather than a broken concept card.
Paste anything
The same engine accepts arbitrary input. Paste a tweet, an article, an account or a phrase, and it identifies the narrative underneath and returns three concepts built on it.
06
Generative identity
Every concept gets artwork generated deterministically from its seed: a symmetric cell matrix, an eye band, scanlines and a ticker plate, with the palette selected by hashing the seed.
The same seed always produces the same image. That is not a cosmetic detail. It means the artwork you preview is byte-for-byte what gets pinned to IPFS, with no regeneration step in between where the identity could silently change. It also removes an entire class of dependency: no image model, no extra API key, no per-image cost, and no generation latency in the launch path.
Implemented in src/lib/pfp.ts.
07
Launch pipeline
- 01
Render artwork
The PFP is drawn to a PNG in the browser. - 02
Preflight
The wallet is checked for buy amount plus priority fee plus roughly 0.03 SOL of rent and fees, so an underfunded launch fails before anything is spent. - 03
Pin to IPFS
Artwork is uploaded, then a metadata document pointing at it. Pinata is used when configured, with Pump.fun's own endpoint as a fallback. - 04
Build transaction
PumpPortal's local endpoint returns an unsigned serialized transaction. No key material is involved server-side. - 05
Sign
The browser signs with the newly generated mint keypair, then your wallet signs the spend. - 06
Broadcast and verify
The transaction is sent and the on-chain result is checked. A transaction that lands but reverts is reported as a failure, never as a successful launch.
Security model
No private key ever reaches the server. External calls are proxied server-side only to handle CORS and to keep the IPFS credential out of the browser. Signing happens entirely in your wallet, and the app cannot broadcast anything you have not approved.Simulation mode
SettingNEXT_PUBLIC_LAUNCH_MODE=simulate walks the entire flow, stage for stage, while broadcasting nothing and spending nothing. Pump.fun is mainnet only, so this is the only available dry run.08
Architecture
src/
app/
page.tsx live opportunity feed
trend/[id]/page.tsx intelligence view + concept studio
paste/page.tsx paste-anything flow
docs/page.tsx this document
api/trends feed data
api/concepts concept generation
api/launch/metadata IPFS proxy
api/launch/transaction PumpPortal proxy
lib/
trends/{types,score,source} data model, scoring, trend provider
prompt.ts system prompt, schema, validation
providers.ts Claude + DeepSeek behind one interface
pfp.ts generative artwork
launch.ts launch state machineTrend data sits behind a TrendSource interface with list() and get(id). Scoring, the intelligence view and the concept engine all consume the same Trend shape, so replacing the data source changes nothing above that file.
Current data source
The shipped build uses seeded fixture data. The scoring model is real; the inputs are not. Velocity figures on the board are illustrative until a live source is connected.Whitepaper · 01
$GROK
$GROK is the native token of TREND → COIN, launched on Pump.fun through the same pipeline the product exposes to everyone else. It is the first token created by the engine, and it is launched under exactly the same rules: no presale, no team allocation, no private round, no reserved supply.
| Field | Value |
|---|---|
| Name | GROK |
| Ticker | $GROK |
| Chain | Solana |
| Launchpad | Pump.fun |
| Contract address | Published at launch — verify on x.com/itsGrokBot before trading |
| Official account | @itsGrokBot |
Verify the contract address
Impersonation is the normal failure mode for a token launch. The only authoritative source for the $GROK contract address is the pinned post on @itsGrokBot. Any address from any other source should be treated as fake.Whitepaper · 02
Launch mechanics
$GROK uses Pump.fun's standard bonding curve. These mechanics are set and enforced by the Pump.fun protocol, not by this project, and apply identically to every token launched there.
- 01
Bonding curve
The full supply is seeded into a bonding curve at deploy. Buying removes tokens from the curve and adds SOL; selling reverses it. Price is a function of remaining supply, with no order book and no market maker. - 02
Fair launch
There is no presale and no allocation reserved for the team. Any initial position is bought on the open curve on the same terms available to everyone else, in the same transaction that creates the token. - 03
Graduation
When the curve fills, liquidity migrates automatically to PumpSwap, Pump.fun's own AMM, and the token trades as a standard Solana asset from that point. - 04
Liquidity
Migration is handled by the protocol. Liquidity is not controlled, withheld or manually provisioned by this project.
Graduation is not guaranteed
Industry reporting puts the share of Pump.fun launches that reach graduation in the low single digits, commonly cited around 1 to 2 percent. The base rate for any token on this launchpad, including this one, is failure.Whitepaper · 03
Supply & distribution
$GROK uses the Pump.fun default supply structure. There is no separate emission schedule, no vesting contract and no mint authority retained after creation.
| Property | Value | Notes |
|---|---|---|
| Total supply | 1,000,000,000 | Fixed at creation. Standard Pump.fun supply. |
| Sold on curve | ~800,000,000 | Available to the open market on the bonding curve. |
| Migrated to the AMM | ~200,000,000 | Paired with accumulated SOL at graduation, by the protocol. |
| Team allocation | 0 | No reserved supply, no vesting, no unlock schedule. |
| Presale | None | No private round and no whitelist. |
| Mint authority | Revoked | Supply cannot be inflated after creation. |
Exact split between curve and migration is determined by the Pump.fun protocol and may be adjusted by the platform independently of this project.
Whitepaper · 04
What the token does
$GROK is a memecoin. Its primary function is coordination and attention around the project, and that should be stated plainly rather than dressed up.
Beyond that, the token is the access and alignment layer for the product. The intended design, in order of how concretely it can be delivered:
| Function | Description | Status |
|---|---|---|
| Access tiers | Holders get higher generation limits and priority during load, since every generation carries a real model cost. | Planned |
| Operating costs | Creator fees earned on $GROK fund the model credits, RPC and infrastructure the engine runs on. | Planned |
| Source governance | Holders signal which data sources, categories and launch destinations get built next. | Planned |
| Agent access | Programmatic access to the trend feed and concept engine for power users and autonomous workflows. | Exploratory |
What $GROK is not
$GROK is not an investment contract, a security, a share of any company, or a claim on revenue, profit or assets. Holding it entitles you to no dividend and no legal right against the project. Items marked planned are statements of intent, not commitments, and may change or not ship at all.Whitepaper · 05
Roadmap
Phases are ordered by dependency, not by date. Publishing dates for work that has not started would be a guess, so none are given.
| Phase | Scope |
|---|---|
| Phase 1 — Live | Trend board with Opportunity scoring, intelligence view, three-concept generation, deterministic artwork, paste-anything, and one-approval Pump.fun launch. |
| Phase 2 — Real signal | Replace fixture data with a live trend source. Real velocity, real mention counts, real saturation measured from on-chain launches against each narrative. |
| Phase 3 — Persistence | Accounts, saved concepts, launch history, and the shareable detection-to-launch timeline. |
| Phase 4 — Agents | Persistent AI teammates that keep watching a narrative after launch: surfacing sub-trends, drafting campaign material, and flagging what needs attention. |
| Phase 5 — Access | Token-gated limits, programmatic API access, and additional launch destinations beyond Pump.fun. |
Whitepaper · 06
Risks & disclaimers
Read this before buying anything
You can lose everything you put into $GROK or into any token launched with this tool. Do not commit money you cannot afford to lose entirely.Token risk
- Memecoins are extremely volatile and frequently go to zero. The majority of Pump.fun launches never graduate and end with holders at a total loss.
- Bonding curve pricing means early buyers hold a lower cost basis. Later buyers are exposed to selling pressure from earlier ones.
- There is no floor, no buyback, no treasury guarantee and no redemption mechanism.
Product risk
- Trend data in the current build is seeded fixture data. Scores computed from it are illustrative and must not be read as market signal until a live source is connected.
- Concepts are machine-generated. Originality is enforced by prompt design and validated automatically, but you are responsible for reviewing any concept before launching it, including for trademark and likeness issues in your jurisdiction.
- Launching a token is irreversible. Fees are spent whether or not the token succeeds.
Dependency risk
- The launch path depends on Pump.fun, PumpPortal, IPFS pinning and a Solana RPC. Any of these can change, rate limit or fail.
- Pump.fun's supply split, graduation threshold and fee structure are set by that platform and can change without notice.
Not financial advice
Nothing in this document or anywhere in this application is financial, investment, legal or tax advice. No statement here is a promise of future value, listing, partnership or return. Opportunity Scores are a heuristic ranking, not a prediction. You are solely responsible for your own decisions and for complying with the laws that apply to you.
09
FAQ
Does the engine copy whatever is trending?
No, and it is specifically built not to. It extracts the underlying narrative and generates original characters and ideas from it. Impersonating a real person, company or existing mascot is blocked at the prompt level.
Can it launch a token on its own?
No. It prepares everything up to the transaction. Signing requires your wallet, and there is no code path that broadcasts without your approval.
Why is the loudest trend usually ranked low?
Because saturation is a multiplier. High attention with a crowded idea space scores worse than moderate attention with an empty one. The board is ranked by velocity, but the Opportunity column is the number that matters.
What does a launch cost?
Your chosen initial buy, plus a priority fee, plus roughly 0.03 SOL of account rent and network fees. The app checks your balance before spending anything and fails early if it is short.
Do I need to hold $GROK to use it?
No. The product is usable without holding anything. Token-gated limits described above are planned, not active.
Where do I verify the contract address?
Only from the pinned post on @itsGrokBot. Treat any other source as fake.
