Livepeer uses both its native token - LPT, and Ethereum (ETH) to power its network and compensate actors for their contributions. The Livepeer protocol uses a dynamic inflation rate and stake-for-access model to ensure the network’s security and functionality. We’ll cover the LPT tokenomics and why delegating to orchestrators remains important even as inflation tapers off.Documentation Index
Fetch the complete documentation index at: https://na-36-docs-v2.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Money Flow: LPT Token Economics
1. Staking Flow (Delegators → Orchestrators)
Step 1: Token Approval Before bonding, delegators must approve the BondingManager to transfer their LPT tokens. Step 2: Bonding Delegators callBond(amount, orchestratorAddress) which:
- Transfers LPT from delegator to BondingManager
- Updates orchestrator’s delegated stake
- Calculates pool position hints for gas optimisation
- Updates the transcoder pool sorted by stake
- First bond LPT to itself
- Call
Transcoder(rewardCut, feeShare)with commission parameters - Register service URI via
SetServiceURI()
2. Reward Flow (Minter → Orchestrators → Delegators)
Each round, active orchestrators can callReward() to mint inflationary tokens:
Reward Calculation Process:
- Orchestrator calls
Reward()on BondingManager - BondingManager queries
CurrentMintableTokens()from Minter - Minter calculates:
mintable = inflation * totalSupply / bonded - Reward distributed proportionally to orchestrator’s stake
- Orchestrator keeps their commission (rewardCut)
- Remaining rewards distributed to delegators proportionally
ClaimEarnings(endRound) to realize their accumulated rewards and fees from past rounds.
3. Payment Flow (Broadcasters → Orchestrators)
The payment system uses probabilistic micropayments to minimise on-chain transactions: Step 1: Broadcaster Deposits Broadcasters fund their account viaFundDepositAndReserve():
- Deposit: Locked collateral (can’t be used immediately)
- Reserve: Available pool for ticket redemptions 14
- Broadcaster creates a signed ticket with faceValue and winProb
- Ticket sent off-chain to orchestrator via HTTP headers
- Most tickets don’t win (e.g., 1% win probability)
- Checks signature and expiration
- Calculates if ticket wins using
recipientRand - Winning tickets queued in local database
- Tracks sender’s MaxFloat (reserve - pending redemptions)
- Orchestrator calls
RedeemWinningTicket(ticket, sig, recipientRand) - TicketBroker validates ticket against on-chain state
- Transfers
faceValuefrom broadcaster’s reserve to orchestrator - Updates
claimedReservein BondingManager
4. Fee Flow (Broadcasters → Orchestrators → Delegators)
Orchestrators earn fees from ticket redemptions:- Fees accumulate in orchestrator’s earnings pool
- Orchestrator keeps their commission (feeShare)
- Remaining fees distributed to delegators
- Delegators claim via
ClaimEarnings()
5. Withdrawal Flows
Unstaking (Delegators):- Call
Unbond(amount)- creates unbonding lock - Wait
UnbondingPeriodrounds (typically 7 rounds) - Call
WithdrawStake(unbondingLockId)- receive LPT back
- Call
Unlock()on TicketBroker - Wait unlock period
- Call
Withdraw()- receive remaining deposit + reserve
Client Integration
The go-livepeer client abstracts all contract interactions through theLivepeerEthClient interface: 15
Contract Address Resolution:
All contract addresses are dynamically discovered through the Controller registry using Keccak256 hashes of contract names. This enables contract upgrades without changing client code. 16
Gas Optimisation Strategies
1. Pool Hints
When bonding or calling reward, the client calculates “hints” (previous/next positions in the sorted transcoder pool) to enable O(1) insertions instead of O(n) searches on-chain. 172. Batch Operations
Multiple tickets can be created off-chain in batches, with only winning tickets requiring on-chain transactions.3. Dynamic Gas Pricing
The client implements sophisticated gas price management, using 2x base fee with user-specified ceilings to balance confirmation speed and cost. 18Summary: Complete Money Flow
- Token holders approve and bond LPT → BondingManager (staking)
- Minter mints new LPT → BondingManager → Orchestrators (inflation rewards)
- Orchestrators distribute rewards → Delegators (minus commission)
- Broadcasters deposit LPT → TicketBroker (payment reserves)
- Orchestrators redeem tickets → receive LPT from TicketBroker (fees)
- Orchestrators distribute fees → Delegators (minus commission)
- Delegators claim earnings from BondingManager (accumulated rewards + fees)
- Staking secures the network and earns inflation rewards
- Active orchestrators earn fees from broadcasters
- Delegators participate in rewards without running infrastructure
- Probabilistic payments enable cost-efficient micropayments
- All flows tracked on-chain with minimal gas overhead
Notes
- The contracts are deployed on Ethereum mainnet (and Arbitrum for L2)
- Contract addresses are stored in the Controller registry for upgradeability
- All token operations use standard ERC20 approval patterns
- The system supports both L1 and L2 deployments with backward compatibility
- Round-based operations ensure coordinated protocol upgrades and state transitions
- The probabilistic payment system reduces on-chain transactions by ~99% while maintaining fair expected value for all parties