RioLRTOperatorRegistry

Git Source

Inherits: OwnableUpgradeable, UUPSUpgradeable, RioLRTCore, RioLRTOperatorRegistryStorageV1

State Variables

strategyManager

The primary entry and exit-point for funds into and out of EigenLayer.

IStrategyManager public immutable strategyManager;

operatorDelegatorBeacon

The operator delegator beacon contract.

address public immutable operatorDelegatorBeacon;

Functions

onlyOperatorManager

Require that the caller is the operator's manager.

modifier onlyOperatorManager(uint8 operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

onlyOperatorManagerOrSecurityDaemon

Require that the caller is the operator's manager OR the security daemon's wallet that has been configured by the security council.

modifier onlyOperatorManagerOrSecurityDaemon(uint8 operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

onlyOperatorManagerOrProofUploader

Require that the caller is the operator's manager OR the proof uploader

modifier onlyOperatorManagerOrProofUploader(uint8 operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

constructor

constructor(address issuer_, address strategyManager_, address operatorDelegatorBeacon_) RioLRTCore(issuer_);

Parameters

Name
Type
Description

issuer_

address

The LRT issuer that's authorized to deploy this contract.

strategyManager_

address

The primary entry and exit-point for funds into and out of EigenLayer.

operatorDelegatorBeacon_

address

The operator delegator beacon contract.

initialize

Initializes the contract.

function initialize(address initialOwner, address token_) external initializer;

Parameters

Name
Type
Description

initialOwner

address

The initial owner of the contract.

token_

address

The address of the liquid restaking token.

operatorCount

Returns the total number of operators in the registry.

function operatorCount() external view returns (uint8);

activeOperatorCount

Returns the total number of active operators in the registry.

function activeOperatorCount() external view returns (uint8);

minStakerOptOutBlocks

The minimum acceptable delay between an operator signaling intent to register

function minStakerOptOutBlocks() external view returns (uint24);

securityDaemon

The security daemon, which is responsible for removal of duplicate or invalid validator keys.

function securityDaemon() external view returns (address);

validatorKeyReviewPeriod

The amount of time (in seconds) before uploaded validator keys are considered "vetted".

function validatorKeyReviewPeriod() external view returns (uint24);

getOperatorDetails

Returns the operator details for the provided operator ID.

function getOperatorDetails(uint8 operatorId) external view returns (OperatorPublicDetails memory);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

getOperatorShareDetails

Returns the operator's share details for the provided operator ID and strategy.

function getOperatorShareDetails(uint8 operatorId, address strategy)
    external
    view
    returns (OperatorShareDetails memory);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

strategy

address

The strategy to get the share details for.

addOperator

Adds a new operator to the registry, deploying a delegator contract and delegating to the provided operator address.

function addOperator(OperatorConfig calldata config) external onlyOwner returns (uint8 operatorId, address delegator);

Parameters

Name
Type
Description

config

OperatorConfig

The new operator's configuration.

activateOperator

Activates an operator.

function activateOperator(uint8 operatorId) external onlyOwner;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

deactivateOperator

Deactivates an operator, exiting all remaining stake to the deposit pool.

function deactivateOperator(uint8 operatorId) external onlyOwner;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

setOperatorStrategyShareCaps

Sets the operator's strategy share allocation caps.

function setOperatorStrategyShareCaps(uint8 operatorId, StrategyShareCap[] calldata newStrategyShareCaps)
    external
    onlyOwner;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

newStrategyShareCaps

StrategyShareCap[]

The new strategy share allocation caps.

setOperatorValidatorCap

Sets the operator's maximum active validator cap.

function setOperatorValidatorCap(uint8 operatorId, uint40 newValidatorCap) external onlyOwner;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

newValidatorCap

uint40

The new maximum active validator cap.

setSecurityDaemon

Sets the security daemon to a new account (newSecurityDaemon).

function setSecurityDaemon(address newSecurityDaemon) external onlyOwner;

Parameters

Name
Type
Description

newSecurityDaemon

address

The new security daemon address.

setProofUploader

Sets the proof uploader to a new account (newProofUploader).

function setProofUploader(address newProofUploader) external onlyOwner;

Parameters

Name
Type
Description

newProofUploader

address

The new proof uploader address.

setMinStakerOptOutBlocks

Sets the minimum acceptable delay between an operator signaling intent to register

function setMinStakerOptOutBlocks(uint24 newMinStakerOptOutBlocks) external onlyOwner;

Parameters

Name
Type
Description

newMinStakerOptOutBlocks

uint24

The new min staker opt out blocks.

setValidatorKeyReviewPeriod

Sets the amount of time (in seconds) before uploaded validator keys are considered "vetted".

function setValidatorKeyReviewPeriod(uint24 newValidatorKeyReviewPeriod) external onlyOwner;

Parameters

Name
Type
Description

newValidatorKeyReviewPeriod

uint24

The new validator key review period.

setOperatorEarningsReceiver

Sets an operator's earnings receiver.

function setOperatorEarningsReceiver(uint8 operatorId, address newEarningsReceiver)
    external
    onlyOperatorManager(operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

newEarningsReceiver

address

The new reward address of the operator.

setOperatorPendingManager

Sets an operator's pending manager.

function setOperatorPendingManager(uint8 operatorId, address newPendingManager)
    external
    onlyOperatorManager(operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

newPendingManager

address

The new pending manager of the operator.

confirmOperatorManager

Confirms an operator's pending manager.

function confirmOperatorManager(uint8 operatorId) external;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

verifyWithdrawalCredentials

Verifies withdrawal credentials of validator(s) owned by the provided operator's EigenPod. It also verifies the effective balance of the validator(s).

function verifyWithdrawalCredentials(
    uint8 operatorId,
    uint64 oracleTimestamp,
    IBeaconChainProofs.StateRootProof calldata stateRootProof,
    uint40[] calldata validatorIndices,
    bytes[] calldata validatorFieldsProofs,
    bytes32[][] calldata validatorFields
) external onlyOperatorManagerOrProofUploader(operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

oracleTimestamp

uint64

The timestamp of the oracle that submitted the proof.

stateRootProof

IBeaconChainProofs.StateRootProof

The state root proof.

validatorIndices

uint40[]

The indices of the validators to verify.

validatorFieldsProofs

bytes[]

The validator fields proofs.

validatorFields

bytes32[][]

The validator fields.

addValidatorDetails

Adds pending validator details (public keys and signatures) to storage for the provided operator. Each added batch extends the timestamp at which the details will be considered confirmed.

function addValidatorDetails(
    uint8 operatorId,
    uint256 validatorCount,
    bytes calldata publicKeys,
    bytes calldata signatures
) external onlyOperatorManager(operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

validatorCount

uint256

The number of validators in the batch.

publicKeys

bytes

The validator public keys.

signatures

bytes

The validator signatures.

removeValidatorDetails

Removes pending or confirmed validator details (public keys and signatures) from storage for the provided operator.

function removeValidatorDetails(uint8 operatorId, uint256 fromIndex, uint256 validatorCount)
    external
    onlyOperatorManagerOrSecurityDaemon(operatorId);

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

fromIndex

uint256

The index of the first validator to remove.

validatorCount

uint256

The number of validator to remove.

reportOutOfOrderValidatorExits

Reports validator exits that occur prior to instruction by the protocol.

function reportOutOfOrderValidatorExits(uint8 operatorId, uint256 fromIndex, uint256 validatorCount) external;

Parameters

Name
Type
Description

operatorId

uint8

The operator's ID.

fromIndex

uint256

The index of the first validator to report.

validatorCount

uint256

The number of validators to report.

syncStrategyShares

Syncs the stored strategy share allocations for the provided operator IDs with EigenLayer.

function syncStrategyShares(uint8[] memory operatorIds, address strategy) external;

Parameters

Name
Type
Description

operatorIds

uint8[]

The operator IDs to sync.

strategy

address

The strategy to sync.

allocateStrategyShares

Allocates a specified amount of shares for the provided strategy to the operators with the lowest utilization.

function allocateStrategyShares(address strategy, uint256 sharesToAllocate)
    external
    onlyDepositPool
    returns (uint256 sharesAllocated, OperatorStrategyAllocation[] memory allocations);

Parameters

Name
Type
Description

strategy

address

The strategy to allocate the shares to.

sharesToAllocate

uint256

The amount of shares to allocate.

allocateETHDeposits

Allocates a specified amount of ETH deposits to the operators with the lowest utilization.

function allocateETHDeposits(uint256 depositsToAllocate)
    external
    onlyDepositPool
    returns (uint256 depositsAllocated, OperatorETHAllocation[] memory allocations);

Parameters

Name
Type
Description

depositsToAllocate

uint256

The amount of deposits to allocate (32 ETH each)

deallocateStrategyShares

Deallocates a specified amount of shares for the provided strategy from the operators with the highest utilization.

function deallocateStrategyShares(address strategy, uint256 sharesToDeallocate)
    external
    onlyCoordinator
    returns (uint256 sharesDeallocated, OperatorStrategyDeallocation[] memory deallocations);

Parameters

Name
Type
Description

strategy

address

The strategy to deallocate the shares from.

sharesToDeallocate

uint256

The amount of shares to deallocate.

deallocateETHDeposits

Deallocates a specified amount of ETH deposits from the operators with the highest utilization.

function deallocateETHDeposits(uint256 depositsToDeallocate)
    external
    onlyCoordinator
    returns (uint256 depositsDeallocated, OperatorETHDeallocation[] memory deallocations);

Parameters

Name
Type
Description

depositsToDeallocate

uint256

The amount of deposits to deallocate (32 ETH each)

_hashValidatorBLSPubKey

Hashes a validator's BLS public key and returns the hash.

function _hashValidatorBLSPubKey(bytes memory pubKey) internal pure returns (bytes32 pubKeyHash);

Parameters

Name
Type
Description

pubKey

bytes

The validator's BLS public key.

_authorizeUpgrade

Allows the owner to upgrade the operator registry implementation.

function _authorizeUpgrade(address newImplementation) internal override onlyOwner;

Parameters

Name
Type
Description

newImplementation

address

The implementation to upgrade to.

Last updated