0.11.0

Release to complete the L2 ledger isomorphism by supporting timed transactions and functional changes related to committing funds to a Hydra Head. Notably, external commits should be used now and this release does deprecate the "internal commits" feature.

⚠️ IMPORTANT: There are several known issues, which are explained in the documentation.

---

Built artifacts

• 📦 Static x86_64-linux binaries: here (also attached)
• 🐳 Docker image: here

Hydra Scripts

Transaction IDs to be used as --hydra-scripts-tx-id when running hydra-node on the following networks:

• preview: 90acbeb0ebece3b5319625eedca3f6514870c9414872d9e940c6b7d7b88178fd checked in smoke test #111
• preprod: 010f68ad75cda7983b68a7691ba1591fa9ce4cfc03ac35d1c6c90cae4b48f849 checked in smoke test #116 (see also #960)
• mainnet: eb4c5f213ffb646046cf1d3543ae240ac922deccdc99826edd9af8ad52ddb877 checked in smoke test #117

---

This release contains breaking changes of the persistence and on-chain scripts
and you'll need to apply the following procedure to upgrade all the nodes
running a head:

1. Close the head
2. Stop hydra-node
3. Remove persistent files stored in --persistence-dir, in particular
   server-output and state
4. Upgrade hydra-node version
5. Start new hydra-node version with new --hydra-scriptx-tx-id and updated
   command line options.
6. Open a new head

---

• BREAKING Allow to commit multiple UTxO #774

  • This changes hydra-plutus scripts to allow commit transactions which spend multiple UTxOs into a Hydra head.
  • Removes the MoreThanOneUTxOCommitted server output on the API.

• Suport commits from external wallets #215

  • Added the /commit HTTP endpoint to the hydra-node for creating a draft commit transaction to commit requested UTxO into a head. This transaction can be signed and submitted to the network by the hydra client now instead of hydra-node.
  • Commits via /commit also allow to commit scripts into a Hydra Head. For that, the UTxO entry in the HTTP request needs to provide a witness with scrpit, datum, and redeemer to be used.
  • Removed the need to mark fuel when using external commits. Fees for Hydra protocol transactions are paid the largest UTxO held by the internal wallet if no marked fuel UTxO is present.
  • BREAKING The hydra-tui now uses the --cardano-signing-key to select and commit "external funds" to the Hydra Head. If you have used this in the past, make sure to not use the same key as also given to the hydra-node.

• DEPRECATED the Commit command to commit funds held by the hydra-node internal wallet. Use the external commit feature instead.

• Make hydra-node support time bounded transactions #196

  • The hydra-node tracks time as seen on-chain and uses that to validate any transactions, which can now use validity ranges the same way as on the layer 1.
  • Added current chain slot and time to log outputs.

• BREAKING API output SnapshotConfirmed only includes transaction ids. #922

• BREAKING Changed to the persisted state by removing the plutus scripts from the internal chain state and adding the headId.

  • Only the seedTxIn parameter is stored and the hydra-node will use the script compiled into it instead.
  • This substantially decreases the size of persisted and logged data.

• BREAKING Changed the hydra-node command line options:

  • Removed --ledger-genesis argument and query this information from cardano-node now. #863
  • --version always displays git revision (SHA) alongside the declared version. #849

• Fixed a bug where hydra-node resets head state when replaying close of another head. #927

• Fixed a bug where hydra-node reports a wrong head status on Greetings after restart. #932

• Decreased verbosity of logs #849

  • BeginEvent/EndEvent and BeginEffect/EndEffect log items are now paired using a numeric eventId and effectId.
  • Repurpose log-filter executable to compute duration of events and effects.

Full Changelog: 0.10.0...0.11.0

---

New Contributors:

• @Agustinblockchain made their first contribution in #866
• @uhbif19 made their first contribution in #918

Other contributors to this release: @abailly-iohk @ch1bo @v0d1ch @ffakenz @pgrange