@distrohelena/canton-typescript-sdk 0.1.35 → 0.1.37

package/README.md

@@ -132,36 +132,89 @@ npm run example:topology:party-hosting
 
 ### Workflow examples
 
-The four workflow examples are standalone proofs, not a sequence: each uploads
-or verifies the fixture DAR, resolves a party, reads the participant status,
-and creates its own run-scoped data. First make a Canton participant available
-and verify the source with `npm run examples:check`; the default endpoints and
-authentication environment variables are documented below. Run any example
-independently:
+The eight stateful workflow examples are standalone proofs, not a sequence:
+each uploads or verifies the fixture DAR, resolves a party, reads the
+participant status, and creates its own run-scoped data. First make a Canton
+participant available and verify the source with `npm run examples:check`; the
+default endpoints and authentication environment variables are documented below.
+The pruning preflight is a separate read-only operator check and does none of
+those setup or mutation steps. Run any example independently:
 
 ```bash
 npm run example:workflow:atomic
 npm run example:workflow:retry
 npm run example:workflow:resume
 npm run example:workflow:stale-contract
+npm run example:workflow:command-completion
+npm run example:workflow:contract-lifecycle-audit
+npm run example:workflow:update-lookup-reconciliation
+npm run example:workflow:pruning-preflight
+npm run example:workflow:participant-local
 ```
 
-They intentionally leave durable state behind. A missing `SDK_EXAMPLE_PARTY`
+Those eight established stateful workflows intentionally leave durable state behind. A missing `SDK_EXAMPLE_PARTY`
 causes fallback party allocation, which creates durable topology state; every
-workflow also creates durable contracts. Set `SDK_EXAMPLE_PARTY` to an existing
-party to rerun all four against that party and avoid fallback allocation. The
-fixture DAR remains installed after a run.
-
-Each program prints its actor plus the full participant version returned by the
+one also creates durable contracts. Set `SDK_EXAMPLE_PARTY` to an existing
+party to rerun the established workflows against that party and avoid fallback
+allocation. The fixture DAR remains installed after a run.
+
+The participant-local command-submission workflow
+(`npm run example:workflow:participant-local`) is a standalone gRPC-only proof
+of the ordinary participant submission authorization route. It uses the normal
+`SDK_EXAMPLE_*` endpoint, authentication, party, and timeout configuration:
+`SDK_EXAMPLE_LEDGER_ENDPOINT`, `SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`,
+`SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`, `SDK_EXAMPLE_BEARER_TOKEN`,
+`SDK_EXAMPLE_LEDGER_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`,
+`SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTY`,
+`SDK_EXAMPLE_PARTY_PREFIX`, `SDK_EXAMPLE_TIMEOUT_MS`, and
+`SDK_EXAMPLE_TLS_ROOT_CERTIFICATE`. It configures a command signer that throws
+if touched, then successfully creates and finds one exact active Message through
+`commandService.submitParticipantLocalAndWaitAsync`; that success proves the
+configured external signer was bypassed. An explicit party is reused, while
+fallback allocation creates durable topology; the fixture upload leaves a
+durable DAR and the proof leaves a durable contract. The unchanged
+implementation uses the common compatibility path on Participant 3.5.7 and
+the isolated Participant 3.5.8 sidecar.
+
+The completion-correlation workflow (`npm run example:workflow:command-completion`)
+is a standalone successful proof that creates durable Message state. It uses the
+same normal `SDK_EXAMPLE_*` configuration: `SDK_EXAMPLE_LEDGER_ENDPOINT`,
+`SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`,
+`SDK_EXAMPLE_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_BEARER_TOKEN`,
+`SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`,
+`SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`,
+`SDK_EXAMPLE_TLS_ROOT_CERTIFICATE`, `SDK_EXAMPLE_PARTY`,
+`SDK_EXAMPLE_PARTY_PREFIX`, and `SDK_EXAMPLE_TIMEOUT_MS`.
+`SDK_EXAMPLE_USER_ID` is mandatory: absent or blank input is rejected, while
+every nonblank value is preserved untrimmed and exactly submitted and exactly
+matched in the completion. With bearer authentication, the configured declared
+user must equal the token's Ledger API user/subject; the example does not inspect
+the token. It keeps the ledger end as its saved exclusive offset and begins the
+first stream read before submission.
+No public wait-for-command-completion helper or API is introduced; the
+correlation helper remains example-only.
+The completion-correlation example asserts successful correlation only; it does
+not assert rejected-command correlation. On both participant observations, the
+stream-first rejected-command probes observed no exact completion before their
+bounded stream transport errors.
+
+The contract-lifecycle audit workflow (`npm run example:workflow:contract-lifecycle-audit`) is a standalone gRPC-only proof. It uses the normal `SDK_EXAMPLE_*` endpoint, authentication, party, and timeout configuration: `SDK_EXAMPLE_LEDGER_ENDPOINT`, `SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`, `SDK_EXAMPLE_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTY`, `SDK_EXAMPLE_PARTY_PREFIX`, and `SDK_EXAMPLE_TIMEOUT_MS`. An explicit `SDK_EXAMPLE_PARTY` is reused; otherwise fallback allocation creates durable topology. The fixture upload leaves a durable DAR, and the workflow leaves durable contracts. It uses the alpha ContractService to prove the original active Message before replacement and the replacement active Message afterward, then uses EventQuery for the original contract's create/archive history. It makes no post-archive ContractService claim for the original.
+
+The update-lookup reconciliation workflow (`npm run example:workflow:update-lookup-reconciliation`) is a standalone gRPC-only proof that observes one exact self-party Message transaction from `UpdateService.GetUpdates`, then immediately reconciles it through `getUpdateById` and `getUpdateByOffset`. It uses the normal `SDK_EXAMPLE_*` endpoint, authentication, party, and timeout configuration, including `SDK_EXAMPLE_PARTY` and `SDK_EXAMPLE_TIMEOUT_MS`; first run `npm run examples:check` and make an authenticated participant available. An explicit party is reused, while fallback allocation creates durable topology; the fixture upload leaves a durable DAR and the workflow leaves durable contracts. The same unchanged implementation is tested against authenticated Participant 3.5.7 and the isolated Participant 3.5.8 sidecar, in default-party and explicit-party modes.
+
+The pruning-preflight workflow (`npm run example:workflow:pruning-preflight`) is a standalone gRPC-only, read-only operator check. It requires `SDK_EXAMPLE_OFFSET` to be a canonical positive decimal integer and uses the normal endpoint, authentication, and timeout variables: `SDK_EXAMPLE_LEDGER_ENDPOINT`, `SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`, `SDK_EXAMPLE_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`, and `SDK_EXAMPLE_TIMEOUT_MS`. The participant-admin credential is required for the schedule and safe-pruning context reads. Its safe-pruning context request sends the saved ledger end and a validated current timestamp encoded in `beforeOrAt`; it leaves commitment-state absent. It does not mutate the participant or create durable state: no party, DAR, command, update query, schedule change, or pruning request is made. The later participant watermark classifies the supplied offset as `alreadyPruned`, `beyondLedgerEnd`, or `notObservedPruned`; all-divulged watermarks and schedule/safe-pruning context are reported separately and do not alter that result. `notObservedPruned` is not proven queryable, because pruning can race after the later observation and other query preconditions can still fail. The unchanged implementation is supported on Participant 3.5.7 and the isolated Participant 3.5.8 sidecar.
+
+Each of the eight established stateful workflows prints its actor plus the full participant version returned by the
 authenticated status API, its parsed release core, and its selected path:
 `Participant version:`, `Release core:`, and `Compatibility path:`. The current
