Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.berachain.com/llms.txt

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

Liquid Staking Token (LST) issuers can plug their staked-LST product into the Berachain Proof of Liquidity (PoL) Incentive Auction. Once an LSTStakerVault and its adapter are registered on BGTIncentiveFeeCollector, the vault automatically receives a pro-rata share of every WBERA payment auction buyers make against redirected Reward Vault incentive tokens. This page is the integrator-facing guide. For the auction mechanics from the protocol side, see Incentive Marketplace — Incentive fee settlement.

​
What registration enables

When a buyer settles redirected incentive tokens through BGTIncentiveFeeCollector, the WBERA they pay is split pro-rata, by WBERA-denominated total assets, across:
  • The shared WBERAStakerVault (sWBERA stakers).
  • Every registered LSTStakerVault whose LST has an adapter that converts WBERA into the underlying LST.
A registered LST vault therefore accrues two sources of return for its stakers: the LST’s own underlying yield, plus a continuous share of PoL incentive-auction WBERA proportional to its total stake value. Stakers of a registered LST do not need to interact with PoL directly. As long as the vault and adapter are registered, the WBERA flows in automatically on every auction settlement.

​
How auction yield reaches an LST vault

  1. Reward Vaults transfer redirected incentive tokens (incentives not paid as validator commission) into BGTIncentiveFeeCollector.
  2. An auction buyer calls claimFees(recipient, feeTokens) and pays WBERA into the collector.
  3. The collector splits the paid WBERA pro-rata across the sWBERA Staking Vault and registered LSTStakerVaults, sized by each vault’s WBERA-denominated total assets.
  4. For each registered LST vault, the collector calls the vault’s registered adapter to convert that WBERA share into the vault’s underlying LST, then credits the LST to the vault through receiveRewards.
  5. The vault’s per-share value rises; its stakers earn the increment without taking any action.
The split is recomputed on every settlement, so vaults that grow attract a larger share of subsequent WBERA flows.

​
Currently registered LSTs

The first registered LST is iBERA from Infrared. Its staked version, siBERA, accrues both the underlying iBERA yield and its pro-rata share of PoL incentive-auction WBERA via the registered LST adapter. Additional LSTs can be registered through the steps below.

​
Integration steps for LST issuers

The integration is two contract deployments and one registry write. Coordinate with governance for the registry call.

​
1. Deploy your LST vault system

Deploy the LSTStakerVault system via LSTStakerVaultFactory. The factory produces:
  • An LSTStakerVault ERC-4626-style vault that accepts your LST as the asset.
  • The supporting contracts for withdrawal accounting and reward receipt.
The vault must implement receiveRewards so that the collector can credit converted LST balances during auction settlement.

​
2. Deploy an LST adapter

The adapter is the contract that converts WBERA into your underlying LST during auction settlement. It must:
  • Accept WBERA from BGTIncentiveFeeCollector.
  • Convert that WBERA into the LST (through your protocol’s mint, swap, or wrap path).
  • Hand the resulting LST to the registered LSTStakerVault via receiveRewards.
Adapter design is LST-specific. Refer to the iBERA adapter for a working pattern.

​
3. Register the vault and adapter with governance

Submit a governance proposal to call addLstStakerVault on BGTIncentiveFeeCollector, supplying:
  • The deployed LSTStakerVault address.
  • The deployed adapter address.
Once the registry write lands, the collector includes the new vault in every subsequent pro-rata split. The vault begins accruing WBERA-sourced LST yield on the next auction settlement. See Deployed contract addresses for the live BGTIncentiveFeeCollector and LSTStakerVaultFactory addresses on each network.

​
Operational notes

  • Vault total assets must be denominated comparably to WBERA. The collector sizes each vault’s share by its WBERA-denominated total assets; an adapter that misreports the underlying value will distort the split for every other registered vault.
  • No staking-pool LSTs. Staking pool shares (stBERA) are not LSTs and cannot be registered through this path; they have their own yield mechanics. See Staking Pools Overview.

​
See also