For Developers
Development Details
Binance Liquid Staking

BNB staking mechanics

BNB Liquid Staking lets the user stake their funds through the corresponding smart contracts on the Binance network, accumulate rewards, and receive their stake and rewards when unstaking.

The following section explains staking requirements, fees, rewards, validators, smart contracts and function calls to interact with these smart contracts.

Requirements

The requirements when staking are:

  • Minimum value to stake — 0.1 BNB.

  • Maximum value to stake — unlimited, at the user’s discretion.

The requirements when classic-unstaking are:

  • Minimum value to unstake — 0.1 BNB.
  • Maximum value to unstake — up to the initial stake for ankrBNB.
  • Unbond time (before user gets their unstaked funds) — 7–15 days.
  • Splitting large unstaked amounts between several unbond times due to limited nodes capacities.

The requirements when flash-unstaking are:

  • Minimum value to unstake — 0.1 BNB.
  • Maximum value to unstake — up to the flash ustake pool capacity.
  • Unbond time (before user gets their unstaked funds) — no unbond time, instant release of funds to the user.

Fees

  • Ankr takes a 10% technical service fee from the staking reward.
  • Ankr takes a 0.05% flash-unstake fee from the unstaked amount when the user flash-unstakes.

The user must also count in the gas price for outgoing transactions.

Rewards

Validators receive rewards every day, at midnight, UTC.

The APY is calculated from the validators' rewards.

The rewards the user gets are calculated using the exchange ratio explained later in this document.

To understand BNB Liquid Staking, you need to know the entities and understand the workflow under the hood.

The following entities are involved:

  • Smart contracts
  • Ankr addresses
  • Ankr validators

Smart contracts

Smart contracts and addresses involved in BNB Liquid Staking are:

Validators

Staking workflow

  1. User sends a request to the BNBStakingPool::stakeCerts({value:stake}) on BNB Chain. stake specifies the staked amount and should meet the requirements described above. BNBStakingPool verifies the request checking the _minimumStake and mints ankrBNB in the amount defined by the current exchange ratio, and then issues a Staked() event with the staker, amount (staked amount), shares (issued ankrBNB), false (because ankrBNB is a reward-bearing token) parameters.
  2. BNBStakingPool accumulates minimum 100 BNB and then sends the accumulated amount via BNBStakingPool:delegate(validator, amount) to an address of one of the validators from the Ankr set.

Exchange ratio

When staking, the user receives:

  • ankrBNB in the amount calculated the following way: user's_stake * exchange_ratio.

When unstaking, the user receives their_stake + accumulated_rewards in BNB. It is calculated by the following formula: accumulated_amount_ankrBNB / exchange ratio.

The exchange ratio is calculated by the following formula:

uint256 totalShares = totalSharesSupply(); == ankrBNB.totalSupply();
uint256 denominator = _totalStaked + totalRewards - _totalUnbondedBonds;
_ratio = (totalShares * 1e18) / denominator;

Unstaking workflow

Classic unstake

  1. User sends a request to the BNBStakingPool::unstakeCerts(shares) on BNB Chain. shares specifies the amount to unstake. You can also unstake to an arbitrarily chosen address via BNBStakingPool::unstakeCertsFor(receiverAddress, shares). BNBStakingPool verifies the request checking the _minimumUnstake and balance_of_user, to transfer ankrBNB from user to the aBNBb smart contract address (input amount) then aBNBb::burn() executes to decrease total supply of tokens, and then issues a Unstaked() event with the ownerAddress (message sender), receiverAddress (user address for receiving unstaked funds and rewards), amount (amount of BNBs to be send to the user), shares (amount of ankrBNB to unstake), false (because ankrBNB is a reward-bearing token) parameters.
  2. BNB backend service waits until _pendingTotalUnstakes reaches minimum 100 BNB at BNBStakingPool, then calls BNBStakingPool:undelegate{value: relayerFee}(validator, amount).
  3. After the UnbondTime, BNBStakingPool gets the rewards via Staking:claimUndelegated() and distributes unstaked funds and rewards to the users.

Additional information

Additional details To get more information about staking on Binance, read Staking (opens in a new tab), Delegating (opens in a new tab), and Binance cross-chain transfer (opens in a new tab).

To get more information about unstaking on Binance, read Unbond (opens in a new tab) and Binance cross-chain transfer (opens in a new tab).