Search…
⌃K

Operator Methods

public registerOperator (operatorName, publicKey, operatorFee)
Description: registers a new operator (key) with a set fee, fails if fee is less than the minimal fee.
Parameter
Type
Description
operatorName
string
The operator’s display name.
publicKey
bytes
The operator public key (generated as part of the node setup).
operatorFee
uint256 (casted to uint64)
The fee charged by the operator (denominated as $SSV tokens per block)
public removeOperator (operatorId)
Description: changes operator status to inactive, which will result in ceasing operation of all its managed validators. Please note that this process is irreversible.
Parameter
Type
Description
operatorId
uint32
The operator id
public getOperatorById (operatorId)
Description: returns operator’s data.
Parameter
Type
Description
operatorId
uint32
The operator id
Return values
Parameter
Type
Description
name
string
The operator’s display name
ownerAddress
address
The operator’s admin address (for management purposes).
publicKey
bytes
The operator public key
validators
uint256
The amount of managed validators
fee
uint256
The fee charged by the operator (denominated as $SSV tokens per block)
score
uint256
The operator score
active
boolean
Operator network status
public declareOperatorFee (operatorId, operatorFee)
Description: initiates the first step of the operator fee update cycle - declaration of a new fee. After specified time window operator will be able to change his fee with executeOperatorFee(). If he decides changing fee is no longer necessary, he can cancel fee update request with cancelDeclaredOperatorFee().
Parameter
Type
Description
operatorId
uint32
The operator id
operatorFee
uint256 (casted to uint64)
New fee (denominated as $SSV tokens per block).
public executeOperatorFee ()
Description: activates operator’s fee change specified in previously called declareOperatorFee(). This function needs to be called within a certain time window following declareOperatorFee().
Parameter
Type
Description
operatorId
uint32
The operator id
public cancelDeclaredOperatorFee (operatorId)
Description: Cancels operator’s fee change requested in previously called declareOperatorFee().
Parameter
Type
Description
operatorId
uint32
The operator id
public getOperatorDeclaredFee (operatorId)
Description: returns the declared fee (not actual fee) together with the execution time window.
Parameter
Type
Description
operatorId
uint32
The operator id
Return values
Parameter
Type
Description
declaredFee
uint256
The declared fee to be charged by the operator (denominated as $SSV tokens per block)
executionBeginTime
uint256
The timestamp of when the operator can execute the declared fee
executionExpirationTime
uint256
The timestamp of when the declared fee is expired
public getOperatorFee (operatorId)
Description: returns actual operator’s fee (not declared).
Parameter
Type
Description
operatorId
uint32
The operator id
Return values
Parameter
Type
Description
declaredFee
uint256
The fee charged by the operator (denominated as $SSV tokens per block)