SSVNetworkViews
The SSVNetworkViews contract is for reading information about the network and its participants.
Repository
General Methods
getNetworkFee ()
getNetworkFee ()Description: Returns current network fee.
Parameter | Type | Description |
Return values
Parameter | Type | Description |
fee | uint256 | The fee charged by the network (denominated as $SSV tokens per block) |
getNetworkEarnings ()
getNetworkEarnings ()Description: Returns accumulated network fees not yet withdrawn.
Parameter | Type | Description |
Return values
Parameter | Type | Description |
amount | uint256 | Amount of fees accumulated in the network treasury |
getLiquidationThresholdPeriod ()
getLiquidationThresholdPeriod ()Description: Returns the minimum duration (in blocks) which a cluster has to have sufficient balance (liquidation collateral) to not be liquidated.
Parameter | Type | Description |
Return values
Parameter | Type | Description |
blocks | uint64 | The minimum duration (blocks) which a cluster has to have sufficient balance (liquidation collateral) to not be liquidated. |
getMinimumLiquidationCollateral()
getMinimumLiquidationCollateral()Description: Returns the minimum amount which a cluster has to have sufficient balance (liquidation collateral) to not be liquidated.
Parameter | Type | Description |
|
|
|
Return values
Parameter | Type | Description |
amount | uint256 | The minimum amount of SSV which a cluster has to have (liquidation collateral) to not be liquidated. |
getOperatorFeeIncreaseLimit ()
getOperatorFeeIncreaseLimit ()Description: Returns the max amount by which operators can increase fees in each fee update cycle. This does refer to the max operator fee limitation, but to the rate (%) by which it can be increased.
Parameter | Type | Description |
Return values
Parameter | Type | Description |
amount | uint64 | The maximum increase in percentage the operator can update his fee to. |
getOperatorFeePeriods()
getOperatorFeePeriods()Description: returns the time windows (in seconds) of operators declaration and execution fee periods.
Parameter | Type | Description |
Return values
Parameter | Type | Description |
seconds | uint64 | The duration (seconds) until an operator can execute a fee after declaring it. |
seconds | uint64 | The duration (seconds) until an operator can execute a fee after declaring it. |
getMaximumOperatorFee()
getMaximumOperatorFee()Description: Gets the operator maximum fee for operators that use SSV token
| Paramet | Type | Description |
|---|---|---|
Return values
| Parameter | Type | Description |
|---|---|---|
maxFee | uint64 | The maximum fee value (SSV/year) |
getValidatorsPerOperatorLimit()
getValidatorsPerOperatorLimit()Description: Returns the maximum amount of validators an operator may manage.
Parameter | Type | Description |
|
|
|
Return values
Parameter | Type | Description |
Validator limit | uint32 | amount of validators an operator may manage. |
Operator Methods
getOperatorById (operatorId)
getOperatorById (operatorId)Description: Returns operator’s data.
Parameter | Type | Description |
operatorId | uint64 | The operator id |
Return values
Parameter | Type | Description |
owner | address | The operator’s admin address (for management purposes). |
fee | uint64256 | The fee charged by the operator (denominated as $SSV tokens per block) |
validatorCount | uint32 | The amount of managed validators |
whitelisted | address | The whitelisted address that can select operator to manage their validators |
isPrivate | boolean | Indication if operator is permissioned |
active | boolean | Operator network status |
getOperatorFee (operatorId)
getOperatorFee (operatorId)Description: returns current operator’s fee (not declared).
Parameter | Type | Description |
operatorId | uint64 | The operator id |
Return values
Parameter | Type | Description |
declaredFee | uint256 | The fee charged by the operator (denominated as $SSV tokens per block) |
getOperatorDeclaredFee (operatorId)
getOperatorDeclaredFee (operatorId)Description: Returns the declared fee (not actual fee) together with the execution time window.
Parameter | Type | Description |
operatorId | uint64 | The operator id |
Return valuegetOperatorEarnings (operatorId)
Description: Returns the outstanding earnings of an operator.
Parameter | Type | Description |
operatorId | uint64 | The operator id |
Return values
Parameter | Type | Description |
balance | uint256 | Operators outstanding earnings in $SSV tokens. |
Cluster Methods
getBalance (owner, operatorIds, cluster)
getBalance (owner, operatorIds, cluster)Description: Returns the outstanding SSV balance of a cluster.\
Parameter | Type | Description |
owner | address | The cluster owner address |
operatorIds | uint64[] | List of cluster operators Ids. |
cluster | tuple[] | Object containing the latest cluster snapshot data - obtained using the SSV Scanner tool. |
Return values
Parameter | Type | Description |
balance | uint256 | Clusters outstanding balance denominated in $SSV tokens |
getBurnRate (owner, operatorIds, cluster)
getBurnRate (owner, operatorIds, cluster)Description: Returns current ongoing expenses of SSV tokens for a particular SSV cluster balance on per block basis (aggregates all expenses for all the validators in this cluster).\
Parameter | Type | Description |
owner | address | The user address |
operatorIds | uint64[] | List of cluster operators Ids. |
cluster | tuple[] | Object containing the latest cluster snapshot data - obtained using the SSV Scanner tool. |
Return values
Parameter | Type | Description |
burnRate | uint256 | The rate per block in which the account spends SSV. |
Liquidator Methods
isLiquidatable (owner, operatorIds, cluster)
isLiquidatable (owner, operatorIds, cluster)Description: Returns true if the specified cluster is under the liquidation threshold and can be liquidated.\
Parameter | Type | Description |
owner | address | The user address |
operatorIds | uint64[] | List of cluster operators Ids. |
cluster | tuple[] | Object containing the latest cluster snapshot data - obtained using the SSV Scanner tool. |
Return values
Parameter | Type | Description |
boolean | Indication if a cluster could be liquidated |
isLiquidated (owner, operatorIds, cluster)
isLiquidated (owner, operatorIds, cluster)Description: Returns true if the provided cluster is liquidated.
Parameter | Type | Description |
owner | address | The user address |
operatorIds | uint64[] | List of cluster operators Ids. |
cluster | tuple[] | Object containing the latest cluster snapshot data - obtained using the SSV Scanner tool. |
Return values
Parameter | Type | Description |
boolean | Indication if a cluster is liquidated |
Last updated