[CHECKLIST] 💧Liquid staking

[drewstone]

Overview

We want to integrate a liquid staking UI similar to Bifrost's https://bifrost.app/vstaking. This UI should allow users to specify an amount of tokens to liquid stake and optionally select the validator on the respective chain for nomination/delegated staking. The chains in question are Polkadot, Phala, Moonbeam, Astar, Manta, and ideally Tangle (de-facto liquid restaking token).

Vocab

• Liquid staking/staked token (LST) is a token that represents some underlying staked token like DOT. An LST tgDOT represents a staked DOT. The core principle is that the underlying DOT is generating yield.
• LST Parachain is where liquid staking occurs. Assets likely (initially until future integrations) need to be bridged into this chain to be staked. This is where LSTs will be unstaked.
• Target Chain is the chain where the asset that generates an LST originates from.

Checklist: High-level, pages, UI & functionality

• Designs: [TASK] Liquid Restaking UI webb-experiences#272
• [FEAT] Liquid staking overview page (UI only) #2328
• [FEAT] Stake card to mint VTokens (ie. from DOT to tgDOT) #2333
• [FEAT] Unstake card to redeem VTokens (ie. from tgDOT back to DOT) #2336
• [FEAT] Validator selection UI & logic for LST #2334
• [TASK] Fetch or calculate APY to display in the overview page #2381
• [FEAT] Implement logic/UI for governance actions #2382
• [FEAT] Fetch minting details from chain: Exchange rate, cross-chain fee, unstake period, token address #2383
• [FEAT] Staking information card #2384

Checklist: Extrinsics & hooks

• Implement bond https://github.com/webb-tools/tangle-lst-parachain/blob/main/pallets/slp/src/lib.rs#L752
• Implement bond_extra https://github.com/webb-tools/tangle-lst-parachain/blob/main/pallets/slp/src/lib.rs#L783
• Implement unbond https://github.com/webb-tools/tangle-lst-parachain/blob/main/pallets/slp/src/lib.rs#L815
• Implement unbond_all https://github.com/webb-tools/tangle-lst-parachain/blob/main/pallets/slp/src/lib.rs#L846
• Implement rebond https://github.com/webb-tools/tangle-lst-parachain/blob/main/pallets/slp/src/lib.rs#L872
• Implement hooks for all unbond/unstake requests (they're time-delayed). We should be able to grab a list of open unstake requests.
• [FEAT] Implement mint hook for lstMinting::mint extrinsic #2365
• [FEAT] Implement redeem hook for lstMinting::redeem extrinsic #2366

Staking/Unstaking

• Consider using our bridge UI to fulfill staking/unstaking. In this UI, we can show the DOT -> tgDOT for stake and tgDOT -> DOT for unstake.
• We want to allow a user to select their validators. This is most similar to bond & nominate on Tangle. Roughly the same process, we want to liquid stake and nominate validators on the target chain.
  • Can be done with a radio button and then selection modal.
• On button click the stake action is triggered (likely bond) (or bondExtra).
• On button click the unstake action is triggered (likely unbond) (unbondAll)
• Show the price of the tgDOT and the unstake/unbond
• Show the unstake fee, show the unstake/unbonding time delay.

Unstaking requests

• Show all active unstaking requests
• List the time unstaked, the remaining time to unstake from the delay, the amount.

Validators

• Show the validators that have been selected by the default selection system.

Governance

• Grab open governance proposals / data from the Target Chain. This requires querying the Target Chain's RPC.
• Put all active proposals for voting in a table.
• On click each proposal show specific proposal voting component.
• On click vote w/ data, call vote