Skip to content

Releases: dQuadrant/kuber

4.2.0 : cardano-node-11 support

22 May 08:19

Choose a tag to compare

This release builds on v4.1.2 with a platform upgrade to Cardano node 11, chain-query API cleanup, and stronger integration test coverage.

Highlights

  • Upgraded Kuber packages and Docker defaults to support cardano-node 11.0.1 and cardano-api ^>= 11.0.
  • Added documented support for the /api/v3/era-history endpoint.
  • Removed the older LocalChainQuery interface in favor of the current chain-query path used across the library, server, and client.
  • Expanded integration and API test coverage around node-v11 compatibility and query behavior.

Changes

Platform and Compatibility

  • Updated package constraints across the core Kuber packages for the Cardano node 11 toolchain.
  • Raised the default Cardano node image in docker-compose.yml to cardano-node 11.0.1.
  • Refreshed cabal configuration and build inputs required by the newer network and ledger packages.

API and Library Changes

  • Added /api/v3/era-history to the published Kuber API reference docs.
  • Simplified chain-query internals by removing LocalChainQuery and aligning the HTTP/client and local-node codepaths.
  • Updated transaction, parser, and data-model handling for the Cardano node 11 era and import changes.

Quality

  • Added shared integration test setup and broadened coverage in API, parser, and transaction tests.
  • Fixed tests and supporting fixtures to match the updated query and transaction behavior.

Compatibility

  • cardano-api: 11.0
  • cardano-node: 11.0.1

v4.0.0 : Docs and tooling

23 Feb 10:41

Choose a tag to compare

Highlights

  • Reorganized and refreshed the docs, especially the Hydra and tx builder references.
  • Added common Kuber functions to the Hydra JS client docs.

Fixes

  • Prevent insufficient input errors in Hydra by starting tx fee at 0 for already balanced transactions.
  • Refactored and fixed decommit API endpoints in kuber-hydra.

Docs and tooling

  • Added a local devnet reset script and setup helpers for Hydra clusters.
  • Added Cardano node configs and genesis files for the devnet cluster.
  • Improved credential generation and UTxO seeding scripts.
  • Added yarn doc:validate.
  • Improved getting started content and navigation.
  • Fixed broken links for kuber-hydra and kuber-client.
  • Updated the README and cleaned up docs organization.
Libraries
Tested with
  • hydra-node:1.2.0

v4.0.0-rc1: Hydra Integration

12 Aug 06:33

Choose a tag to compare

This release introduces kuber-hydra, a dedicated module that adds full Hydra head
support to Kuber. The new module exposes a set of command and query APIs for
committing, decommitting, closing, fan‑out, contesting, and querying the state of a
Hydra head, along with a transaction‑builder helper and APIs.

Note : kuber-hydra executable additionally exposes all layer1 endpoints making it versatile for both hydra and l1 interaction.

DependsOn
  • cardano-api:10.1
Tested with
  • hydra-node:0.22.0-65b4c1201e7533d4269d42e2ca1c8b53f999454f

New moudle: kuber-hydra

  • Added new module kuber-hydra with:
    • Command endpoints under /api/hydra:
      • POST /hydra/init
      • POST /hydra/abort
      • POST /hydra/commit
      • POST /hydra/decommit
      • POST /hydra/close
      • POST /hydra/contest
      • POST /hydra/fanout
      • POST /hydra/tx
      • POST /hydra/submit
    • Query endpoints under /api/hydra/query:
      • GET /hydra/query/utxo
      • GET /hydra/query/head
      • GET /hydra/query/protocol-parameters
      • GET /hydra/query/state
      • GET /hydra/query/commits
  • Implemented a Hydra transaction‑builder that:
    • Selects inputs/outputs
    • Handles optional signing keys
    • Filters UTxOs by txin and address
  • Updated Hydra‑specific documentation and added sequence diagrams illustrating
    typical Hydra head interactions.

Release Docker images

Client Package

3.1.1 : Conway era minor fixes

25 Sep 06:19

Choose a tag to compare

Fixes

  • Collateral selection logic now prefers 5Ada inputs
  • Multiple collateral inputs if collateral is not sufficient with 1 utxo.

Release Docker image

dquadrant/kuber:3.1.1

3.1.0: Stable Conway Era Support

03 Sep 10:53

Choose a tag to compare

DependsOn

Release Docker Image

Changes: kuber-server

  • new endpoint /api/v3/health now returns node's current tip and secondsSince last block was minted. If lastBlock was seen before 300 secs, status code will be 503

Changes: lib:kuber

  • when not set, kuber will automatically fill in following field by querying ledger state
    • proposal.deposit
    • proposal.previousGovActionId
    • proposal.executionUnits
    • certificates.deposit

Fixes

  • Fix catchError function on Unhandled error
  • Add exception handler on txSubmission
  • Use FrameworkError explicitly to improve error handling
  • Make Kontract instance of MonadError and Alternative
  • Show proper error message for plutus error
  • add ex-unit test
  • Fix fromJson of proposal field
  • fix utxoModal parsing problem
  • PlutusV3 Support

