Skip to content

Releases

11.7.0.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 22:23
cardano-cli-11.7.0.0
24c0582

Changelog

  • Bump cardano-api to 11.12.0 and add Dijkstra protocol parameter options to governance action create-protocol-parameters-update for the minimum pool margin, maximum pledge leverage, Peras parameters, and reference-input costs. --no-max-pledge-leverage and --no-peras-bootstrap-round propose setting those optional parameters to no value.
    (feature)
    PR 1497

  • Add support for printing sub-transaction data to transaction view.
    (compatible, feature)
    PR 1492

  • Add cardano-cli dijkstra stake-pool bls-registration-certificate offline with --registration-certificate-file, --bls-signing-key-file and --out-file. It reads an existing stake pool registration certificate and writes a new one that keeps every pool parameter and replaces only the pool's BLS key and its proof of possession, both derived from the given BLS signing key. Use it to register a BLS key for a pool for the first time or to rotate it later, without re-entering pool parameters, so they cannot change by accident. The command prints the pool ID and the old and new BLS keys, and warns when the new key equals the old one. It also accepts registration certificates created in the Conway era, including files written by earlier cardano-cli versions, and treats them as having no BLS key.
    (feature)
    PR 1489

  • Add debug certificate view, which prints a certificate file as JSON or YAML.
    (feature)
    PR 1488

  • Certificates in debug transaction view use new keys, so update scripts that read them; pool registrations show pool id, vrf key hash, reward account (bech32) and margin (a fraction), DRep keys are spelled DRep and the credential key is DRep credential, and committee certificates show every credential and anchor.
    (breaking)
    PR 1488

  • Read standard input when an input file path is - in commands that also read pipes, such as --certificate-file in debug certificate view and --tx-file in debug transaction view.
    (feature)
    PR 1488

  • Add Dijkstra sub-transaction witness and assemble commands to create key witnesses separately and combine them with an unsigned sub-transaction, rejecting witnesses whose signatures do not match its body.
    (feature)
    PR 1485

  • Add CIP-159 --account-balance-interval and --starting-account-balance-interval to Dijkstra transaction build, build-raw, and build-estimate; sub-transaction build-raw supports only the former. Values use STAKE_ADDRESS{=N|>=L|<U|>=L,<U} in lovelace, with inclusive lower bounds, exclusive upper bounds, and L < U. Add matching builder argument fields and always display intervals and sub-transactions in JSON/YAML views, with interval amounts in Lovelace.
    (feature)
    PR 1483

  • Add native and Plutus V4 script guards to Dijkstra transaction build, build-raw, and build-estimate, with inline or reference scripts, guarding redeemers, and automatic or explicit execution budgets. Native reference guards use --simple-guard-script-tx-in-reference; Plutus V4 reference guards use --guard-tx-in-reference with --guard-plutus-script-v4 and require a redeemer.
    (feature)
    PR 1477

11.6.0.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 16:31
90cc2b9

Changelog

  • Update to cardano-api 11.11 and adapt Dijkstra sub-transaction construction to validated, insertion-ordered TxGuards while preserving existing guard witness handling. Add TxCmdGuardsError to the exposed TxCmdError type to report API guard-validation failures.
    (compatible)
    PR 1486

11.5.0.0

Choose a tag to compare

@github-actions github-actions released this 23 Oct 18:59
cardano-cli-11.5.0.0
39d1d37

Changelog

  • debug check-node-configuration now reads the configuration with cardano-config. It accepts both the old flat format and the new cardano-config format.
    Genesis hashes are now required. Before, a configuration without them was accepted, and only the hashes it gave were checked.
    Every genesis file is now decoded, not only hashed.
    With ExperimentalHardForksEnabled, the configuration must also name a DijkstraGenesisFile and its DijkstraGenesisHash, and that file is checked too.
    The initial data in the Shelley and Conway genesis files, such as initialFunds, is now checked too: it is rejected on mainnet, when it is given both at the top level and under extraConfig, or when a file it names is missing.
    The success message now goes to stderr instead of stdout.
    DebugNodeConfigWrongGenesisHashCmdError is replaced by DebugNodeConfigReadCmdError, which carries the configuration file path and cardano-api's NodeConfigError.
    (breaking)
    PR 1475

  • Show direct-deposit recipients and amounts in Dijkstra transaction JSON and YAML views.
    (bugfix)
    PR 1470

11.4.0.0

Choose a tag to compare

@github-actions github-actions released this 16 Oct 19:15
cardano-cli-11.4.0.0
25f4d7a