-implementation uses one common-code path for release cores 3.5.7 and 3.5.8. It
+stateful-workflow implementation uses one common-code path for release cores 3.5.7 and 3.5.8. It
 adds a version-specific behavioral difference only after live evidence proves
 one; it does not infer compatibility from a container tag or endpoint.
 
-- `example:workflow:atomic` first proves that an invalid choice is rejected,
-  then proves an atomic create-and-exercise by reading the created replacement
-  and its exact text.
+- `example:workflow:atomic` first proves that a two-command batch with an
+  invalid second command is rejected without creating its valid first Message,
+  then proves that two independent creates commit atomically and remain active
+  with their exact payloads.
 - `example:workflow:retry` submits a caller-controlled command ID with a
   deduplication duration, retries the exact same request, classifies the
   duplicate outcome, and proves that exactly one matching contract is active.
@@ -179,15 +232,15 @@ request and is not a retry proof. The resume example treats the saved offset as
 exclusive, so its resumed stream must observe only updates after the saved
 ledger end.
 
-The workflow source and unit contracts were developed and live-tested against
-authenticated Participant 3.5.7 and the isolated Participant 3.5.8. Both
-final-tree matrices selected the same unchanged implementation and common
+The eight established stateful workflow sources and unit contracts were developed
+and live-tested against authenticated Participant 3.5.7 and the isolated
+Participant 3.5.8. Both final-tree matrices selected the same unchanged implementation and common
 compatibility path. The normalized outcome comparison is identical: atomic
 reports `invalidChoice` before its replacement proof, retry reports
 `duplicateCommand` with one active contract, resume reports `idle-timeout` and
 a post-offset update, and stale-contract reports `staleContract`.
 
-The best multi-version path reads the authenticated full version, parses its
+For those eight established stateful workflows, the best multi-version path reads the authenticated full version, parses its
 release core, and uses data-only structured compatibility for observed
 outcomes. A behavioral difference is introduced only after live proof; it is
 never inferred from a container tag, endpoint, or prose error message. For the
@@ -555,7 +608,11 @@ const contracts = await client.stateService.getActiveContractsPageAsync(
 );
 ```
 
-`stateService.getActiveContractsPageAsync(...)` accepts the generated Ledger API request on gRPC, including its `eventFormat`, `activeAtOffset`, `maxPageSize`, and `pageToken` fields. Build party, template, and interface filters in `eventFormat`. JSON does not implement this paginated RPC; use `getActiveContractsAsync(...)` for JSON streaming reads.
+`stateService.getActiveContractsPageAsync(...)` is gRPC-only and accepts the generated Ledger API request, including its `eventFormat`, `activeAtOffset`, `maxPageSize`, and `pageToken` fields. Build party, template, and interface filters in `eventFormat`.
+
+`stateService.getActiveContractsPagesAsync(...)` is the gRPC-only lazy, raw, bounded traversal API. It starts from the same generated request and yields raw `GetActiveContractsPageResponse` values one page at a time. The caller selects the shared `OperationDeadline`, maximum pages, and maximum contracts with `ActiveContractsTraversalOptions`; there is no collect-all wrapper. Transport errors from dispatched RPCs propagate unchanged. Traversal safety, invariant, and bound failures use `ActiveContractsTraversalError` codes, such as an inconsistent offset, repeated page token, or exceeded bound.
+
+JSON does not implement either paginated gRPC API. Its existing `stateService.getActiveContractsAsync(...)` behavior remains the distinct JSON streaming read.
 
 For interface views, do not use `contractService.getContractAsync(...)`. That contract lookup surface cannot return interface views; use `stateService` or `updateService` instead.
 
@@ -645,53 +702,103 @@ signature format and algorithm. This convenience operation is gRPC-only.
 
 ## Canton Manager queries
 
-`CantonManager` keeps gRPC as the write path and selects a single query source
-at initialization. PQS exposes the complete PQS relation surface; gRPC exposes
-an all-hosted-party active-contract snapshot.
+`CantonManager` keeps gRPC as the write path and selects one typed-query source
+at initialization. The same typed query function works with either gRPC or
+PQS; source selection changes how the data is read, not the query grammar.
 
 ```ts
 import {
+    CantonClientOptions,
     CantonManager,
+    CreateCommand,
+    DamlRecord,
     MemoryQueryCache,
     QuerySource,
+    SubmitCommandsRequest,
     TransportKind,
 } from "@distrohelena/canton-typescript-sdk";
 
