com.daml.ledger.api.v1

Class CommandServiceGrpc.CommandServiceFutureStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractFutureStub<CommandServiceGrpc.CommandServiceFutureStub>

com.daml.ledger.api.v1.CommandServiceGrpc.CommandServiceFutureStub

Enclosing class:

CommandServiceGrpc

public static final class CommandServiceGrpc.CommandServiceFutureStub
extends io.grpc.stub.AbstractFutureStub<CommandServiceGrpc.CommandServiceFutureStub>

 Command Service is able to correlate submitted commands with completion data, identify timeouts, and return contextual
 information with each tracking result. This supports the implementation of stateless clients.
 Note that submitted commands generally produce completion events as well, even in case a command gets rejected.
 For example, the participant MAY choose to produce a completion event for a rejection of a duplicate command.
 

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 CommandServiceGrpc.CommandServiceFutureStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Empty>	submitAndWait(CommandServiceOuterClass.SubmitAndWaitRequest request) Submits a single composite command and waits for its result.
com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionResponse>	submitAndWaitForTransaction(CommandServiceOuterClass.SubmitAndWaitRequest request) Submits a single composite command, waits for its result, and returns the transaction.
com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionIdResponse>	submitAndWaitForTransactionId(CommandServiceOuterClass.SubmitAndWaitRequest request) Submits a single composite command, waits for its result, and returns the transaction id.
com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionTreeResponse>	submitAndWaitForTransactionTree(CommandServiceOuterClass.SubmitAndWaitRequest request) Submits a single composite command, waits for its result, and returns the transaction tree.

Methods inherited from class io.grpc.stub.AbstractFutureStub

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 CommandServiceGrpc.CommandServiceFutureStub build(io.grpc.Channel channel,
                                                            io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<CommandServiceGrpc.CommandServiceFutureStub>

submitAndWait

public com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Empty> submitAndWait(CommandServiceOuterClass.SubmitAndWaitRequest request)

 Submits a single composite command and waits for its result.
 Propagates the gRPC error of failed submissions including Daml interpretation errors.
 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
 - ``RESOURCE_EXHAUSTED``: if the number of in-flight commands reached the maximum (if a limit is configured)
 - ``UNAVAILABLE``: if the participant is not yet ready to submit commands or if the service has been shut down.
 - ``ABORTED``: if a contract key is missing or duplicated due to for example contention on resources
 

submitAndWaitForTransactionId

public com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionIdResponse> submitAndWaitForTransactionId(CommandServiceOuterClass.SubmitAndWaitRequest request)

 Submits a single composite command, waits for its result, and returns the transaction id.
 Propagates the gRPC error of failed submissions including Daml interpretation errors.
 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
 - ``RESOURCE_EXHAUSTED``: if the number of in-flight commands reached the maximum (if a limit is configured)
 - ``UNAVAILABLE``: if the participant is not yet ready to submit commands or if the service has been shut down.
 - ``ABORTED``: if a contract key is missing or duplicated due to for example contention on resources
 

submitAndWaitForTransaction

public com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionResponse> submitAndWaitForTransaction(CommandServiceOuterClass.SubmitAndWaitRequest request)

 Submits a single composite command, waits for its result, and returns the transaction.
 Propagates the gRPC error of failed submissions including Daml interpretation errors.
 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
 - ``RESOURCE_EXHAUSTED``: if the number of in-flight commands reached the maximum (if a limit is configured)
 - ``UNAVAILABLE``: if the participant is not yet ready to submit commands or if the service has been shut down.
 - ``ABORTED``: if a contract key is missing or duplicated due to for example contention on resources
 

submitAndWaitForTransactionTree

public com.google.common.util.concurrent.ListenableFuture<CommandServiceOuterClass.SubmitAndWaitForTransactionTreeResponse> submitAndWaitForTransactionTree(CommandServiceOuterClass.SubmitAndWaitRequest request)

 Submits a single composite command, waits for its result, and returns the transaction tree.
 Propagates the gRPC error of failed submissions including Daml interpretation errors.
 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
 - ``RESOURCE_EXHAUSTED``: if the number of in-flight commands reached the maximum (if a limit is configured)
 - ``UNAVAILABLE``: if the participant is not yet ready to submit commands or if the service has been shut down.
 - ``ABORTED``: if a contract key is missing or duplicated due to for example contention on resources