com.daml.ledger.api.v1.admin

Class PackageManagementServiceGrpc.PackageManagementServiceFutureStub

java.lang.Object

io.grpc.stub.AbstractStub<PackageManagementServiceGrpc.PackageManagementServiceFutureStub>

com.daml.ledger.api.v1.admin.PackageManagementServiceGrpc.PackageManagementServiceFutureStub

Enclosing class:

PackageManagementServiceGrpc

public static final class PackageManagementServiceGrpc.PackageManagementServiceFutureStub
extends io.grpc.stub.AbstractStub<PackageManagementServiceGrpc.PackageManagementServiceFutureStub>

 Query the DAML-LF packages supported by the ledger participant and upload
 DAR files. We use 'backing participant' to refer to this specific participant
 in the methods of this API.
 When the participant is run in mode requiring authentication, all the calls 
 in this interface will respond with UNAUTHENTICATED, if the caller fails
 to provide a valid access token, and will respond with PERMISSION_DENIED, if
 the claims in the token are insufficient to perform a given operation.
 Subsequently, only specific errors of individual calls not related to 
 authorization will be described.
 

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 PackageManagementServiceGrpc.PackageManagementServiceFutureStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
com.google.common.util.concurrent.ListenableFuture<PackageManagementServiceOuterClass.ListKnownPackagesResponse>	listKnownPackages(PackageManagementServiceOuterClass.ListKnownPackagesRequest request) Returns the details of all DAML-LF packages known to the backing participant.
com.google.common.util.concurrent.ListenableFuture<PackageManagementServiceOuterClass.UploadDarFileResponse>	uploadDarFile(PackageManagementServiceOuterClass.UploadDarFileRequest request) Upload a DAR file to the backing participant.

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, newStub, newStub, 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 PackageManagementServiceGrpc.PackageManagementServiceFutureStub build(io.grpc.Channel channel,
                                                                                io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<PackageManagementServiceGrpc.PackageManagementServiceFutureStub>

listKnownPackages

public com.google.common.util.concurrent.ListenableFuture<PackageManagementServiceOuterClass.ListKnownPackagesResponse> listKnownPackages(PackageManagementServiceOuterClass.ListKnownPackagesRequest request)

 Returns the details of all DAML-LF packages known to the backing
 participant.
 This request will always succeed.
 

uploadDarFile

public com.google.common.util.concurrent.ListenableFuture<PackageManagementServiceOuterClass.UploadDarFileResponse> uploadDarFile(PackageManagementServiceOuterClass.UploadDarFileRequest request)

 Upload a DAR file to the backing participant.
 Depending on the ledger implementation this might also make the package 
 available on the whole ledger. This call might not be supported by some 
 ledger implementations. Canton could be an example, where uploading a DAR
 is not sufficient to render it usable, it must be activated first.
 This call may:
 - Succeed, if the package was successfully uploaded, or if the same package
   was already uploaded before. 
 - Respond with UNIMPLEMENTED, if DAR package uploading is not supported by
   the backing participant.
 - Respond with INVALID_ARGUMENT, if the DAR file is too big or malformed.
 The maximum supported size is implementation specific.