diff --git a/public/changelog.json b/public/changelog.json index 602c77d519b..a42b5fec6d3 100644 --- a/public/changelog.json +++ b/public/changelog.json @@ -417,6 +417,13 @@ "title": "Cross-chain token (CCT) standard: Added support for new tokens", "topic": "CCIP" }, + { + "category": "release", + "date": "2026-07-09", + "description": "CRE CLI version 1.24.0 is now available. New [`cre execution`](https://docs.chain.link/cre/reference/cli/execution) commands (`list`, `status`, `events`, `logs`) let you inspect workflow runs from the terminal. [`cre workflow get`](https://docs.chain.link/cre/reference/cli/workflow#cre-workflow-get) now shows deployment health and the most recent execution. Solana Write is supported: workflows can submit DON-signed reports to Solana programs on Mainnet and Devnet via the Keystone Forwarder, with CLI tooling for `CRE_SOLANA_PRIVATE_KEY`, `cre generate-bindings solana`, and local write simulation.\n\nUpdate your CLI by running `cre update` when prompted, or follow the [CLI Installation guide](https://docs.chain.link/cre/getting-started/cli-installation) for fresh installations.\n\n[See all changes on GitHub](https://github.com/smartcontractkit/cre-cli/compare/v1.23.0...v1.24.0)", + "title": "CRE CLI v1.24.0 — Execution Observability and Solana Write", + "topic": "CRE" + }, { "category": "release", "date": "2026-07-02", diff --git a/src/config/sidebar.ts b/src/config/sidebar.ts index f4cb4c06cb4..075959ac8fb 100644 --- a/src/config/sidebar.ts +++ b/src/config/sidebar.ts @@ -640,6 +640,7 @@ export const SIDEBAR: Partial> = { }, { title: "Account Management", url: "cre/reference/cli/account" }, { title: "Workflow Commands", url: "cre/reference/cli/workflow" }, + { title: "Execution Commands", url: "cre/reference/cli/execution" }, { title: "Registry Commands", url: "cre/reference/cli/registry" }, { title: "Secrets Management", url: "cre/reference/cli/secrets" }, { title: "Template Sources", url: "cre/reference/cli/templates" }, diff --git a/src/config/versions/index.ts b/src/config/versions/index.ts index 759e8d44aab..2ae69917e75 100644 --- a/src/config/versions/index.ts +++ b/src/config/versions/index.ts @@ -77,8 +77,9 @@ export const VERSIONS = { }, // CRE CLI Versions — update LATEST here for each new release "cre-cli": { - LATEST: "v1.23.0", + LATEST: "v1.24.0", ALL: [ + "v1.24.0", "v1.23.0", "v1.22.0", "v1.21.0", @@ -97,6 +98,7 @@ export const VERSIONS = { "v1.8.0", ] as const, RELEASE_DATES: { + "v1.24.0": "2026-07-09T00:00:00Z", "v1.23.0": "2026-07-02T00:00:00Z", "v1.22.0": "2026-06-25T00:00:00Z", "v1.21.0": "2026-06-18T00:00:00Z", diff --git a/src/content/cre/llms-full-go.txt b/src/content/cre/llms-full-go.txt index 078ea88a771..0da6f11e933 100644 --- a/src/content/cre/llms-full-go.txt +++ b/src/content/cre/llms-full-go.txt @@ -514,10 +514,25 @@ To help us assist you faster, please include: # Release Notes Source: https://docs.chain.link/cre/release-notes -Last Updated: 2026-07-02 +Last Updated: 2026-07-09 This page provides detailed release notes for CRE. It includes information on new features, significant changes, and known limitations. +## CLI v1.24.0 - July 9, 2026 + +**CRE CLI version 1.24.0 is now available.** + +- **Execution observability from the CLI**: New [`cre execution`](/cre/reference/cli/execution) commands let you inspect deployed workflow runs without opening the UI — `list` for recent executions (filter by status and time range), `status` for a single run, `events` for the capability timeline, and `logs` for emitted log lines. All support `--output json` for scripting. +- **Enhanced `cre workflow get`**: [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) now resolves the workflow from your `workflow.yaml` settings and shows deployment health plus the most recent execution, not just registry metadata. +- **Solana Write capability**: Workflows can now submit DON-consensus signed reports to Solana programs on Mainnet and Devnet via the Keystone Forwarder — the same secure write model as EVM. The CLI adds the tooling to build and test these workflows: `CRE_SOLANA_PRIVATE_KEY` for signing, `cre generate-bindings solana` for Go and TypeScript bindings from Anchor IDLs, and local write simulation with `cre workflow simulate` (dry run or `--broadcast`). + +**How to update:** + +- **Automatic update**: When you run any CRE command, the CLI will automatically detect if a newer version is available and prompt you to update. Simply run `cre update` to install the latest version. +- **Fresh installation**: If you're installing the CLI for the first time, follow the [CLI Installation guide](/cre/getting-started/cli-installation). + +[See all changes on GitHub](https://github.com/smartcontractkit/cre-cli/compare/v1.23.0...v1.24.0) + ## CLI v1.23.0 - July 2, 2026 **CRE CLI version 1.23.0 is now available.** @@ -8443,7 +8458,7 @@ See the [repository README](https://github.com/smartcontractkit/cre-gcp-predicti # CLI Reference Source: https://docs.chain.link/cre/reference/cli -Last Updated: 2026-05-14 +Last Updated: 2026-07-09 export const CRE_CLI_VERSION = VERSIONS["cre-cli"].LATEST @@ -8469,6 +8484,7 @@ These flags can be used with any `cre` command. | `-v, --verbose` | Enables verbose logging to print `DEBUG` level logs | | `--non-interactive` | Fails instead of prompting; provide all required inputs with flags or environment variables. Use this for CI/CD, scripts, and other headless environments | | `--allow-unknown-chains` | Skips chain-name validation against the chain-selectors registry for `cre workflow simulate` and `cre workflow deploy`. Use for experimental or unlisted chains. Chain-selector and RPC availability are still enforced | +| `--allow-insecure-rpc` | Allows non-localhost HTTP RPC URLs. By default, the CLI blocks cleartext RPC endpoints to reduce accidental secret exposure over insecure connections | -Shows metadata for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, searches the CRE platform for matching workflow metadata, and filters results to the workflow's configured `deployment-registry` by default. +Shows deployment health and the most recent execution for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, resolves the workflow on the CRE platform (scoped to the configured `deployment-registry` by default), and prints deployment health plus the latest execution. **Usage:** @@ -9439,25 +9468,33 @@ cre workflow get [flags] **Flags:** -| Flag | Description | -| ------------------ | ------------------------------------------------------------------------ | -| `--all-registries` | Do not filter results by the workflow's configured `deployment-registry` | +| Flag | Description | +| ------------------- | ------------------------------------------------------------------------------------------ | +| `--all-registries` | Resolve the workflow across every registry instead of the configured `deployment-registry` | +| `--output ` | Output format. Use `json` to print JSON to stdout for scripting | +| `--json` | Shorthand for `--output=json` | **Examples:** -- Show metadata for the workflow configured for a target +- Show deployment health and recent execution for the workflow configured for a target ```bash cre workflow get ./my-workflow --target staging-settings ``` -- Search across all registries in your organization +- Resolve across all registries in your organization ```bash cre workflow get ./my-workflow --target staging-settings --all-registries ``` -The command prints the same human-readable workflow metadata fields as [`cre workflow list`](#cre-workflow-list): workflow name, workflow ID, owner address, status, registry, and registry address when available. +- Export as JSON + + ```bash + cre workflow get ./my-workflow --target staging-settings --output json + ``` + +For a full execution history, use [`cre execution list`](/cre/reference/cli/execution#cre-execution-list). *** @@ -9625,6 +9662,161 @@ The typical workflow lifecycle uses these commands in sequence: --- +# Execution Commands +Source: https://docs.chain.link/cre/reference/cli/execution +Last Updated: 2026-07-09 + +The `cre execution` commands query workflow execution history from the CRE platform. Use them to debug failures, review capability timelines, and pull log lines without opening the web UI. + + + + + + + +For a quick health check on the workflow configured in your project, see [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get), which shows deployment health and the most recent execution. + +## `cre execution list` + +Lists recent workflow executions from the CRE platform. + +**Usage:** + +```bash +cre execution list [workflow-id-or-name] [flags] +``` + +**Arguments:** + +- `[workflow-id-or-name]` — (Optional) On-chain workflow ID (64-char hex, visible in [`cre workflow list`](/cre/reference/cli/workflow#cre-workflow-list)) or workflow name. When omitted, executions across all workflows are returned. + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------------------------------------- | +| `--status ` | Filter by execution status: `TRIGGERED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE` | +| `--start ` | Start of time range in ISO8601 format (e.g. `2026-01-01T00:00:00Z`) | +| `--end ` | End of time range in ISO8601 format (e.g. `2026-01-02T00:00:00Z`) | +| `--limit ` | Maximum number of executions to return (max 100, default 20) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout for scripting | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution list +cre execution list my-workflow +cre execution list my-workflow --status FAILURE +cre execution list my-workflow --start 2026-01-01T00:00:00Z --end 2026-01-02T00:00:00Z +cre execution list my-workflow --limit 50 --output json +``` + +*** + +## `cre execution status` + +Shows detailed status for a single workflow execution, including top-level errors when the run has failed. + +**Usage:** + +```bash +cre execution status [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID from `cre execution list` or the CRE UI + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------- | +| `--output ` | Output format. Use `json` to print JSON to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +*** + +## `cre execution events` + +Shows the ordered capability event timeline for a workflow execution, including per-event status, method, duration, and errors. + +**Usage:** + +```bash +cre execution events [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +| Flag | Description | +| ----------------------- | --------------------------------------------------------- | +| `--capability ` | Filter events to a specific capability ID | +| `--status ` | Filter events by status (e.g. `FAILURE`) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --capability fetch-price +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --status FAILURE --output json +``` + +*** + +## `cre execution logs` + +Shows log lines emitted during a workflow execution. + +**Usage:** + +```bash +cre execution logs [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------------------------ | +| `--node ` | Filter logs to a specific node or capability ID (case-insensitive) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --node ProcessData +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +## Learn more + +- [Monitoring & Debugging Workflows](/cre/guides/operations/monitoring-workflows) — Web UI monitoring dashboard +- [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) — Deployment health and recent execution for the workflow in `workflow.yaml` + +--- + # Registry Commands Source: https://docs.chain.link/cre/reference/cli/registry Last Updated: 2026-05-08 diff --git a/src/content/cre/llms-full-ts.txt b/src/content/cre/llms-full-ts.txt index 0f77a505826..30f72073c86 100644 --- a/src/content/cre/llms-full-ts.txt +++ b/src/content/cre/llms-full-ts.txt @@ -514,10 +514,25 @@ To help us assist you faster, please include: # Release Notes Source: https://docs.chain.link/cre/release-notes -Last Updated: 2026-07-02 +Last Updated: 2026-07-09 This page provides detailed release notes for CRE. It includes information on new features, significant changes, and known limitations. +## CLI v1.24.0 - July 9, 2026 + +**CRE CLI version 1.24.0 is now available.** + +- **Execution observability from the CLI**: New [`cre execution`](/cre/reference/cli/execution) commands let you inspect deployed workflow runs without opening the UI — `list` for recent executions (filter by status and time range), `status` for a single run, `events` for the capability timeline, and `logs` for emitted log lines. All support `--output json` for scripting. +- **Enhanced `cre workflow get`**: [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) now resolves the workflow from your `workflow.yaml` settings and shows deployment health plus the most recent execution, not just registry metadata. +- **Solana Write capability**: Workflows can now submit DON-consensus signed reports to Solana programs on Mainnet and Devnet via the Keystone Forwarder — the same secure write model as EVM. The CLI adds the tooling to build and test these workflows: `CRE_SOLANA_PRIVATE_KEY` for signing, `cre generate-bindings solana` for Go and TypeScript bindings from Anchor IDLs, and local write simulation with `cre workflow simulate` (dry run or `--broadcast`). + +**How to update:** + +- **Automatic update**: When you run any CRE command, the CLI will automatically detect if a newer version is available and prompt you to update. Simply run `cre update` to install the latest version. +- **Fresh installation**: If you're installing the CLI for the first time, follow the [CLI Installation guide](/cre/getting-started/cli-installation). + +[See all changes on GitHub](https://github.com/smartcontractkit/cre-cli/compare/v1.23.0...v1.24.0) + ## CLI v1.23.0 - July 2, 2026 **CRE CLI version 1.23.0 is now available.** @@ -8045,7 +8060,7 @@ See the [repository README](https://github.com/smartcontractkit/cre-gcp-predicti # CLI Reference Source: https://docs.chain.link/cre/reference/cli -Last Updated: 2026-05-14 +Last Updated: 2026-07-09 export const CRE_CLI_VERSION = VERSIONS["cre-cli"].LATEST @@ -8071,6 +8086,7 @@ These flags can be used with any `cre` command. | `-v, --verbose` | Enables verbose logging to print `DEBUG` level logs | | `--non-interactive` | Fails instead of prompting; provide all required inputs with flags or environment variables. Use this for CI/CD, scripts, and other headless environments | | `--allow-unknown-chains` | Skips chain-name validation against the chain-selectors registry for `cre workflow simulate` and `cre workflow deploy`. Use for experimental or unlisted chains. Chain-selector and RPC availability are still enforced | +| `--allow-insecure-rpc` | Allows non-localhost HTTP RPC URLs. By default, the CLI blocks cleartext RPC endpoints to reduce accidental secret exposure over insecure connections | -Shows metadata for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, searches the CRE platform for matching workflow metadata, and filters results to the workflow's configured `deployment-registry` by default. +Shows deployment health and the most recent execution for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, resolves the workflow on the CRE platform (scoped to the configured `deployment-registry` by default), and prints deployment health plus the latest execution. **Usage:** @@ -9041,25 +9070,33 @@ cre workflow get [flags] **Flags:** -| Flag | Description | -| ------------------ | ------------------------------------------------------------------------ | -| `--all-registries` | Do not filter results by the workflow's configured `deployment-registry` | +| Flag | Description | +| ------------------- | ------------------------------------------------------------------------------------------ | +| `--all-registries` | Resolve the workflow across every registry instead of the configured `deployment-registry` | +| `--output ` | Output format. Use `json` to print JSON to stdout for scripting | +| `--json` | Shorthand for `--output=json` | **Examples:** -- Show metadata for the workflow configured for a target +- Show deployment health and recent execution for the workflow configured for a target ```bash cre workflow get ./my-workflow --target staging-settings ``` -- Search across all registries in your organization +- Resolve across all registries in your organization ```bash cre workflow get ./my-workflow --target staging-settings --all-registries ``` -The command prints the same human-readable workflow metadata fields as [`cre workflow list`](#cre-workflow-list): workflow name, workflow ID, owner address, status, registry, and registry address when available. +- Export as JSON + + ```bash + cre workflow get ./my-workflow --target staging-settings --output json + ``` + +For a full execution history, use [`cre execution list`](/cre/reference/cli/execution#cre-execution-list). *** @@ -9227,6 +9264,161 @@ The typical workflow lifecycle uses these commands in sequence: --- +# Execution Commands +Source: https://docs.chain.link/cre/reference/cli/execution +Last Updated: 2026-07-09 + +The `cre execution` commands query workflow execution history from the CRE platform. Use them to debug failures, review capability timelines, and pull log lines without opening the web UI. + + + + + + + +For a quick health check on the workflow configured in your project, see [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get), which shows deployment health and the most recent execution. + +## `cre execution list` + +Lists recent workflow executions from the CRE platform. + +**Usage:** + +```bash +cre execution list [workflow-id-or-name] [flags] +``` + +**Arguments:** + +- `[workflow-id-or-name]` — (Optional) On-chain workflow ID (64-char hex, visible in [`cre workflow list`](/cre/reference/cli/workflow#cre-workflow-list)) or workflow name. When omitted, executions across all workflows are returned. + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------------------------------------- | +| `--status ` | Filter by execution status: `TRIGGERED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE` | +| `--start ` | Start of time range in ISO8601 format (e.g. `2026-01-01T00:00:00Z`) | +| `--end ` | End of time range in ISO8601 format (e.g. `2026-01-02T00:00:00Z`) | +| `--limit ` | Maximum number of executions to return (max 100, default 20) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout for scripting | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution list +cre execution list my-workflow +cre execution list my-workflow --status FAILURE +cre execution list my-workflow --start 2026-01-01T00:00:00Z --end 2026-01-02T00:00:00Z +cre execution list my-workflow --limit 50 --output json +``` + +*** + +## `cre execution status` + +Shows detailed status for a single workflow execution, including top-level errors when the run has failed. + +**Usage:** + +```bash +cre execution status [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID from `cre execution list` or the CRE UI + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------- | +| `--output ` | Output format. Use `json` to print JSON to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +*** + +## `cre execution events` + +Shows the ordered capability event timeline for a workflow execution, including per-event status, method, duration, and errors. + +**Usage:** + +```bash +cre execution events [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +| Flag | Description | +| ----------------------- | --------------------------------------------------------- | +| `--capability ` | Filter events to a specific capability ID | +| `--status ` | Filter events by status (e.g. `FAILURE`) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --capability fetch-price +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --status FAILURE --output json +``` + +*** + +## `cre execution logs` + +Shows log lines emitted during a workflow execution. + +**Usage:** + +```bash +cre execution logs [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +| Flag | Description | +| ------------------- | ------------------------------------------------------------------ | +| `--node ` | Filter logs to a specific node or capability ID (case-insensitive) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --node ProcessData +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +## Learn more + +- [Monitoring & Debugging Workflows](/cre/guides/operations/monitoring-workflows) — Web UI monitoring dashboard +- [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) — Deployment health and recent execution for the workflow in `workflow.yaml` + +--- + # Registry Commands Source: https://docs.chain.link/cre/reference/cli/registry Last Updated: 2026-05-08 diff --git a/src/content/cre/reference/cli/execution.mdx b/src/content/cre/reference/cli/execution.mdx new file mode 100644 index 00000000000..0ec5bfda810 --- /dev/null +++ b/src/content/cre/reference/cli/execution.mdx @@ -0,0 +1,160 @@ +--- +section: cre +date: Last Modified +title: "Execution Commands" +metadata: + description: "Inspect deployed workflow executions from the CLI: list runs, view status, events, and logs." + datePublished: "2026-07-09" + lastModified: "2026-07-09" +--- + +import { Aside } from "@components" + +The `cre execution` commands query workflow execution history from the CRE platform. Use them to debug failures, review capability timelines, and pull log lines without opening the web UI. + +{/* prettier-ignore */} + + +{/* prettier-ignore */} + + +For a quick health check on the workflow configured in your project, see [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get), which shows deployment health and the most recent execution. + +## `cre execution list` + +Lists recent workflow executions from the CRE platform. + +**Usage:** + +```bash +cre execution list [workflow-id-or-name] [flags] +``` + +**Arguments:** + +- `[workflow-id-or-name]` — (Optional) On-chain workflow ID (64-char hex, visible in [`cre workflow list`](/cre/reference/cli/workflow#cre-workflow-list)) or workflow name. When omitted, executions across all workflows are returned. + +**Flags:** + +|
Flag
| Description | +| ------------------------------------------ | ------------------------------------------------------------------------------- | +| `--status ` | Filter by execution status: `TRIGGERED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE` | +| `--start ` | Start of time range in ISO8601 format (e.g. `2026-01-01T00:00:00Z`) | +| `--end ` | End of time range in ISO8601 format (e.g. `2026-01-02T00:00:00Z`) | +| `--limit ` | Maximum number of executions to return (max 100, default 20) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout for scripting | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution list +cre execution list my-workflow +cre execution list my-workflow --status FAILURE +cre execution list my-workflow --start 2026-01-01T00:00:00Z --end 2026-01-02T00:00:00Z +cre execution list my-workflow --limit 50 --output json +``` + +--- + +## `cre execution status` + +Shows detailed status for a single workflow execution, including top-level errors when the run has failed. + +**Usage:** + +```bash +cre execution status [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID from `cre execution list` or the CRE UI + +**Flags:** + +|
Flag
| Description | +| ------------------------------------------ | ------------------------------------------------- | +| `--output ` | Output format. Use `json` to print JSON to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution status 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +--- + +## `cre execution events` + +Shows the ordered capability event timeline for a workflow execution, including per-event status, method, duration, and errors. + +**Usage:** + +```bash +cre execution events [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +|
Flag
| Description | +| ------------------------------------------ | --------------------------------------------------------- | +| `--capability ` | Filter events to a specific capability ID | +| `--status ` | Filter events by status (e.g. `FAILURE`) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --capability fetch-price +cre execution events 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --status FAILURE --output json +``` + +--- + +## `cre execution logs` + +Shows log lines emitted during a workflow execution. + +**Usage:** + +```bash +cre execution logs [flags] +``` + +**Arguments:** + +- `` — (Required) Execution UUID + +**Flags:** + +|
Flag
| Description | +| ------------------------------------------ | ------------------------------------------------------------------ | +| `--node ` | Filter logs to a specific node or capability ID (case-insensitive) | +| `--output ` | Output format. Use `json` to print a JSON array to stdout | +| `--json` | Shorthand for `--output=json` | + +**Examples:** + +```bash +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --node ProcessData +cre execution logs 7f3d8a12-b1c2-4d3e-9f0a-1b2c3d4e5f6g --output json +``` + +## Learn more + +- [Monitoring & Debugging Workflows](/cre/guides/operations/monitoring-workflows) — Web UI monitoring dashboard +- [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) — Deployment health and recent execution for the workflow in `workflow.yaml` diff --git a/src/content/cre/reference/cli/index.mdx b/src/content/cre/reference/cli/index.mdx index 261ac764990..359f63d10f4 100644 --- a/src/content/cre/reference/cli/index.mdx +++ b/src/content/cre/reference/cli/index.mdx @@ -6,7 +6,7 @@ isIndex: true metadata: description: "Explore all CRE CLI commands: complete reference for project setup, workflow deployment, account management, and development tools." datePublished: "2025-11-04" - lastModified: "2026-05-14" + lastModified: "2026-07-09" --- import { Aside } from "@components" @@ -36,6 +36,7 @@ These flags can be used with any `cre` command. | `-v, --verbose` | Enables verbose logging to print `DEBUG` level logs | | `--non-interactive` | Fails instead of prompting; provide all required inputs with flags or environment variables. Use this for CI/CD, scripts, and other headless environments | | `--allow-unknown-chains` | Skips chain-name validation against the chain-selectors registry for `cre workflow simulate` and `cre workflow deploy`. Use for experimental or unlisted chains. Chain-selector and RPC availability are still enforced | +| `--allow-insecure-rpc` | Allows non-localhost HTTP RPC URLs. By default, the CLI blocks cleartext RPC endpoints to reduce accidental secret exposure over insecure connections | {/* prettier-ignore */} -Shows metadata for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, searches the CRE platform for matching workflow metadata, and filters results to the workflow's configured `deployment-registry` by default. +Shows deployment health and the most recent execution for the workflow configured in `workflow.yaml`. The command reads the workflow name for the selected `--target`, resolves the workflow on the CRE platform (scoped to the configured `deployment-registry` by default), and prints deployment health plus the latest execution. **Usage:** @@ -495,25 +495,33 @@ cre workflow get [flags] **Flags:** -|
Flag
| Description | -| ------------------------------------------ | ------------------------------------------------------------------------ | -| `--all-registries` | Do not filter results by the workflow's configured `deployment-registry` | +|
Flag
| Description | +| ------------------------------------------ | ------------------------------------------------------------------------------------------ | +| `--all-registries` | Resolve the workflow across every registry instead of the configured `deployment-registry` | +| `--output ` | Output format. Use `json` to print JSON to stdout for scripting | +| `--json` | Shorthand for `--output=json` | **Examples:** -- Show metadata for the workflow configured for a target +- Show deployment health and recent execution for the workflow configured for a target ```bash cre workflow get ./my-workflow --target staging-settings ``` -- Search across all registries in your organization +- Resolve across all registries in your organization ```bash cre workflow get ./my-workflow --target staging-settings --all-registries ``` -The command prints the same human-readable workflow metadata fields as [`cre workflow list`](#cre-workflow-list): workflow name, workflow ID, owner address, status, registry, and registry address when available. +- Export as JSON + + ```bash + cre workflow get ./my-workflow --target staging-settings --output json + ``` + +For a full execution history, use [`cre execution list`](/cre/reference/cli/execution#cre-execution-list). --- diff --git a/src/content/cre/release-notes.mdx b/src/content/cre/release-notes.mdx index aa529e3270e..d0a747e1eba 100644 --- a/src/content/cre/release-notes.mdx +++ b/src/content/cre/release-notes.mdx @@ -5,13 +5,28 @@ date: Last Modified metadata: description: "Discover what's new in CRE: latest features, changes, and improvements in each release of the Chainlink Runtime Environment." datePublished: "2025-11-04" - lastModified: "2026-07-02" + lastModified: "2026-07-09" --- import { Aside } from "@components" This page provides detailed release notes for CRE. It includes information on new features, significant changes, and known limitations. +## CLI v1.24.0 - July 9, 2026 + +**CRE CLI version 1.24.0 is now available.** + +- **Execution observability from the CLI**: New [`cre execution`](/cre/reference/cli/execution) commands let you inspect deployed workflow runs without opening the UI — `list` for recent executions (filter by status and time range), `status` for a single run, `events` for the capability timeline, and `logs` for emitted log lines. All support `--output json` for scripting. +- **Enhanced `cre workflow get`**: [`cre workflow get`](/cre/reference/cli/workflow#cre-workflow-get) now resolves the workflow from your `workflow.yaml` settings and shows deployment health plus the most recent execution, not just registry metadata. +- **Solana Write capability**: Workflows can now submit DON-consensus signed reports to Solana programs on Mainnet and Devnet via the Keystone Forwarder — the same secure write model as EVM. The CLI adds the tooling to build and test these workflows: `CRE_SOLANA_PRIVATE_KEY` for signing, `cre generate-bindings solana` for Go and TypeScript bindings from Anchor IDLs, and local write simulation with `cre workflow simulate` (dry run or `--broadcast`). + +**How to update:** + +- **Automatic update**: When you run any CRE command, the CLI will automatically detect if a newer version is available and prompt you to update. Simply run `cre update` to install the latest version. +- **Fresh installation**: If you're installing the CLI for the first time, follow the [CLI Installation guide](/cre/getting-started/cli-installation). + +[See all changes on GitHub](https://github.com/smartcontractkit/cre-cli/compare/v1.23.0...v1.24.0) + ## CLI v1.23.0 - July 2, 2026 **CRE CLI version 1.23.0 is now available.**