Releases: CardanoSolutions/ogmios
Release list
v7.0.0
Added
-
Preliminary support for the Dijkstra era and PlutusV4. The Dijkstra era is not officially available, so expect (breaking) changes in the schema moving forward; though a best effort will be done to avoid any important breaking changes.
-
Missing
plutusCostModelsandminFeeReferenceScriptsproperties from Conway's genesis object.
Changed
-
Dependencies and compatibility to
cardano-node==11.0.1. -
Ogmios not returning a success error code when interrupted by the user (e.g. CTRL+C / SIGINT).
-
When evaluating transactions, additional utxos provided manually are now preferred over those automatically resolved (allowing to override more easily existing utxos for testing).
-
The
treasuryfield on transaction was sometimes ommitted when it should've been present; this is now fixed. -
⚠️ BREAKING-CHANGE⚠️ : onProtocolParametersandProposedProtocolParameters, the fieldmaxReferenceScriptsSizehas been renamed tomaxReferenceScriptsSizePerTransactionto disambiguate it frommaxReferenceScriptsSizePerBlock. -
⚠️ BREAKING-CHANGE⚠️ : transaction object now omits thevalidityIntervalandoutputsfields when they're empty. -
⚠️ BREAKING-CHANGE⚠️ : Byron bootstrap witness encoding has changed from a single 64-bytes key payload to a combo key + chain-code.
Removed
⚠️ BREAKING-CHANGE⚠️ : transaction submission and evaluation no longer includeshelley,allegraandmaryparsing hints on errors. Onlyalonzoonwards is included.
Tested with
- cardano-node
== 11.0.1(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v7.0.0_11.0.1-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v7.0.0_11.0.1-preprod
- Preview cardanosolutions/cardano-node-ogmios:v7.0.0_11.0.1-preview
Details
Acknowledgements
v6.14.0
Added
queryLedgerState/delegateRepresentativesnow returns the list of delegators also for the pre-defined always-abstain and always-no-confidence dreps.
Note
Couldn't get the query available in the cardano-node on-time, so this is still not available in this release, but should be ready for the next as soon as a version of cardano-node with support for the GetDRepsDelegations ledger state query is released.
Changed
-
Bump dependencies to
cardano-node==10.5.1. -
queryLedgerState/stakePoolswill also include the stake of pools that have just retired. This is useful to consider the voting power granted to such pool for the upcoming epoch ratification. -
Ogmios will now attempt to negotiate older versions of the client protocols, so that it can work with tools and libraries that are lagging behind. Ogmios will go as low as node-to-client version 17. Beyond that, some queries will no longer work and the overall user experience would be degraded.
Removed
queryLedgerState/proposedProtocolParametersis no longer available in the underlying node and was already returning dummy data for a few versions. It's been removed.
Tested with
- cardano-node
== 10.5.1(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.14.0_10.5.1-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.14.0_10.5.1-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.14.0_10.5.1-preview
Details
v6.13.0
Added
- A new query
queryLedgerState/rewardsProvenancewhich now re-implements and exposes the intermediate rewards calculation. The query name already exists, but the schema is now different. The previous behaviour can be recovered by using the newqueryLedgerState/stakePoolsPerformancesinstead. (🔨 @KtorZ)
Changed
-
⚠️ BREAKING-CHANGE⚠️ :queryLedgerState/dumpno longer return a hex-encoded CBOR dump as part of the JSON response, but instead, serialise directly to a specified on-disk location. (🔨 @jeluard, @KtorZ) -
⚠️ BREAKING-CHANGE⚠️ :queryLedgerState/rewardsProvenancehas been renamed toqueryLedgerState/stakePoolsPerformances. The schema remains otherwise unchanged. (🔨 @KtorZ) -
⚠️ BREAKING-CHANGE⚠️ :queryLedgerState/rewardAccountSummariesnow returns a list of results instead of a map. While this is technically a breaking change, it is necessary to fix scenarios where a credential exist as both script and verification key and would therefore lead to conflict in the key space. The response is otherwise similar to its previous form. (🔨 @KtorZ)
Removed
N/A
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview) - cardano-node
== 10.1.4(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.13.0_10.1.4-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.13.0_10.1.4-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.13.0_10.1.4-preview
Details
Acknowledgement
Additional contributors through reports and suggestions: @xray-robot, @mpizenberg. Thank you ❤️.
v6.12.0
Added
- Two new ledger-state queries:
queryLedgerState/nonces: internal node's rolling nonces calculations used in consensus.queryLedgerState/operationalCertificates: internal stake pool operational certificates states used in consensus.
Changed
-
The
queryLedgerState/rewardAccountSummariesnow includes the delegate representative -- a.k.a DRep -- (if any) for each summary under a fielddelegateRepresentative. The fielddelegatehas also been renamed tostakePoolto disambiguate both. Also, thestakePoolfield is now optional and may be omitted in case where a particular account is only delegated to a DRep. Similarly, the fielddelegateRepresentativewill be ommitted when the account is only delegated to a stake pool. -
The
queryLedgerState/delegateRepresentativesno longer discards registered DReps that have unregistered but whose stake is still available. This may happen when a DRep is already unregistered, but his stake distribution is still available because still needed to ratify votes on the next epoch boundary. As a consequence, some of the fields for the registered drep summaries are now optional instead of required."
Removed
ø
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview) - cardano-node
== 10.1.4(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.12.0_10.1.4-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.12.0_10.1.4-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.12.0_10.1.4-preview
Details
v6.11.2
Added
- N/A
Changed
- Fix (sometimes) missing governance proposals returned from the
queryLedgerState/governanceProposals(likely) due to unfinished incremental calculations on the ledger state. The proposals are now pulled from a different location in the ledger state which ensures they are complete.
Removed
- N/A
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview) - cardano-node
== 10.1.4(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.11.2_10.1.4-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.11.2_10.1.4-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.11.2_10.1.4-preview
Details
v6.11.1
Added
- N/A
Changed
- Fix missing DReps with no stake not showing up through
queryLedgerState/delegateRepresentatives. - Fix
queryLedgerState/dumpreturningEpochStateinstead ofNewEpochState
Removed
- N/A
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview) - cardano-node
== 10.1.4(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.11.1_10.1.4-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.11.1_10.1.4-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.11.1_10.1.4-preview
Details
v6.11.0
Added
-
The
queryLedgerState/stakePoolsquery now take an optionalincludeStake: boolparameter. When provided and set totrue, each stake pool result will include an additionalstakefield with its current absolute live stake (reflecting its governance power). -
A new query [
queryLedgerState/delegateRepresentatives] to fetch all registered (and pre-defined) DReps, alongside their metadata and live stake. In a similar fashion to many other queries, DReps can be filtered usingkeysorscriptscredentials in the query parameters. When both are omitted, all representatives are returned.
Changed
- The dual container image (
CardnoSolutions/cardano-node-ogmios) now ships withcardano-node==10.1.4.
Removed
- N/A
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview) - cardano-node
== 10.1.4(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.11.0_10.1.4-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.11.0_10.1.4-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.11.0_10.1.4-preview
Details
v6.10.0
Added
-
ConnectionConfigcan now take an optionaladdressobject, so that URL with paths can be provided instead of only host/port; allowing for more flexible connection options. -
New ledger-state query
ledgerState/dumpwhich dumps the ENTIRE ledger-state as base16-encoded CBOR. That query is mostly for advanced used only, and spits out a lot of data. Use only if you know what you're doing.
Changed
- N/A
Removed
- N/A
Tested with
- cardano-node
== 10.1.3(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.10.0_10.1.3-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.10.0_10.1.3-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.10.0_10.1.3-preview
Details
v6.9.0
Added
- Integrate
cardano-node==10.1.2and associated dependencies.- New transaction submission / evaluation errors:
EmptyTreasuryWithdrawal(code=3168) triggered when a transaction contains a governance proposal with an empty treasury withdrawal.UnexpectedMempoolError(code=3997) triggered when a transaction is rejected due to custom arbitrary rules that prevented it from entering the mempool.
Changed
- N/A
Removed
- N/A
Tested with
- cardano-node
== 10.1.2(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.9.0_10.1.2-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.9.0_10.1.2-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.9.0_10.1.2-preview
Details
v6.8.0
Added
-
Integrate
cardano-node==9.2.0and associated dependencies. -
Add new ledger-state query:
queryLedgerState/governanceProposalsto retrieve currently active governance proposals and their ratification state (i.e. ongoig votes).
Caution
This new ledger-state query requires cardano-node >= 9.2.0
Changed
-
Fix automatic transaction upgrade to NOT change underlying binary format during upgrade. The previous implementation would on some occasions alter the serialized form, thus causing transaction hash to change and invalidating all signatures on it. The new approach does always preserve binary serialisation, but as a result, makes more scenario not translatable (e.g. trying to translate a multi-asset UTxOs containing a 0 quantity is impossible when targetting Conway).
-
Fix JSON deserialization of metadata on web platforms. 🔨 @Sluder
Removed
- N/A
Tested with
- cardano-node
== 9.2.0(Mainnet, Preprod, Preview)
Docker image(s)
Standalone
With cardano-node
- Mainnet cardanosolutions/cardano-node-ogmios:v6.8.0_9.2.0-mainnet
- Preprod cardanosolutions/cardano-node-ogmios:v6.8.0_9.2.0-preprod
- Preview cardanosolutions/cardano-node-ogmios:v6.8.0_9.2.0-preview









