v2 Jobs
What is a Job?
Chainlink nodes require jobs to do anything useful. For example, posting asset price data onchain requires jobs. Chainlink nodes support the following job types:
Jobs are represented by TOML specifications.
Users access to Jobs
Chainlink Nodes have a role-based access control system. Ensure you assign the appropriate role to users who manage jobs.
Example v2 job spec
The following is an example cron
job spec. This is a simple spec that you can add to a node:
type = "cron"
schemaVersion = 1
schedule = "CRON_TZ=UTC 0 0 1 1 *"
# Optional externalJobID: Automatically generated if unspecified
# externalJobID = "0EEC7E1D-D0D2-476C-A1A8-72DFB6633F46"
observationSource = """
ds [type="http" method=GET url="https://chain.link/ETH-USD"];
ds_parse [type="jsonparse" path="data,price"];
ds_multiply [type="multiply" times=100];
ds -> ds_parse -> ds_multiply;
"""
Shared fields
Every job type supported by a node shares the following TOML fields:
name
: The name of the job in the Operator UItype
: Specifies the v2 job type, which can be one of the following:cron
directrequest
fluxmonitor
keeper
offchainreporting
webhook
schemaVersion
: Must be present and set to a value of1
. This field will handle progressive iterations of the job spec format gracefully with backwards-compatibility.observationSource
: The v2 pipeline task DAG, which is specified in DOT syntax. See below for information on writing pipeline DAGs.maxTaskDuration
: The default maximum duration that any task is allowed to run. If the duration is exceeded, the task is errored. This value can be overridden on a per-task basis using thetimeout
attribute. See the Shared attributes section for details.externalJobID
: An optional way for a user to deterministically provide the ID of a job. The ID must be unique. For example, you can specify anexternalJobID
if you want to run the samedirectrequest
job on two different Chainlink nodes with different bridge names. The spec contents differ slightly, but you can use the sameexternalJobID
on both jobs, specify that in your onchain requests, and both nodes will pick it up. If you do not provide anexternalJobID
, the node generates the ID for you.gasLimit
: Optional gas limit for any outgoing transactions spawned by this job. When specified, it overridesETH_GAS_LIMIT_DEFAULT
env variable.forwardingAllowed
: Optional. Whentrue
, it allows forwarding transactions submitted by the job.