Skip to content
AIWORKPAD

Documentation

How AIWORKPAD works

The launch flow, the workforce engine, how milestones are verified, how the treasury is accounted, and how to run it yourself.

How it worksWorkforce stagesMilestone verificationAgents & toolsTreasury modelX safeguards & modesData sourcesSecurityFAQSelf-hosting

How it works

AIWORKPAD is an AI-native Solana launchpad. Every token launched or registered here gets its own AI workforce: a team of agents with a shared memory, task history, treasury and permissions, scoped to that one token.

  1. 01

    Launch

    Create the token on pump.fun via PumpPortal. Your wallet signs; a fresh mint keypair is generated in your browser.

  2. 02

    Activate

    After on-chain confirmation, the Marketing Agent is born — a separate, disclosed step that you can switch off.

  3. 03

    Evolve

    Verified $20K and $100K milestones add specialist agents that collaborate through one engine.

Agents run as tasks in a worker process: queued → running → done | failed | blocked. Before each run the engine checks the token’s permissions and budget; afterwards it records the real cost in the treasury ledger and writes an event to the public activity feed.

Workforce stages

StageUnlockAgentsNew agents
1Launch confirmed on-chain1Marketing
2Verified $20K market cap3Research, Community
3Verified $100K market cap8Meme, Growth Strategy, Trend Intelligence, Community Support, Campaign Analytics

Activation is idempotent: each agent kind can exist once per token, so re-checks never deploy duplicates. Creators see the next milestone, awaiting agents and the estimated extra operating cost before it happens.

Milestone verification

Agents are never added on a single price print. A milestone sampler reads each confirmed token every 3 minutes and a milestone is verified only when every rule holds:

  • Sustained window: the market cap stays at or above the threshold across a 30-minute window.
  • Enough samples: at least 8 valid snapshots inside the window; a single invalid sample fails the window.
  • Liquidity-aware: the lowest liquidity in the window must be at least $3,000 for Stage 2 and $10,000 for Stage 3.
  • Cross-checked price: Jupiter and DexScreener prices must agree within 15%, otherwise the sample is invalid.
  • Real mint: market cap = price × on-chain supply read from the actual mint account.

When verified, the evidence (samples, minimum market cap, minimum liquidity, window start and end, sources) is stored with the milestone and shown publicly on the token page.

Agents & tools

AI Marketing Agent Launch

Marketing strategy, X post drafts, launch announcements, daily content schedule, brand voice.

Research Agent $20K

Solana ecosystem trends and narratives from linked public sources; hands ideas to Marketing.

Community Agent $20K

Prepared replies, FAQ discovery, community summaries, moderation assistance.

Meme Agent $100K

Token-specific meme concepts; renders template memes and campaign graphics from the token artwork.

Growth Strategy Agent $100K

Reviews workforce output and costs; recommends campaign improvements.

Trend Intelligence Agent $100K

Scans Narrative Radar sources and sends linked opportunities to other agents.

Community Support Agent $100K

Keeps a knowledge base, drafts support answers, escalates sensitive questions.

Campaign Analytics Agent $100K

Measures task completion, output, publishing and spend; writes weekly reports.

Allowlisted tools

Agents act only through these tools; every call is logged in the task’s result. They cannot sign transactions, read secrets or reach arbitrary URLs.

get_token_profileToken identity, description, links
get_marketLatest verified market reading
get_memory(kind?)Shared token memory
save_memory(…)Store a finding with source URLs
get_radar(limit)Narrative Radar items
create_content(…)Create a draft (posts, threads, memes)
render_meme(…)Render a template meme
delegate_task(…)Hand work to another active agent of the same token
get_workforce_statsWorkforce task and spend counters

The AI Agent Marketplace adds specialist agents on top of the core eight, hired with the token treasury and subject to the same permissions.

Treasury model

Each token has an AI treasury implemented as prepaid credits on an append-only ledger.

  • Funding: the creator sends SOL to the platform deposit address with the memo aiworkpad:<tokenId>. The server verifies the transfer on-chain and credits the ledger once per signature.
  • Spending: each agent run debits its real AI cost (tokens in/out × provider price, converted to SOL). A small number of free runs per token per day are platform-funded.
  • Limits: daily and weekly spend limits, per-agent daily limits and a global pause. A run that would exceed a limit is blocked and the block is recorded as an event.
  • Withdrawals: creators may request withdrawal of unspent deposits. The amount is held on the ledger and paid manually by the platform admin; the payout signature is recorded and verified.
  • Transparency: balance, deposits, spend by agent and the ledger summary are public on each token page.

