Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 2 additions & 2 deletions .claude/skills/fireblocks-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@ Always pass `--no-confirm` on write operations. The CLI auto-skips prompts when
## Output

- **stdout**: JSON data only.
- **stderr**: warnings, beta notices, errors, debug logs.
- **stderr**: warnings, errors, debug logs.
- `--debug` output on stderr: `[DEBUG] METHOD URL`, `[DEBUG] Body: ...`, `[DEBUG] Response: STATUS`, `[DEBUG] Request-ID: ...`
- Beta commands print to stderr: `Warning: This command is in beta and may change in future releases.` This is informational, not an error.
- When a response reports a non-GA lifecycle state (`beta`, `deprecated` or `closed`), the CLI prints one line to stderr naming the operation, for example `Warning: Operation 'getWebhooks' is in 'beta' lifecycle state and is not generally available. ...`. For `deprecated` operations it includes the sunset date and, when the API provides them, the replacement and migration guide. A `closed` operation that returns `410 Gone` prints no warning; one that still responds (a temporary exception) warns that it has been closed and access may be revoked. This is informational, not an error: stdout and the exit code are unchanged. Set `FIREBLOCKS_SDK_SUPPRESS_LIFECYCLE_WARNING=1` to suppress it.

## Exit Codes

Expand Down
163 changes: 0 additions & 163 deletions CHANGELOG.md

This file was deleted.

18 changes: 17 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,10 @@ sha256sum <downloaded-file>
shasum -a 256 <downloaded-file>
```

## Versioning

This CLI follows [semantic versioning](https://semver.org), with one exception: commands that call operations in the `beta` lifecycle state. Beta operations are not generally available and may not be accessible to all customers. They can change or be removed without notice.

## Quick start

```bash
Expand Down Expand Up @@ -167,7 +171,19 @@ Write operations run against your workspace's **Transaction Authorization Policy
## Output and errors

- **stdout**: JSON data only
- **stderr**: warnings, beta notices, debug logs, and errors
- **stderr**: lifecycle warnings, debug logs, and errors

**Lifecycle warnings.** When a response reports a non-GA lifecycle state (`beta`, `deprecated` or `closed`), the CLI prints one line to stderr naming the operation. The state is read from the `Fireblocks-Lifecycle-State` response header, so it is accurate whatever CLI version you have installed:

```
Warning: Operation 'getWebhooks' is in 'beta' lifecycle state and is not generally available. It may change or be removed without notice.
```

For `deprecated` operations it includes the sunset date, plus the replacement and migration guide when the API provides them. A `closed` operation is normally answered with `410 Gone`, which needs no warning; if it still responds (your workspace has a temporary exception), the CLI warns that the operation has been closed and your access may be revoked. The warning is informational: stdout and the exit code are unchanged, and it also appears on error responses. To suppress it, set `FIREBLOCKS_SDK_SUPPRESS_LIFECYCLE_WARNING` to any value other than `0` or `false`:

```bash
export FIREBLOCKS_SDK_SUPPRESS_LIFECYCLE_WARNING=1
```

Errors are structured JSON on stderr:

Expand Down
4 changes: 2 additions & 2 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@ Always pass `--no-confirm` on write operations. The CLI auto-skips prompts when
## Output

- **stdout**: JSON data only.
- **stderr**: warnings, beta notices, errors, debug logs.
- **stderr**: warnings, errors, debug logs.
- `--debug` output on stderr: `[DEBUG] METHOD URL`, `[DEBUG] Body: ...`, `[DEBUG] Response: STATUS`, `[DEBUG] Request-ID: ...`
- Beta commands print to stderr: `Warning: This command is in beta and may change in future releases.` This is informational, not an error.
- When a response reports a non-GA lifecycle state (`beta`, `deprecated` or `closed`), the CLI prints one line to stderr naming the operation, for example `Warning: Operation 'getWebhooks' is in 'beta' lifecycle state and is not generally available. ...`. For `deprecated` operations it includes the sunset date and, when the API provides them, the replacement and migration guide. A `closed` operation that returns `410 Gone` prints no warning; one that still responds (a temporary exception) warns that it has been closed and access may be revoked. This is informational, not an error: stdout and the exit code are unchanged. Set `FIREBLOCKS_SDK_SUPPRESS_LIFECYCLE_WARNING=1` to suppress it.

## Exit Codes

Expand Down
Loading
Loading