Struct DamlGrpcClient 

pub struct DamlGrpcClient { /* private fields */ }

Daml v2 ledger client connection. A thin handle around a tonic Channel that hands out per-service clients on demand. Cheap to hold — service factories clone the channel rather than opening new ones.

Implementations

impl DamlGrpcClient

pub async fn connect(config: DamlGrpcClientConfig) -> DamlResult<Self>

Open a channel and connect.

pub const fn config(&self) -> &DamlGrpcClientConfig

pub fn package_service(&self) -> DamlPackageService<'_>

Retrieve a DamlPackageService for querying the Daml-LF packages supported by the participant.

pub fn command_submission_service(&self) -> DamlCommandSubmissionService<'_>

Retrieve a DamlCommandSubmissionService for fire-and-forget command submissions. Completion is observed separately through command_completion_service.

pub fn command_completion_service(&self) -> DamlCommandCompletionService<'_>

Retrieve a DamlCommandCompletionService for observing the asynchronous outcome (success or rejection) of command submissions, plus periodic OffsetCheckpoint markers.

pub fn update_service(&self) -> DamlUpdateService<'_>

Retrieve a DamlUpdateService for reading the participant’s update stream — transactions, reassignments, and topology transactions, paginated or open-ended. v2’s replacement for v1’s TransactionService.

pub fn state_service(&self) -> DamlStateService<'_>

Retrieve a DamlStateService for snapshotting the active contract set, listing connected synchronizers, reading the ledger end, and querying pruning watermarks. v2’s replacement for v1’s ActiveContractsService.

pub fn event_query_service(&self) -> DamlEventQueryService<'_>

Retrieve a DamlEventQueryService for per-contract event lookup (create + consuming-archive halves) by contract id.

pub fn contract_service(&self) -> DamlContractService<'_>

Retrieve a DamlContractService for contract-payload lookup by id. Experimental / alpha per the proto; prefer event_query_service or state_service for stable surfaces.

pub fn command_service(&self) -> DamlCommandService<'_>

Retrieve a DamlCommandService for synchronous command submission: submit and wait for the participant’s verdict in a single RPC.

pub fn version_service(&self) -> DamlVersionService<'_>

Retrieve a DamlVersionService for querying the participant’s Ledger API version.

pub fn package_management_service(&self) -> DamlPackageManagementService<'_>

Retrieve a DamlPackageManagementService for inspecting known packages, uploading DARs, validating DARs, and adjusting the participant’s package-vetting topology.

pub fn party_management_service(&self) -> DamlPartyManagementService<'_>

Retrieve a DamlPartyManagementService for inspecting and administering participant-local party state.

pub fn user_management_service(&self) -> DamlUserManagementService<'_>

Retrieve a DamlUserManagementService for managing participant users and their rights.

pub fn identity_provider_config_service( &self, ) -> DamlIdentityProviderConfigService<'_>

Retrieve a DamlIdentityProviderConfigService for managing runtime-configured Identity Provider configurations.

pub fn command_inspection_service(&self) -> DamlCommandInspectionService<'_>

Retrieve a DamlCommandInspectionService for debugging in-flight commands on the participant. Alpha; only available when the participant advertises experimental.command_inspection_service.supported in its VersionService.GetLedgerApiVersion feature descriptor.

pub fn participant_pruning_service(&self) -> DamlParticipantPruningService<'_>

Retrieve a DamlParticipantPruningService for truncating older portions of the participant-local ledger view.

pub fn time_service(&self) -> DamlTimeService<'_>

Retrieve a DamlTimeService for reading and advancing the participant’s static-time clock. Only meaningful when the participant is configured for static time (see the experimental.static_time flag in VersionService::GetLedgerApiVersion).

v2 dropped the sandbox feature gate — TimeService is part of every Canton participant’s testing API; static-vs- wallclock is a server-side config switch, not a client build flag.

Trait Implementations

impl Debug for DamlGrpcClient

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

Formats the value using the given formatter.