Changelog

  • Remove --script-valid and --script-invalid from Dijkstra transaction build, build-raw and build-estimate in preparation for CIP-0167; retain both options for Conway.
    (breaking)
    PR 1474

  • Add --direct-deposit STAKE_ADDRESS+LOVELACE to Dijkstra transaction build, build-raw and build-estimate, and sub-transaction build-raw, to deposit ADA into registered accounts. Reject duplicate recipients and include deposits in automatic fee balancing.
    (feature)
    PR 1469

  • CARDANO_ERA now accepts every era cardano-api supports, including dijkstra, in any letter case, and an unknown value stops the command with an error that lists the valid eras.
    (bugfix)
    PR 1452

  • transaction policyid and address build with --payment-script-file or --stake-script-file now accept Plutus V4 scripts, instead of failing with "Plutus language PlutusScriptV4 is not supported in the Conway era". They also accept simple scripts with a guard, which used to crash them.
    (bugfix)
    PR 1452

  • A transaction output whose reference script is written in a Plutus language not supported by the transaction's era now makes the command fail with a clear error, instead of silently building the transaction with that reference script dropped from the output.
    (bugfix)
    PR 1452

  • Add a repeatable --tx-in-collateral option to compatible transaction signed-transaction, available from the Alonzo era onwards, so transactions with Plutus witnesses can include collateral inputs.
    (feature)
    PR 1408

11.3.1.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 13:32
cardano-cli-11.3.1.0
fc466f2

Changelog

  • genesis create-testnet-data now lists --spec-dijkstra in its help (it was hidden before). It takes a Dijkstra genesis file to start from, like --spec-conway does for Conway.
    (feature)
    PR 1465

  • Add the Dijkstra-only dijkstra sub-transaction command group with build-raw (builds an unsigned sub-transaction from the Conway-era transaction options plus --guard-key-hash, --guard-verification-key, --guard-verification-key-file and --guard-script-hash), sign and txid, and add a repeatable --signed-sub-tx-file FILE option to dijkstra transaction build-raw that embeds signed sub-transactions in a top-level transaction. Sub-transactions are written as Unwitnessed SubTx DijkstraEra / Witnessed SubTx DijkstraEra text envelopes.
    Sub-transaction build-raw supports --out-canonical-cbor before signing. Canonical output of a top-level transaction rejects embedded sub-transactions whose signed body bytes would change.
    Canonical output rejects changes to hashed metadata, redeemers, datums and native scripts within sub-transactions, including embedded signed sub-transactions, rather than writing invalid hashes.
    Sub-transaction builders expose only Plutus V4 reference-script selectors and reject Plutus V1-V3 script files; native scripts and key witnesses remain supported.
    Add Dijkstra-only Plutus V4 reference-script flags for spending, minting, certificates, withdrawals, voting and proposals in both top-level and sub-transaction builders.
    (feature)
    PR 1453

  • Add repeatable --top-level-guard-key-hash, --top-level-guard-verification-key, --top-level-guard-verification-key-file, --top-level-guard-script-hash and --top-level-guard-script-file options to dijkstra sub-transaction build-raw to specify credentials required as guards in the enclosing top-level transaction.
    Script guards accept an optional datum as an inline value, a JSON file, or a CBOR file. For script files, require Plutus V4 and a datum for Plutus scripts, and reject datums for native scripts. Key guards do not accept datums. For script hashes, leave script-language validation to the ledger.
    Reject repeated top-level guard credentials and list the duplicates, including keys and scripts supplied in different forms.
    (feature)
    PR 1453

11.3.0.0

Choose a tag to compare

@github-actions github-actions released this 07 Oct 23:31
cardano-cli-11.3.0.0
b8bbda7

