Liquid Staking on Tangle Network

Introduction

Liquid staking on Tangle allows users to participate in staking while still maintaining liquidity of their staked assets. This mechanism is implemented via delegation pools, enabling participants to stake their tokens in a pool, earn rewards, and retain the ability to unbond or transfer staked assets without waiting for the traditional staking lock-up periods.

Key Components of Liquid Staking

1. Pools and Roles

• Pools: The fundamental unit of liquid staking on Tangle. Pools are managed by specific roles:
• Root: The administrator who has full control over the pool and can update roles.
• Nominator: An account responsible for nominating validators on behalf of the pool.
• Bouncer: An account that can change the state of the pool (eg. open or close it, limiting whether new users can join the pool).
• Depositor: The user who creates the pool and deposits the initial bond.

2. Bonding and Staking

• Users can bond their assets to a pool using the join function, effectively staking their tokens in exchange for pool rewards. The bond amount is transferred to the pool's account increasing the pool's total bond and the user receives pool tokens (LST) in return.
• Additional funds can be bonded using the bond_extra function. This allows users to add more tokens to their existing stake, either from free balance or pending rewards.

3. Unbonding

• Users can unbond their staked tokens with the unbond function, which allows them to withdraw up to a specified amount of their staked assets. When unbonding, users submit their LST tokens, which are then burned. The system ensures that the initial deposit plus any rewards are automatically collected and returned during the withdraw unbonding process.
• Permissionless unbonding: Under specific conditions, such as when a pool is blocked or destroying, users can unbond their tokens permissionlessly.

4. Withdrawals

• Withdraw Unbonded: Once tokens are unbonded, users can withdraw their funds using the withdraw_unbonded function. This function can also be used permissionlessly if certain conditions are met (e.g., the pool is destroying, or the caller is the depositor and the only member left).

5. Pool Management

• Create Pools: Users can create new delegation pools with the create function. A pool requires an initial deposit, and the creator can set the roles for root, nominator, and bouncer. Pools can also be created with a previously used pool ID using the create_with_pool_id function.
• Pool State Management: The state of a pool can be modified using the set_state function. Pools can have various states, such as open, blocked, or destroying. Once a pool enters the destroying state, it cannot change its state again.

6. Rewards and Commission

• Commission: Pools can set a commission percentage using the set_commission function. This determines the amount of rewards that are paid to the pool's commission account from the total rewards.
• Claiming Commission: Pending commission can be claimed using the claim_commission function, which adds the claimed amount to the total claimed commission and resets pending commission to zero.
• Maximum Commission: The maximum allowable commission can be set with the set_commission_max function, ensuring that future commissions are bound by this limit.
• Commission Change Rate: The rate at which commission changes can be controlled using the set_commission_change_rate function.

7. Adjusting Pool Deposits

• Pools must maintain an existential deposit (ED) in the reward account to ensure proper functionality. The adjust_pool_deposit function allows users to either top up the deficit or withdraw any excess deposit from the pool.

8. Claim Permissions

• The ability to claim pending commission is controlled by the set_commission_claim_permission function, which determines who can claim the pool's pending commission. This allows the pool owner to delegate the commission claim to a different account.

What is commission change rate?

The maximum rate increase allowed for a single commission update. Note that once set, the pool admin can only lower it. When setting the Change Rate, it will also be possible to set a minDelay quantified as the number of blocks (since last commission update) after which it is possible to change the commission (i.e. the minimum delay between commission updates). Note that once set, the pool admin can only increase it.

Max Commission and Change Rate must not be necessarily set. It is the choice of the pool admin to set those parameters and provide transparency to the pool members about the pool's commission policy.