Skip to content
EcosystemNetworkPublic

About

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,456 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LOAR: Narrative Control Suite

LOAR Banner

Create AI-powered cinematic universes. Own them on-chain. Monetize them.

License: MIT pnpm 9.15.0 Node 18+ Ethereum Sepolia Target: Ethereum Mainnet Solana: live on devnet $LOAR on pump.fun

Website · $LOAR token · Telegram · X / Twitter

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.


Links & Community

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


What is LOAR?

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)

Hybrid Architecture — What's On-Chain vs Off-Chain

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.

AI Models

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.

Video (~32 model IDs)

Family Variants Provider Tier
Veo 3.1 full / lite / std × t2v / i2v (6 IDs) Google 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

Image (~17 model IDs)

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

Audio

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)

3D

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

Language models / agents

Family IDs Provider Purpose
Gemini 2.5 2.5 Pro, 2.5 Flash Google 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

Honest Feature Status

We classify every feature by what actually works end-to-end today, not what has backend code or UI shells.

LIVE (Working end-to-end)

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

PARTIAL (Working but with gaps)

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

PLANNED (Not implemented)

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

Architecture

                 ┌─────────────────────────────────────────────────┐
                 │                    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.

Key Flows

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)


Smart Contracts (Sepolia)

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.

Core Protocol

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.

Additional 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

Revenue Infrastructure (UUPS Proxies)

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

NFT Beacons & Factory

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)

Upgradeability

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

🛣️ Multi-chain status — Solana live, Base not yet

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 (mint 2xowaGYFTMtBfvjqw6jnEgxyrpouzmcE9A7uarZdpTYb) — a standalone bonding-curve launch, not wired into the protocol.

Solana — live on devnet

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 — not currently active

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.

How to Run Locally

Prerequisites

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

Quick Start

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)

Environment

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 payments
  • LOAR_TOKEN_ADDRESS — $LOAR ERC-20 contract address
  • RPC_URL — Sepolia RPC for on-chain payment verification

Optional (server starts without these):

  • FAL_KEY — AI generation (image/video) + FAL Whisper captions
  • GOOGLE_API_KEY — Gemini wiki generation + VLM subsystem
  • OPENAI_API_KEY — GPT-4o-mini storyline generation
  • BYTEDANCE_API_KEY — ModelArk: Seedance/Seedream/Seed/OmniHuman
  • ZAI_API_KEY — Z.AI: GLM chat/vision, CogView image, CogVideoX video, GLM-ASR
  • MESHY_API_KEY — Meshy 3D + humanoid auto-rig + animation library
  • TRIPO_API_KEY — Tripo3D non-humanoid auto-rig (quadruped, avian, aquatic, etc.)
  • ELEVENLABS_API_KEY — Voice cloning, TTS, dubbing
  • ASSEMBLYAI_API_KEY / DEEPGRAM_API_KEY / GROQ_API_KEY — Alternate caption backends
  • PROVIDER_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 analytics
  • WEBHOOK_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.

Individual Services

pnpm dev:web           # web only (port 3001)
pnpm dev:server        # server only (port 3000)
pnpm -F indexer dev    # indexer only (port 42069)

How to Deploy

Architecture

                    ┌─────────────────┐
                    │  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

Web → Netlify

  1. Connect the repo to Netlify
  2. Set env vars in the Netlify site dashboard: VITE_SERVER_URL, VITE_PONDER_URL
  3. Build command/publish directory are set in the Netlify dashboard; netlify.toml at the repo root adds SPA rewrites, security headers, and asset caching on top

Server + Indexer → Railway (recommended)

  1. Create a Railway project and connect your GitHub repo
  2. Add two services from the same repo:
    • loar-server — root directory: apps/server (picks up railway.toml)
    • loar-indexer — root directory: apps/indexer (picks up railway.toml)
  3. Set env vars in each service's Railway dashboard (see deployment docs)
  4. Add custom domains: api.loar.fun → server, idx.loar.fun → indexer
  5. Update Netlify env vars: VITE_SERVER_URL and VITE_PONDER_URL to your Railway URLs

Server + Indexer → VPS (Docker, alternative)

# 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 -d

CI/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.

Health Checks

Service Endpoint Response
Server GET /health { status, checks: { firebase }, uptime, env }
Indexer GET /health Ponder built-in

Documentation

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

Web App Routes (65 pages)

Core

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

Universe & Creation

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

Marketplace & Commerce

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

Tokens & DeFi

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)

Content & Wiki

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

Voice Studio & Settings

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)

Social & Community

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

Revenue & Licensing

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

Admin & Legal

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

Project Structure

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

Common Commands

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

License

MIT


About

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages