Kiln
Operators Registry Interface (v1)
This interface exposes methods to handle the list of operators and their keys
Adds an operator to the registry
Only callable by the administrator
Adds new keys for an operator
Only callable by the administrator or the operator address
Get operator details
Get operator count
Retrieve the River address
Get the details of a validator
Initializes the operators registry
Retrieve the active operator set
Retrieve validator keys based on operator statuses
Remove validator keys
Only callable by the administrator or the operator addressThe indexes must be provided sorted in decreasing order and duplicate-free, otherwise the method will revertThe operator limit will be set to the lowest deleted key index if the operator's limit wasn't equal to its total key countThe operator or the admin cannot remove funded keysWhen removing validators, the indexes of specific unfunded keys can be changed in order to properlyremove the keys from the storage array. Beware of this specific behavior when chaining calls as thetargeted public key indexes can point to a different key after a first call was made and performedsome swaps
Changes the operator address of an operator
Only callable by the administrator or the previous operator address
Changes the operator staking limit
Only callable by the administratorThe operator indexes must be in increasing order and contain no duplicateThe limit cannot exceed the total key count of the operatorThe _indexes and _newLimits must have the same length.Each limit value is applied to the operator index at the same index in the _indexes array.
Changes the operator name
Only callable by the administrator or the operator
Changes the operator status
Only callable by the administrator
Changes the operator stopped validator count
Only callable by the administrator
A new operator has been added to the registry
The operator or the admin added new validator keys and signatures
The public keys and signatures are concatenatedA public key is 48 bytes longA signature is 96 bytes long[P1, S1, P2, S2, ..., PN, SN] where N is the bytes length divided by (96 + 48)
The operator edited its keys after the snapshot block
This means that we cannot assume that its key set is checked by the snapshotThis happens only if the limit was meant to be increased
The call didn't alter the limit of the operator
The operator or the admin removed a public key and its signature from the registry
The operator address has been changed
The operator limit has been changed
The operator display name has been changed
The operator status has been changed
The operator stopped validator count has been changed
The stored river address has been changed
The calling operator is inactive
The provided operator and limits array have different lengths
The provided operator and limits array are empty
A funded key deletion has been attempted
The index that is removed is out of bounds
The provided key count is 0
The provided concatenated keys do not have the expected length
The index provided are not sorted properly (descending order)
The value for the operator limit is too high
The value for the limit is too low
The provided list of operators is not in increasing order
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
_name
string
The name identifying the operator
_operator
address
The address representing the operator, receiving the rewards
_0
uint256
The index of the new operator
_index
uint256
The operator index
_keyCount
uint256
The amount of keys provided
_publicKeysAndSignatures
bytes
Public keys of the validator, concatenated
_index
uint256
The index of the operator
_0
Operators.Operator
The details of the operator
_0
uint256
The operator count
_0
address
The address of River
_operatorIndex
uint256
The index of the operator
_validatorIndex
uint256
The index of the validator
publicKey
bytes
The public key of the validator
signature
bytes
The signature used during deposit
funded
bool
True if validator has been funded
_admin
address
Admin in charge of managing operators
_river
address
Address of River system
_0
Operators.Operator[]
The list of active operators and their details
_count
uint256
Max amount of keys requested
publicKeys
bytes[]
An array of public keys
signatures
bytes[]
An array of signatures linked to the public keys
_index
uint256
The operator index
_indexes
uint256[]
The indexes of the keys to remove
_index
uint256
The operator index
_newOperatorAddress
address
The new address of the operator
_operatorIndexes
uint256[]
The operator indexes, in increasing order and duplicate free
_newLimits
uint256[]
The new staking limit of the operators
_snapshotBlock
uint256
The block number at which the snapshot was computed
_index
uint256
The operator index
_newName
string
The new operator name
_index
uint256
The operator index
_newStatus
bool
The new status of the operator
_index
uint256
The operator index
_newStoppedValidatorCount
uint256
The new stopped validator count of the operator
index indexed
uint256
The operator index
name
string
The operator display name
operatorAddress indexed
address
The operator address
index indexed
uint256
The operator index
publicKeysAndSignatures
bytes
The concatenated public keys and signatures
index indexed
uint256
The operator index
currentLimit
uint256
The current operator limit
newLimit
uint256
The new operator limit that was attempted to be set
latestKeysEditBlockNumber indexed
uint256
The last block number at which the operator changed its keys
snapshotBlock indexed
uint256
The block number of the snapshot
index indexed
uint256
The operator index
limit
uint256
The limit of the operator
index indexed
uint256
The operator index
publicKey
bytes
The BLS public key that has been removed
index indexed
uint256
The operator index
newOperatorAddress indexed
address
The new operator address
index indexed
uint256
The operator index
newLimit
uint256
The new operator staking limit
index indexed
uint256
The operator index
newName
string
The new display name
index indexed
uint256
The operator index
active
bool
True if the operator is active
index indexed
uint256
The operator index
newStoppedValidatorCount
uint256
The new stopped validator count
river indexed
address
The new river address
index
uint256
The operator index
index
uint256
The operator index
limit
uint256
The new limit provided
keyCount
uint256
The operator key count
index
uint256
The operator index
limit
uint256
The new limit provided
fundedKeyCount
uint256
The operator funded key count