public static final class CommandCompletionServiceGrpc.CommandCompletionServiceFutureStub extends io.grpc.stub.AbstractFutureStub<CommandCompletionServiceGrpc.CommandCompletionServiceFutureStub>
Allows clients to observe the status of their submissions. Commands may be submitted via the Command Submission Service. The on-ledger effects of their submissions are disclosed by the Transaction Service. Commands may fail in 2 distinct manners: 1. Failure communicated in the gRPC error of the submission. 2. Failure communicated in a Completion. Only successfully submitted commands may produce a completion event. Clients that do not receive a successful completion about their submission MUST NOT assume that it was successful. Clients SHOULD subscribe to the CompletionStream before starting to submit commands to prevent race conditions. Interprocess tracing of command submissions may be achieved via Zipkin by filling out the ``trace_context`` field. The server will return a child context of the submitted one, (or a new one if the context was missing) on both the Completion and Transaction streams.
Modifier and Type | Method and Description |
---|---|
protected CommandCompletionServiceGrpc.CommandCompletionServiceFutureStub |
build(io.grpc.Channel channel,
io.grpc.CallOptions callOptions) |
com.google.common.util.concurrent.ListenableFuture<CommandCompletionServiceOuterClass.CompletionEndResponse> |
completionEnd(CommandCompletionServiceOuterClass.CompletionEndRequest request)
Returns the offset after the latest completion.
|
protected CommandCompletionServiceGrpc.CommandCompletionServiceFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
build
in class io.grpc.stub.AbstractStub<CommandCompletionServiceGrpc.CommandCompletionServiceFutureStub>
public com.google.common.util.concurrent.ListenableFuture<CommandCompletionServiceOuterClass.CompletionEndResponse> completionEnd(CommandCompletionServiceOuterClass.CompletionEndRequest request)
Returns the offset after the latest completion. Errors: - ``UNAUTHENTICATED``: if the request does not include a valid access token - ``PERMISSION_DENIED``: if the claims in the token are insufficient to perform a given operation - ``NOT_FOUND``: if the request does not include a valid ledger id