Technical Spec

RemitOtter architecture & API reference

Front end, back end, on-chain components and integrations for the $OTTER platform.

Architecture

Front end

Next.js + Tailwind, SSR for SEO, Solana wallet adapter (Phantom). Marketing site + dashboards + War Room + /spec.

Back end

Next.js API routes (Node). REST endpoints for auth, ambassadors, quests, KOL, burns, launch, cron. Rate limiting + signed webhooks.

Data + cache

MongoDB collections (users, ambassadors, burns, launch_state...). Redis-style live counters simulated server-side.

Browser + Phantom→Next.js API→MongoDB+Pump.fun / PumpSwap+Solana programs

API reference

GET/api/statsLive bonding-curve counters (mkt cap, SOL in curve, holders, volume)
GET/api/leaderboardTop ambassadors (seed + real), sorted by referred volume
POST/api/ambassador/joinCreate ambassador (referral code, tier, referrals, rewards)
GET/api/ambassador?wallet=Fetch ambassador dashboard data
POST/api/ambassador/claimClaim liquid rewards (vesting-aware)
GET/api/quests?wallet=Tier quests + points + next-tier progress
POST/api/quests/completeVerify a quest, award points, level up tier
POST/api/kol/linkGenerate trackable KOL link (CPA / rev-share)
POST/api/partner/contactInstitutional onboarding request
GET/api/burnsPublic burn ledger (filter by type, limit)
GET/api/burns/statsCumulative burned, burn rate 24h, by-type breakdown
POST/api/burns/milestonePropose a milestone burn (multi-sig gated)
POST/api/burns/milestone/approveApprove/execute milestone burn (2-of-N)
POST/api/burns/executeExecute a manual burn (buyback / utility)
GET/api/vesting/violationsVesting clawback violations + burned amounts
GET/api/launchLaunch War Room state (waves, checklist, countdown)
POST/api/launchWar Room actions (setTarget, triggerWave, checklist, reset)
POST/api/cron/buybackScheduled auto buyback-and-burn bot (Bearer auth)
GET/api/onepagerDownload the ambassador one-pager (Markdown)

Data models

users
wallet_address, email?, roles[], kyc_status?, created_at
ambassadors
wallet, tier, referral_code, referrals[], totalVolumeSol, points, quests_completed[], vestedOtter, liquidOtter, claimedOtter, status
referrals (embedded)
id, referred_wallet, volume_sol, volume_usd, status, referred_at
kol_campaigns
id, influencer_wallet, deal_type, cpa_rate, revshare_rate, code, link, clicks
institutional_partners
id, org_name, email, sandbox_enabled, status, created_at
burns
id, type, amount_tokens, amount_usd_equivalent, tx_signature, timestamp, triggered_by, metadata
burn_proposals
id, milestone, pct, amount_tokens, approvals[], required, executed, status
vesting_violations
id, handle, dump_pct, dump_window_days, burned_amount, timestamp
launch_state
id, status, targetTime, waves[], checklist[]

Solana programs

  • • SPL token — 1B supply meme token launched via Pump.fun.
  • • Transfer wrapper — burns 1% of every transfer to the dead address; emits burn events.
  • • Treasury / fee splitter — routes revenue; 50% to ops, 50% to buyback & burn; multi-sig for large burns.
  • • Vesting w/ clawback — ambassador/KOL grants; burns clawback portion on dump violations.
  • • Burn registry — on-chain log of all burns for transparency.

Security & observability

Solana sign-in + nonce HMAC signed webhooksRate limits per IP/walletZod input validationSybil detection Metrics / logs / alerts Cron: Bearer-auth, idempotent