Packages

trait BlockUpdateGenerator extends AnyRef

Exposes functions that take the deserialized contents of a block from a blockchain integration and compute the new BlockUpdates.

These functions correspond to the following steps in the block processing stream pipeline:

  1. Extracting block events from a raw ledger block (extractBlockEvents).
  2. Chunking such block events into either event chunks terminated by a sequencer-addessed event or a block completion (chunkBlock).
  3. Validating and enriching chunks to yield block updates (processBlockChunk).

In particular, these functions are responsible for the final timestamp assignment of a given submission request. The timestamp assignment works as follows:

  1. an initial timestamp is assigned to the submission request by the sequencer that writes it to the ledger
  2. each sequencer that reads the block potentially adapts the previously assigned timestamp deterministically via ensureStrictlyIncreasingTimestamp
  3. this timestamp is used to compute the BlockUpdates

Reasoning:

  • Step 1 is done so that every sequencer sees the same timestamp for a given event.
  • Step 2 is needed because different sequencers may assign the same timestamps to different events or may not assign strictly increasing timestamps due to clock skews.

Invariants: For step 2, we assume that every sequencer observes the same stream of events from the underlying ledger (and especially that events are always read in the same order).

Linear Supertypes
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. BlockUpdateGenerator
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Type Members

  1. abstract type InternalState

Abstract Value Members

  1. abstract def chunkBlock(block: BlockEvents)(implicit traceContext: TraceContext): Iterable[BlockChunk]
  2. abstract def extractBlockEvents(block: RawLedgerBlock): BlockEvents
  3. abstract def internalStateFor(state: BlockEphemeralState): InternalState
  4. abstract def processBlockChunk(state: InternalState, chunk: BlockChunk)(implicit ec: ExecutionContext, traceContext: TraceContext): FutureUnlessShutdown[(InternalState, OrderedBlockUpdate)]

Concrete Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @IntrinsicCandidate() @native()
  6. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  7. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  8. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @IntrinsicCandidate() @native()
  9. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @IntrinsicCandidate() @native()
  10. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  11. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @IntrinsicCandidate() @native()
  13. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @IntrinsicCandidate() @native()
  14. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  15. def toString(): String
    Definition Classes
    AnyRef → Any
  16. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  17. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  18. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

Inherited from AnyRef

Inherited from Any

Ungrouped