StakingModule

The StakingModule contract facilitates the conversion and staking of Ethereum-based tokens, specifically WETH, stETH, and wstETH. It leverages the DefaultModule structure whilintegrating closely with security and withdrawal management systems of Lido protocol.

Key Features

• Token Conversion: Supports the conversion of WETH to stETH and subsequently to wstETH.

• Secure Staking: Interfaces with a DepositSecurityModule for secure staking operations.

• Withdrawal Management: Coordinates with a WithdrawalQueue to manage staking withdrawals.

Constructor

• Initializes the contract with the relevant Ethereum-based token addresses and modules.

  • Parameters:

    • weth_: Address of the WETH token.

    • steth_: Address of the stETH token.

    • wsteth_: Address of the wstETH token.

    • depositSecurityModule_: The deposit security module for additional security during deposits.

    • withdrawalQueue_: The withdrawal queue module to manage withdrawals.

    • stakingModuleId_: A unique identifier for the staking module.

Core Methods

1. Token Conversion

   • convert(uint256): Converts a specified amount of WETH to wstETH.

     • amount: The amount of WETH to convert.

   • convertAndDeposit(uint256, uint256, bytes32, bytes32, uint256, bytes, IDepositSecurityModule.Signature[]): Converts WETH to wstETH and deposits it using the provided security parameters.

     • amount: The amount of WETH to convert and deposit.

     • blockNumber: The block number to reference for the deposit.

     • blockHash: The hash of the block.

     • depositRoot: The root of the deposit.

     • nonce: A nonce to ensure the uniqueness of the deposit.

     • depositCalldata: Additional calldata required for the deposit.

     • sortedGuardianSignatures: Signatures from guardians to validate the deposit.

2. Private Helper Functions

   • _wethToWSteth(uint256): Internal function to convert WETH directly to wstETH, handling intermediate steps.

     • amount: The amount of WETH to convert.

Modifiers

• onlyDelegateCall: Ensures that certain functions are only callable through delegate calls to prevent direct interaction that might bypass security checks.

Error Handling

• NotEnoughWeth: Triggered if there is insufficient WETH for the requested operation.

• InvalidWithdrawalQueueState: Indicates a mismatch in the expected state of withdrawals, potentially blocking operations if the conditions are unsafe.