Registry Commands

The cre registry commands let you view and inspect the workflow registries available to your organization.

What is a workflow registry?

A workflow registry is the system that tracks which workflows are registered to your CRE organization and makes them available to the DON (Decentralized Oracle Network) for execution. The standard registry is a smart contract on Ethereum Mainnet — when you run cre workflow deploy, the CLI submits a transaction to that contract recording your workflow's name, owner, and artifact URLs, and the DON reads from it to discover and execute your workflow.

When you log in with cre login, the CLI fetches your organization's registry configuration from the CRE platform and caches it locally in ~/.cre/context.yaml. cre registry list reads from that cache and shows which registries your organization has access to.

Each workflow can declare a deployment-registry in workflow.yaml (under the target you deploy with). Set it to one of the ID values printed by cre registry list (for example onchain:ethereum-mainnet). Commands such as cre workflow get use that setting to decide which registry to query by default; use --all-registries when you need to search across every registry your org can access.

cre registry list

Displays the workflow registries configured for your organization, including each registry's label, ID, type, and on-chain address (where applicable). Registry data is sourced from ~/.cre/context.yaml, which is fetched from the CRE platform when you run cre login. The CLI may also print a short reminder for setting deployment-registry in workflow.yaml (see example output below).

Usage:

cre registry list

Example output:

Registries available to your organization

ethereum-mainnet (0x4Ac5...E7e5)
  ID:   onchain:ethereum-mainnet
  Type: on-chain
  Addr: 0x4Ac54353FA4Fa961AfcC5ec4B118596d3305E7e5

Private (Chainlink-hosted)
  ID:   private
  Type: off-chain

Targeting a registry
  Set `deployment-registry` in your workflow.yaml to one of the IDs above:

  <target-name>:
    user-workflow:
      deployment-registry: "onchain:ethereum-mainnet"

Exact registries depend on your organization. Some environments list only on-chain registries; others also include off-chain (private) entries. If no registries are found, the command prints a warning and exits cleanly.

Learn more

Get the latest Chainlink content straight to your inbox.