📚 Documentation

All documentation lives in the docs-site/ directory.

Top-level

• Docs Index
• Sidebar Config

Overview

• docs-site/overview/ — high-level protocol, architecture, migrations, glossary, FAQ

Protocol

• docs-site/protocol/ — constitution, governance, multi-chain, L3, SubDAOs, MC, etc.

Tokens

• docs-site/tokens/ — CAST, QUEST, MEDIA, FRAM, GAME, CODE, SponsorToken

Agents

• docs-site/agents/ — Creation, Frame, Game, Pricing, Auction, Curation, Fraud, Sync, UI, Portfolio, Social Automation

Marketplace

• docs-site/marketplace/ — global marketplace, auctions, cross-chain, Solana, sponsor marketplace

L3

• docs-site/l3/ — RollupFactory, L3Bridge, L3 governance, L3 marketplace

SDK

• docs-site/sdk/ — wallet, media, fram, game, code, marketplace, agents, l3, bridge, governance, profile

Admin Dashboard

• docs-site/admin-dashboard/ — audit logs, system health, agent monitoring

Fees & Treasury

• docs-site/fees-and-treasury/ — fees, buybacks, treasury, yield

Frames

• docs-site/frames/ — Farcaster frames, FRAM flows

Integrations

• docs-site/integrations/ — GitHub, Vercel, Netlify, Render, Telegram, Discord, Reddit, X, auth

SEO & Marketing

• docs-site/seo-and-marketing/ — SEO engine, geo engine, sitemap, campaigns

Users & Access

• docs-site/users-and-access/ — roles, permissions, auth, access control

Brain Engine / Workers / Quests / Mints / Reference / Risk

• docs-site/brain-engine/
• docs-site/workers/
• docs-site/quests/
• docs-site/mints/
• docs-site/reference/
• docs-site/risk-and-compliance/

CASTQUEST V3 — Autonomous Creative Economy

First Public Stable Release (V1 + V2 + V3 Unified)

CASTQUEST V3 is a multi-chain, AI‑powered creative protocol that unifies creators, sponsors, agents, and L3 chains into one autonomous economy.

This release merges the full evolution:

• V1 — MEDIA, MC, buybacks, early Farcaster
• V2 — Multi-chain, agents, L3s, Solana, DAO, builders
• V3 — Production‑grade architecture with AI UI/UX, global marketplace, sponsorship economy, autonomous treasury, AI DAO Constitution, and full SDK

---

📚 Documentation

All documentation lives in the docs-site/ directory and follows the CASTQUEST V3 structure.

---

Overview

• Overview Index
• Actors
• Architecture
• Data Model
• Governance Overview
• L3 Overview
• Lifecycle
• Multi-chain Architecture
• Protocol Map
• Roadmap
• Security Model

---

Protocol

• Protocol Index
• Automation Engine
• Buyback Engine
• Core Contracts
• Emergency Controls
• Event Bus
• Execution Engine
• Fee Router
• Governance Engine
• Oracle Integration
• Pause Resume
• Risk Engine
• Treasury
• Upgrade Strategy
• Versioning

---

Tokens

• Tokens Index
• Bridging
• Buyback Loops
• CAST Token
• Emissions
• Fee Tokens
• Liquidity
• Pricing Oracles
• Profile Tokens
• Quest Tokens
• Reward Tokens
• Supply Models
• Vesting

---

Agents

• Agents Index
• Alerting Agents
• Automation Agents
• Backtesting Agents
• Brain Engine Agents
• Governance Agents
• Market Making Agents
• Monitoring Agents
• Risk Agents
• Simulation Agents
• Worker Agents

---

Marketplace

• Marketplace Index
• Auctions
• Bundles
• Buyer Flows
• Creator Profiles
• Curation
• Dispute Resolution
• Fixed Price
• Listings
• Reputation
• Revenue Share
• Royalties
• Settlement

---

Builders

• Builders Index
• Automation Builder
• Cloning Flows
• Collaboration
• Dashboard Builder
• Deployment Flows
• Frame Builder
• Mint Builder
• Quest Builder
• Template Library
• Testing Sandbox
• Versioning
• Worker Builder

---

SDK

• SDK Index
• Admin SDK
• Auth
• CLI Tools
• Events
• Frames SDK
• Mints SDK
• Python Examples
• Quests SDK
• Testing
• TypeScript Examples
• Webhooks
• Workers SDK

---

L3

• L3 Index
• Architecture
• Bridges
• Data Availability
• Gas Model
• Migration
• Monitoring
• Rollup Design
• Security
• Settlement
• Upgrades

---

Integrations

