Jolt network
These docs are in active development by the Jolt community.
Jolt network is a decentralized network of workers created for projects that need external devops and for external teams to find onchain jobs.
Workers
Worker is the term used to refer to an external person/team/bot that executes a job on the Jolt network. This can be as simplistic as calling a transaction, or as complex as requiring extensive off-chain logic. The scope of Jolt network is not to manage these jobs themselves, but to allow contracts to register as jobs for workers, and for workers to register themselves as available to perform jobs. It is up to the individual worker to set up their devops and infrastructure and create their own rules based on what transactions they deem profitable (even though the Jolt network CLI can help considerably in setting up a profitable worker from a predefined set of jobs).
Jobs
Job is the term used to refer to a smart contract that wishes an external entity to perform an action. They would like the action to be performed in "good will" and not have a malicious result. For this reason they register as a job, and workers can then execute on their contract.
Becoming a worker
To become a worker you just need to bond some JOLT
to the platform. In order
to do so you will have to call bond(uint256)
on the Bonder
contract. There
is a bonding delay before you can activate as a worker. The extent of the delay
is decided though governance by the Jolt guild. Once the bonding time has
passed, you can call consolidateBond()
to officially register as a valid
worker.
Registering a job
A job can be any system that requires external execution, the scope of Jolt is not to define or restrict the action taken, but to create an incentive mechanism for all parties involved. There are two core ways to create a job;
Registering a job via governance
If you prefer, you can register as a job by simply submitting a proposal via governance to the Jolt guild, to include the contract as a job. If governance approves, no further steps are required.
Registering a job by becoming a job creator
Job creators are a privileged entity in the platform, since they can create jobs at any time without further validation. Job creators can only be allowed through governance, and the Jolt guild must approve them after carefully considering the details of the application. Most of the time, job creators are platforms that wish to create a certain number of Jolt jobs without much friction.
Job interface
Some contracts require external event execution on some conditions. These normally require a restricted access control list, however these can be difficult for fully decentralized projects to manage, as they lack devops infrastructure.
These interfaces can be broken down into types depending on security considerations.
For no, or low risk executions, you can simply call Master.worker(msg.sender)
which will let you know if the given actor is a valid worker in the network.
For high, sensitive, or critical risk executions, you can specify a minimum
bond, minimum earned, and minimum worker age required to execute this function.
Based on these 3 limits you can define your own trust ratio on these keepers. In
general, to create a job one can simply extend from either the Job
or
JobUpgradeable
contract. The contract needs to be passed the Master
instance
address on the targeted network and override the workable
and work
function
(making sure to apply either the needsExecution
or
needsExecutionWithRequirements
modifier to it, depending on the needs).
You can take a look at a simple example job here.
Job credits
As mentioned above, a job has a set amount of credits
that they can award
workers with, and any ERC20 token can be awarded as credit. But if you need to
add a job to the platform, you can avoid purchasing credit tokens directly. You
can instead opt to receive bonus credits by providing liquidity to specific
pools, as defined by governance. After having provided liquidity, you can "sell"
the LP token to the platform for an amount of JOLT equal to the value of the LP
tokens plus a premium. The premium amount is decided by the governance. This is
a way to buy up credits at a discount. Keep in mind that credits obtained this
way can never be withdrawn from the platform.
With the v1 of Jolt, a frontend will obviously be released to make it a lot easier to interact with the platform.