Releases: dQuadrant/kuber
Releases · dQuadrant/kuber
4.2.0 : cardano-node-11 support
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-historyendpoint. - Removed the older
LocalChainQueryinterface 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.ymlto 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-historyto the published Kuber API reference docs. - Simplified chain-query internals by removing
LocalChainQueryand 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
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-hydraandkuber-client. - Updated the README and cleaned up docs organization.
Libraries
- cardano-api:10.1
- kuber-client:v3.3.6
Tested with
- hydra-node:1.2.0
v4.0.0-rc1: Hydra Integration
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-hydrawith:- 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
- Command endpoints under
- 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
- kuber-client v3.3.2
3.1.1 : Conway era minor fixes
Fixes
- Collateral selection logic now prefers 5Ada inputs
- Multiple collateral inputs if collateral is not sufficient with 1 utxo.
Release Docker image
3.1.0: Stable Conway Era Support
DependsOn
- cardano-api:9.2.0.0
Release Docker Image
Changes: kuber-server
- new endpoint
/api/v3/healthnow returns node's current tip and secondsSince last block was minted. If lastBlock was seen before 300 secs, status code will be503
Changes: lib:kuber
- when not set, kuber will automatically fill in following field by querying ledger state
proposal.depositproposal.previousGovActionIdproposal.executionUnitscertificates.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 :
Kontractwill omit following fields when usingRemoteKuberConnection: $.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
New Features:
- Introduced
kQueryCurrentErafunctionality to retrieve the current era information. - Added
kQueryStakeDepositfeature for querying stake deposit details. - Implemented
kQueryDrepStatefunctionality for querying DREP state. - Enabled automatic withdrawal amount evaluation for stake deregistration during Conway Era.
Bug Fixes:
- Resolved an issue in
kQueryUTXOByAddresswhere only one UTXO was returned. Parsing issue has been fixed to ensure correct handling. - Fixed an error in
kCalculateMinFeerelated to single fork encoded hardcoded era Conway. - Implemented functionality for
TxOutDatumInTxto support datum in Auxiliary data. - Enabled
kBuildTxfunctionality to work on RemoteKuberConnection.
Updates:
- Updated
toJSONparsing forTxInputScriptTxIn, which includes updates to JSON schemas for UTXO.
3.0.0-rc2 : Tx build bug fix , Add tests
Changes
- Fix Bug : Server got irresponsive after requesting
/api/v1/txwith plutus included transaction - Add tests to validate that the kuber apis are working via LocalNode Socket connection.
Known Issues:
Kontractis not working viaRemoteKuberConnection- If node is at Babbage era when kuber-server starts, after node reaches Conway era, restart is required to enable Conway features.
$.validtyStartis broken and is ignored.
Docker image
v3.0.0-rc1 : Full Refactor and ConwayEra Support
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-pointis used for healthcheck ) - Server starts by querying NodeEra and enables fields based on
BabbageEraorConwayEra - 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]
Known Issues:
- If node is at Babbage era when kuber-server starts, after node reaches Conway era, restart is required to enable Conway features.
$.validtyStartis 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
ToJsonandFromJsonfor all the entities used in api - Reorganize code and introduction of
Kontactfor offchain code. - Support For ConwayEra [BREAKING change ]
TxBuilderis now parametrized onerasuppportingBabbageandConwayeras, withIsTxBuilderEraconstraint.- Kuber Offchain code required Local Node Socket. WIP support running kuber code by connecting to kuber server
- Remove
ChainConnectInfoand related classes. Instead, useLocalNodeConnectInfo CardanoModedirectly.
2.3.2 - Minor Api Fixes
Kuber 2.3.1 - Ui and Api fixes
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