• Integrations Index
• Analytics
• Ethereum
• External Oracles
• Farcaster
• Indexers
• Layer2s
• Notification Systems
• Partner Protocols
• Solana
• Wallets

---

Admin Dashboard

• Admin Dashboard Index
• Alerts
• Audit Logs
• Fee Controls
• Overview Metrics
• Pause Protocol
• Permissions
• Protocol Fees
• Risk Management
• System Status
• Token Management
• TVL and Volume
• User Metrics

---

Fees & Treasury

• Fees & Treasury Index
• Buyback Policies
• Creator Revenue
• Fee Discounts
• Fee Routing
• Fee Types
• Protocol Revenue
• Rebates and Incentives
• Reporting
• Revenue Sharing
• Treasury Accounts

---

Frames

• Frames Index
• Farcaster Integration
• Frame Actions
• Frame Governance
• Frame Imports
• Frame Lifecycle
• Frame Metadata
• Frame Mints
• Frame Quests
• Frame Risk
• Frame Templates
• Frame Types
• Frame Workers

---

Users & Access

• Users & Access Index
• Abuse Prevention
• Access Logs
• Admin Roles
• API Keys
• Builder Roles
• OAuth and SSO
• Permissions Model
• Rate Limits
• Roles
• Session Security
• Viewer Roles

---

Brain Engine

• Brain Engine Index
• Architecture
• Evaluation
• Governance Hooks
• Integration with Frames
• Integration with Workers
• Memory Model
• Playbooks
• Prompt Pipelines
• Safety Rails
• Simulation
• Tooling

---

Workers

• Workers Index
• Worker Failures
• Worker Lifecycle
• Worker Metrics
• Worker Permissions
• Worker Restarts
• Worker Safety
• Worker Sandbox
• Worker Scaling
• Worker Scheduling
• Worker Types

---

Quests

• Quests Index
• Quest Abuse Prevention
• Quest Automation
• Quest Eligibility
• Quest Failures
• Quest Lifecycle
• Quest Metrics
• Quest Rewards
• Quest Templates
• Quest Types
• Quest Verification

---

Mints

• Mints Index
• Mint Automation
• Mint Eligibility
• Mint Failures
• Mint Lifecycle
• Mint Limits
• Mint Metrics
• Mint Pricing
• Mint Recovery
• Mint Templates
• Mint Types

---

Reference

• Reference Index
• API Reference
• Data Schemas
• Deprecation Policy
• Error Codes
• Event Specs
• Glossary
• Migration Guides
• Rate Limits

---

Risk & Compliance

• Risk & Compliance Index
• Anomaly Detection
• Blacklists and Blocklists
• Circuit Breakers
• Incident Response
• Jurisdiction Flags
• KYC AML Integration
• Limits and Thresholds
• Post Mortems
• Risk Categories

---

SEO & Marketing

• SEO & Marketing Index
• Changelogs
• Content Strategy
• Deep Links
• FAQ
• Glossary
• Landing Pages
• Public Docs Structure
• Release Notes
• Tracking and Analytics

---

🚀 Production Beta (Testnet + Mainnet)

CASTQUEST V3 is ready for Production Beta:

Testnet

• Deploy full contract suite
• Validate L3 deployment
• Validate marketplace PR #58
• Validate agent orchestration
• Validate SDK flows
• Validate dashboards

Mainnet

• Same contracts
• Same flows
• Same invariants
• Same architecture

---

🧱 Monorepo Structure

apps/web → Next.js dashboards (user/admin/dev) packages/contracts → Full V3 contract suite packages/sdk → TypeScript SDK packages/agents → AI agents packages/indexer → Indexers bots/* → Farcaster, Reddit, X, Discord, Telegram docs-site/ → Full V3 documentation infra/ → Deployment + orchestration

Code

---

🛠 Dev Quickstart

Install Dependencies

npm install

Web App (Next.js)

npm run dev:web

Docs-site

npm run docs:dev

Social Builder / Protocol Flows

See documentation under:

• Frames — Farcaster frames, FRAM flows
• Agents — Agent orchestration and automation
• Brain Engine — Brain engine architecture and integration
• Quests — Quest automation and lifecycle

---

🌐 Deployment

Testnet (Base Sepolia)

Testnet deploy script to be wired in infra:

npm run orchestrate:v3

Mainnet (Base + L3s)

Mainnet deploy script to be wired in infra:

• Base mainnet deployment
• L3 chains deployment
• Solana integration

Hosting: Vercel / Netlify / Render

---

📎 Links

• Docs: docs-site/
• Dashboards: apps/web/
• Contracts: packages/contracts/
• SDK: packages/sdk/
• Agents: packages/agents/