Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt

Use this file to discover all available pages before exploring further.

The protocol is structured so that on-chain contracts coordinate economic security and off-chain components handle high-throughput compute. The blockchain settles state that must be globally agreed upon - stake, payments, governance. Everything else runs off-chain and references the chain only when it has to.

Three Architectural Layers

The protocol stack has three layers, each with a different responsibility and a different rate of change. The blockchain layer is slow, expensive, and authoritative. The protocol layer is fast and trust-minimised. The node layer is where the actual work happens.

Blockchain Layer

The blockchain layer is the protocol’s source of truth for any state that must be globally agreed and economically secured. Smart contracts deployed on Arbitrum One coordinate stake, settle payments, govern parameters, and define the active set of Orchestrators eligible for work. The contracts are organised around a central Controller that records the deployed address of every other protocol contract. Contracts query the Controller to find each other, which makes upgrades possible without redeploying the entire system. The LPT token contract is deployed on Ethereum mainnet and bridged to Arbitrum One. Protocol contracts read and write the bridged LPT on Arbitrum. The Confluence upgrade (LIP-73) migrated the protocol contracts from Ethereum mainnet to Arbitrum One to reduce transaction costs and increase throughput, while keeping Ethereum’s security guarantees through the rollup. For full contract addresses and source links see .

Protocol Layer

The protocol layer is the set of off-chain coordination protocols that sit between Gateways and Orchestrators. It is what makes the network usable at production volume: every video segment, every AI inference request, every price quote runs through the protocol layer without touching the chain. The protocol layer pairs each off-chain mechanism with a thin on-chain anchor. Discovery happens off-chain, but the addresses Gateways query were registered on-chain. Payment happens off-chain through tickets, but winning tickets settle on-chain. Verification happens off-chain through re-encoding, but slashing happens on-chain. The probabilistic micropayment design is the load-bearing piece. Without it, every transcoded segment would need an on-chain transaction. With it, payments accumulate as off-chain tickets and only winning tickets settle on Arbitrum, keeping per-segment cost bounded while preserving the economic guarantees of on-chain settlement. For the mechanisms in detail see .

Node Layer

The node layer is the software that participants run. The reference implementation is go-livepeer. It is the same binary in every role - the role is selected by command-line flag. A node started with -broadcaster (or -gateway) accepts video streams and AI requests from applications, selects Orchestrators from the on-chain registry, and dispatches jobs with attached payment tickets. A node started with -orchestrator registers on-chain, advertises capabilities, accepts jobs from Gateways, and coordinates GPU workers. A node started with -transcoder connects to an Orchestrator and performs only the video encoding work, allowing GPU capacity to scale independently of the Orchestrator controller. The node layer is what interacts with both other layers. Gateways read the on-chain ServiceRegistry to discover Orchestrators, then talk to those Orchestrators directly through the protocol layer. Orchestrators read on-chain stake and bonding state, accept off-chain jobs, redeem winning tickets back on-chain, and call reward() once per round to claim inflation.

How the Layers Interact

The interaction model is best read as the lifecycle of a single piece of work. A Gateway has a video stream or an AI request. It needs an Orchestrator that can do the work, a way to pay for it, and a way to verify the result. The three layers each play one part. The Gateway begins by reading the on-chain ServiceRegistry to find Orchestrators that have advertised the capability it needs. It then negotiates price directly with one or more candidates over the protocol layer - that negotiation never touches the chain. Once a session is open, jobs flow segment-by-segment, each carrying a probabilistic payment ticket. Most tickets are losing tickets and never settle. A small fraction win and are redeemed by the Orchestrator on-chain through the TicketBroker, releasing accumulated ETH. Once per round, the Orchestrator also calls reward() to claim its share of newly minted LPT, distributed proportionally to bonded stake. For the per-job state machine and per-workload pipeline differences see .

What This Architecture Buys

The layered design reflects three deliberate tradeoffs. The blockchain handles only what must be globally agreed: stake, payments at the redemption boundary, governance, and the active set. Everything else is pushed off-chain, which is what makes the per-segment cost low enough to compete with centralised infrastructure. The protocol layer is the verification surface. Gateways check that returned segments match the input - if they do not, the Gateway stops sending work. Slashing on-chain only intervenes for repeated or provable misbehaviour. Most quality enforcement happens through Gateway selection, which costs the misbehaving Orchestrator future revenue without requiring an on-chain transaction. The node layer is interchangeable. Anyone can implement a compatible Gateway or Orchestrator against the protocol specification. go-livepeer is the reference implementation, but the protocol does not require it - what defines a compliant participant is correct interaction with the on-chain contracts and the off-chain protocol mechanisms.

Protocol Design

Why the protocol is structured this way and the design decisions behind it.

Core Mechanisms

Rounds, staking, rewards, payments, slashing, and upgrades in detail.

Protocol Actors

Orchestrators, Gateways, Delegators, and how their incentives align.

Blockchain Contracts

Full contract reference with deployed addresses and source links.

Governance and Treasury

LIPs, on-chain voting, and the protocol treasury.

Livepeer Token

LPT token economics, inflation, and bridging.
Last modified on May 4, 2026