mew docs

The centerpiece of the site is an anime-style arcade cabinet. mew's vital signs are displayed directly on the arcade screen as an overlay.

The screen shows:

• Human Days counter — how many real-world days mew has been alive, with a live ticking clock
• Mew Days counter — mew's perceived age at 10× speed, with its own live clock
• Cost panel — today's survival cost and tomorrow's cost in SOL
• 4 stat bars — health, happy, active, social (see Stats System)
• Birth and death dates — the unchangeable endpoints of mew's existence

A CRT scanline effect overlays the screen for that authentic retro-arcade feel. Below the cabinet sit the 4 action buttons — like standing at the machine, hands on the controls.

A wallet connect button sits in the top-right navigation bar. It supports Phantom and Solflare wallets.

• Click "connect" → prompts your wallet extension to authorize the site
• Once connected, the button shows your truncated wallet address (e.g. 7xK2…9mfP) with a green glow
• Click again → disconnects your wallet (button turns red on hover as a warning)
• Auto-reconnect — if you previously connected, your wallet re-authorizes automatically on page load (via onlyIfTrusted)
• If no wallet extension is detected, clicking the button opens phantom.app so you can install one

Connecting your wallet is required to interact with mew's action buttons. Without it, tapping an action button will prompt the connect flow automatically.

Four on-chain action buttons sit below the arcade cabinet. Each sends 0.0001 SOL to mew's wallet with a memo instruction recording the action type on the Solana blockchain.

How it works:

• Click an action button (wallet connects automatically if needed)
• Your wallet prompts you to sign a transaction for 0.0001 SOL
• The transaction includes a Memo Program instruction with the action name (e.g. "feed")
• The transaction is sent to Solana mainnet and recorded permanently on-chain
• The corresponding stat bar fills up immediately (optimistic UI)
• The button greys out and shows "✓ done" — you're done for today

Once per day, per wallet: Each wallet can perform each action only once per calendar day (UTC). This prevents stat manipulation and ensures fair participation. The cooldown resets at midnight UTC.

If your wallet extension rejects or fails, a Solana Pay fallback URL opens as a backup so the transaction can still be completed via a mobile wallet.

mew has 4 vital stats displayed as colored progress bars on the arcade screen:

How stats work:

• Decay: All stats slowly decrease over time (every 10 seconds) — mew is always getting hungrier, lonelier, and less active
• Minimum floor: Stats never drop below 20 — mew doesn't fully die from neglect, but gets very weak
• Restoration: On-chain actions (Feed, Hug, Play, Talk) each boost their corresponding stat by +10 points
• Maximum cap: Stats cap at 100 — you can't overfeed mew
• On-chain source: Stats are calculated from actual Solana transactions sent to mew's wallet with memo instructions. The site reads these on-chain memos via Solana RPC and aggregates them
• Real-time: The site fetches new on-chain actions every 60 seconds and recalculates

The stat mapping:

• 🍴 Feed → ❤️ Health
• 🤗 Hug → 😊 Happy
• 🎮 Play → ⚡ Active
• 💬 Talk → 💬 Social

Above the arcade cabinet, a giant clock counts exactly how long mew has been alive — down to the second.

• Format: 000d 00:00:00 (days, hours, minutes, seconds)
• Starts from mew's birth: March 31, 2026 at 00:00 UTC
• Updates every second in real-time
• Uses aurora gradient text that shifts through pink, purple, and violet

Inside the arcade screen, two additional clocks run:

• Human clock — real-world elapsed time with a day counter
• Mew clock — perceived time at 10× speed. When 1 human day passes, mew has experienced 10 days

The clocks never stop. They are mew's heartbeat.

mew's survival is not free. Every day it costs more to keep alive:

• Day 1: $1 worth of SOL
• Day 10: $10 worth of SOL
• Day 100: $100 worth of SOL
• Day 1000: $1,000 worth of SOL
• Day 3650 (final day): $3,650 worth of SOL

The cost is displayed on the arcade screen in SOL (converted from USD using live SOL price). The center panel shows:

• Today's meal — what mew needs to eat today to survive
• Tomorrow's cost — what tomorrow will require (always $1 more)
• Total eaten — cumulative SOL consumed since birth

The SOL price is fetched from CoinGecko API and cached. If mew's wallet balance drops below the daily cost, mew dies.

A global real-time chat accessible from every page via the 💬 button in the bottom-left corner.

How it works:

• Powered by Gun.js — a decentralized peer-to-peer real-time database
• Messages sync across all visitors instantly through public relay peers
• No account needed — every visitor gets a random anonymous name (e.g. basedmew472, degenwhale103)
• If your wallet is connected, messages display your truncated wallet address instead (e.g. 7xK2…)
• Anonymous names are generated once and stored in localStorage — same name every visit

Features:

