VaultValidators
Inherits: VaultImmutables →, Initializable ↗, ReentrancyGuardUpgradeable ↗, VaultAdmin →, VaultState →, IVaultValidators
Defines the validators functionality for the Vault.
Events
ValidatorRegistered
Event emitted on V1 validator registration
event ValidatorRegistered(bytes publicKey);
Parameters
| Name | Type | Description |
|---|---|---|
publicKey | bytes | The public key of the validator that was registered |
V2ValidatorRegistered
Event emitted on V2 validator registration
event V2ValidatorRegistered(bytes publicKey, uint256 amount);
Parameters
| Name | Type | Description |
|---|---|---|
publicKey | bytes | The public key of the validator that was registered |
amount | uint256 | The amount of assets that was registered |
ValidatorWithdrawalSubmitted
Event emitted on validator withdrawal
event ValidatorWithdrawalSubmitted(bytes publicKey, uint256 amount, uint256 feePaid);
Parameters
| Name | Type | Description |
|---|---|---|
publicKey | bytes | The public key of the validator that was withdrawn |
amount | uint256 | The amount of assets that was withdrawn |
feePaid | uint256 | The amount of fee that was paid |
ValidatorFunded
Event emitted on validator balance top-up
event ValidatorFunded(bytes publicKey, uint256 amount);
Parameters
| Name | Type | Description |
|---|---|---|
publicKey | bytes | The public key of the validator that was funded |
amount | uint256 | The amount of assets that was funded |
ValidatorConsolidationSubmitted
Event emitted on validators consolidation
event ValidatorConsolidationSubmitted(bytes fromPublicKey, bytes toPublicKey, uint256 feePaid);
Parameters
| Name | Type | Description |
|---|---|---|
fromPublicKey | bytes | The public key of the validator that was consolidated |
toPublicKey | bytes | The public key of the validator that was consolidated to |
feePaid | uint256 | The amount of fee that was paid |
KeysManagerUpdated
Event emitted on keys manager address update (deprecated)
event KeysManagerUpdated(address indexed caller, address indexed keysManager);
Parameters
| Name | Type | Description |
|---|---|---|
caller | address | The address of the function caller |
keysManager | address | The address of the new keys manager |
ValidatorsRootUpdated
Event emitted on validators merkle tree root update (deprecated)
event ValidatorsRootUpdated(address indexed caller, bytes32 indexed validatorsRoot);
Parameters
| Name | Type | Description |
|---|---|---|
caller | address | The address of the function caller |
validatorsRoot | bytes32 | The new validators merkle tree root |
ValidatorsManagerUpdated
Event emitted on validators manager address update
event ValidatorsManagerUpdated(address indexed caller, address indexed validatorsManager);
Parameters
| Name | Type | Description |
|---|---|---|
caller | address | The address of the function caller |
validatorsManager | address | The address of the new validators manager |
Functions
validatorsManager
The Vault validators manager address
function validatorsManager() external view returns (address);
Returns
| Name | Type | Description |
|---|---|---|
<none> | address | The address that can register validators |
validatorsManagerNonce
The nonce for the validators manager used for signing
function validatorsManagerNonce() external view returns (uint256);
Returns
| Name | Type | Description |
|---|---|---|
<none> | uint256 | The nonce for the validators manager |
v2Validators
Function for checking if the validator is tracked V2 validator
function v2Validators(bytes32 publicKeyHash) external view returns (bool);
Parameters
| Name | Type | Description |
|---|---|---|
publicKeyHash | bytes32 | The keccak256 hash of the public key of the validator |
Returns
| Name | Type | Description |
|---|---|---|
<none> | bool | Whether the validator is tracked V2 validator |
registerValidators
Function for registering single or multiple validators
function registerValidators(
IKeeperValidators.ApprovalParams calldata keeperParams,
bytes calldata validatorsManagerSignature
) external override;
Parameters
| Name | Type | Description |
|---|---|---|
keeperParams | IKeeperValidators.ApprovalParams | The parameters for getting approval from Keeper oracles |
validatorsManagerSignature | bytes | The optional signature from the validators manager |
fundValidators
Function for funding single or multiple existing validators
function fundValidators(bytes calldata validators, bytes calldata validatorsManagerSignature) external override;
Parameters
| Name | Type | Description |
|---|---|---|
validators | bytes | The concatenated validators data |
validatorsManagerSignature | bytes | The optional signature from the validators manager |
withdrawValidators
Function for withdrawing single or multiple validators
function withdrawValidators(bytes calldata validators, bytes calldata validatorsManagerSignature)
external
payable
override
nonReentrant;
Parameters
| Name | Type | Description |
|---|---|---|
validators | bytes | The concatenated validators data |
validatorsManagerSignature | bytes | The optional signature from the validators manager |
consolidateValidators
Function for consolidating single or multiple validators
function consolidateValidators(
bytes calldata validators,
bytes calldata validatorsManagerSignature,
bytes calldata oracleSignatures
) external payable override nonReentrant;
Parameters
| Name | Type | Description |
|---|---|---|
validators | bytes | The concatenated validators data |
validatorsManagerSignature | bytes | The optional signature from the validators manager |
oracleSignatures | bytes | The optional signatures from the oracles |
setValidatorsManager
Function for updating the validators manager. Can only be called by the admin. Default is the DepositDataRegistry contract.
function setValidatorsManager(address _validatorsManager) external override;
Parameters
| Name | Type | Description |
|---|---|---|
_validatorsManager | address | The new validators manager address |