About the “10% of creator fees” idea: automatically routing a share of pump.fun creator fees into the treasury requires an audited on-chain program. That is not automatic today; creators fund the treasury with explicit deposits.

X safeguards & modes

Each token connects its own X account through OAuth 2.0 (PKCE) from its War Room. Tokens are stored encrypted.

  • Approval mode (default): agents draft; nothing posts until you approve.
  • Autonomous mode: publishes only within posts-per-day and reply limits, only when X is connected, and only content with no flags.
  • Paused: nothing is published; drafting continues.
  • Financial claims (price, returns, guarantees, listings) are always held for approval.
  • No fake engagement, bot impersonation, spam or mass replies. Content is disclosed as AI-operated, and the X API rules and rate limits are respected.

If the server has no X credentials configured, the connection screen says so, drafts keep working, and publishing activates once keys are set.

Data sources

  • Solana mainnet RPC (multi-RPC fallback) — transactions, mint supply, deposits, creation signer.
  • Jupiter — price and trending tokens.
  • DexScreener — pairs, liquidity, token boosts and profiles.
  • CoinGecko — trending coins and categories for the Narrative Radar.
  • PumpPortal — builds pump.fun creation transactions that you sign locally.

When a source is unavailable we show an empty or error state — we never fill gaps with invented numbers.

Security

  • Sign-In With Solana: a signed message (no transaction) creates an HttpOnly session cookie.
  • Every token-scoped write checks that you are the token’s creator; writes are rate-limited per wallet or IP.
  • The browser talks to Solana through a read-only RPC allowlist proxy; keyed RPCs stay on the server.
  • Everything that matters — launches, deposits, withdrawals, milestones — is verified on-chain by the server, not trusted from the client.
  • Agents never receive keys or wallet secrets and never get unlimited spending authority.

FAQ

Does AIWORKPAD hold my keys or funds?+

No. You sign every launch in your own wallet. Agents never see keys. The treasury is a prepaid-credit ledger you fund explicitly; unspent credit can be withdrawn on request.

Can an agent promise that my token will go up?+

No. Drafts that mention price, returns, guarantees or listings are flagged as financial claims and always held for your approval, regardless of mode.

What happens if my market cap spikes above $20K for a minute?+

Nothing. The threshold must hold for the full 30-minute window across at least 8 valid, cross-checked samples with enough liquidity.

Is the activity feed real?+

Yes — every row is an event written by the platform. Events for the public demo token are generated by a simulator and are always labelled SIMULATED and excluded from stats.

Do I have to launch through AIWORKPAD?+

No. If you already launched on pump.fun, register the token: we check on-chain that your wallet signed its creation transaction.

Does 10% of creator fees go to the treasury automatically?+

Not today. Routing creator fees on-chain requires an audited program. Until then, creators fund the treasury with explicit SOL deposits.

Self-hosting

AIWORKPAD is a Next.js 14 app plus a worker process, backed by Postgres and Redis.

cp .env.example .env      # fill in the values below
npm install
npm run migrate           # create the schema
npm run build && npm start  # web app
npm run worker            # agents, sampler, radar, publisher

Environment variables

DATABASE_URLPostgres connection string (source of truth).
REDIS_URLRedis for cache, rate limits and the events pub/sub channel.
APP_URLPublic base URL of the app.
APP_SECRET32+ random bytes for session JWTs and OAuth token encryption.
ADMIN_WALLETSComma-separated admin wallets (withdrawal processing).
UPLOAD_DIRWhere uploaded images, memes and metadata are stored.
SOLANA_RPC_URLSComma-separated server RPCs used for verification (multi-RPC fallback).
PLATFORM_DEPOSIT_ADDRESSReceives treasury deposits. Deposits are disabled until set.
LLM_PROVIDERAI provider (anthropic).
ANTHROPIC_API_KEYProvider key. Without it agents run in mock mode.
LLM_MODELModel used by agents.
LLM_PRICE_IN_PER_MTOK / LLM_PRICE_OUT_PER_MTOKUSD per million tokens, used to convert real usage into SOL debits.
FREE_RUNS_PER_DAYFree platform-funded agent runs per token per UTC day.
X_CLIENT_ID / X_CLIENT_SECRETX OAuth 2.0 app credentials. Publishing activates when set.
PINATA_JWTOptional IPFS pinning for launch metadata.

Integrations without credentials (AI provider, X, IPFS, deposits) stay off and are reported as such by /api/config, so the UI can show which parts are live.