Keep3r V2
Search…
Keepers
Keepers are bots, scripts, other contracts, or simply EOA accounts that trigger events. This can be submitting a signed TX on behalf of a third party, calling a transaction at a specific time, or a more complex functionality.
Each time you execute such a function, you are rewarded in either tokens, or the systems native token KP3R.
Jobs might require keepers that have a minimum amount of bonded tokens, have earned a minimum amount of fees, or have been in the system longer than a certain period of time.
At the most simple level, they simply require a keeper to be registered in the system.
Becoming a Keeper
To become a keeper, you simply need to call
bond(address,uint), no funds are required to become a keeper, however certain jobs might require a minimum amount of funds.1
/// @notice Beginning of the bonding process
2
/// @param _bonding The asset being bound
3
/// @param _amount The amount of bonding asset being bound
4
function bond(address _bonding, uint256 _amount) external;
Copied!
After waiting
bondTime (default 3 days) and you can activate as a keeper;1
/// @notice End of the bonding process after bonding time has passed
2
/// @param _bonding The asset being activated as bond collateral
3
function activate(address _bonding) external;
Copied!
Removing a Keeper
If you want to withdraw your bonds, you will need first to unbond them,
1
/// @notice Beginning of the unbonding process
2
/// @param _bonding The asset being unbound
3
/// @param _amount Allows for partial unbonding
4
function unbond(address _bonding, uint256 _amount) external;
Copied!
After a keeper has unbonded an asset amount, it may stop qualifying for the Filtered Access Control jobs, should they require to have bondings of that asset
After waiting
unbondTime (default 14 days) you can withdraw any bonded assets1
/// @notice Withdraw funds after unbonding has finished
2
/// @param _bonding The asset to withdraw from the bonding pool
3
function withdraw(address _bonding) external;
Copied!
Disputing and Slashing a Keeper
Disputed Keeper
A Keeper might be disputed by a disputer if there is suspicious activity detected within that keeper.
A good behavior is expected from keepers, this includes but isn't limited to:
- NOT working a malicious job
- NOT sandwiching a job
In case it's disputed, the keeper won't be able to bond or activate new assets nor withdraw its unbonded assets
Slashed Keeper
Keepers that are detected to have a malicious behavior within the network (either towards the network or the protocol they are working for — eg: sandwiching a job) will get their bonded assets slashed and seized by governance
Additional Requirements
Some jobs might have additional requirements such as minimum bonded protocol tokens (for example SNX). In such cases you would need to bond a minimum amount of SNX before you may qualify for the job.
Last modified 4mo ago