livepeer · its-DeFine · May 3, 2026 · May 4, 2026 · May 4, 2026 · May 4, 2026
diff --git a/.mintignore b/.mintignore
@@ -68,6 +68,11 @@ _workspace
 /tools/_workspace/**
 
 # V2 draft / scratch / context-only content / deprecated
+/v2/developers2/**
+/v2/about/network2/**
+/v2/about/protocol2/**
+/v2/about/concepts/unclassified/**
+/v2/**/x-*.mdx
 /v2/**/x-archived/**
 /v2/**/x-deprecated/**
 /v2/**/x-experimental/**

diff --git a/docs.json b/docs.json
diff --git a/jsconfig.json b/jsconfig.json
@@ -9,137 +9,3 @@
   "include": ["snippets/**/*.jsx", "v2/**/*.mdx"],
   "exclude": ["node_modules", "tools", "v1"]
 }
-
-/v2/developers
-│
-├── Concepts (4)
-│   ├── overview                                    [retained]
-│   ├── mental-model                                [new — supersedes oss-stack]
-│   ├── architecture                                [new]
-│   └── integrations                                [new]
-│
-├── Get Started (4)
-│   ├── setup-paths                                 [retained]
-│   ├── video-on-livepeer                           [moved from v2 Concepts, rewrite]
-│   ├── ai-on-livepeer                              [moved from v2 Concepts, rewrite]
-│   └── agents-on-livepeer                          [moved from v2 Concepts, rewrite]
-│
-├── Build (8 subgroups)
-│   │
-│   ├── Video (7)
-│   │   ├── ingest-and-playback                     [retained]
-│   │   ├── gpu-transcoding                         [retained]
-│   │   ├── codec-support                           [new]
-│   │   ├── transcoding-quickstart                  [moved from v2 Get Started]
-│   │   ├── storage-and-archival                    [moved from v2 Guides]
-│   │   ├── live-events                             [moved from v2 Guides]
-│   │   └── vod-workflows                           [moved from v2 Guides]
-│   │
-│   ├── AI (11)
-│   │   ├── ai-quickstart                           [moved from v2 Get Started]
-│   │   ├── ai-orchestration                        [retained]
-│   │   ├── realtime-quickstart                     [moved from v2 Get Started]
-│   │   ├── byoc-architecture                       [moved from v2 Concepts]
-│   │   ├── byoc-quickstart                         [moved from v2 Get Started]
-│   │   ├── byoc-production                         [new]
-│   │   ├── comfystream-platform                    [retained]
-│   │   ├── comfystream-authoring                   [retained]
-│   │   ├── comfyui-stream-pack                     [retained]
-│   │   ├── pytrickle                               [retained]
-│   │   └── ai-pipelines                            [retained]
-│   │
-│   ├── Agents (4)
-│   │   ├── agent-quickstart                        [moved from v2 Get Started]
-│   │   ├── agent-sdk                               [new]
-│   │   ├── reference-agents                        [new]
-│   │   └── eliza-integration                       [new]
-│   │
-│   ├── Applications (8)
-│   │   ├── running-a-gateway                       [moved from v2 Concepts]
-│   │   ├── local-gateway                           [new]
-│   │   ├── custody-and-signing                     [moved from v2 Concepts]
-│   │   ├── pymthouse-and-oidc                      [moved from v2 Guides]
-│   │   ├── gateway-for-app-developers              [new]
-│   │   ├── data-and-observability                  [moved from v2 Concepts]
-│   │   ├── settlement-observability                [new]
-│   │   └── prometheus-scrape                       [new]
-│   │
-│   ├── Protocol & Local Development (9)
-│   │   ├── trickle-protocol                        [moved from v2 Concepts]
-│   │   ├── payment-modes                           [moved from v2 Concepts]
-│   │   ├── off-chain-discovery                     [moved from v2 Concepts]
-│   │   ├── python-gateway                          [retained]
-│   │   ├── lpms-integration                        [new]
-│   │   ├── self-host-quickstart                    [moved from v2 Get Started]
-│   │   ├── livepeer-in-a-box                       [moved from v2 Guides]
-│   │   ├── contributor-quickstart                  [moved from v2 Get Started]
-│   │   └── recurring-jobs                          [moved from v2 Guides]
-│   │
-│   ├── Front End Primitives (4)
-│   │   ├── react-player                            [rewrite]
-│   │   ├── react-broadcast                         [rewrite]
-│   │   ├── core-web                                [new]
-│   │   └── creative-kit-ui                         [new]
-│   │
-│   ├── Beta Platforms (3)
-│   │   ├── daydream-platform                       [new]
-│   │   ├── streamplace-platform                    [new]
-│   │   └── frameworks-platform                     [new]
-│   │
-│   └── Tutorials (4 — per spec)
-│       ├── build-an-ai-agent-on-livepeer           [retained — guides/tutorials/]
-│       ├── ipfs-video-integration                  [retained — guides/tutorials/]
-│       ├── token-gated-video                       [retained — guides/tutorials/]
-│       └── comfystream-quickstart                  [retained — get-started/, surfaced here per spec]
-│
-├── Guides (2 — trimmed)
-│   ├── signing-keys                                [retained — identity/]
-│   └── identity-overview                           [retained — identity/]
-│
-├── Reference (unchanged from v2)
-│   ├── APIs
-│   │   ├── ai-gateway
-│   │   ├── trickle
-│   │   ├── byoc
-│   │   └── go-livepeer-http
-│   ├── SDKs
-│   │   ├── livepeer-ai-js                          [@livepeer/ai]
-│   │   ├── livepeer-ai-python
-│   │   ├── livepeer-ai-go
-│   │   ├── ui-kit                                  [@livepeer/react family]
-│   │   └── byoc-sdk                                [@muxionlabs/byoc-sdk]
-│   ├── Protocol
-│   │   ├── contracts                               [LINKS to /v2/about/resources/reference/livepeer-contract-addresses]
-│   │   ├── subgraph-schema
-│   │   ├── lips
-│   │   └── arbitrum-bridge
-│   └── Ecosystem (community)
-│       ├── ad-astra-video
-│       ├── stronk-tech
-│       ├── muxionlabs
-│       ├── titan-node
-│       ├── eliteprox
-│       ├── cloud-spe
-│       ├── liveinfra-spe
-│       ├── gwid-spe
-│       └── govworks-spe
-│
-└── Contributing (unchanged from v2)
-    ├── overview
-    ├── how-to-help
-    ├── grants-and-spes
-    │   ├── spe-path
-    │   ├── community-developer-contract
-    │   ├── active-spes
-    │   ├── completed-spes
-    │   └── pre-proposal-spes
-    └── per-repo
-        ├── go-livepeer
-        ├── ai-runner                               [folds ai-worker]
-        ├── protocol
-        ├── comfystream
-        ├── ui-kit
-        ├── subgraph-and-explorer
-        ├── livepeer-data
-        ├── docs
-        └── livepeer-in-a-box
diff --git a/v2/about/concepts/about-livepeer.mdx b/v2/about/concepts/about-livepeer.mdx
@@ -6,6 +6,7 @@ lifecycleStage: discover
 complexity: beginner
 pageType: concept
 audience: community