Changelog

  • The IPv4 address of a stake pool's registered relay is no longer byte-reversed in stake pool registration certificates, in pool state query output, or in transaction view output; this is fixed by requiring cardano-ledger-binary 1.9.1.0 (#1442).
    (bugfix)
    PR 1451

  • stake-pool registration-certificate can now register a stake pool's BLS voting key. The new --bls-signing-key-file FILEPATH option is era-gated: it is mandatory from the Dijkstra era onwards and not offered in Conway or earlier, so existing Conway invocations are unaffected. The signing key is read as a text envelope (produce one with node key-gen-BLS) and converted to the registered verification key plus proof of possession via toLedgerBlsKey.
    Genesis pool parameters built by genesis create-staked and genesis create-testnet-data set the new ledger sppBlsKey field to SNothing.
    (feature)
    PR 1439

  • Fix Dijkstra era commands (BLS key generation, transaction witness/assemble) that were failing with "TODO DijkstraEra" because the era dispatch in runAnyEraCommand was unconditionally calling obtainCommonConstraints, which is not yet implemented for DijkstraEra. Commands that do not require EraCommonConstraints now work correctly for the Dijkstra era.
    (bugfix)
    PR 1439

  • Add new Leios parameters to create-protocol-parameters-update command line options
    (feature)
    PR 1439

  • Removed the node issue-pop-BLS and node key-hash-BLS commands. A pool's BLS proof of possession is now built straight into the registration certificate from the signing key given to stake-pool registration-certificate --bls-signing-key-file, so there is no need to issue one as a standalone artifact; a standalone BLS key hash was never needed at all. Both commands shipped in 10.16.0.0 but no node release ever made use of their output, so removing them breaks no existing workflow. node key-gen-BLS is unaffected, and either command can be reinstated if a concrete use case turns up.
    (breaking)
    PR 1439

  • Adapt to cardano-ledger-core 1.22, where mkStakePoolState stamps a pool's BLS voting key with the epoch its registration takes effect in. The pool-state query does not report that epoch yet, so query pool-state fills bksRegisteredIn with the epoch the parameters take effect in: the current epoch for the active parameters and the next one for the future parameters. The reported value is a placeholder until the ledger exposes the real one (IntersectMBO/cardano-ledger#6147); the feature is not yet used on mainnet.
    (compatible)
    PR 1439

11.2.3.1

Choose a tag to compare

@github-actions github-actions released this 04 Sep 09:46
80d5595

Changelog

  • Update cardano-api to 11.7.0.0, fixing plutus redeemer pointer indexing in transaction building: proposal pointers now follow the transaction's insertion order and certificate pointers count unwitnessed certificates.
    (bugfix)
    PR 1440

11.2.3.0

Choose a tag to compare

@github-actions github-actions released this 03 Sep 10:03
eac27b8

Changelog

  • Bumped ouroboros-consensus to address issue that affected queries query kes-period-info and query tip.
    (bugfix)
    PR 1436

  • The dijkstra era subcommand now provides the full command set: address, key, genesis, governance, query, stake-address, stake-pool, text-view and transaction commands, matching the other eras; previously only the node commands were available.
    (feature)
    PR 1431

  • transaction view now renders Dijkstra-era certificates instead of failing with an internal TODO error.
    (feature)
    PR 1430

  • Protocol-parameter update proposals can now be created in the Dijkstra era with governance action create-protocol-parameters-update, including cost models and the parameters the era introduces: maximum reference-script size per block and per transaction, and the reference-script cost stride and multiplier.
    (feature)
    PR 1429

  • Simple scripts read from JSON files now work in the Dijkstra era, instead of aborting with an internal TODO error.
    (feature)
    PR 1427

  • Fixed transaction assemble (also known as transaction sign-witness) rejecting witness files from eras after Conway: witness files from every supported era, including Dijkstra, are now accepted.
    (bugfix)
    PR 1426

11.2.2.0

Choose a tag to compare

@github-actions github-actions released this 25 Aug 16:44
5deecc8

Changelog

  • Bump cardano-api to 11.6.0.0.
    (compatible)
    PR 1424

  • Commands that query a node now check that the network id given to the CLI (--mainnet, --testnet-magic, or CARDANO_NODE_NETWORK_ID) matches the network id in the node's genesis, so that for example CARDANO_NODE_NETWORK_ID=764824073 against a mainnet node no longer renders addresses with a testnet prefix. Additionally, query stake-address-info now fails when the given stake address does not match the network id, instead of silently dropping the address's network tag.
    (bugfix, test)
    PR 1405

11.2.1.0

Choose a tag to compare

@github-actions github-actions released this 19 Aug 10:59
7cb4f2b

Changelog

  • Bump cardano-api to 11.5, bump CHaP index-state, fix byronGenesis name-shadowing warning
    (compatible)
    PR 1418

