UtxoEvent

scalus.cardano.node.stream.UtxoEvent
enum UtxoEvent

UTxO lifecycle event.

RolledBack is not an error and not an exception: a chain that reorganises is a chain behaving normally, and a subscriber that cannot express "undo everything after this point" has a bug waiting for its first fork. Providers that never signal rollbacks declare rollbackHorizon = None so the difference is visible before subscribing rather than after.

Attributes

Graph
Supertypes
trait Enum
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Members list

Type members

Enum entries

final case class Created(utxo: Utxo, producedBy: TransactionHash, at: ChainPoint)

A UTxO matching the subscription was created by producedBy.

A UTxO matching the subscription was created by producedBy.

Attributes

final case class Idle(at: ChainPoint)

Progress signal: the chain advanced to at and nothing matched this subscription.

Progress signal: the chain advanced to at and nothing matched this subscription.

Without it, a narrowly-scoped subscription cannot distinguish "quiet chain" from "stalled connection", and has no point to checkpoint. Emitted at provider discretion — see SubscriptionOptions.idleSignals.

Attributes

final case class RolledBack(to: ChainPoint)

The chain rolled back to to. Discard every previously delivered event that occurred strictly after it, then resume with the events that follow.

The chain rolled back to to. Discard every previously delivered event that occurred strictly after it, then resume with the events that follow.

Attributes

final case class Spent(utxo: Utxo, spentBy: TransactionHash, at: ChainPoint)

A UTxO matching the subscription was spent by spentBy.

A UTxO matching the subscription was spent by spentBy.

Attributes