+status: current
 lastVerified: 2026-03-17T00:00:00.000Z
 purpose: explain
 keywords:
@@ -48,10 +49,10 @@ The <span style={{color: "white"}}>**Livepeer Protocol**</span> and <span style=
   **Key themes**
 
   - **DePIN overview:** Blockchain networks coordinate idle physical resources for open global access.
-  - **Livepeer focus:** Livepeer offers video infrastructure at 10x lower cost than centralised providers.
-  - **Market stats:** Video streaming is a $250 billion market; Livepeer handles 3 million+ video minutes weekly.
-  - **Token model:** Staking yields about 40% annual returns; inflationary rewards foster competition.
-  - **AI expansion:** Plans to add generative AI workloads could increase usage 10x to 100x.
+  - **Livepeer focus:** Livepeer coordinates open video and AI infrastructure through a decentralised operator marketplace.
+  - **Market context:** Video and AI media workloads are large, compute-heavy markets where open infrastructure can reduce vendor lock-in.
+  - **Token model:** Staking rewards are variable; inflationary rewards and usage fees incentivise network participation.
+  - **AI expansion:** Generative and real-time AI workloads expand the kinds of compute that can route through the network.
   - **Market efficiency:** Millions of idle GPUs enable efficient decentralised resource use.
 
   **DePIN definition and market context** *(00:00)*
