Jobs - Keep3r V2

Quick Start Examples
Simple Keeper
To setup a keeper function simply add the following modifier in your contract:
1
modifier validateAndPayKeeper(address _keeper) {
2
  if (!IKeep3r(keep3r).isKeeper(_keeper)) revert KeeperNotValid();
3
  _;
4
  IKeep3r(keep3r).worked(_keeper);
5
}
Copied!
It could be then implement it like this:
1
function work() external validateAndPayKeeper(msg.sender) {
2
  // ...
3
}
Copied!
The above will make sure the caller is a registered keeper as well as reward them with an amount of KP3R equal to their gas spent + premium. Make sure to have enough credits assigned in the Keep3r system for the relevant job.
Adding Jobs
Jobs can be created directly via addJob().
1
  /// @notice Allows any caller to add a new job
2
  /// @param _job Address of the contract for which work should be performed
3
  function addJob(address _job) external;
Copied!
Managing Credits
Jobs need credit to be able to pay keepers, this credit can either be paid for directly (see Token Payments), or by being a liquidity provider (see Credit Mining) in the system. If you pay directly, this is a direct expense, if you are a liquidity provider, you get all your liquidity back after you are done being a provider.
Start mining credits for your job via Liquidity
To start mining credits, you will need to provide LP tokens as liquidity by calling addLiquidityToJob(). You receive all your LP tokens back when you no longer need to provide credit for a contract.
1
  /// @notice Allows anyone to fund a job with liquidity
2
  /// @param _job The address of the job to assign liquidity to
3
  /// @param _liquidity The liquidity being added
4
  /// @param _amount The amount of liquidity tokens to add
5
  function addLiquidityToJob(
6
    address _job,
7
    address _liquidity,
8
    uint256 _amount
9
  ) external;
Copied!
Remove liquidity from a job
To remove your liquidity from a job, you will need to call unbondLiquidityFromJob().
1
  /// @notice Unbond liquidity for a job
2
  /// @dev Can only be called by the job's owner
3
  /// @param _job The address of the job being unbound from
4
  /// @param _liquidity The liquidity being unbound
5
  /// @param _amount The amount of liquidity being removed
6
  function unbondLiquidityFromJob(
7
    address _job,
8
    address _liquidity,
9
    uint256 _amount
10
  ) external;
Copied!
Wait UNBOND (default 14 days) days and call withdrawLiquidityFromJob().
1
  /// @notice Withdraw liquidity from a job
2
  /// @param _job The address of the job being withdrawn from
3
  /// @param _liquidity The liquidity being withdrawn
4
  /// @param _receiver The address that will receive the withdrawn liquidity
5
  function withdrawLiquidityFromJob(
6
    address _job,
7
    address _liquidity,
8
    address _receiver
9
  ) external;
Copied!
Adding credits directly (non ETH)
To add Token Credits to your job, you will need to call addTokenCreditsToJob(). 
Adding KP3R tokens is not allowed this way, the only way is via liquidity mining.
1
  /// @notice Add credit to a job to be paid out for work
2
  /// @param _job The address of the job being credited
3
  /// @param _token The address of the token being credited
4
  /// @param _amount The amount of credit being added
5
  function addTokenCreditsToJob(
6
    address _job,
7
    address _token,
8
    uint256 _amount
9
  ) external;
