Struct PackageManagementServiceClient 

pub struct PackageManagementServiceClient<T> { /* private fields */ }

Status: experimental interface, will change before it is deemed production ready

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.

Implementations

impl PackageManagementServiceClient<Channel>

pub async fn connect<D>( dst: D, ) -> Result<PackageManagementServiceClient<Channel>, Error>

where D: TryInto<Endpoint>, <D as TryInto<Endpoint>>::Error: Into<Box<dyn Error + Send + Sync>>,

Attempt to create a new client by connecting to a given endpoint.

impl<T> PackageManagementServiceClient<T>

where T: GrpcService<Body>, <T as GrpcService<Body>>::Error: Into<Box<dyn Error + Send + Sync>>, <T as GrpcService<Body>>::ResponseBody: Body<Data = Bytes> + Send + 'static, <<T as GrpcService<Body>>::ResponseBody as Body>::Error: Into<Box<dyn Error + Send + Sync>> + Send,

pub fn new(inner: T) -> PackageManagementServiceClient<T>

pub fn with_origin(inner: T, origin: Uri) -> PackageManagementServiceClient<T>

pub fn with_interceptor<F>( inner: T, interceptor: F, ) -> PackageManagementServiceClient<InterceptedService<T, F>>

where F: Interceptor, <T as GrpcService<Body>>::ResponseBody: Default, T: Service<Request<Body>, Response = Response<<T as GrpcService<Body>>::ResponseBody>>, <T as Service<Request<Body>>>::Error: Into<Box<dyn Error + Send + Sync>> + Send + Sync,

pub fn send_compressed( self, encoding: CompressionEncoding, ) -> PackageManagementServiceClient<T>

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

pub fn accept_compressed( self, encoding: CompressionEncoding, ) -> PackageManagementServiceClient<T>

Enable decompressing responses.

pub fn max_decoding_message_size( self, limit: usize, ) -> PackageManagementServiceClient<T>

Limits the maximum size of a decoded message.

Default: 4MB

pub fn max_encoding_message_size( self, limit: usize, ) -> PackageManagementServiceClient<T>

Limits the maximum size of an encoded message.

Default: usize::MAX

pub async fn list_known_packages( &mut self, request: impl IntoRequest<ListKnownPackagesRequest>, ) -> Result<Response<ListKnownPackagesResponse>, Status>

Returns the details of all Daml-LF packages known to the backing participant.

pub async fn upload_dar_file( &mut self, request: impl IntoRequest<UploadDarFileRequest>, ) -> Result<Response<UploadDarFileResponse>, Status>

Upload a DAR file to the participant.

If vetting is enabled in the request, the DAR is checked for upgrade compatibility with the set of the already vetted packages on the target vetting synchronizer See UploadDarFileRequest for details regarding vetting and the target vetting synchronizer.

pub async fn validate_dar_file( &mut self, request: impl IntoRequest<ValidateDarFileRequest>, ) -> Result<Response<ValidateDarFileResponse>, Status>

Validates the DAR and checks the upgrade compatibility of the DAR’s packages with the set of the already vetted packages on the target vetting synchronizer. See ValidateDarFileRequest for details regarding the target vetting synchronizer.

The operation has no effect on the state of the participant or the Canton ledger: the DAR payload and its packages are not persisted neither are the packages vetted.

pub async fn update_vetted_packages( &mut self, request: impl IntoRequest<UpdateVettedPackagesRequest>, ) -> Result<Response<UpdateVettedPackagesResponse>, Status>

Update the vetted packages of this participant

Trait Implementations

impl<T> Clone for PackageManagementServiceClient<T>

where T: Clone,

fn clone(&self) -> PackageManagementServiceClient<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Debug for PackageManagementServiceClient<T>

where T: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.