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.