@@ -64,23 +65,23 @@ The <span style={{color: "white"}}>**Livepeer Protocol**</span> and <span style=
 
   Livepeer aims to be the leading open video infrastructure, backed by nearly eight years of development.
 
-  - Offers up to 10x cost savings and better scalability than centralised clouds.
-  - Targets the $250 billion video market through decentralised networks and developer-friendly SaaS APIs.
-  - Processes over 3 million unique video minutes weekly, gaining industry credibility.
+  - Aims to reduce infrastructure costs and vendor lock-in through an open operator marketplace.
+  - Targets video and AI media workloads through decentralised networks and developer-friendly APIs.
+  - Has supported production video workloads and continues expanding into AI media workloads.
 
   **Token economics and network incentives** *(15:35)*
 
   Livepeer's work token model incentivizes GPU operators to stake and earn fees plus inflationary rewards.
 
-  - Stakers earn about 40% annual returns; the protocol targets 50% token staking to maintain network health.
+  - Staker returns vary with inflation, active stake, orchestrator reward cuts, fee share, and reward-call reliability; the protocol target bonding rate is 50%.
   - Inflation adjusts dynamically to encourage optimal staking levels.
   - Inflationary rewards enable lower prices than traditional clouds, fostering competition.
 
   **AI and generative video expansion** *(22:33)*
 
   Livepeer plans to support generative AI video workloads, which are highly compute-intensive.
 
-  - AI integration could increase network usage 10x to 100x.
+  - AI integration adds new demand categories for GPU-backed media compute.
   - NVIDIA's rapid data centre growth highlights huge compute demand and chip shortages.
 
   **Supply-side dynamics and market efficiency** *(28:18)*
@@ -323,7 +324,7 @@ While **_the Livepeer Protocol and Network have evolved significantly since the
 
     <Update label="Confluence" description="2022" tags={["V3", "Arbitrum L2"]}>
     - Core protocol contracts migrated from Ethereum mainnet to Arbitrum One.
-    - The migration reduced gas costs roughly 100x while inheriting Ethereum security through the rollup.
+    - The migration reduced protocol transaction costs while inheriting Ethereum security through the rollup.
     </Update>
 
     <Update label="Cascade" description="2024" tags={["V4", "AI Workloads"]}>
@@ -337,7 +338,7 @@ While **_the Livepeer Protocol and Network have evolved significantly since the
     Industry-standard low latency optimised for real-time video AI and media, enabling sub-second inference and proven scalability.
     </DisplayCard>
     <DisplayCard title="Cost Efficiency" icon="piggy-bank">
-    Access to GPU compute at 5–10x lower cost through an open marketplace with transparent on-chain economics and a pay-per-use model.
+    Access to GPU compute through an open marketplace with transparent on-chain economics and a pay-per-use model.
     </DisplayCard>
     <DisplayCard title="Automagic Scalability" icon="arrows-maximize">
     Scale capacity up or down dynamically in real-time via an elastic network supply, smart routing, and incentivised idle GPU utilisation.
@@ -491,6 +492,6 @@ The Livepeer Network is implemented by <LinkArrow label="go-livepeer" href="http
 
 **Network Pages**
 <Columns cols={2} gap="2rem" style={{ margin: "2rem 0" }}>
-    <Card href="/v2/about/network/actors" title={<CustomCardTitle icon="circle-nodes" title="Network Actors" />} horizontal arrow> A detailed overview of the core actors and participants enabling the Livepeer Network. </Card>
-    <Card href="/v2/about/network/marketplace" title={<CustomCardTitle icon="play" title="Livepeer Marketplace" />} horizontal arrow> How the Livepeer Network functions as a service marketplace to facilitates the exchange of compute resources. </Card>
+    <Card href="/v2/about/concepts/actors-and-capabilities" title={<CustomCardTitle icon="circle-nodes" title="Network Actors" />} horizontal arrow> A detailed overview of the core actors and participants enabling the Livepeer Network. </Card>
+    <Card href="/v2/about/network/marketplace-model" title={<CustomCardTitle icon="play" title="Livepeer Marketplace" />} horizontal arrow> How the Livepeer Network functions as a service marketplace to facilitates the exchange of compute resources. </Card>
 </Columns>