@cardano-ogmios/repl

Cardano Ogmios TypeScript Client Packages - REPL

A Node.js REPL which exposes the client behaviour in a terminal. Loaded into the context are the client builder functions, isolated query functions, and an instance of ChainSyncClient as chainSync with handlers to log the returned data. On exit the chainSync instance is shutdown. Optionally pass --host and --port arguments to specify the Ogmios server connection.

Quick Start

Download and run static package from the latest release for your environment.

Build From Source

See instructions in Workspace root

Example

ogmios> await epoch()
256

ogmios> await ledgerTip()
{
  id: '41364e89e44370a009f083ce9963261aabf6138db519b039012232bf40f187f8',
  slot: 25541023
}

ogmios> await protocolParameters()
{
  minFeeCoefficient: 44,
  minFeeConstant: { lovelace: 155381n },
  maxBlockBodySize: { bytes: 90112 },
  maxBlockHeaderSize: { bytes: 1100 },
  maxTransactionSize: { bytes: 16384 },
  stakeCredentialDeposit: { lovelace: 2000000n },
  stakePoolDeposit: { lovelace: 500000000n },
  stakePoolRetirementEpochBound: 18,
  ...
}

Changelog

[6.14.0] - 2025-10-16

Added

• ~~queryLedgerState/delegateRepresentatives now 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/stakePools will 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/proposedProtocolParameters is no longer available in the underlying node and was already returning dummy data for a few versions. It's been removed.