Last updated: September 10, 2026 | Status: Testnet Alpha. LOAR is a multi-modal AI creation suite — video, image, audio, 3D, and language models (~70 model IDs, 9 providers) — wrapped in an on-chain ownership, governance, and revenue layer. The protocol's canonical rights/revenue layer runs on Ethereum Sepolia today (contracts live + verified; Mainnet wired for swaps/auth), with a parallel Solana devnet stack live for wallet provisioning, universe creation, and a custodial bridge (token launchpad still EVM-only). Chain details: Smart Contracts · multi-chain status.
| Link | URL |
|---|---|
| Website | LOAR.FUN |
| $LOAR token | pump.fun/coin/2xowaGYF…dpTYb |
| Telegram | t.me/+AXD-XK8SVvw5MTIx |
| X / Twitter | @LOAR_FUN |
$LOAR is live and tradable on pump.fun (Solana, mint 2xowaGYF…dpTYb) — a standalone bonding-curve launch, not wired into the protocol. A native Token-2022 $LOAR is still planned; see multi-chain status for what's live today (wallets, universe creation, bridge) versus what's next (the SVM token launchpad).
LOAR is a platform where creators build cinematic universes with a full multi-modal AI stack, then own and monetize them on-chain:
- Video — Veo 3.1, Sora 2, Kling, Seedance 2, Wan 2.5/2.7, PixVerse V6, Runway Gen-3, LTX, HunYuan, CogVideoX, ViduQ1 (~32 model IDs)
- Image — FLUX, Imagen 4, Nano Banana, Recraft V4, Ideogram V3, Seedream V5, GPT Image, Qwen Image, GLM Image (~17 model IDs)
- Audio — ElevenLabs (voice clone / design / dubbing), stable-audio, MusicGen, Kokoro TTS, seed-tts, Whisper captions
- 3D — Meshy 4/5/6 (text/image-to-3D, auto-rig, animation), Tripo3D
- Language — Gemini 2.5, Claude, GPT-4o-mini, GLM (wiki, lore, storyline, agents, VLM continuity)
Smart Auto routes each generation across ~70 model IDs / 9 providers by quality / speed / cost, with deterministic fallback and a manual model dropdown on every form. No single model is the default — see the full AI Models catalog.
On top of that: deploy each universe as a smart contract, build branching narratives, and wire up multiple revenue streams — all governed by token holders.
One-liner: "YouTube meets DAO meets AI studio" — creators own the IP, communities govern the canon, tokens capture the value.
Live testnet demo: loar.fun (Ethereum Sepolia)
LOAR uses a hybrid architecture by design. Here's what lives where and why:
| Layer | Where | Why |
|---|---|---|
| Universe ownership, governance, tokens | On-chain (EVM) | Immutable ownership, trustless governance, permissionless trading |
| NFTs, royalties, payments, licensing | On-chain (EVM) | Enforceable revenue splits, transparent fee flows |
| Content bytes (video, images, audio) | Pinata (IPFS) + Lighthouse (Filecoin) | Content-addressed, redundant, accessible via gateway |
| Content hashes | On-chain (Universe contract) | Proof of existence, tamper detection |
| User profiles, analytics, moderation | Firestore (cloud) | Fast reads, complex queries, mutable by design |
| AI generation orchestration | Cloud server (Hono/tRPC) | API key management, model routing, rate limiting |
What this means in practice:
- If LOAR the platform disappears, your universe contracts, tokens, and NFTs continue to exist on-chain. Content is retrievable via IPFS/Filecoin CIDs.
- The discovery layer (wiki, search, analytics, moderation) is centralized and would need to be rebuilt or replaced by the community.
- We chose this tradeoff intentionally: fully on-chain content storage is cost-prohibitive for video, and centralized metadata enables the UX creators need (search, moderation, real-time collaboration).
- The long-term goal is progressive decentralization — universe content is editable and lives in the cloud until creators commit it on-chain, at which point it becomes permanent and verifiable.
LOAR routes ~70 model IDs across 9 integration providers — fal AI (the bulk), Google (Vertex + Gemini), OpenAI, Anthropic, ElevenLabs, ByteDance, Z.AI (BYOK), Meshy, Tripo3D — spanning video, image, audio, 3D, and language. Smart Auto picks a model per generation by quality / speed / cost preference with deterministic fallback; every generation form also exposes a manual model dropdown. BYOK models appear once the user adds their own provider key at /settings/api-keys.
Full call-site inventory: docs/ai-models.md. Per-model USD cost, fiat / $LOAR price, and credit cost: docs/pricing.md.
| Family | Variants | Provider | Tier |
|---|---|---|---|
| Veo 3.1 | full / lite / std × t2v / i2v (6 IDs) | Premium | |
| Sora 2 | sora2 t2v / i2v, sora2-pro t2v / i2v | OpenAI | Premium |
| Kling | kling t2v / i2v, kling3-i2v, kling-video-v3, v2.5 turbo / pro | Kuaishou | Standard |
| Seedance 2 | t2v, i2v, fast-t2v, fast-i2v, ref, fast-ref | ByteDance | Standard |
| Wan | wan 2.5 t2v / i2v, wan 2.7 t2v / i2v | Alibaba | Standard |
| PixVerse V6 | t2v, i2v | PixVerse | Standard |
| Runway Gen-3 | runway-gen3 | Runway | Standard |
| LTX | ltx-video | Lightricks | Budget |
| HunYuan | hunyuan | Tencent | Budget |
| CogVideoX | cogvideox, cogvideox-3 | Zhipu | Budget |
| ViduQ1 | viduq1 t2v / i2v | Vidu (Z.AI BYOK) | Standard |
| Family | Variants | Provider | Tier |
|---|---|---|---|
| FLUX | schnell, dev, pro, 1.1 Pro, 2 Pro, kontext-pro, inpaint | BFL | All |
| Imagen 4 | 4.0 standard, 4.0 ultra, 4.0 fast | Google Vertex | Premium |
| Nano Banana | nano-banana, nano-banana-2, nano-banana-pro | fal | Budget |
| Recraft V4 | recraft-v4 | Recraft | Standard |
| Ideogram V3 | ideogram-v3 | Ideogram | Standard |
| Seedream V5 | seedream-v5, seedream-5-direct | ByteDance | Standard |
| GPT Image | gpt-image | OpenAI | Standard |
| Qwen Image | qwen-image | Alibaba (BYOK) | Standard |
| GLM Image | glm-image | Z.AI (BYOK) | Standard |
| Model | Provider | Purpose |
|---|---|---|
| stable-audio | Stability via fal | Episode theme / ambient music |
| MusicGen Large + Stereo Large | Meta via fal | Long-form music generation |
| ElevenLabs voices | ElevenLabs | Dialogue, voice cloning (IVC), voice design, dubbing |
| Kokoro TTS | Kokoro via fal | Cheap, consistent character voice samples |
| seed-tts-1.0 | ByteDance | Alternate TTS path |
| Whisper | OpenAI via fal | Caption transcription (SRT / VTT) |
| Model | Provider | Purpose |
|---|---|---|
| Meshy 4 / 5 / 6 | Meshy | Text-to-3D, image-to-3D, humanoid auto-rig, animation library |
| Tripo3D | Tripo | Non-humanoid auto-rig (quadruped, avian, aquatic, etc.) |
| Family | IDs | Provider | Purpose |
|---|---|---|---|
| Gemini 2.5 | 2.5 Pro, 2.5 Flash | VLM continuity subsystem, wiki + lore generation | |
| GPT-4o-mini | gpt-4o-mini | OpenAI | Storyline / wiki narrative generation |
| GLM | glm-4.7, glm-5.1, glm-5-turbo | Z.AI (BYOK) | Chat / reasoning / worldbuilding |
| Claude | Opus 4.x, Sonnet 4.x, Haiku 4.x | Anthropic | Claude Agent SDK pathway + platform editorial agents |
We classify every feature by what actually works end-to-end today, not what has backend code or UI shells.
| Feature | What Works Today |
|---|---|
| Wallet Auth (SIWE) | Circle DCW (email/social/passkey) provisions a server-custodied EVM wallet → SIWE signature → JWT. No browser key material, no seed phrase |
| Universe Creation | Atomic single-tx createUniverseWithToken() or two-step: Universe contract → token + Uniswap v4 pool. Runs on Ethereum Sepolia today (Mainnet wired); the chain-selector UI is built to add Solana + Base as future chains |
| Token Deployment | Deploy governance token for existing universes via /universe/$id/deploy-token. Custom token symbol, configurable allocation splits (LP/creator/treasury/community), multi-recipient LP fee distribution |
| LP Yield & Fee Management | On-chain fee collection from Uniswap v4 pools, multi-recipient BPS splits, claim UI in dashboard via LPYieldManager component. Anyone can trigger fee harvest; recipients claim their share |
| Narrative Timeline Editor | ReactFlow-based visual story builder with MiniMap, node search (Ctrl+K), undo/redo (Ctrl+Z), auto-layout, keyboard shortcuts, fullscreen mode, edge labels (Canon/Branch), and zoom controls. Tree layout positions nodes by depth and subtree size |
| AI Video Generation | 11 providers (Veo 3.1, Sora 2, Kling, Seedance 2.0, Wan 2.5/2.7, PixVerse V6, Runway Gen-3, LTX, HunYuan, CogVideoX, ViduQ1) via fal AI + ModelArk + Z.AI BYOK. ~32 model variants, 1-60s duration |
| AI Image Generation | ~17 models (FLUX schnell/dev/pro/1.1 Pro/2 Pro/kontext-pro, Imagen 4.0 std/ultra/fast, Nano Banana 1/2/Pro, Recraft V4, Ideogram V3, Seedream V5, GPT Image, Qwen Image, GLM Image) via fal AI + Google Vertex + ByteDance direct |
| Model Routing (Smart Auto) | Auto-selects best model by quality/speed/cost. Manual override available. ~70 models across video / image / audio / 3D / LLM, cost tracked per generation. Full inventory: docs/ai-models.md |
| Quest & Affiliate System | Earn $LOAR tokens for onboarding, engagement, social, and power-user actions. Referral tracking with rewards |
| AI Wiki Generation | Gemini-powered character analysis, storyline generation, video-to-wiki extraction |
| On-Chain Node Storage | Content hashes + plot hashes stored in Universe contract, indexed by Ponder |
| Decentralized Storage | Multi-provider fallback: Pinata > Lighthouse/Filecoin > Firebase |
| Credit System (On-Chain) | ETH + $LOAR payment on-chain (Ethereum Sepolia). Dual-margin pricing (35% card/ETH, 25% LOAR). CreditStore UI with package selection. Stripe card payments when STRIPE_SECRET_KEY is set |
| Creator Profiles | Username, bio, themes (5 options), social links, privacy controls, public portfolios |
| Content Upload | IP classification (Fan vs Creator-Owned vs Rights-Cleared), copyright declarations, license selection |
| Content Discovery | Search/filter by classification, media type, tags. Creator gallery + content feed |
| Character Wiki | Browse, search, filter characters by collection/traits. Individual character pages |
| Blockchain Indexer | Ponder v0.15 indexing all contract events into 37 GraphQL tables |
| ETH Purchase Flow | Product detail page sends real ETH on-chain to seller via wagmi sendTransaction before recording the order |
| Identity NFTs | Minted by UniverseManager per universe creator. Tracks co-creators and multi-sig signers |
| TimelockController Governance | UniverseTimelockGovernor with 24-hour execution delay for major proposals. Per-universe Governor with configurable voting delay/period/quorum |
| Multi-Sig Support | Gnosis Safe addresses as universe owners for shared team governance |
| AI Audio Generation | Music generation, voice TTS, voice cloning (ElevenLabs), sound effects, lip-sync video generation |
| AI 3D Asset Generation | Text-to-3D and image-to-3D via Meshy |
| Scene Controls | Per-node camera presets (16 types), style presets (12 types), VFX overlays (14 types), cast member assignment, motion brush masking, keyframe handoff between nodes |
| Image-to-Video & Talking Scenes | talkingScene.create combo endpoint (image → motion → lipsync/TTS), motion presets, Animate + Talking tabs in the editor, generation lineage refs (parentGenerationId, sourceImageUrl) so derived clips link back to their source |
| Cast Management | Universe-wide cast member registry with reference images for character consistency across scenes |
| Worldbuilding Studio | /create hub with per-kind forms (person, place, thing, faction, event, lore, species, vehicle, technology, organization). Tabbed wiki encyclopedia at /wiki |
| Social Features | Follow/unfollow, activity feed (Following + Global tabs), notification center, like system, threaded comments on episodes/universes/content, token-gated discussions |
| AI Agent System | AI agent creation with budget allocation, multi-step pipelines, API key management, MCP server with 25 tools for external AI agents |
| Private Creator's Room | Per-universe private workspace: plot notes, lore vault, draft workspace. Token-gated access |
| Narrative Player | Interactive branching narrative playback with choice overlays, player controls, and branch stats |
| Error Toast Notifications | Real-time toast feedback on all mutation successes and failures via Sonner |
| VLM Subsystem | Gemini 2.5 Pro extraction: scenes, entities, canon conflicts, moderation risk, prompt coaching, style-bible, recap/trailer, grounded governance drafts. Multimodal search over sceneIndex. See docs/prd-vlm-subsystem.md |
| Cost Tracker (Admin) | Per-provider USD cost attribution, gross-margin gauges, daily platform cap, top movers, cost-vs-revenue by model, CSV export. Alert sweep Slacks margin/cap breaches. Dashboard at /admin/cost |
| Advanced Creator Analytics | Wallet-based conversion funnel (viewed → engaged → minted) with 30/90/180-day windows, weekly cohort retention matrix with 4/6/8-week windows. Creator-gated via analytics.getFunnel + analytics.getCohorts. Surfaced on /analytics/$universeId |
| ERC-4337 Paymaster | Gas sponsorship for mint/vote/universe-create via Pimlico or Biconomy. Frontend falls back to user-paid gas when sponsorship is unavailable |
| CSAM Fingerprinting | Every image publish scanned via local pHash + PhotoDNA + Hive AI before IPFS pinning. Hit → block upload + audit-log entry |
| Outbound Webhooks | HMAC-signed webhook delivery via BullMQ worker, retry with exponential backoff. 5-minute replay window |
| Product Analytics (PostHog) | Autocapture + custom events across web, mobile, server. Session replay (inputs masked), funnels, retention. Privacy: wallet-address identity only, DNT respected. See docs/analytics.md |
| Sandbox Workspace | Tabbed multi-modal draft surface: image / video / voice / audio / 3D / talking. Inline image edits (upscale, relight, outpaint, remove-bg), video edits, bring-your-own-video, style presets, seed, ref upload, keyboard shortcuts |
| Universe Privacy (Owner) | Toggle isPrivate from Access Settings to hide a universe + every linked content item (gallery, landing page, search, wiki, lineage, entities) from the public. Owner still sees everything. Enforced server-side via a single getExcludedUniverseIds chokepoint; orthogonal to admin isHidden. Audit log entry per toggle |
| Voice Studio | Full per-universe voice pipeline at /lab/voice-studio — voice library, clone upload (ElevenLabs IVC), voice designer, script editor with multi-track mixer + waveform lanes, captions tab (FAL Whisper), and multilingual dubbing. "Open in Voice Studio" + "Dub to other languages" CTAs on every episode |
| Captions (Voice Studio) | captions tRPC router + Captions tab in Voice Studio. FAL Whisper transcription with SRT/VTT export; pinned source URL written into generation lineage. See docs/prd-model-metering.md §4 |
| Multilingual Dubbing | multilingualDub + dubbing routers; clone-then-translate flow renders 1:N target-language audio tracks per episode with per-language voice match and per-track preview. Used by the "Dub to other languages" episode CTA |
| BYOK Provider Keys | Single-source-of-truth BYOK system at /settings/api-keys. AES-256-GCM-encrypted keys for FAL, AssemblyAI, Deepgram, Groq, ModelArk, OpenAI, Google, Anthropic. Server picks user-key first, platform-key fallback. Legacy userSecrets removed 2026-05-17 |
| Model Metering (Reserve/Reconcile) | Every metered AI call goes through reserve (atomic credit hold) → provider invocation → reconcile (settle on real cost). Replaces the older "spend then refund" pattern. 4-backend transcription registry, ~70 models routed. Usage dashboard at /settings/usage |
| Editor v2 (E2–E7) | Universe editor now includes E2/E3 dub + lipsync, E4 style & shot pickers, E5 cutdown auto-assembly panel, E7 editor drafts (resumable per-episode). See docs/prd-editor.md |
| Character Rigging & Animation | Meshy character rigging pipeline (auto-rig from 3D mesh) + animation library; threed router exposes both Meshy and Tripo3D backends |
| Centralized Credit Reservation | All metered pipelines (image, video, audio, 3D, talking-scene, lipsync, dubbing) share a single reserve → invoke → reconcile service. No more bespoke credit math per route |
These features have working smart contracts, backend APIs, AND frontend UIs, but some interactive flows need completion.
| Feature | What Works | What's Missing |
|---|---|---|
| Episode NFTs | Contract: ERC721 + ERC2981 royalties. API: listing + mint recording + atomic batchCreateEpisodeListing. MintContentDialog: pin to IPFS + on-chain mint. BuyNFTDialog: purchase with revenue splits. BatchMintEpisodesDialog in RevenuePanel for multi-row listings (up to 50 per batch) |
— |
| Character NFTs | Contract: ownership + appearance royalties. API: full CRUD. MintContentDialog supports character minting. Dedicated gallery at /characters/$universeId with appearance/royalty chips, sort by top/newest/royalties, and per-universe totals |
— |
| Canon Marketplace | Contract: submit/vote/finalize/license. API: all operations including onChainSubmissionId + finalizeTxHash for audit. Full submit form + For/Against voting UI. On-chain finalize button appears after the voting deadline (CanonMarketplace.finalize) with Firestore mirror. License dialog accepts ETH amount and calls CanonMarketplace.licenseCanon with PaymentRouter routing |
— |
| Credit System | API: balance, tiers, purchase, spend, history. CreditStore UI with package selection. On-chain ETH + $LOAR payment verification (Ethereum Sepolia). Stripe PaymentIntent creation + server-side verification | Card payments require STRIPE_SECRET_KEY env var. Without it, card tab is disabled |
| Subscriptions | API: configure tiers, subscribe, check access. 4-tier model. SubscribeDialog: tier selection + on-chain ETH payment. /subscriptions management page with cancel |
No renewal reminders or tier downgrade UI |
| Collabs | API: propose, accept, activate, record episodes, complete. /collabs hub with Active/Proposals/History tabs. /collabs/new creation form |
No episode-level collab tracking in universe editor |
| Ad Marketplace | Contract: slots, bidding, impressions. API: full CRUD. /ads hub with Browse & Campaigns tabs. /ads/new creation. /ads/$slotId detail + bidding. Seed Dance: /ads/seeds hub with Browse/My Seeds/My Gigs tabs, /ads/seeds/new creation wizard, /ads/seeds/$seedId detail + placement submissions |
No ad impression rendering during episode playback |
| IP Licensing | Contract: 6 license types, royalty tracking. API: full CRUD + merch. /licensing hub with Licenses + Merch tabs. /licensing/new creation |
No merch fulfillment dashboard |
| On-Chain Governance | Contract: OpenZeppelin Governor + TimelockController. Ponder indexes proposals/votes. Governance page at /governance/$universeId. Proposal creation awaits the tx receipt and parses the ProposalCreated event to record the real proposalId. Vote casting awaits on-chain confirmation and reads hasVoted so the UI never double-submits or shows a false-success toast |
— |
| Token Trading | Uniswap v4 pool created at universe deployment. Fee hooks + LP locking live. LP yield dashboard. TokenSwapWidget with bonding curve + LP pool support, quick buy amounts. Per-token recent trades on /tokens/$address. User-scoped swap history on /tokens/portfolio backed by Ponder's indexed swap table |
— |
| Social Features | Follow/unfollow, activity feed (Following + Global tabs), notification center, NotificationBell dropdown, like system, token comments with threads, general comments on episodes/universes/content | No push notifications to mobile devices yet |
| Analytics | API: views, engagement, trending, platform stats, per-episode metrics, export. Creator analytics dashboard at /analytics/$universeId. Market page queries real stats |
No subscriber funnels or cohort analysis |
| Dashboard | AI generation tools + universe list wired to live tRPC API. LP Yield Manager panel, quests panel, daily check-in, monetization overview, upload form, NFT gallery. Per-universe cards now show views / mints / subs / votes / revenue chips sourced from analytics.getUniverseMetrics, with a "Details" link into /analytics/$universeId |
— |
| Rights Classification | Backend enum is fan / original / licensed; licensed content has licensingProof + reviewStatus. Content feed on /discover now filters across all three lanes and renders <ContentLaneBadge /> (including pending/approved/rejected review states) instead of the old fun / monetized pill. content.feed exposes reviewStatus so badges can render the correct lane variant |
— |
| Worldbuilding Studio | /create hub + per-kind forms. Wiki at /wiki with tabbed entity browsing + detail pages (/wiki/entity/$id). Kind filter at /wiki/$kind (person, place, thing, etc.) |
— |
| Content Moderation | Flag system, admin review queue, DMCA intake (/dmca), immutable audit log. contentStatus gates commercial transactions. Admin UI at /admin/moderation |
No auto-flag threshold, no counter-notice workflow (manual review only) |
| Mobile App | Expo 52 / React Native (iOS + Android). Portfolio, tokens, earnings, collections, profile tabs. Circle DCW auth (email/social/passkey via the server-side flow shared with web). Production Hermes bytecode builds end-to-end (~16.6MB .hbc, 7083 modules). @sentry/react-native scaffold initialized in app/_layout.tsx (JS-layer crashes; native capture requires expo prebuild) |
Beta — not yet published to App Store / Play Store |
| Feature | Notes |
|---|---|
| Mainnet Deployment | Contracts live on Ethereum Sepolia. Needs security audit before Ethereum Mainnet. Solana's sister programs are live on devnet only — mainnet-beta needs an Anchor audit + Wormhole NTT bridge (see multi-chain status); Base is not currently active. See launch audit |
| Fiat On-Ramp | Stripe integration exists but requires STRIPE_SECRET_KEY. No other fiat on-ramp |
| Merch Fulfillment | Backend CRUD exists. No fulfillment partner integration, no order management dashboard |
| Mobile App Store Publishing | Expo 52 app exists (iOS + Android). Not yet submitted to App Store / Play Store |
┌─────────────────────────────────────────────────┐
│ Frontend │
│ React 18 + Vite + TanStack Router + wagmi │
│ Port 3001 │
└──────────┬──────────────────┬───────────────────┘
│ tRPC │ wagmi
▼ ▼
┌─────────────────────┐ ┌──────────────────────┐
│ API Server │ │ Ethereum (EVM) │
│ Hono + tRPC │ │ 69 contracts │
│ 111+ routers │ │ (proxied + │
│ 900+ procedures │ │ upgradeable) │
│ Port 3000 │ └──────────┬───────────┘
│ │ │ events
└──────────┬──────────┘ ▼
│ ┌──────────────────┐
▼ │ Ponder Indexer │
┌──────────────────┐ │ 37 tables │
│ Firestore │ │ GraphQL API │
│ (user data, │ │ Port 42069 │
│ content meta, │ └──────────────────┘
│ analytics) │
└──────────────────┘
Diagram shows the Ethereum path. Solana runs a parallel devnet stack (apps/programs + apps/solana-indexer) — see multi-chain status.
| App | Stack | Description |
|---|---|---|
apps/web |
React 18, Vite, TanStack Router/Query, wagmi, Circle DCW | Frontend SPA (139 routes) |
apps/server |
Hono, tRPC, Firebase Admin (Firestore) | API server (111+ routers, 900+ procedures) |
apps/indexer |
Ponder v0.15, GraphQL | Ethereum event indexer (37 tables) |
apps/contracts |
Foundry, Solidity ^0.8.30 | EVM smart contracts (Ethereum Sepolia, 69 contracts) |
apps/programs |
Anchor 0.31.1, Rust | Solana programs — universe (PDA container) + episode (Bubblegum cNFT), devnet-live |
apps/solana-indexer |
Helius webhooks, Firestore | Solana event indexer for the Anchor programs + cNFT mints |
apps/mcp |
MCP Server | AI agent gateway (25 tools for MCP-compatible agents) |
apps/mcp-gateway |
OAuth 2.1, SSE | Hosted MCP gateway at mcp.loar.fun — bridges browser agents to per-user MCP sessions |
apps/mobile |
Expo 52, React Native, NativeWind | iOS + Android app (Circle DCW auth; Android adds Solana SIWS) |
packages/abis |
Auto-generated wagmi hooks + Anchor IDL types | Shared EVM + Solana contract bindings |
apps/event-listener(a Firestore-based indexer meant to eventually replace Ponder/Neon, see docs/prd-indexer-firestore-migration.md) exists in the workspace but isn't deployed — Ponder remains the live Ethereum indexer today.
Auth: Circle DCW provisions both an EVM wallet and a Solana wallet at sign-up. SIWE Signature (EVM) or SIWS Signature (Solana, mobile) > Server JWT (carries evm/sol claims) > Bearer Token > protectedProcedure. EVM writes go through useCircleWrite; Solana writes go through dedicated /api/solana/* routes that build Anchor instructions server-side and sign through Circle KMS — see multi-chain status.
Content Creation: AI Generate > Decentralized Storage (SHA-256 dedup) > On-Chain Hash > Ponder Index
Universe Deployment (Atomic): UniverseManager.createUniverseWithToken() > Deploy GovernanceERC20 + Governor + TimelockController > Initialize Uniswap v4 Pool > Lock LP > Mint IdentityNFT (single tx)
Universe Deployment (Two-Step): createUniverse() (pays mint fee) > deployUniverseToken() (deploys token, pool, locker — mint fee WETH seeds the LP)
LP Yield: Uniswap v4 Swaps > LoarHookStaticFee (collects fees) > LoarLpLockerMultiple (distributes by BPS splits) > LoarFeeLocker (recipients claim ETH)
69 EVM contracts are deployed and verified on Ethereum Sepolia testnet (chain ID 11155111). Ethereum Mainnet (chain ID 1) is wired for swaps/auth; no LOAR contracts are deployed there yet. Revenue contracts use an upgradeable proxy pattern: UUPS for singletons and Beacon Proxy for per-universe NFTs.
Contracts are live on Ethereum Sepolia (chain 11155111) today — the only EVM network with LOAR contracts deployed. Ethereum Mainnet (chain 1) is the deployment target and is wired for swaps/auth, but no LOAR contracts are deployed there yet. Solana has its own sister programs live on devnet (Anchor, not Solidity — see below); Base is not currently a deployable chain. See the multi-chain status.
| Contract | Address | Purpose |
|---|---|---|
| UniverseManager | 0x66F289658Ce5fD0Bb1022251eA4604F6b0C4d7Ce |
Factory: deploys universes + tokens |
| LoarHookStaticFee | 0x9A53B31b8B4F76Bb617D6B9aAd62731f8033A8Cc |
Uniswap v4 fee collection hook |
| LoarLpLockerMultiple | 0xc00225D9463C15280748dC2E21D8D8625982Ad54 |
LP token locking (anti-rug) |
| LoarFeeLocker | 0x1E10b62bd2817d0C2414909027E1E63653fcCd8e |
Fee escrow and creator payouts |
Plus per-universe: Universe, GovernanceERC20, UniverseGovernor, UniverseTimelockGovernor, IdentityNFT contracts.
| Contract | Purpose |
|---|---|
| IdentityNFT | Creator identity proof, minted per universe. Tracks co-creators |
| UniverseTimelockGovernor | 24-hour timelock on governance execution for safer proposals |
| UniverseTokenDeployerV2 | Enhanced token deployer with allocation config (LP/creator/treasury/community splits) |
| PaymentRouter | Unified payment processing across ETH, ERC-20, and stablecoins |
| ContentLicensing | BUY/RENT/LICENSE deals with royalty tracking |
| StoryBounties | Bounty creation for content creation tasks |
| SlopMarket | Secondary market for digital assets |
| LaunchpadStaking | Stake $LOAR tokens, per-universe staking pools |
| TokenVesting | Token vesting schedules for team/investor allocations |
| LoarSwapRouter | DEX routing for $LOAR token swaps |
These are upgradeable singleton contracts behind ERC1967 proxies. Upgrade via proxy.upgradeToAndCall(newImpl, "").
| Contract | Proxy Address | Purpose |
|---|---|---|
| PaymentRouter | 0x920e9A9bac991554AEE2AB7c76c521e5FB3113b6 |
Fee splits & treasury routing |
| RightsRegistry | 0x3A14A746990498d5a4eCe867db10a197f91856Bc |
Content rights & ownership tracking |
| CanonMarketplace | 0xDc5998C5e334345Ac3Aa9a9c6e141f471e929c81 |
Canon submission, voting & licensing |
| CreditManager | 0x5110FCCaf50316D8F874F22428dC1a832F591639 |
AI generation credits & tiers |
| AdPlacement | 0x972bD30323B0Fb5f2466E39593cCdE1e8ae3F8C1 |
Ad slot bidding & impressions |
| SubscriptionManager | 0x53542bA1e3445804D9a225C967E2677F017D1d47 |
Creator subscription tiers |
| LicensingRegistry | 0xbF0Fed6125b1e05aA3Dc52B72B5cd7703990627C |
IP licensing (6 types) & royalty splits |
| CollabManager | 0xE981454B4149BEa3a9018fa2ab77482F388ba01f |
Multi-creator collaboration management |
| AnalyticsRegistry | 0xB86539C4bf30036B6bd1513320cF38Bc839c7922 |
On-chain analytics & engagement tracking |
Per-universe NFT instances are deployed as Beacon Proxies. Upgrading a beacon upgrades ALL universe instances of that NFT type simultaneously.
| Contract | Address | Purpose |
|---|---|---|
| RevenueModuleFactory | 0x6D5CEf09F044224A51bd59EB841769255070e5dA |
Deploys all 5 NFT proxies per universe |
| EpisodeEdition Beacon | 0x14742D6BB8eeE513D0D70a235d8B4d801F19F9ed |
ERC1155 episode editions (mint + royalty) |
| Character Beacon | 0x0BEcc54417e9AaC9289C748eb72ECBb55292756f |
ERC721 character NFTs (appearance fees) |
| Entity Beacon | 0xF951065C7d4d28805188F60a3F8bd398B7776EC8 |
ERC721 entity NFTs (world objects) |
| EntityEdition Beacon | 0xb3D7889c393b710edF2e087Cd2b7148a2556f47b |
ERC1155 entity editions |
| EpisodeNFT Beacon | 0x3ebb4FFd384Fc971F445AA950055203916b749a5 |
ERC721 episode NFTs (per-episode mint) |
- UUPS Singletons: Deploy new implementation, call
proxy.upgradeToAndCall(newImpl, ""). Only the contract owner can upgrade. - Beacon NFTs: Deploy new implementation, call
beacon.upgradeTo(newImpl). All universe instances upgrade at once. - All contracts use OpenZeppelin Upgradeable v5.0.2 with
Initializable+ReentrancyGuardUpgradeable.
Ethereum stays canonical for rights and revenue. Universe ownership, governance, tokens, and every revenue contract in Smart Contracts live on Ethereum (Sepolia today; Mainnet is the deployment target). Solana was prototyped end-to-end, removed from
main, and has since been restored as a parallel devnet stack — this is a live, actively-fixed integration, not a future roadmap item. Base was prototyped alongside it and has not been restored; it isn't a selectable chain today. The one thing live on Solana outside this stack is the $LOAR token itself, launched on pump.fun (mint2xowaGYFTMtBfvjqw6jnEgxyrpouzmcE9A7uarZdpTYb) — a standalone bonding-curve launch, not wired into the protocol.
Circle Developer-Controlled Wallets provision one server-custodied identity
that signs on both chains at sign-up — no Phantom/Solflare adapter, no second
seed phrase. The chain picker in the universe-creation flow (gated behind
VITE_SOLANA_CLUSTER, currently devnet) lets a creator deploy a universe on
Solana instead of Ethereum; the same session then reads/writes it through the
editor, wiki, and profile like any other universe.
| Live today | Detail |
|---|---|
| Dual-wallet sign-up | provisionSolanaWalletAtSignup() provisions a Solana wallet alongside the EVM wallet on every OTP/social login; JWT gains an sol claim |
| Universe creation (create-only) | The universe Anchor program mints a PDA-based universe on devnet via useSolanaUniverseInit; the base58 PDA is never lowercased end-to-end |
| Universe editor + wiki | Timeline editor, watch/profile pages, entities/curation, physics, and the governance sidebar all recognize Solana PDA universes |
| Custodial bridge | /bridge — public reconciliation snapshot (ledger vs. vault per chain) + authenticated transfer history for Solana ↔ EVM $LOAR transfers |
| Mobile SIWS | Android Mobile Wallet Adapter Sign-In-With-Solana; iOS shows a universal-link fallback |
| Solana Pay | QR-code payment button wired to the same custodial flow |
| Not live yet | Detail |
|---|---|
| SVM token launchpad | Solana universes are create-only — no on-chain token + LP deploy yet; monetize mode is disabled for Solana selections |
| Governance | useGovernance() has a typed Solana branch that returns disabled — Realms wiring is unbuilt, no /api/governance/* Solana routes exist |
| Canon marketplace / licensing / ads / collabs | EVM-only; no Solana equivalents yet |
| Mainnet-beta | Devnet only. Needs program-upgrade keypair rotation, an external Anchor audit, a live Wormhole NTT bridge, and Squads multisig handover |
| Native $LOAR (Token-2022) | The only live $LOAR is the pump.fun bonding-curve token — standalone, not wired into the protocol. A Token-2022 mint with a permanently-locked mint authority is designed but not deployed |
Under the hood: apps/programs (Anchor 0.31.1) holds the universe and episode
(Bubblegum cNFT, canon promotion to Metaplex Core) programs; apps/solana-indexer
mirrors their events into Firestore via Helius webhooks. Both were surgically
restored from an earlier archived snapshot (commit 4cff84fb) in a phased
migration — programs/indexer, server routes, shared ABIs, web UI, mobile, and
CI all landed; the one open item is a full credential-rotated devnet redeploy,
tracked in the restoration plan's status log.
Design docs: docs/solana-overview.md (umbrella),
docs/solana-parity-restoration-plan.md (what was restored, phase-by-phase status log),
docs/solana-bridge.md (bridge design),
docs/solana-mainnet-runbook.md (devnet → mainnet-beta),
docs/prd-solana-parity.md (EVM parity plan, S0–S5 phases),
docs/prd-solana-native-sdk-glue.md (native SDK adapters).
Base (Base Sepolia → Base Mainnet) was prototyped as a second EVM deploy target
behind the same multi-chain contract-address registry and chain-selector UI,
then removed along with Solana. Unlike Solana, it has not been restored —
there's no Base route, no Base contract deployment, and no Base option in the
chain picker today. The one place Base still appears in the code is as the
intended canonical home for $LOAR in a future production bridge
(apps/server/src/lib/wormhole-bridge.ts names Base Mainnet as where $LOAR
would live once Wormhole NTT replaces the current custodial lock-and-mint
backend) — a documented target, not a live integration.
| Tool | Required | Notes |
|---|---|---|
| Node.js >= 18 | Yes | nodejs.org |
| pnpm 9.15.0 | Yes | Auto-installed via corepack |
| Foundry | Optional | For smart contract dev |
| Docker | Optional | Only for production-like local testing |
git clone <repo-url>
cd loar
bash setup.sh # checks prereqs, copies .env.example → .env, installs deps
# Edit .env — at minimum set SIWE_JWT_SECRET and FIREBASE_SERVICE_ACCOUNT
pnpm dev # starts web (3001) + server (3000) + indexer (42069)All apps read from a single .env at the repo root. Copy .env.example and fill in values.
Required for server:
SIWE_JWT_SECRET— JWT signing (openssl rand -hex 32)FIREBASE_SERVICE_ACCOUNT— Firestore access (JSON string or file path)
Required for indexer:
PONDER_RPC_URL_2— Sepolia RPC endpoint
Required for payments (testnet):
TREASURY_ADDRESS— Wallet address that receives ETH/$LOAR paymentsLOAR_TOKEN_ADDRESS— $LOAR ERC-20 contract addressRPC_URL— Sepolia RPC for on-chain payment verification
Optional (server starts without these):
FAL_KEY— AI generation (image/video) + FAL Whisper captionsGOOGLE_API_KEY— Gemini wiki generation + VLM subsystemOPENAI_API_KEY— GPT-4o-mini storyline generationBYTEDANCE_API_KEY— ModelArk: Seedance/Seedream/Seed/OmniHumanZAI_API_KEY— Z.AI: GLM chat/vision, CogView image, CogVideoX video, GLM-ASRMESHY_API_KEY— Meshy 3D + humanoid auto-rig + animation libraryTRIPO_API_KEY— Tripo3D non-humanoid auto-rig (quadruped, avian, aquatic, etc.)ELEVENLABS_API_KEY— Voice cloning, TTS, dubbingASSEMBLYAI_API_KEY/DEEPGRAM_API_KEY/GROQ_API_KEY— Alternate caption backendsPROVIDER_KEY_MASTER_KEY— Required to enable BYOK at/settings/api-keys(AES-256-GCM, 32 hex bytes)STRIPE_SECRET_KEY— Enables card payments (card tab disabled without this)REDIS_URL— Distributed rate limiting (in-memory if unset, fine for single-instance)PIMLICO_API_KEY/BICONOMY_API_KEY— ERC-4337 paymaster (gas sponsorship)PHOTODNA_*/HIVE_API_KEY— CSAM moderation (required in production)POSTHOG_API_KEY,VITE_POSTHOG_KEY,EXPO_PUBLIC_POSTHOG_KEY— product analyticsWEBHOOK_SIGNING_SECRET— outbound webhook delivery (HMAC signing)CIRCLE_API_KEY,CIRCLE_ENTITY_SECRET,CIRCLE_WALLET_SET_ID— Circle DCW server-signed wallets (EVM)
See docs/environment.md for the full reference.
pnpm dev:web # web only (port 3001)
pnpm dev:server # server only (port 3000)
pnpm -F indexer dev # indexer only (port 42069) ┌─────────────────┐
│ Netlify (CDN) │ ← apps/web (static SPA)
│ loar.fun │
└────────┬────────┘
│ HTTPS
┌────────────────────┼────────────────────┐
│ │ │
┌───────▼────────┐ ┌──────▼───────┐ ┌────────▼────────┐
│ loar-server │ │ loar-indexer │ │ Firebase │
│ Railway :3000 │ │ Railway:42069│ │ Firestore │
│ Hono + tRPC │ │ Ponder v0.15 │ │ (data store) │
└───────┬────────┘ └──────┬───────┘ └─────────────────┘
│ │
Storage providers Ethereum RPC
| Service | Deployed To | Trigger |
|---|---|---|
| Web | Netlify | Push to main (Netlify Git integration) |
| Server + Indexer | Railway or VPS (Docker) | Push to main |
| Mobile | Expo (iOS + Android) | eas build / eas submit |
- Connect the repo to Netlify
- Set env vars in the Netlify site dashboard:
VITE_SERVER_URL,VITE_PONDER_URL - Build command/publish directory are set in the Netlify dashboard;
netlify.tomlat the repo root adds SPA rewrites, security headers, and asset caching on top
- Create a Railway project and connect your GitHub repo
- Add two services from the same repo:
- loar-server — root directory:
apps/server(picks uprailway.toml) - loar-indexer — root directory:
apps/indexer(picks uprailway.toml)
- loar-server — root directory:
- Set env vars in each service's Railway dashboard (see deployment docs)
- Add custom domains:
api.loar.fun→ server,idx.loar.fun→ indexer - Update Netlify env vars:
VITE_SERVER_URLandVITE_PONDER_URLto your Railway URLs
# On the VPS:
git clone <repo-url> && cd loar
cp .env.example .env # fill in production values (CORS_ORIGIN = your Netlify URL)
docker compose build
docker compose up -dCI/CD: deploy.yml SSHs to VPS on push to main and runs docker compose build && up -d.
Required GitHub secrets: SSH_HOST, SSH_USER, SSH_PRIVATE_KEY, WORK_DIR.
| Service | Endpoint | Response |
|---|---|---|
| Server | GET /health |
{ status, checks: { firebase }, uptime, env } |
| Indexer | GET /health |
Ponder built-in |
| Document | Description |
|---|---|
| Hackathon Submission | AI Lab: Seed Agents Challenge — demo script, track positioning, submission copy |
| MVP Scope | What's in the MVP, what's deferred, success criteria |
| Roadmap | 3 milestones with concrete deliverables |
| Creator Journey | Step-by-step from wallet connect to revenue |
| IP & Content Policy | Copyright rules, licensing, compliance |
| Monetization Map | How money flows, who pays, what's owned |
| Product Loops | Core loops with status assessment |
| Architecture | System design, auth flow, service connections |
| Trust Model | Contract ownership, admin powers, security model |
| Environment | All env vars, Firebase setup guide |
| API Reference | REST + tRPC + GraphQL endpoints |
| Smart Contracts | Contract guide, ABI generation |
| Database | Firestore + Ponder schema reference |
| Deployment | Docker, CI/CD, manual deploy |
| Agents & MCP | AI agent pipelines, API keys, MCP server |
| AI Model Matrix | Every model, provider, purpose, and call site |
| Model Pricing | Per-model USD cost, fiat / LOAR price, credits — auto-generated (pnpm docs:pricing). Daily drift alerts (pnpm cost:check-drift), weekly staleness audit (pnpm registry:check-staleness), monthly invoice reconciliation (pnpm reconcile:spend). |
| Pricing Integrity — Ops Runbook | Credential setup, IAM roles, alert playbooks, secret rotation. Run pnpm ops:firebase-doctor when ops scripts fail. |
| Troubleshooting | Common issues and fixes |
| GTM Strategy | Go-to-market positioning and phased rollout |
| Analytics Spec | Analytics events and tracking specification |
| Rights Classification UI | Three-lane model, badge system, data migration |
| Moderation & Rights | Content flagging, DMCA, admin review, audit log |
| Worldbuilding Studio | Entity kinds, wiki, create hub |
| Likeness Marketplace | Verified likeness KYC + consent (deferred to V2) |
| Alpha 01: Brand Unification | Brand consistency and UI unification PRD |
| Alpha 02: Revenue Loop | Closing the revenue loop for alpha launch |
| Mobile: Portfolio & Wallet | Mobile portfolio, wallet, and assets PRD |
| Mobile: Consumer Feed | Mobile consumer feed and creation PRD |
| Mobile: Market & Shop | Mobile marketplace and seller PRD |
| Security | Security architecture and threat model |
| Pre-Launch Checklist | Validation checklist before launch |
| Product Analytics (PostHog) | Event catalogue, privacy posture, query recipes |
| VLM Subsystem | Vision-Language Model pipeline spec |
| Gas Abstraction | ERC-4337 paymaster architecture |
| Social Graph | Follow graph + activity feed spec |
| KYC / AML Compliance | KYC/AML posture for creator payouts |
| Tax Reporting | 1099-K and international reporting |
| Mobile Store Submission | App Store + Play Store submission playbook |
| Launch Readiness Scorecard | Canonical "what's left before mainnet" page |
| Mainnet Readiness Session 2026-05-16 | Latest mainnet-readiness sync notes |
| Audit Fix Tracker | All 157 findings across 9 review passes |
| Bug Bounty | Bounty program scope, rewards, and triage |
| Content Provenance | C2PA, lineage refs, AI provenance manifests |
| Disaster Recovery | RPO/RTO targets, restore drills |
| Incident Response | On-call rotation, runbooks, paging |
| Governance Transition | EOA → Safe+Timelock handoff plan |
| Safe + Timelock Runbook | Multi-sig + timelock operations playbook |
| Secrets Rotation | Key rotation schedule (KMS, JWT, provider keys) |
| Scale Readiness (10k) | Capacity plan for 10k concurrent users |
| MEV & Fee Hook | Uniswap v4 hook + MEV considerations |
| External Audit Engagement | Code4rena/Sherlock engagement playbook |
| Tokenomics | $LOAR supply, distribution, vesting, sinks |
| Solana Overview | Solana stack umbrella + 16-program architecture |
| Solana Bridge | Custodial v1 + Wormhole NTT v2 cross-chain $LOAR |
| Solana Mainnet Runbook | Devnet → mainnet-beta launch checklist |
| Solana Parity PRD | 28-week plan to lift Solana to EVM parity |
| Solana Native SDK Glue | 12 native-SDK helpers between Anchor + server |
| Model Metering & BYOK | Reserve/reconcile credits + 4-backend captions |
| Editor v2 (E2–E7) | Dub + lipsync, style pickers, cutdown, drafts |
| Bounties PRD | StoryBounties contract + B3 ContentLicensing flow |
| Agents PRD | TalentAgentRegistry on-chain commission routing |
| Ad Placements PRD | AdSeedEscrow + Seed Dance economic model |
| Pose & Composition Control | Shot templates, control nets, pose guidance |
| Motion Editing | Image-to-video, talking scenes, motion presets |
| MCP Integration PRD | MCP resources surface + agent navigation |
| MCP Publish Runbook | Publishing the MCP server to public registries |
| MCP Hosted SSE Deploy | Hosted SSE deployment for the MCP server |
| Protocol Take Rate | Fee schedule across primary + secondary flows |
| Wikia Feature | Cross-universe encyclopedia spec |
| Universe / Escrow Decision | Per-universe escrow design rationale |
| Route | Description |
|---|---|
/ |
Landing page |
/login |
Wallet authentication |
/dashboard |
User dashboard — universes, AI generation, LP yield, quests, daily check-in, uploads |
/discover |
Explore creators and universes |
| Route | Description |
|---|---|
/cinematicUniverseCreate |
Full universe creation wizard (atomic or two-step) |
/universe/$id |
Universe detail view |
/universe/$id/deploy-token |
Deploy governance token + LP pool for existing universe |
/universe/$id/gen-config |
AI generation configuration |
/universe/$id/gallery |
Universe gallery |
/create |
Create hub (entities, characters, places, etc.) |
/create/$kind |
Per-kind creation form (person, place, thing, faction, event, lore, etc.) |
/play/$universeId |
Narrative gameplay/exploration |
| Route | Description |
|---|---|
/market |
Primary marketplace with stats |
/shop/$universeId |
Universe shop |
/product/$id |
Product detail with ETH buy button |
/checkout |
Purchase checkout |
/pricing |
Credit pricing tiers |
/credits |
Credit balance and purchase |
/sell/ |
Content selling hub |
/sell/new |
Create sale listing |
/sell/earnings |
View earnings |
| Route | Description |
|---|---|
/tokens/ |
Token dashboard |
/tokens/$address |
Token details |
/tokens/creator.$address |
Creator token info |
/tokens/portfolio |
Token portfolio |
/tokens/swap |
Token swap widget |
/staking |
$LOAR staking interface |
/governance/$universeId |
Governance voting (proposals, votes, timelock) |
/treasury/$universeId |
Treasury management |
/analytics/$universeId |
Creator analytics dashboard (views, mints, subs, revenue) |
| Route | Description |
|---|---|
/wiki |
Worldbuilding encyclopedia (tabbed by entity kind) |
/wiki/$kind |
Entity list filtered by kind (person, place, etc.) |
/wiki/entity/$id |
Entity detail page |
/wiki/character/$id |
Character detail page |
/my-works |
View created content |
/upload |
Upload media files |
/sandbox |
Draft workspace |
/videos |
Video gallery |
/gallery |
Image gallery |
/event/$universe/$event |
Event detail within universe |
/episode/$id |
Episode page with "Open in Voice Studio" + "Dub to other languages" CTAs |
| Route | Description |
|---|---|
/lab/voice-studio |
Voice Studio — tabbed UI: library, clone, designer, script editor, captions, multilingual dub |
/settings/api-keys |
BYOK provider keys (FAL, AssemblyAI, Deepgram, Groq, ModelArk, OpenAI, Google, Anthropic) |
/settings/usage |
Per-user generation usage dashboard (model metering, credit spend) |
/settings/wallets |
Wallet management (Circle DCW EVM addresses) |
| Route | Description |
|---|---|
/profile/$username |
User profiles |
/profile/edit |
Edit profile |
/activity |
Activity feed |
/notifications |
Notification center |
/subscriptions |
Manage subscriptions |
/agents/ |
AI agent marketplace |
/agents/$uid |
Agent detail |
/agents/register |
Register new agent |
/agents/dashboard |
Agent dashboard |
/bounties/ |
Bounty hub |
/bounties/$bountyId |
Bounty detail |
/bounties/mine |
My bounties |
| Route | Description |
|---|---|
/licensing/ |
IP licensing hub |
/licensing/new |
Create license agreement |
/collabs/ |
Collaboration hub |
/collabs/new |
Create collaboration |
/ads/ |
Ad management |
/ads/new |
Create ad placement |
/ads/$slotId |
Ad detail + bidding |
/ads/seeds/ |
Seed Dance hub (browse, my seeds, my gigs) |
/ads/seeds/new |
Plant a new ad seed |
/ads/seeds/$seedId |
Seed detail + submit/approve placements |
/canon/$universeId |
Canon marketplace (submit, vote) |
/order/$id |
Order details |
| Route | Description |
|---|---|
/admin/moderation |
Content moderation queue |
/dmca |
DMCA takedown form |
/docs |
Documentation |
/terms |
Terms of service |
/privacy |
Privacy policy |
/faucet |
Testnet token faucet |
/coming-soon |
Coming soon placeholder |
loar/
├── apps/
│ ├── web/ # React 18 SPA (Vite + TanStack Router, 139 routes)
│ ├── server/ # Hono + tRPC API (111+ routers, 900+ procedures)
│ ├── indexer/ # Ponder v0.15 Ethereum indexer (37 tables)
│ ├── contracts/ # Foundry/Solidity EVM (69 contracts, upgradeable, Ethereum Sepolia)
│ ├── programs/ # Anchor Solana programs — universe + episode (devnet)
│ ├── solana-indexer/ # Helius-webhook Solana indexer → Firestore
│ ├── mcp/ # MCP server — AI agent gateway (25+ tools)
│ ├── mcp-gateway/ # Hosted OAuth 2.1 MCP gateway (mcp.loar.fun)
│ └── mobile/ # Expo 52 / React Native (iOS + Android, Circle DCW + Solana SIWS)
├── packages/
│ └── abis/ # Generated wagmi hooks + Anchor IDL types + addresses
├── docs/ # Product + technical documentation (80+ docs)
├── scripts/ # Ops scripts (smoke harness, reattribution, recovery)
├── .env.example # Environment variable template
├── setup.sh # First-time setup script
├── Makefile # Command shortcuts
└── turbo.json # Turbo build config
| Command | Description |
|---|---|
make dev |
Start all services (web + server + indexer) |
make dev-web |
Start web app only (port 3001) |
make dev-server |
Start server only (port 3000) |
make build |
Build all apps |
make test |
Run smart contract tests |
make codegen |
Generate wagmi hooks from ABIs |
pnpm smoke |
Full 7-layer testnet smoke harness (seeded wallets) |
pnpm smoke:voice |
Voice Studio smoke layer (clone → script → dub → captions) |
npx gitnexus analyze |
Re-index the codebase for GitNexus MCP |
MIT