Skip to main content
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.