Package com.daml.ledger.api.v2

Class UpdateServiceGrpc.UpdateServiceFutureStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractFutureStub<UpdateServiceGrpc.UpdateServiceFutureStub>

com.daml.ledger.api.v2.UpdateServiceGrpc.UpdateServiceFutureStub

Enclosing class:

UpdateServiceGrpc

public static final class UpdateServiceGrpc.UpdateServiceFutureStub
extends io.grpc.stub.AbstractFutureStub<UpdateServiceGrpc.UpdateServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service UpdateService.

 Allows clients to read updates (transactions, (un)assignments, topology events) from the ledger.
 ``GetUpdates`` and ``GetUpdateTrees`` provide a comprehensive stream of updates/changes
 which happened on the virtual shared ledger. These streams are indexed with ledger
 offsets, which are strictly increasing.
 The virtual shared ledger consist of changes happening on multiple synchronizers which are
 connected to the serving participant. Each update belongs to one synchronizer, this is
 provided in the result (the ``synchronizer_id`` field in ``Transaction`` and ``TransactionTree``
 for transactions, the ``source`` field in ``UnassignedEvent`` and the ``target`` field in ``AssignedEvent``).
 Consumers can rely on strong causal guarantees on the virtual shared ledger for a single
 synchronizer: updates which have greater offsets are happened after than updates with smaller
 offsets for the same synchronizer. Across different synchronizers this is not guaranteed.
 

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	Description
protected UpdateServiceGrpc.UpdateServiceFutureStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionResponse>	getTransactionById(UpdateServiceOuterClass.GetTransactionByIdRequest request)	Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionResponse>	getTransactionByOffset(UpdateServiceOuterClass.GetTransactionByOffsetRequest request)	Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionTreeResponse>	getTransactionTreeById(UpdateServiceOuterClass.GetTransactionByIdRequest request)	Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionTreeResponse>	getTransactionTreeByOffset(UpdateServiceOuterClass.GetTransactionByOffsetRequest request)	Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetUpdateResponse>	getUpdateById(UpdateServiceOuterClass.GetUpdateByIdRequest request)	Lookup an update by its ID.
com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetUpdateResponse>	getUpdateByOffset(UpdateServiceOuterClass.GetUpdateByOffsetRequest request)	Lookup an update by its offset.

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, withOnReadyThreshold, withOption, withWaitForReady

Methods inherited from class java.lang.Object

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

Method Details

build

protected UpdateServiceGrpc.UpdateServiceFutureStub build(io.grpc.Channel channel,
 io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<UpdateServiceGrpc.UpdateServiceFutureStub>

getTransactionTreeByOffset

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionTreeResponse> getTransactionTreeByOffset(UpdateServiceOuterClass.GetTransactionByOffsetRequest request)

 Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
 Lookup a transaction tree by its offset.
 For looking up a transaction instead of a transaction tree, please see GetTransactionByEventId
 If the transaction cannot be found for the request, or all the events are filtered, a TRANSACTION_NOT_FOUND error will be raised.
 

getTransactionTreeById

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionTreeResponse> getTransactionTreeById(UpdateServiceOuterClass.GetTransactionByIdRequest request)

 Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
 Lookup a transaction tree by its ID.
 For looking up a transaction instead of a transaction tree, please see GetTransactionById
 If the transaction cannot be found for the request, or all the events are filtered, a TRANSACTION_NOT_FOUND error will be raised.
 

getTransactionByOffset

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionResponse> getTransactionByOffset(UpdateServiceOuterClass.GetTransactionByOffsetRequest request)

 Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
 Lookup a transaction by its offset.
 If there is no transaction with this offset, or all the events are filtered, a TRANSACTION_NOT_FOUND error will be raised.
 Use a wildcard template filter if you want to retrieve any transaction visible to the parties you can read as.
 

getTransactionById

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetTransactionResponse> getTransactionById(UpdateServiceOuterClass.GetTransactionByIdRequest request)

 Provided for backwards compatibility, it will be removed in the Canton version 3.4.0.
 Lookup a transaction by its ID.
 If there is no transaction with this id, or all the events are filtered, a TRANSACTION_NOT_FOUND error will be raised.
 Use a wildcard template filter if you want to retrieve any transaction visible to the parties you can read as.
 

getUpdateByOffset

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetUpdateResponse> getUpdateByOffset(UpdateServiceOuterClass.GetUpdateByOffsetRequest request)

 Lookup an update by its offset.
 If there is no update with this offset, or all the events are filtered, an UPDATE_NOT_FOUND error will be raised.
 

getUpdateById

public com.google.common.util.concurrent.ListenableFuture<UpdateServiceOuterClass.GetUpdateResponse> getUpdateById(UpdateServiceOuterClass.GetUpdateByIdRequest request)

 Lookup an update by its ID.
 If there is no update with this ID, or all the events are filtered, an UPDATE_NOT_FOUND error will be raised.