Copied!
Selecting Keepers
Dependent on your requirements you might allow any keepers, or you want to limit specific keepers, you can filter keepers based on age, bond, total earned funds, or even arbitrary values such as additional bonded tokens.
No access control
Accept all keepers in the system.
1
/// @notice Confirms if the current keeper is registered, can be used for general (non critical) functions
2
/// @param _keeper The keeper being investigated
3
/// @return _isKeeper Whether the address passed as a parameter is a keeper or not
4
function isKeeper(address _keeper) external returns (bool _isKeeper);
Copied!
Filtered access control
Filter keepers based on bonded amount of tokens, earned funds, and age in system. For example a keeper might need to have SNX to be able to participate in the Synthetix ecosystem.
1
/// @notice Confirms if the current keeper is registered and has a minimum bond of any asset. Should be used for protected functions
2
/// @param _keeper The keeper to check
3
/// @param _bond The bond token being evaluated
4
/// @param _minBond The minimum amount of bonded tokens
5
/// @param _earned The minimum funds earned in the keepers lifetime
6
/// @param _age The minimum keeper age required
7
/// @return _isBondedKeeper Whether the `_keeper` meets the given requirements
8
function isBondedKeeper(
9
  address _keeper,
10
  address _bond,
11
  uint256 _minBond,
12
  uint256 _earned,
13
  uint256 _age
14
) external returns (bool _isBondedKeeper);
Copied!
Paying Keepers
There are two primary payment mechanisms and these are based on the credit provided;
Pay via liquidity provided tokens (based on addLiquidityToJob)
Pay in direct token (based on addTokenCreditsToJob)
Auto Pay
Pay for Work
If you don't want to worry about calculating payment, you can simply let the system calculate the recommended payment itself.
1
/// @notice Implemented by jobs to show that a keeper performed work
2
/// @dev Automatically calculates the payment for the keeper
3
/// @param _keeper Address of the keeper that performed the work
4
function worked(address _keeper) external;
Copied!
Pay with KP3R
1
/// @notice Implemented by jobs to show that a keeper performed work
2
/// @dev Pays the keeper that performs the work with KP3R
3
/// @param _keeper Address of the keeper that performed the work
4
/// @param _payment The reward that should be allocated for the job
5
function bondedPayment(address _keeper, uint256 _payment) external;
Copied!
Pay with an ERC20 token
1
/// @notice Implemented by jobs to show that a keeper performed work
2
/// @dev Pays the keeper that performs the work with a specific token
3
/// @param _token The asset being awarded to the keeper
4
/// @param _keeper Address of the keeper that performed the work
5
/// @param _amount The reward that should be allocated
6
function directTokenPayment(
7
  address _token,
8
  address _keeper,
9
  uint256 _amount
10
) external;
Copied!
Disputing and Slashing a Job
Disputed Job
A job might be disputed by a disputer if there is suspicious activity detected within that job.
A good behavior is expected from jobs, this includes but isn't limited to:
NOT leverage the network of keepers for malicious activities (exploits, rug pulls, etc.).
NOT limiting qualified keepers to work on their job.
NOT creating a malicious workable function to drain credits from the network.
In case it's disputed, the job won't be able to be worked by keepers, withdraw LPs / tokens credits nor perform a job migration.
Slashed Jobs
Jobs that are detected to have a malicious behavior within the network (either towards the network or the protocol they are working for — eg: exploiting a protocol) will get their LP tokens slashed and seized by governance.
Job Migration
There may be situations where a job needs to migrate all of their "assets" to another contract address, for a job update for example. A proper migration implies the accountancy (tokens, liquidities, period credits) from the original job address will be transferred to the new one. This process is possible, and it requires the job to call two functions:
​migrateJob()first to start the migration process. This function should be call by the owner of the job that currently holds the assets to migrate.
1
/// @notice Initializes the migration process for a job by adding the request to the pendingJobMigrations mapping
2
/// @param _fromJob The address of the job that is requesting to migrate
3
/// @param _toJob The address at which the job is requesting to migrate
4
function migrateJob(address _fromJob, address _toJob) external;
Copied!
​acceptJobMigration() to complete the migration process. This function should be call by the owner of the job that will receive the assets to migrate.
1
/// @notice Completes the migration process for a job
2
/// @dev Unbond/withdraw process doesn't get migrated
3
/// @param _fromJob The address of the job that requested to migrate
4
/// @param _toJob The address to which the job wants to migrate to
5
function acceptJobMigration(address _fromJob, address _toJob) external;
Copied!
There are some considerations the job wishing to migrate must take into account to prevent the functions from reverting:
It must not provide its current address as the address where it wants to migrate to when calling migrateJob.
Calls to both migrateJob and acceptJobMigration should be done with the same arguments. 
Neither of the jobs involved in the migration process should be disputed
It must wait at least one minute between migrations
Here's a graphic representation to visualize the resulting changes in the credits of a job that goes through a successful migration.
Additional Information
Once you set up your job on the protocol, you will be able to request for it to be registered on the Job Board providing the following data to governance:
Job Address
Job Name
Job Address Link (Etherscan)
Job Documentation (script)
This information will be used to display the job on the UI, and will provide users and keepers of the network with additional information regarding the jobs of the network.
​
Introduction
Next - Core
Keepers
Last modified 4mo ago