com.daml.ledger.api.v1

Class CommandSubmissionServiceGrpc.CommandSubmissionServiceStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractAsyncStub<CommandSubmissionServiceGrpc.CommandSubmissionServiceStub>

com.daml.ledger.api.v1.CommandSubmissionServiceGrpc.CommandSubmissionServiceStub

Enclosing class:

CommandSubmissionServiceGrpc

public static final class CommandSubmissionServiceGrpc.CommandSubmissionServiceStub
extends io.grpc.stub.AbstractAsyncStub<CommandSubmissionServiceGrpc.CommandSubmissionServiceStub>

 Allows clients to attempt advancing the ledger's state by submitting commands.
 The final states of their submissions are disclosed by the Command Completion 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.
 

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 Summary

Modifier and Type	Method and Description
protected CommandSubmissionServiceGrpc.CommandSubmissionServiceStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
void	submit(CommandSubmissionServiceOuterClass.SubmitRequest request, io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver) Submit a single composite command.

Methods inherited from class io.grpc.stub.AbstractAsyncStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOption, withWaitForReady

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

build

protected CommandSubmissionServiceGrpc.CommandSubmissionServiceStub build(io.grpc.Channel channel,
                                                                          io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<CommandSubmissionServiceGrpc.CommandSubmissionServiceStub>

submit

public void submit(CommandSubmissionServiceOuterClass.SubmitRequest request,
                   io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver)

 Submit a single composite command.
 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
 - ``INVALID_ARGUMENT``: if the payload is malformed or is missing required fields
 - ``UNAVAILABLE``: if the participant is not yet ready to submit commands or if the service has been shut down.
 - ``RESOURCE_EXHAUSTED``: if the participant or the ledger is overloaded. Clients should back off exponentially and retry.
 - ``ABORTED``: if a contract key is missing or duplicated due to for example contention on resources