-const manager = new CantonManager({
-    grpc: { transportKind: TransportKind.grpc, ledgerEndpoint: "localhost:6865" },
-    querySource: QuerySource.pqs,
+const options = {
+    grpc: new CantonClientOptions({
+        transportKind: TransportKind.grpc,
+        ledgerEndpoint: "localhost:6865",
+    }),
     pqs: { connectionString: process.env.PQS_URL!, schema: "public" },
     cache: { store: new MemoryQueryCache(), ttlMs: 5_000 },
-});
+};
 
-const contracts = await manager.query.contracts.findMany({
-    where: { templateId: { equals: "packageId:Module:Template" }, active: true },
+const readIous = (manager: CantonManager) => manager.query.contracts.findMany({
+    where: { templateId: { moduleName: { equals: "Main" }, entityName: { equals: "Iou" } } },
+    orderBy: [{ createdAt: "desc" }],
     take: 50,
 });
 
-await manager.grpc.commandService.submitAndWaitAsync(/* existing command request */);
-await manager.disposeAsync();
+const pqsManager = new CantonManager({ ...options, querySource: QuerySource.pqs });
+const grpcManager = new CantonManager({ ...options, querySource: QuerySource.grpc });
+const pqsContracts = await readIous(pqsManager);
+const grpcContracts = await readIous(grpcManager);
+
+// gRPC caching is explicit and point-in-time; ordinary reads never populate it.
+await grpcManager.query.cacheContracts({ parties: ["Alice"] });
+await grpcManager.query.invalidateContractsCache({ parties: ["Alice"] });
+
+// A SubmitCommandsRequest contains a non-empty ordered atomic command batch:
+// all commands commit together, or none of them do.
+await grpcManager.grpc.commandService.submitAndWaitAsync(
+    new SubmitCommandsRequest({
+        applicationId: "example-app",
+        actAs: ["Alice"],
+        commands: [
+            new CreateCommand({
+                templateId: { packageId: "", moduleName: "Main", entityName: "Message" },
+                createArguments: new DamlRecord({ author: "Alice", body: "Hello" }),
+            }),
+        ],
+    }),
+);
+await Promise.all([pqsManager.disposeAsync(), grpcManager.disposeAsync()]);
 ```
 
-With `QuerySource.grpc`, omit `pqs`; contract queries fetch the participant's
-active-contract snapshot using the Ledger API wildcard for all hosted parties.
-PQS-only relation delegates and raw SQL then reject with `QueryCapabilityError`.
-
-PQS managers expose `contracts`, `contractTypes`, `events`, `exercises`,
-`exerciseTypes`, `packages`, `transactions`, and `watermark`. Raw SQL is
-available through `manager.query.$queryRaw(...)` when the selected client is
-PQS-specific. It accepts one read-only statement with positional parameters;
-use a read-only PostgreSQL role as defense in depth.
-
-The PQS relation delegates use a Prisma-like surface: `findMany({ where,
+To migrate a prior singleton submission, pass `commands: [previousCommand]`.
+There is no compatibility alias; put multiple independent commands in that
+array in their required atomic order.
+
+An options object may contain both `grpc` and `pqs`; the PQS setting is used
+only when `querySource` is `pqs`. Both sources expose `contracts`,
+`contractTypes`, `events`, `exercises`, `exerciseTypes`, `packages`,
+`transactions`, and `watermark`, including filters, includes, ordering,
+pagination, projections, grouping, and aggregates. Literal parity requires
+PQS and gRPC to observe the same participant-visible data; independently
+configured participants can legitimately see different contracts.
+
+`cacheContracts` is a gRPC-only explicit prewarm of active contracts for one
+party scope. It needs a cache store and a positive TTL; reads may use a valid
+entry but never renew it. A cached gRPC result is internally consistent at its
+`activeAtOffset`, so it can be stale until expiry, refresh, or
+`invalidateContractsCache`. Under PQS the same lifecycle calls are safe no-ops
+and `cacheContracts` returns `{ source: QuerySource.pqs, cached: false }`.
+
+Typed-query `pk`/`ix` values are canonical and source-independent. Transaction
+and watermark keys are ledger offsets; event, package, contract-type, and
+exercise-type keys are lossless positive-decimal encodings of their stable
+semantic identities. PQS physical keys are retained only for internal joins.
+If pruning has removed history needed by a gRPC typed query, it rejects with
+`QuerySnapshotIncompleteError` rather than returning partial rows, groups, or
+aggregates.
+
+Raw SQL is the sole PQS-only query operation: use
+`pqsManager.query.$queryRaw(...)` for one read-only statement with positional
+parameters and a read-only PostgreSQL role. `$queryRaw` on a gRPC manager
+rejects with `QueryCapabilityError`.
+
+The typed relation delegates use a Prisma-like surface: `findMany({ where,
 select, orderBy, skip, take })`, `findUnique({ where, select })`, `count`, and
 `aggregate({ count, min, max, sum })`. Filters support `equals`, `in`,
 `{ is: null }`, `{ isNot: null }`, and `{ has: party }` on array fields.
-Ordering accepts one field. `exercises` intentionally has no `findUnique`
+Ordering accepts an ordered list of one-field entries, so multi-field ordering
+uses `[{ createdAt: "desc" }, { contractId: "asc" }]`. `exercises` intentionally has no `findUnique`
 because the v1 PQS profile does not declare a stable key. The manager validates
-the selected PQS schema profile before its first query. In gRPC mode, only the
-active-contract `findMany`, `findUnique`, and `count` subset is available;
-unsupported query features reject with `QueryCapabilityError`.
+the selected PQS schema profile before its first PQS query.
 
 - Ledger endpoint:
 - `versionService.getLedgerApiVersionAsync(...)`: `json`, `grpc`
@@ -703,11 +810,12 @@ unsupported query features reject with `QueryCapabilityError`.
 - `commandService.submitAndWaitAsync(...)`: `json`, `grpc`
 - `commandSubmissionService.submitAsync(...)`: reserved, currently unsupported
 - `stateService.getActiveContractsPageAsync(...)`: `grpc` only
-- `stateService.getActiveContractsAsync(...)`: `json` only
+- `stateService.getActiveContractsPagesAsync(...)`: `grpc` only, lazy raw bounded traversal
+- `stateService.getActiveContractsAsync(...)`: `json` only, existing distinct streaming read
 - `updateService.getUpdatesAsync(...)`: `grpc` only
-- `commandCompletionService`: placeholder, no methods yet
-- `eventQueryService`: placeholder, no methods yet
-- `contractService`: placeholder, no methods yet
+- `commandCompletionService.getCompletionsAsync(...)`: `grpc` only, existing streaming API
+- `eventQueryService.getEventsByContractIdAsync(...)`: `grpc` only; JSON rejects this request
+- `contractService.getContractAsync(...)`: `grpc` only; JSON rejects this request
 
 - Ledger Admin endpoint:
 - `partyManagementService.allocatePartyAsync(...)`: `json`, `grpc`

package/dist/cjs/core/types/requests/{submit-command-request.js → submit-commands-request.js}

@@ -1,22 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubmitCommandRequest = void 0;
+exports.SubmitCommandsRequest = void 0;
 const validation_error_js_1 = require("../../errors/validation-error.js");
 const ledgerStringPattern = /^[A-Za-z0-9#:\-_/ ]+$/;
 const canonicalOffsetPattern = /^(0|[1-9][0-9]*)$/;
 const maximumInt64Offset = "9223372036854775807";
-class SubmitCommandRequest {
+class SubmitCommandsRequest {
     applicationId;
     userId;
     actAs;
     readAs;
-    command;
+    commands;
     commandId;
     deduplicationPeriod;
     disclosedContracts;
     synchronizerId;
     constructor(init) {
-        if (init.actAs.length === 0) {
+        const commands = init.commands;
+        if (!Array.isArray(commands) || commands.length === 0) {
+            throw new validation_error_js_1.ValidationError("submit requests require at least one command");
+        }
+        else if (init.actAs.length === 0) {
             throw new validation_error_js_1.ValidationError("submit requests require at least one actAs party");
         }
         else if (init.commandId !== undefined &&
@@ -30,14 +34,14 @@ class SubmitCommandRequest {
         this.userId = init.userId;
         this.actAs = init.actAs;
         this.readAs = init.readAs ?? [];
-        this.command = init.command;
+        this.commands = Object.freeze([...commands]);
         this.commandId = init.commandId;
         this.deduplicationPeriod = deduplicationPeriod;
         this.disclosedContracts = init.disclosedContracts ?? [];
         this.synchronizerId = init.synchronizerId;
     }
 }
-exports.SubmitCommandRequest = SubmitCommandRequest;
+exports.SubmitCommandsRequest = SubmitCommandsRequest;
 function freezeDeduplicationPeriod(value) {
     if (value === undefined) {
         return undefined;

package/dist/cjs/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalPartySigningAlgorithmSpec = exports.ExternalPartySignatureFormat = exports.ExternalPartySignature = exports.ExternalPartyOnboardingTransaction = exports.ExternalPartyCryptoKeyFormat = exports.TransportKind = exports.TransportCapability = exports.SignCommandResult = exports.SignCommandRequest = exports.BearerTokenAuthProvider = exports.SynchronizerConnectivityServiceClient = exports.VersionServiceClient = exports.UserManagementServiceClient = exports.UpdateServiceClient = exports.TrafficControlServiceClient = exports.TopologyManagerWriteServiceClient = exports.TopologyManagerReadServiceClient = exports.TopologyAggregationServiceClient = exports.StateServiceClient = exports.ResourceManagementServiceClient = exports.PruningServiceClient = exports.PartyManagementServiceClient = exports.ParticipantStatusServiceClient = exports.ParticipantRepairServiceClient = exports.ParticipantPackageServiceClient = exports.ParticipantPartyManagementServiceClient = exports.ParticipantInspectionServiceClient = exports.PackageServiceClient = exports.PackageManagementServiceClient = exports.IdentityProviderConfigServiceClient = exports.IdentityInitializationServiceClient = exports.HealthServiceClient = exports.EventQueryServiceClient = exports.ContractServiceClient = exports.CommandSubmissionServiceClient = exports.CommandServiceClient = exports.CommandInspectionServiceClient = exports.CommandCompletionServiceClient = exports.ExternalPartyActivationResponse = exports.ExternalPartyActivationRequest = exports.ExternalPartyActivationClient = exports.CantonClientOptions = exports.CantonHashingClient = exports.PqsSchemaProfileError = exports.PqsQueryError = exports.QueryCapabilityError = exports.MemoryQueryCache = exports.QuerySource = exports.CantonManager = exports.CantonClient = void 0;
-exports.ParticipantDarDescription = exports.PackageReference = exports.PackageMetadataFilter = exports.ActiveContractsTraversalOptions = exports.OperationDeadline = exports.RequestOptions = exports.ReceivedAcsCommitmentState = exports.ReceivedAcsCommitmentPerSynchronizer = exports.ReceivedAcsCommitment = exports.PruningSchedule = exports.ParticipantPruningSchedule = exports.PendingOperationMetadata = exports.PackageStatus = exports.CantonHashPurpose = exports.HashFunction = exports.PackageFormat = exports.OffsetCheckpoint = exports.ObjectMeta = exports.LedgerUser = exports.KnownPackageDetails = exports.IdentityProviderConfig = exports.UserRightKind = exports.EventStreamKind = exports.DamlParty = exports.DamlNumeric = exports.ContractCreated = exports.ContractArchived = exports.CounterParticipantInfo = exports.CommitmentTimeRange = exports.CommitmentInterval = exports.Completion = exports.CommandUpdateSummary = exports.CommandTiming = exports.CommandStatus = exports.CommandState = exports.CommandRequestStatistics = exports.CommandInspectionContract = exports.ConnectedSynchronizerStatus = exports.ConnectedSynchronizer = exports.ConnectedSynchronizerHealth = exports.AdminTopologyQueueStatus = exports.AdminNotInitializedStatus = exports.AdminNotInitializedExternalInputKind = exports.AdminNodeStatus = exports.AdminComponentStatus = exports.AdminComponentHealthKind = exports.SubmissionMode = exports.GrpcChannelSecurity = exports.ExternalPartySigningPublicKey = exports.ExternalPartySigningKeySpec = void 0;
-exports.TopologyForceFlag = exports.TopologyPublicKey = exports.TopologyPartyResult = exports.TopologyPartyParticipantSynchronizerPermission = exports.TopologyPartyParticipant = exports.TopologyMappingResult = exports.TopologyMappingOperation = exports.TopologyMappingCode = exports.TopologyKeyOwnerResult = exports.MultiTopologyTransactionSignature = exports.GeneratedTopologyTransaction = exports.TopologyEncryptionPublicKey = exports.ExternalTopologySignature = exports.TopologyDuration = exports.TopologyBaseResult = exports.TopologyBaseQuery = exports.SynchronizerTrustCertificate = exports.SequencerSynchronizerState = exports.PartyToParticipantParticipant = exports.PartyToParticipantOnboarding = exports.PartyToParticipant = exports.PartyToKeyMapping = exports.PartyHostingLimits = exports.ParticipantSynchronizerPermission = exports.ParticipantSynchronizerLimits = exports.ParticipantPermission = exports.OwnerToKeyMapping = exports.OnboardingRestriction = exports.NamespaceDelegationRestrictionKind = exports.NamespaceDelegationRestriction = exports.NamespaceDelegation = exports.MediatorSynchronizerState = exports.LsuSequencerConnectionSuccessor = exports.LsuSequencerConnection = exports.LsuAnnouncement = exports.DynamicSynchronizerParameters = exports.DynamicSequencingParameters = exports.DecentralizedNamespaceDefinition = exports.AcsCommitmentsCatchUpConfig = exports.WaitCommitmentsSetup = exports.TopologyStateFilter = exports.SynchronizerTimeRange = exports.SlowCounterParticipantSynchronizerConfig = exports.SentAcsCommitmentState = exports.SentAcsCommitmentPerSynchronizer = exports.SentAcsCommitment = exports.SdkCommand = exports.SafeToPruneCommitmentState = exports.ParticipantPackageDescription = exports.ParticipantModuleDescription = void 0;
-exports.ListDecentralizedNamespaceDefinitionRequest = exports.ListAllRequest = exports.ListPackagesRequest = exports.GetCommandStatusRequest = exports.GetActiveContractsRequest = exports.GetActiveContractsPageRequest = exports.GetDarRequest = exports.GetDarContentsRequest = exports.AssembleSignedTopologyTransactionsRequest = exports.SubmitCommandTransactionResponse = exports.DamlRecord = exports.DamlEnum = exports.DamlVariant = exports.DamlGenMap = exports.DamlTextMap = exports.DamlTimestamp = exports.DamlDate = exports.DamlUnit = exports.DamlContractId = exports.PreparedCommandSubmission = exports.DisclosedContract = exports.AllocatePartyRequest = exports.CreateExternalPartyRequest = exports.PreparedDecentralizedParty = exports.FinalizeDecentralizedPartyRequest = exports.CreateDecentralizedPartyRequest = exports.ExerciseCommand = exports.ExerciseByKeyCommand = exports.CreateCommand = exports.CreateAndExerciseCommand = exports.SignedTopologyTransaction = exports.PreparedTopologyTransaction = exports.VettedPackages = exports.VettedPackage = exports.TrafficControlParameters = exports.TopologyVettedPackages = exports.TopologyVettedPackage = exports.TopologyTransactions = exports.TopologyTransactionItem = exports.TopologyTransactionSignature = exports.TopologyTimeRange = exports.TopologyStoreTemporary = exports.TopologyStoreSynchronizer = exports.TopologyStoreKind = exports.TopologyStoreId = exports.TopologyStoreAuthorized = exports.TopologySigningPublicKey = exports.TopologySigningKeysWithThreshold = exports.TopologySignatureFormat = exports.TopologySignatureDelegation = void 0;
-exports.ListDecentralizedNamespaceDefinitionResponse = exports.ListAllResponse = exports.GetUserResponse = exports.GetPartiesResponse = exports.GetPackageStatusResponse = exports.GetPackageResponse = exports.GetLedgerEndResponse = exports.GetLatestPrunedOffsetsResponse = exports.GetIdentityProviderConfigResponse = exports.GetCommandStatusResponse = exports.GetConnectedSynchronizersResponse = exports.GetActiveContractsPageResponse = exports.GetDarResponse = exports.GetDarContentsResponse = exports.AllocatePartyResponse = exports.UploadDarFileRequest = exports.GrantUserRightsRequest = exports.WaitForPartyHostingRequest = exports.TopologyListPartiesRequest = exports.SubmitCommandRequest = exports.ListUsersRequest = exports.ListUserRightsRequest = exports.ListKeyOwnersRequest = exports.ListIdentityProviderConfigsRequest = exports.ListDarsRequest = exports.ListKnownPackagesRequest = exports.ListKnownPartiesRequest = exports.TopologyListVettedPackagesRequest = exports.ListSynchronizerTrustCertificateRequest = exports.ListSynchronizerParametersStateRequest = exports.ListSequencingParametersStateRequest = exports.ListSequencerSynchronizerStateRequest = exports.ListPartyToParticipantRequest = exports.ListPartyToKeyMappingRequest = exports.ListVettedPackagesRequest = exports.ListPartyHostingLimitsRequest = exports.ListParticipantSynchronizerPermissionRequest = exports.ListOwnerToKeyMappingRequest = exports.ListNamespaceDelegationRequest = exports.ListMediatorSynchronizerStateRequest = exports.ListLsuSequencerConnectionSuccessorRequest = exports.ListLsuAnnouncementRequest = exports.GetUserRequest = exports.GetPartiesRequest = exports.GetLedgerEndRequest = exports.GetLatestPrunedOffsetsRequest = exports.GetConnectedSynchronizersRequest = exports.GetPackageStatusRequest = exports.GetPackageRequest = exports.GetIdentityProviderConfigRequest = void 0;
-exports.EndpointNotConfiguredError = exports.ObjectDisposedError = exports.NotSupportedError = exports.ConflictError = exports.TimeoutError = exports.SigningError = exports.GrpcTransportError = exports.TransportError = exports.AuthorizationError = exports.AuthenticationError = exports.ActiveContractsTraversalError = exports.ValidationError = exports.CantonError = exports.SynchronizerTime = exports.ParticipantNodeStatus = exports.PartyDetails = exports.UploadDarFileResponse = exports.GrantUserRightsResponse = exports.SubmitCommandResponse = exports.TopologyListPartiesResponse = exports.TopologyListVettedPackagesResponse = exports.ListVettedPackagesResponse = exports.ListUsersResponse = exports.ListUserRightsResponse = exports.ListSynchronizerTrustCertificateResponse = exports.ListSynchronizerParametersStateResponse = exports.ListSequencingParametersStateResponse = exports.ListSequencerSynchronizerStateResponse = exports.ListPartyToParticipantResponse = exports.ListPartyToKeyMappingResponse = exports.ListPartyHostingLimitsResponse = exports.ListParticipantSynchronizerPermissionResponse = exports.ListKeyOwnersResponse = exports.ListKnownPartiesResponse = exports.ListKnownPackagesResponse = exports.ListIdentityProviderConfigsResponse = exports.ListDarsResponse = exports.ListPackagesResponse = exports.ListOwnerToKeyMappingResponse = exports.ListNamespaceDelegationResponse = exports.ListMediatorSynchronizerStateResponse = exports.ListLsuSequencerConnectionSuccessorResponse = exports.ListLsuAnnouncementResponse = void 0;
+exports.ExternalPartySignatureFormat = exports.ExternalPartySignature = exports.ExternalPartyOnboardingTransaction = exports.ExternalPartyCryptoKeyFormat = exports.TransportKind = exports.TransportCapability = exports.SignCommandResult = exports.SignCommandRequest = exports.BearerTokenAuthProvider = exports.SynchronizerConnectivityServiceClient = exports.VersionServiceClient = exports.UserManagementServiceClient = exports.UpdateServiceClient = exports.TrafficControlServiceClient = exports.TopologyManagerWriteServiceClient = exports.TopologyManagerReadServiceClient = exports.TopologyAggregationServiceClient = exports.StateServiceClient = exports.ResourceManagementServiceClient = exports.PruningServiceClient = exports.PartyManagementServiceClient = exports.ParticipantStatusServiceClient = exports.ParticipantRepairServiceClient = exports.ParticipantPackageServiceClient = exports.ParticipantPartyManagementServiceClient = exports.ParticipantInspectionServiceClient = exports.PackageServiceClient = exports.PackageManagementServiceClient = exports.IdentityProviderConfigServiceClient = exports.IdentityInitializationServiceClient = exports.HealthServiceClient = exports.EventQueryServiceClient = exports.ContractServiceClient = exports.CommandSubmissionServiceClient = exports.CommandServiceClient = exports.CommandInspectionServiceClient = exports.CommandCompletionServiceClient = exports.ExternalPartyActivationResponse = exports.ExternalPartyActivationRequest = exports.ExternalPartyActivationClient = exports.CantonClientOptions = exports.CantonHashingClient = exports.PqsSchemaProfileError = exports.PqsQueryError = exports.QuerySnapshotIncompleteError = exports.QueryCapabilityError = exports.MemoryQueryCache = exports.QuerySource = exports.CantonManager = exports.CantonClient = void 0;
+exports.PackageReference = exports.PackageMetadataFilter = exports.ActiveContractsTraversalOptions = exports.OperationDeadline = exports.RequestOptions = exports.ReceivedAcsCommitmentState = exports.ReceivedAcsCommitmentPerSynchronizer = exports.ReceivedAcsCommitment = exports.PruningSchedule = exports.ParticipantPruningSchedule = exports.PendingOperationMetadata = exports.PackageStatus = exports.CantonHashPurpose = exports.HashFunction = exports.PackageFormat = exports.OffsetCheckpoint = exports.ObjectMeta = exports.LedgerUser = exports.KnownPackageDetails = exports.IdentityProviderConfig = exports.UserRightKind = exports.EventStreamKind = exports.DamlParty = exports.DamlNumeric = exports.ContractCreated = exports.ContractArchived = exports.CounterParticipantInfo = exports.CommitmentTimeRange = exports.CommitmentInterval = exports.Completion = exports.CommandUpdateSummary = exports.CommandTiming = exports.CommandStatus = exports.CommandState = exports.CommandRequestStatistics = exports.CommandInspectionContract = exports.ConnectedSynchronizerStatus = exports.ConnectedSynchronizer = exports.ConnectedSynchronizerHealth = exports.AdminTopologyQueueStatus = exports.AdminNotInitializedStatus = exports.AdminNotInitializedExternalInputKind = exports.AdminNodeStatus = exports.AdminComponentStatus = exports.AdminComponentHealthKind = exports.SubmissionMode = exports.GrpcChannelSecurity = exports.ExternalPartySigningPublicKey = exports.ExternalPartySigningKeySpec = exports.ExternalPartySigningAlgorithmSpec = void 0;
+exports.TopologyPublicKey = exports.TopologyPartyResult = exports.TopologyPartyParticipantSynchronizerPermission = exports.TopologyPartyParticipant = exports.TopologyMappingResult = exports.TopologyMappingOperation = exports.TopologyMappingCode = exports.TopologyKeyOwnerResult = exports.MultiTopologyTransactionSignature = exports.GeneratedTopologyTransaction = exports.TopologyEncryptionPublicKey = exports.ExternalTopologySignature = exports.TopologyDuration = exports.TopologyBaseResult = exports.TopologyBaseQuery = exports.SynchronizerTrustCertificate = exports.SequencerSynchronizerState = exports.PartyToParticipantParticipant = exports.PartyToParticipantOnboarding = exports.PartyToParticipant = exports.PartyToKeyMapping = exports.PartyHostingLimits = exports.ParticipantSynchronizerPermission = exports.ParticipantSynchronizerLimits = exports.ParticipantPermission = exports.OwnerToKeyMapping = exports.OnboardingRestriction = exports.NamespaceDelegationRestrictionKind = exports.NamespaceDelegationRestriction = exports.NamespaceDelegation = exports.MediatorSynchronizerState = exports.LsuSequencerConnectionSuccessor = exports.LsuSequencerConnection = exports.LsuAnnouncement = exports.DynamicSynchronizerParameters = exports.DynamicSequencingParameters = exports.DecentralizedNamespaceDefinition = exports.AcsCommitmentsCatchUpConfig = exports.WaitCommitmentsSetup = exports.TopologyStateFilter = exports.SynchronizerTimeRange = exports.SlowCounterParticipantSynchronizerConfig = exports.SentAcsCommitmentState = exports.SentAcsCommitmentPerSynchronizer = exports.SentAcsCommitment = exports.SdkCommand = exports.SafeToPruneCommitmentState = exports.ParticipantPackageDescription = exports.ParticipantModuleDescription = exports.ParticipantDarDescription = void 0;
+exports.ListAllRequest = exports.ListPackagesRequest = exports.GetCommandStatusRequest = exports.GetActiveContractsRequest = exports.GetActiveContractsPageRequest = exports.GetDarRequest = exports.GetDarContentsRequest = exports.AssembleSignedTopologyTransactionsRequest = exports.SubmitCommandTransactionResponse = exports.DamlRecord = exports.DamlEnum = exports.DamlVariant = exports.DamlGenMap = exports.DamlTextMap = exports.DamlTimestamp = exports.DamlDate = exports.DamlUnit = exports.DamlContractId = exports.PreparedCommandSubmission = exports.DisclosedContract = exports.AllocatePartyRequest = exports.CreateExternalPartyRequest = exports.PreparedDecentralizedParty = exports.FinalizeDecentralizedPartyRequest = exports.CreateDecentralizedPartyRequest = exports.ExerciseCommand = exports.ExerciseByKeyCommand = exports.CreateCommand = exports.CreateAndExerciseCommand = exports.SignedTopologyTransaction = exports.PreparedTopologyTransaction = exports.VettedPackages = exports.VettedPackage = exports.TrafficControlParameters = exports.TopologyVettedPackages = exports.TopologyVettedPackage = exports.TopologyTransactions = exports.TopologyTransactionItem = exports.TopologyTransactionSignature = exports.TopologyTimeRange = exports.TopologyStoreTemporary = exports.TopologyStoreSynchronizer = exports.TopologyStoreKind = exports.TopologyStoreId = exports.TopologyStoreAuthorized = exports.TopologySigningPublicKey = exports.TopologySigningKeysWithThreshold = exports.TopologySignatureFormat = exports.TopologySignatureDelegation = exports.TopologyForceFlag = void 0;
+exports.ListAllResponse = exports.GetUserResponse = exports.GetPartiesResponse = exports.GetPackageStatusResponse = exports.GetPackageResponse = exports.GetLedgerEndResponse = exports.GetLatestPrunedOffsetsResponse = exports.GetIdentityProviderConfigResponse = exports.GetCommandStatusResponse = exports.GetConnectedSynchronizersResponse = exports.GetActiveContractsPageResponse = exports.GetDarResponse = exports.GetDarContentsResponse = exports.AllocatePartyResponse = exports.UploadDarFileRequest = exports.GrantUserRightsRequest = exports.WaitForPartyHostingRequest = exports.TopologyListPartiesRequest = exports.SubmitCommandsRequest = exports.ListUsersRequest = exports.ListUserRightsRequest = exports.ListKeyOwnersRequest = exports.ListIdentityProviderConfigsRequest = exports.ListDarsRequest = exports.ListKnownPackagesRequest = exports.ListKnownPartiesRequest = exports.TopologyListVettedPackagesRequest = exports.ListSynchronizerTrustCertificateRequest = exports.ListSynchronizerParametersStateRequest = exports.ListSequencingParametersStateRequest = exports.ListSequencerSynchronizerStateRequest = exports.ListPartyToParticipantRequest = exports.ListPartyToKeyMappingRequest = exports.ListVettedPackagesRequest = exports.ListPartyHostingLimitsRequest = exports.ListParticipantSynchronizerPermissionRequest = exports.ListOwnerToKeyMappingRequest = exports.ListNamespaceDelegationRequest = exports.ListMediatorSynchronizerStateRequest = exports.ListLsuSequencerConnectionSuccessorRequest = exports.ListLsuAnnouncementRequest = exports.GetUserRequest = exports.GetPartiesRequest = exports.GetLedgerEndRequest = exports.GetLatestPrunedOffsetsRequest = exports.GetConnectedSynchronizersRequest = exports.GetPackageStatusRequest = exports.GetPackageRequest = exports.GetIdentityProviderConfigRequest = exports.ListDecentralizedNamespaceDefinitionRequest = void 0;
+exports.EndpointNotConfiguredError = exports.ObjectDisposedError = exports.NotSupportedError = exports.ConflictError = exports.TimeoutError = exports.SigningError = exports.GrpcTransportError = exports.TransportError = exports.AuthorizationError = exports.AuthenticationError = exports.ActiveContractsTraversalError = exports.ValidationError = exports.CantonError = exports.SynchronizerTime = exports.ParticipantNodeStatus = exports.PartyDetails = exports.UploadDarFileResponse = exports.GrantUserRightsResponse = exports.SubmitCommandResponse = exports.TopologyListPartiesResponse = exports.TopologyListVettedPackagesResponse = exports.ListVettedPackagesResponse = exports.ListUsersResponse = exports.ListUserRightsResponse = exports.ListSynchronizerTrustCertificateResponse = exports.ListSynchronizerParametersStateResponse = exports.ListSequencingParametersStateResponse = exports.ListSequencerSynchronizerStateResponse = exports.ListPartyToParticipantResponse = exports.ListPartyToKeyMappingResponse = exports.ListPartyHostingLimitsResponse = exports.ListParticipantSynchronizerPermissionResponse = exports.ListKeyOwnersResponse = exports.ListKnownPartiesResponse = exports.ListKnownPackagesResponse = exports.ListIdentityProviderConfigsResponse = exports.ListDarsResponse = exports.ListPackagesResponse = exports.ListOwnerToKeyMappingResponse = exports.ListNamespaceDelegationResponse = exports.ListMediatorSynchronizerStateResponse = exports.ListLsuSequencerConnectionSuccessorResponse = exports.ListLsuAnnouncementResponse = exports.ListDecentralizedNamespaceDefinitionResponse = void 0;
 var canton_client_js_1 = require("./client/canton-client.js");
 Object.defineProperty(exports, "CantonClient", { enumerable: true, get: function () { return canton_client_js_1.CantonClient; } });
 var canton_manager_js_1 = require("./query/canton-manager.js");
@@ -16,6 +16,8 @@ var memory_query_cache_js_1 = require("./query/cache/memory-query-cache.js");
 Object.defineProperty(exports, "MemoryQueryCache", { enumerable: true, get: function () { return memory_query_cache_js_1.MemoryQueryCache; } });
 var query_capability_error_js_1 = require("./query/errors/query-capability-error.js");
 Object.defineProperty(exports, "QueryCapabilityError", { enumerable: true, get: function () { return query_capability_error_js_1.QueryCapabilityError; } });
+var query_snapshot_incomplete_error_js_1 = require("./query/errors/query-snapshot-incomplete-error.js");
+Object.defineProperty(exports, "QuerySnapshotIncompleteError", { enumerable: true, get: function () { return query_snapshot_incomplete_error_js_1.QuerySnapshotIncompleteError; } });
 var pqs_query_error_js_1 = require("./query/errors/pqs-query-error.js");
 Object.defineProperty(exports, "PqsQueryError", { enumerable: true, get: function () { return pqs_query_error_js_1.PqsQueryError; } });
 var pqs_schema_profile_error_js_1 = require("./query/errors/pqs-schema-profile-error.js");
@@ -458,8 +460,8 @@ var list_user_rights_request_js_1 = require("./core/types/requests/list-user-rig
 Object.defineProperty(exports, "ListUserRightsRequest", { enumerable: true, get: function () { return list_user_rights_request_js_1.ListUserRightsRequest; } });
 var list_users_request_js_1 = require("./core/types/requests/list-users-request.js");
 Object.defineProperty(exports, "ListUsersRequest", { enumerable: true, get: function () { return list_users_request_js_1.ListUsersRequest; } });
-var submit_command_request_js_1 = require("./core/types/requests/submit-command-request.js");
-Object.defineProperty(exports, "SubmitCommandRequest", { enumerable: true, get: function () { return submit_command_request_js_1.SubmitCommandRequest; } });
+var submit_commands_request_js_1 = require("./core/types/requests/submit-commands-request.js");
+Object.defineProperty(exports, "SubmitCommandsRequest", { enumerable: true, get: function () { return submit_commands_request_js_1.SubmitCommandsRequest; } });
 var topology_list_parties_request_js_1 = require("./core/types/requests/topology-list-parties-request.js");
 Object.defineProperty(exports, "TopologyListPartiesRequest", { enumerable: true, get: function () { return topology_list_parties_request_js_1.TopologyListPartiesRequest; } });
 var wait_for_party_hosting_request_js_1 = require("./core/types/requests/wait-for-party-hosting-request.js");