# in-toto v3.0.0

2024-05-14 · [Original release notes](https://github.com/in-toto/in-toto/releases/tag/v3.0.0) · [Full summary](https://ratatosk.io/en/releases/in-toto/v3.0.0)

Breaking changes 3 · Dependency updates 1

## Breaking changes (3)

### Deprecated signature-related CLI arguments removed

- Affects: commands using `-k`/`--key`, `-t`/`--key-type`, `-k`/`--layout-keys`, or `--key-types` (Inferred)

The CLI previously accepted these deprecated arguments. The PR names `--signing-key` and `--verification-keys` as replacements for the old key and layout-key arguments.

Evidence: “This PR removes deprecated CLI and API arguments related to signature creation and verification.” https://github.com/in-toto/in-toto/pull/739

> Remove deprecated CLI/API arguments and legacy securesystemslib integration (#739)

https://github.com/in-toto/in-toto/blob/v3.0.0/CHANGELOG.md

### Legacy in-toto signing APIs and key-dictionary path removed

- Affects: applications using the removed `signing_key` arguments, `Metablock.sign(key)`, or legacy `SSlibSigner` integration (Inferred)

Before this release, the run and record APIs accepted `signing_key` arguments, and `Metablock.sign(key)` was available; those calls no longer work. `Metablock.create_signature()` replaces `Metablock.sign()`, while the `Signer` API remains.

Evidence: “-from securesystemslib.signer import Key, Signature, Signer, SSlibSigner +from securesystemslib.signer import Key, Signature, Signer” https://github.com/in-toto/in-toto/pull/739

> Remove deprecated CLI/API arguments and legacy securesystemslib integration (#739)

https://github.com/in-toto/in-toto/blob/v3.0.0/CHANGELOG.md

### Removal of the `pynacl` optional dependency

- Affects: setups using the `pynacl` optional dependency or securesystemslib `pynacl` extra (Inferred)

Previously, the project exposed a `pynacl` optional dependency and required securesystemslib with the `crypto,pynacl` extras. The metadata now omits that optional dependency and lists securesystemslib with only the `crypto` extra.

Evidence: “-securesystemslib[crypto,pynacl]>=0.28.0 +securesystemslib[crypto]>=0.28.0” https://github.com/in-toto/in-toto/pull/739

> Remove deprecated CLI/API arguments and legacy securesystemslib integration (#739)

https://github.com/in-toto/in-toto/blob/v3.0.0/CHANGELOG.md

## Dependency updates (1)

1 more, none mentioning security

- `Update securesystemslib v1.0.0 (#740)`

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
