ExitPenalties

• Source code

Deployed contracts

Module	Mainnet
CMv2	0x004aFb7DAA7dEA20EbAaB75c9F4892C879FaCCe0
CSM	0x06cd61045f958A209a0f8D746e103eCc625f4193

ExitPenalties is a supplementary contract that records exit-related penalties and charges for individual validators. It can track:

• a delayed-exit penalty after the allowed exit window;
• a bad-performance penalty reported by ValidatorStrikes;
• the execution-layer withdrawal request fee paid for a non-voluntary triggered exit.

Applicable amounts and limits are obtained from ParametersRegistry for the Node Operator's bond curve. When a validator withdrawal is processed, the module contract (CuratedModule or CSModule) applies the relevant penalties and charges to the Node Operator's bond through Accounting.

Upgradability

The contract uses OssifiableProxy for upgradability.

State Variables

MODULE

IBaseModule public immutable MODULE

PARAMETERS_REGISTRY

IParametersRegistry public immutable PARAMETERS_REGISTRY

ACCOUNTING

IAccounting public immutable ACCOUNTING

STRIKES

address public immutable STRIKES

_exitPenaltyInfo

mapping(bytes32 keyPointer => ExitPenaltyInfo info) private _exitPenaltyInfo

Functions

onlyModule

modifier onlyModule() ;

onlyStrikes

modifier onlyStrikes() ;

constructor

constructor(address module, address strikes) ;

processExitDelayReport

Handles tracking and penalization logic for a validator that remains active beyond its eligible exit window.

See IStakingModule.reportValidatorExitDelay for details.

function processExitDelayReport(uint256 nodeOperatorId, bytes calldata publicKey, uint256 eligibleToExitInSec)
    external
    onlyModule;

Parameters

Name	Type	Description
nodeOperatorId	uint256	The ID of the node operator whose validator's status is being delivered.
publicKey	bytes	The public key of the validator being reported.
eligibleToExitInSec	uint256	The duration (in seconds) indicating how long the validator has been eligible to exit but has not exited.

processTriggeredExit

Process the triggered exit report

function processTriggeredExit(
    uint256 nodeOperatorId,
    bytes calldata publicKey,
    uint256 elWithdrawalRequestFeePaid,
    uint256 exitType
) external onlyModule;

Parameters

Name	Type	Description
nodeOperatorId	uint256	ID of the Node Operator
publicKey	bytes	Public key of the validator
elWithdrawalRequestFeePaid	uint256	The fee paid for the withdrawal request
exitType	uint256	The type of the exit; only VOLUNTARY_EXIT_TYPE_ID skips recording EL withdrawal request fee

processStrikesReport

Process the strikes report

function processStrikesReport(uint256 nodeOperatorId, bytes calldata publicKey) external onlyStrikes;

Parameters

Name	Type	Description
nodeOperatorId	uint256	ID of the Node Operator
publicKey	bytes	Public key of the validator

isValidatorExitDelayPenaltyApplicable

Determines whether a validator exit status should be updated and will have an effect on the Node Operator.

There is a onlyModule modifier to prevent using it from outside as it gives a false-positive information for non-existent node operators. Use isValidatorExitDelayPenaltyApplicable in the BaseModule.sol instead.

function isValidatorExitDelayPenaltyApplicable(
    uint256 nodeOperatorId,
    bytes calldata publicKey,
    uint256 eligibleToExitInSec
) external view onlyModule returns (bool);

Parameters

Name	Type	Description
nodeOperatorId	uint256	The ID of the node operator.
publicKey	bytes	Validator's public key.
eligibleToExitInSec	uint256	The number of seconds the validator was eligible to exit but did not.

Returns

Name	Type	Description
<none>	bool	Returns true if contract should receive updated validator's status.

getExitPenaltyInfo

Get delayed exit penalty info for the given Node Operator

function getExitPenaltyInfo(uint256 nodeOperatorId, bytes calldata publicKey)
    external
    view
    returns (ExitPenaltyInfo memory);

Parameters

Name	Type	Description
nodeOperatorId	uint256	ID of the Node Operator
publicKey	bytes	Public key of the validator

Returns

Name	Type	Description
<none>	ExitPenaltyInfo	penaltyInfo Delayed exit penalty info

_onlyModule

function _onlyModule() internal view;

_onlyStrikes

function _onlyStrikes() internal view;