Package com.daml.ledger.api.v1.admin

Class ParticipantPruningServiceGrpc.ParticipantPruningServiceBlockingStub

  • Enclosing class:
    ParticipantPruningServiceGrpc
    public static final class ParticipantPruningServiceGrpc.ParticipantPruningServiceBlockingStub
extends io.grpc.stub.AbstractBlockingStub<ParticipantPruningServiceGrpc.ParticipantPruningServiceBlockingStub>
     Prunes/truncates the "oldest" transactions from the participant (the participant Ledger Api Server plus any other
 participant-local state) by removing a portion of the ledger in such a way that the set of future, allowed
 commands are not affected.
 This enables:
 1. keeping the "inactive" portion of the ledger to a manageable size and
 2. removing inactive state to honor the right to be forgotten.

    • Nested Class Summary

      • Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

        io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

    • Method Detail

      • prune

        public ParticipantPruningServiceOuterClass.PruneResponse prune​(ParticipantPruningServiceOuterClass.PruneRequest request)
         Prune the ledger specifying the offset before and at which ledger transactions should be removed. Only returns when
 the potentially long-running prune request ends successfully or with one of the following errors:
 - ``INVALID_ARGUMENT``: if the payload, particularly the offset is malformed or missing
 - ``UNIMPLEMENTED``: if the participant is based on a ledger that has not implemented pruning
 - ``INTERNAL``: if the participant has encountered a failure and has potentially applied pruning partially. Such cases
   warrant verifying the participant health before retrying the prune with the same (or a larger, valid) offset.
   Successful retries after such errors ensure that different components reach a consistent pruning state.
 - ``FAILED_PRECONDITION``: if the participant is not yet able to prune at the specified offset.