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

  1. 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.
  2. 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.
  3. 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.
  4. 04

    Build

    Choosing a concept switches into build mode: identity, artwork and token metadata are assembled into a reviewable package.
  5. 05

    Approve

    Every field stays editable up to the moment of signing. Nothing is committed until you approve the transaction in your own wallet.
  6. 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:

MetricWhat it measures
TrendTotal attention the narrative is receiving right now.
GrowthHow quickly mentions, searches and engagement are accelerating.
MemeabilityHow naturally the topic becomes a memorable visual, character or joke.
SaturationHow 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 × penalty

Why the shape matters

Two narratives with almost identical attention can score completely differently:

NarrativeTrendGrowthMemeSaturationScore
AI Employees9694912793
Old Meme Revival9741999827

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

AngleStance
Comedy / MemeThe joke-first read. Absurd, specific, immediately shareable.
Clean / StartupThe earnest read. Confident, minimal, sounds like a real product.
Character / LoreA 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

  1. 01

    Render artwork

    The PFP is drawn to a PNG in the browser.
  2. 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.
  3. 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.
  4. 04

    Build transaction

    PumpPortal's local endpoint returns an unsigned serialized transaction. No key material is involved server-side.
  5. 05

    Sign

    The browser signs with the newly generated mint keypair, then your wallet signs the spend.
  6. 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

Setting NEXT_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 machine

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

FieldValue
NameGROK
Ticker$GROK
ChainSolana
LaunchpadPump.fun
Contract addressPublished 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

PropertyValueNotes
Total supply1,000,000,000Fixed at creation. Standard Pump.fun supply.
Sold on curve~800,000,000Available to the open market on the bonding curve.
Migrated to the AMM~200,000,000Paired with accumulated SOL at graduation, by the protocol.
Team allocation0No reserved supply, no vesting, no unlock schedule.
PresaleNoneNo private round and no whitelist.
Mint authorityRevokedSupply 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:

FunctionDescriptionStatus
Access tiersHolders get higher generation limits and priority during load, since every generation carries a real model cost.Planned
Operating costsCreator fees earned on $GROK fund the model credits, RPC and infrastructure the engine runs on.Planned
Source governanceHolders signal which data sources, categories and launch destinations get built next.Planned
Agent accessProgrammatic 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.

PhaseScope
Phase 1 — LiveTrend board with Opportunity scoring, intelligence view, three-concept generation, deterministic artwork, paste-anything, and one-approval Pump.fun launch.
Phase 2 — Real signalReplace fixture data with a live trend source. Real velocity, real mention counts, real saturation measured from on-chain launches against each narrative.
Phase 3 — PersistenceAccounts, saved concepts, launch history, and the shareable detection-to-launch timeline.
Phase 4 — AgentsPersistent AI teammates that keep watching a narrative after launch: surfacing sub-trends, drafting campaign material, and flagging what needs attention.
Phase 5 — AccessToken-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.