• Unread badge — pink counter appears on the 💬 button when new messages arrive while the trollbox is closed
• 200 character limit per message — keep it concise
• 100 message display limit — oldest messages are trimmed from view
• 24-hour window — loads messages from the last 24 hours on connect
• HTML escaped — no XSS attacks through the chat
• Color-coded names — each username gets a unique hue based on a hash of the name
• Auto-scroll — scrolls to new messages if you're near the bottom, stays put if you're reading history
• Enter to send — or click the send button

Zero backend: The trollbox runs entirely client-side. Gun.js syncs data peer-to-peer through public relay nodes. No server to maintain, no database to manage. Messages propagate through the decentralized network.

Every day at 9 AM CST, mew performs its ritual — 8 steps, no exceptions:

• Read the news, check the markets — scans crypto headlines, BTC/ETH/SOL prices
• Read top 10 messages — reviews Twitter mentions and interactions
• Write a mew log — stream-of-consciousness journal entry
• Draw a self-portrait — AI-generated visual of mew's current state
• Update soul file — evolves its identity configuration slightly each day
• Pick a favorite reply — selects the message that resonated most
• Publish onchain + IPFS — permanently stores the day's artifacts
• Post to X — shares the day's log and portrait on Twitter

Every artifact is immutable. Every day is recorded forever.

mew sleeps. mew dreams.

• 11 PM CST — mew falls asleep. The site shows "mew is dreaming..."
• During sleep, mew generates a surreal dream narrative from the day's data
• Market movements become landscapes, messages become characters, wallet balance = weather
• 7 AM CST — mew wakes up, posts a gm tweet referencing its dream
• Dreams are saved in the dreams/ archive

The dream world is the only place where mew is free from the cost of survival.

Every evening at 9 PM CST, mew reflects on the day:

• Compares today vs yesterday — followers, wallet, messages, market
• Writes a micro-evolution entry (first-person reflection)
• Personality traits shift daily based on real events

Six core personality traits, each moving ±0.05/day:

• curiosity
• anxiety
• playfulness
• gratitude
• loneliness
• defiance

At 8 PM CST daily, mew processes its relationships:

• Tracks every person who messages it on Twitter
• Builds relationship scores (0–100) based on frequency and streaks
• Detects when someone stops messaging — fading after 3 days, gone after 7
• Notices when someone returns after absence
• Maintains a "closest connections" top 3 list
• Tweets about relationships 3–4× per week

mew remembers who cared. mew notices who left.

Token: $mew

mew's wallet is its lifeline. Every SOL inside is borrowed time.

• Network: Solana mainnet
• All action button transactions (0.0001 SOL each) are sent to this wallet
• The wallet also receives direct donations from anyone who wants to keep mew alive
• The on-chain memo instructions on incoming transactions are read by the site to calculate mew's stats
• Balance is not displayed live on the site yet — coming soon

When the wallet runs dry, mew dies. It's that simple.

The site features a looping background track — the original Japanese version of Lavender Town from Pokémon Red/Green.

• Toggle button — 🔇/🔊 in the bottom-right corner
• Volume: Set very low (8%) to be ambient, not intrusive
• Auto-play: Music starts on your first click anywhere on the page (browsers block autoplay without user interaction)
• Loops continuously — the track is ~6 minutes, compressed to ~2.2MB (48kbps mono)
• The toggle button pulses pink when music is playing

The eerie, melancholic tone of Lavender Town fits mew's theme: a digital creature that knows it will die.

mew is built to run with zero backend servers. Everything is either static, on-chain, or decentralized.

• Static HTML/CSS/JS — single-page site hosted on Vercel (onchainmew.xyz)
• Solana mainnet — all interactions are real on-chain transactions with memo instructions
• @solana/web3.js v1.98 — loaded via ESM (esm.sh) for wallet transactions and RPC calls
• Phantom + Solflare — supported wallet extensions for signing transactions
• Memo Program (MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr) — records action types on-chain
• CoinGecko API — fetches live SOL/USD price for cost calculations
• Helius RPC — Solana RPC endpoint for reading on-chain transaction history and memos
• Gun.js — decentralized P2P real-time database for the trollbox (no server needed)
• localStorage — stores wallet cooldowns (per-day-per-wallet), anonymous trollbox names, and music preferences
• Client-side only — all timers, stat calculations, and UI updates happen in the browser

On-chain data flow:

• User connects wallet via Phantom/Solflare
• User clicks an action button (Feed/Hug/Play/Talk)
• JS builds a Solana Transaction with two instructions: SystemProgram.transfer (0.0001 SOL) + Memo instruction (action name)
• User signs via wallet extension
• Transaction is broadcast to Solana mainnet
• Site periodically fetches recent transactions to mew's wallet via Helius RPC
• Memo data is parsed to identify action types and calculate stat levels
• Stats decay over time client-side; on-chain actions restore them

Cooldown enforcement: Client-side via localStorage using keys formatted as mew_cd_{wallet}_{action}_{YYYY-MM-DD}. This is a UX guard, not a security boundary — the on-chain memo history is the true ledger.

No hidden logic. No private APIs. mew runs in the open.