Known Issues :

  • lib:kuber : Kontract will omit following fields when using RemoteKuberConnection : $.proposal[s], $.votes[s] or $.certificate[s]

Litmiations:

  • script dreps are not supported
  • voting with script key is not supported

3.0.0-rc4: Bug Fixes, New Features & Kuber-Client Updates

13 Feb 07:40

Choose a tag to compare

New Features:

  • Introduced kQueryCurrentEra functionality to retrieve the current era information.
  • Added kQueryStakeDeposit feature for querying stake deposit details.
  • Implemented kQueryDrepState functionality for querying DREP state.
  • Enabled automatic withdrawal amount evaluation for stake deregistration during Conway Era.

Bug Fixes:

  • Resolved an issue in kQueryUTXOByAddress where only one UTXO was returned. Parsing issue has been fixed to ensure correct handling.
  • Fixed an error in kCalculateMinFee related to single fork encoded hardcoded era Conway.
  • Implemented functionality for TxOutDatumInTx to support datum in Auxiliary data.
  • Enabled kBuildTx functionality to work on RemoteKuberConnection.

Updates:

  • Updated toJSON parsing for TxInputScriptTxIn, which includes updates to JSON schemas for UTXO.

3.0.0-rc2 : Tx build bug fix , Add tests

21 Nov 05:16

Choose a tag to compare

Changes

  • Fix Bug : Server got irresponsive after requesting /api/v1/tx with plutus included transaction
  • Add tests to validate that the kuber apis are working via LocalNode Socket connection.

Known Issues:

  • Kontract is not working via RemoteKuberConnection
  • If node is at Babbage era when kuber-server starts, after node reaches Conway era, restart is required to enable Conway features.
  • $.validtyStart is broken and is ignored.

Docker image

dquadrant/kuber:3.0.0-rc2

v3.0.0-rc1 : Full Refactor and ConwayEra Support

13 Nov 11:08

Choose a tag to compare

v3.0.0-rc1 : Full Refactor and ConwayEra Support

Changes on kuber-server

  • Add new chain-query api-endpoints.
    • GET /api/v3/protocol-params
    • GET /api/v3/chain-point
    • GET /api/v3/utxo
    • GET /api/v3/system-start
    • GET /api/v3/genesis-params
  • Update default healthcheck url in docker image. (/api/v3/chain-point is used for healthcheck )
  • Server starts by querying NodeEra and enables fields based on BabbageEra or ConwayEra
  • TxBuilder json now supports following new fields.
    • $.proposal[s] : Conway Era Governance proposals.
    • $.votes[s] : Conway Era votes.
    • $.certificate[s] : Registration and dregistration certs only for Conway era. (Not available when node is running in babbage era).

Release Docker image [supports only x86_64 architecture]

dquadrant/kuber:3.0.0-rc1

Known Issues:

  • If node is at Babbage era when kuber-server starts, after node reaches Conway era, restart is required to enable Conway features.
  • $.validtyStart is broken and is ignored when building transaction.

Changes on Kontract-example [WIP]

  • Introduced new package to showcase usage of Kontract

Changes on lib:kuber

  • Update code comments for better haddock docs generation
  • Implement both ToJson and FromJson for all the entities used in api
  • Reorganize code and introduction of Kontact for offchain code.
  • Support For ConwayEra [BREAKING change ]
  • TxBuilder is now parametrized on era suppporting Babbage and Conway eras, with IsTxBuilderEra constraint.
  • Kuber Offchain code required Local Node Socket. WIP support running kuber code by connecting to kuber server
  • Remove ChainConnectInfoand related classes. Instead, use LocalNodeConnectInfo CardanoMode directly.

2.3.2 - Minor Api Fixes

20 Feb 15:38

Choose a tag to compare

API Changes

  • Add endpoint /api/v1/chaintip for chaintip query ead85f8
  • Fix inlineDatum boolean option in output , that was previously set as inline only af5f758

Release Docker Image

dquadrant/kuber:2.3.2

Kuber 2.3.1 - Ui and Api fixes

20 Feb 09:20

Choose a tag to compare

API changes

  • Support setting Fee explicitly c0f483a
  • BugFix for reference scripts in input missing in body f9cabf4

UI changes

  • Update pubkeyHash inspector and output tab 97dacba
  • Show full event log on output on transaction submission e0c8559
  • fix dependency issue with monaco-editor 2c68e64
  • Fix 'Auto' network URL selection f120c02
  • Fix sig script linting 01d4eb7
  • Update/redesign address sidebar 6cd7589
  • Fix error message display on submitting transaction e456782
  • Fix oscillation in fee balancing resulting in error 9dd1251
  • Fix inlineDatum option in output af5f758

Release Docker Image

dquadrant/kuber:2.3.1