From unreleased 11.2.0.0

  • Fixed cardano-cli ping's dependency on the command line parser of cardano-diffusion:ping, which made the released package unbuildable with default cabal flags (it required a manual optparse-applicative-fork cabal flag set via cabal.project, which does not ship with the sdist). The parser is replaced with a behaviourally identical local one; the command line interface is unchanged.
    (bugfix)
    PR 1413

  • Fix query utxo --output-text rendering a dangling " + " separator after the value for pre-Babbage era outputs. Outputs of eras without datums (Shelley to Mary) now end at the value, and Alonzo era outputs now render their datum hash the way Babbage+ outputs do. Golden tests added for the text rendering.
    (bugfix, test)
    PR 1399

  • Fix help messages in anchor hashing functions to display the right protocols supported
    (bugfix)
    PR 1396

  • new cardano-cli ping api

    cardano-cli ping allows now to ping multiple servers, does domain name
    resolution and supports SRV records (as specified in
    https://cips.cardano.org/cip/CIP-0155)

    Some examples:

    Run a ping against two ip addresses, ipv4 & ipv6

    cardano-cli ping 127.0.0.1:3001 [::1]:3001

    Run a ping against a domain name:

    cardano-cli ping my.domain.com:3001

    Run a ping against an SRV domain.
    According to CIP#0155 the SRV record needs to be registered at
    _cardano._tcp.srv.domain.com

    cardano-cli ping srv.domain.com

    Run a ping against unix socket

    cardano-cli ping /var/run/cardano-node.socket

    cardano-cli ping has three modes of operation:

    • ping mode: --mode ping (the default)
    • tip mode --mode tip
    • query handshake parameters: --mode query
      (breaking, feature)
      PR 1384
  • The interface for cardano-cli ping has been reshuffled:

    Removed:

    • -h/--host, -u/--unixsock and -p/--port. The target is now given as a
      positional argument instead (see below).
    • -Q/--query-versions, replaced by --mode query.
    • -t/--tip, replaced by --mode tip.

    Renamed:

    • -m/--magic is now -m/--network-magic.

    Added:

    • A positional ADDRS argument, which accepts one or more targets: an IP/DNS address
      with a port (127.0.0.1:3001, [::1]:3001, example.org:3001), an SRV name, or a
      UNIX socket path.
    • --mode MODE, one of ping (keep-alive, node-to-node only), tip (chain-sync) or
      query (handshake parameters).
    • --srv-prefix SRV_PREFIX, the prefix prepended to an SRV service name
      (default _cardano._tcp).
    • --color COLOR, one of auto, never or always.
    • --short-hash, to show an abbreviated tip hash.

    Note that -h is now only a short form of --help; it no longer means --host.
    (breaking, feature)
    PR 1384

  • genesis create, genesis create-staked and genesis create-testnet-data now write
    initial funds, stake pools, stake credentials, delegations and initial DReps into the
    extraConfig field of the generated Shelley and Conway genesis files, leaving the
    deprecated top-level initialFunds, staking, delegs and initialDReps fields
    empty.
    (breaking)
    PR 1384

  • --pool-relay-port is now required when --single-host-pool-relay is given. Use an
    SRV record via --multi-host-pool-relay if the port should be resolved rather than
    stated explicitly.
    (breaking)
    PR 1384

  • stake-pool registration-certificate gained a --validate-relays flag. When it is
    given, each relay passed on the command line is checked for reachability by connecting
    to it with cardano-diffusion:ping, and the command fails with the collected errors if
    any relay cannot be reached. The flag is opt-in: without it the certificate is created
    without any network access, as before.
    (feature)
    PR 1384

From unreleased 11.1.0.0

  • Fix cardano-cli transaction view rendering inline datums as a Haskell-Show
    string instead of the structured JSON detailed-schema dict. The friendly tx
    renderer's L.Datum branch in friendlyTxOut now routes through
    scriptDataToJson ScriptDataJsonDetailedSchema . fromAlonzoData, restoring the
    pre-#1374 output shape for inline-datum outputs.
    (bugfix)
    PR 1379

  • Add --key-output-bech32/--key-output-text-envelope to governance key-gen commands.
    (feature, compatible)
    PR 1378

  • Migrate the friendly transaction renderer (Cardano.CLI.Compatible.Json.Friendly) off the old-API Tx/TxBody/TxBodyContent onto Exp.SignedTx/Exp.UnsignedTx. The public renderer entry points and every internal helper now use Exp.Era era and Exp.LedgerEra era. cardano-cli debug transaction view and cardano-cli transaction view now only accept Conway and Dijkstra tx/tx-body files. Pre-Conway files fail with a DeprecatedEra error.
    (breaking, refactoring)
    PR 1374

  • Remove the deprecated --update-proposal-file flag from era-based transaction build and transaction build-raw. Update proposals are deprecated since Conway and the flag was already a no-op for Conway+. The flag is kept for compatible transaction signed-transaction where pre-Conway eras still need it.
    (breaking)
    PR 1372