@distrohelena/canton-typescript-sdk 0.1.33 → 0.1.36

package/dist/transports/grpc/grpc-transport.js

@@ -10,6 +10,8 @@ import { createGrpcOperations, } from "./grpc-channel-factory.js";
 import { mapGrpcSubmitCommand, mapGrpcSubmitCommandForTransactionRequest, mapGrpcSubmitCommandTransaction, mapGrpcSubmitCommandRequest, } from "./mappers/commands-mapper.js";
 import { mapGrpcExecuteSubmissionAndWaitRequest, mapGrpcInteractiveSubmitCommand, mapGrpcPrepareSubmissionRequest, } from "./mappers/interactive-command-mapper.js";
 import { mapGrpcCreateParty, mapGrpcCreatePartyRequest, mapGrpcListParties, mapGrpcListPartiesRequest } from "./mappers/parties-mapper.js";
+import { mapGrpcListPartyToParticipantRequest, mapGrpcListPartyToParticipantResponse, } from "./mappers/topology-manager-read-mapper.js";
+import { mapGrpcGetUser, mapGrpcGetUserRequest, mapGrpcListUserRights, mapGrpcListUserRightsRequest, mapGrpcListUsers, mapGrpcListUsersRequest, } from "./mappers/users-mapper.js";
 import { ObjectDisposedError } from "../../core/errors/object-disposed-error.js";
 export class GrpcTransport {
     operations;
@@ -84,15 +86,18 @@ export class GrpcTransport {
     }
     async getUserAsync(request, options) {
         this.throwIfDisposed();
-        return (await this.operations.getUserAsync(request, options));
+        const payload = await this.operations.getUserAsync(mapGrpcGetUserRequest(request), options);
+        return mapGrpcGetUser(payload);
     }
     async listUsersAsync(request, options) {
         this.throwIfDisposed();
-        return (await this.operations.listUsersAsync(request, options));
+        const payload = await this.operations.listUsersAsync(mapGrpcListUsersRequest(request), options);
+        return mapGrpcListUsers(payload);
     }
     async listUserRightsAsync(request, options) {
         this.throwIfDisposed();
-        return (await this.operations.listUserRightsAsync(request, options));
+        const payload = await this.operations.listUserRightsAsync(mapGrpcListUserRightsRequest(request), options);
+        return mapGrpcListUserRights(payload);
     }
     async uploadDarFileAsync(request, options) {
         this.throwIfDisposed();
@@ -373,12 +378,12 @@ export class GrpcTransport {
         this.throwIfDisposed();
         let payload;
         try {
-            payload = await this.operations.listPartyToParticipantAsync(request, options);
+            payload = await this.operations.listPartyToParticipantAsync(mapGrpcListPartyToParticipantRequest(request), options);
         }
         catch (error) {
             this.throwPartyTopologyReadCompatibilityError(error, "topologyManagerReadService.listPartyToParticipantAsync");
         }
-        return payload;
+        return mapGrpcListPartyToParticipantResponse(payload);
     }
     async listSynchronizerParametersStateAsync(request, options) {
         this.throwIfDisposed();
@@ -437,7 +442,7 @@ export class GrpcTransport {
     }
     async getActiveContractsPageAsync(request, options) {
         this.throwIfDisposed();
-        return (await this.operations.getActiveContractsPageAsync(request, options));
+        return (await this.operations.queryContractsAsync(request, options));
     }
     async getConnectedSynchronizersAsync(request, options) {
         this.throwIfDisposed();
@@ -494,7 +499,7 @@ export class GrpcTransport {
         else if (!this.operations.executeSubmissionAndWaitAsync) {
             throw new NotSupportedError("interactive gRPC command signing is not available on this transport");
         }
-        const commandId = randomUUID();
+        const commandId = request.commandId ?? randomUUID();
         const submissionId = randomUUID();
         const prepared = await this.operations.prepareSubmissionAsync(mapGrpcPrepareSubmissionRequest(request, commandId), options);
         if (!prepared.preparedTransaction) {
@@ -505,8 +510,9 @@ export class GrpcTransport {
         }
         const signerResults = await Promise.all(request.actAs.map(async (party) => {
             const partySigner = "signAsync" in signer ? signer : signer[party];
-            if (partySigner === undefined)
+            if (partySigner === undefined) {
                 throw new ValidationError(`interactive command signing requires a signer for ${party}`);
+            }
             return { party, result: await partySigner.signAsync(new SignCommandRequest({ payload: prepared.preparedTransactionHash, party, algorithmHint: "ed25519" })) };
         }));
         const executed = await this.operations.executeSubmissionAndWaitAsync(mapGrpcExecuteSubmissionAndWaitRequest({
@@ -520,23 +526,33 @@ export class GrpcTransport {
     }
     async submitCommandForTransactionAsync(request, options) {
         this.throwIfDisposed();
-        if (!this.operations.submitCommandForTransactionAsync)
+        if (!this.operations.submitCommandForTransactionAsync) {
             throw new NotSupportedError("transaction-returning command submission is not available on this transport");
+        }
         return mapGrpcSubmitCommandTransaction(await this.operations.submitCommandForTransactionAsync(mapGrpcSubmitCommandForTransactionRequest(request), options));
     }
     async prepareCommandAsync(request, options) {
-        if (!this.operations.prepareSubmissionAsync)
+        if (!this.operations.prepareSubmissionAsync) {
             throw new NotSupportedError("interactive gRPC command signing is not available on this transport");
-        const prepared = await this.operations.prepareSubmissionAsync(mapGrpcPrepareSubmissionRequest(request, randomUUID()), options);
-        if (!prepared.preparedTransaction || prepared.preparedTransactionHash.length === 0)
+        }
+        const commandId = request.commandId ?? randomUUID();
+        const prepared = await this.operations.prepareSubmissionAsync(mapGrpcPrepareSubmissionRequest(request, commandId), options);
+        if (!prepared.preparedTransaction || prepared.preparedTransactionHash.length === 0) {
             throw new ValidationError("interactive prepare submission returned an incomplete result");
+        }
         return new PreparedCommandSubmission(request, prepared.preparedTransaction, prepared.preparedTransactionHash, prepared.hashingSchemeVersion);
     }
     async executePreparedCommandAndWaitAsync(prepared, signatures, options) {
-        if (!this.operations.executeSubmissionAndWaitAsync)
+        if (!this.operations.executeSubmissionAndWaitAsync) {
             throw new NotSupportedError("interactive gRPC command signing is not available on this transport");
-        const signerResults = prepared.request.actAs.map((party) => { const result = signatures[party]; if (!result)
-            throw new ValidationError(`interactive command signing requires a signature for ${party}`); return { party, result }; });
+        }
+        const signerResults = prepared.request.actAs.map((party) => {
+            const result = signatures[party];
+            if (!result) {
+                throw new ValidationError(`interactive command signing requires a signature for ${party}`);
+            }
+            return { party, result };
+        });
         const result = await this.operations.executeSubmissionAndWaitAsync(mapGrpcExecuteSubmissionAndWaitRequest({ request: prepared.request, preparedTransaction: prepared.transaction, hashingSchemeVersion: prepared.hashingSchemeVersion, submissionId: randomUUID(), signerResults }), options);
         return mapGrpcInteractiveSubmitCommand(result);
     }

package/dist/transports/grpc/mappers/command-deduplication-mapper.d.ts

@@ -0,0 +1,5 @@
+import { CommandDeduplicationPeriod } from "../../../core/types/command-deduplication-period.js";
+import { Commands } from "../generated/canton/com/daml/ledger/api/v2/commands.js";
+export declare function mapGrpcDeduplicationPeriod(period: CommandDeduplicationPeriod | undefined, options: {
+    readonly allowParticipantBegin: boolean;
+}): Commands["deduplicationPeriod"];

package/dist/transports/grpc/mappers/command-deduplication-mapper.js

@@ -0,0 +1,19 @@
+import { ValidationError } from "../../../core/errors/validation-error.js";
+export function mapGrpcDeduplicationPeriod(period, options) {
+    if (period === undefined) {
+        return { oneofKind: undefined };
+    }
+    else if (period.kind === "duration") {
+        return {
+            oneofKind: "deduplicationDuration",
+            deduplicationDuration: { seconds: String(period.seconds), nanos: 0 },
+        };
+    }
+    else if (!options.allowParticipantBegin && period.offset === "0") {
+        throw new ValidationError("interactive command deduplication offsets must be positive");
+    }
+    return {
+        oneofKind: "deduplicationOffset",
+        deduplicationOffset: period.offset,
+    };
+}

package/dist/transports/grpc/mappers/commands-mapper.js

@@ -10,16 +10,15 @@ import { ExerciseByKeyCommand } from "../../../core/types/commands/exercise-by-k
 import { ExerciseCommand } from "../../../core/types/commands/exercise-command.js";
 import { SubmitCommandResponse } from "../../../core/types/responses/submit-command-response.js";
 import { SubmitCommandTransactionResponse } from "../../../core/types/responses/submit-command-transaction-response.js";
+import { mapGrpcDeduplicationPeriod } from "./command-deduplication-mapper.js";
 export function mapGrpcSubmitCommandRequest(request) {
     return {
         commands: {
             workflowId: "",
             userId: request.userId ?? "",
-            commandId: randomUUID(),
+            commandId: request.commandId ?? randomUUID(),
             commands: [mapGrpcLedgerCommand(request.command)],
-            deduplicationPeriod: {
-                oneofKind: undefined,
-            },
+            deduplicationPeriod: mapGrpcDeduplicationPeriod(request.deduplicationPeriod, { allowParticipantBegin: true }),
             actAs: [...request.actAs],
             readAs: [...request.readAs],
             submissionId: "",

package/dist/transports/grpc/mappers/interactive-command-mapper.js

@@ -1,8 +1,12 @@
 import { ValidationError } from "../../../core/errors/validation-error.js";
 import { SubmitCommandResponse } from "../../../core/types/responses/submit-command-response.js";
 import { SignatureFormat, SigningAlgorithmSpec, } from "../generated/canton/com/daml/ledger/api/v2/crypto.js";
+import { mapGrpcDeduplicationPeriod } from "./command-deduplication-mapper.js";
 import { mapGrpcLedgerCommand } from "./commands-mapper.js";
 export function mapGrpcPrepareSubmissionRequest(request, commandId) {
+    mapGrpcDeduplicationPeriod(request.deduplicationPeriod, {
+        allowParticipantBegin: false,
+    });
     return {
         userId: request.userId ?? "",
         commandId,
@@ -22,9 +26,7 @@ export function mapGrpcExecuteSubmissionAndWaitRequest(init) {
         partySignatures: {
             signatures: init.signerResults.map(({ party, result }) => ({ party, signatures: [mapGrpcSignature(result)] })),
         },
-        deduplicationPeriod: {
-            oneofKind: undefined,
-        },
+        deduplicationPeriod: mapGrpcDeduplicationPeriod(init.request.deduplicationPeriod, { allowParticipantBegin: false }),
         submissionId: init.submissionId,
         userId: init.request.userId ?? "",
         hashingSchemeVersion: init.hashingSchemeVersion,

package/dist/transports/grpc/mappers/parties-mapper.d.ts

@@ -1,13 +1,11 @@
-import { GetParticipantIdRequest } from "../../../core/types/requests/get-participant-id-request.js";
 import { GetPartiesRequest } from "../../../core/types/requests/get-parties-request.js";
-import { CreatePartyRequest } from "../../../core/types/requests/create-party-request.js";
+import { AllocatePartyRequest as SdkAllocatePartyRequest } from "../../../core/types/requests/allocate-party-request.js";
 import { ListPartiesRequest } from "../../../core/types/requests/list-parties-request.js";
 import { CreatePartyResponse } from "../../../core/types/responses/create-party-response.js";
-import { GetParticipantIdResponse as SdkGetParticipantIdResponse } from "../../../core/types/responses/get-participant-id-response.js";
 import { GetPartiesResponse as SdkGetPartiesResponse } from "../../../core/types/responses/get-parties-response.js";
 import { ListPartiesResponse } from "../../../core/types/responses/list-parties-response.js";
-import { AllocatePartyRequest, AllocatePartyResponse, GetParticipantIdResponse, GetPartiesResponse, ListKnownPartiesRequest, ListKnownPartiesResponse } from "../generated/canton/com/daml/ledger/api/v2/admin/party_management_service.js";
-export declare function mapGrpcCreatePartyRequest(request: CreatePartyRequest): AllocatePartyRequest;
+import { AllocatePartyRequest, AllocatePartyResponse, GetPartiesResponse, ListKnownPartiesRequest, ListKnownPartiesResponse } from "../generated/canton/com/daml/ledger/api/v2/admin/party_management_service.js";
+export declare function mapGrpcCreatePartyRequest(request: SdkAllocatePartyRequest): AllocatePartyRequest;
 export declare function mapGrpcCreateParty(payload: {
     identifier?: string;
     partyDetails?: {
@@ -16,8 +14,6 @@ export declare function mapGrpcCreateParty(payload: {
 } | AllocatePartyResponse): CreatePartyResponse;
 export declare function mapGrpcListPartiesRequest(request: ListPartiesRequest): ListKnownPartiesRequest;
 export declare function mapGrpcListParties(payload: ListKnownPartiesResponse): ListPartiesResponse;
-export declare function mapGrpcGetParticipantIdRequest(_request: GetParticipantIdRequest): Record<string, never>;
-export declare function mapGrpcGetParticipantId(payload: Partial<GetParticipantIdResponse>): SdkGetParticipantIdResponse;
 export declare function mapGrpcGetPartiesRequest(request: GetPartiesRequest): {
     parties: string[];
     identityProviderId: string;

package/dist/transports/grpc/mappers/parties-mapper.js

@@ -1,6 +1,5 @@
 import { PartyDetails as SdkPartyDetails } from "../../../core/types/party-details.js";
 import { CreatePartyResponse } from "../../../core/types/responses/create-party-response.js";
-import { GetParticipantIdResponse as SdkGetParticipantIdResponse } from "../../../core/types/responses/get-participant-id-response.js";
 import { GetPartiesResponse as SdkGetPartiesResponse } from "../../../core/types/responses/get-parties-response.js";
 import { ListPartiesResponse } from "../../../core/types/responses/list-parties-response.js";
 export function mapGrpcCreatePartyRequest(request) {
@@ -8,7 +7,7 @@ export function mapGrpcCreatePartyRequest(request) {
         partyIdHint: request.partyIdHint ?? "",
         identityProviderId: "",
         synchronizerId: "",
-        userId: "",
+        userId: request.userId ?? "",
     };
 }
 export function mapGrpcCreateParty(payload) {
@@ -37,14 +36,6 @@ export function mapGrpcListParties(payload) {
         nextPageToken: payload.nextPageToken || undefined,
     });
 }
-export function mapGrpcGetParticipantIdRequest(_request) {
-    return {};
-}
-export function mapGrpcGetParticipantId(payload) {
-    return new SdkGetParticipantIdResponse({
-        participantId: payload.participantId ?? "",
-    });
-}
 export function mapGrpcGetPartiesRequest(request) {
     return {
         parties: [...request.parties],

package/dist/transports/json/json-transport.d.ts

@@ -1,18 +1,24 @@
 import { AllocatePartyRequest } from "../../core/types/requests/allocate-party-request.js";
 import { GetActiveContractsRequest } from "../../core/types/requests/get-active-contracts-request.js";
-import { GetParticipantIdRequest } from "../../core/types/requests/get-participant-id-request.js";
+import { GetUserRequest } from "../../core/types/requests/get-user-request.js";
 import { ListKnownPartiesRequest } from "../../core/types/requests/list-known-parties-request.js";
+import { ListPartyToParticipantRequest } from "../../core/types/requests/list-party-to-participant-request.js";
+import { ListUserRightsRequest } from "../../core/types/requests/list-user-rights-request.js";
+import { ListUsersRequest } from "../../core/types/requests/list-users-request.js";
 import { SubmitCommandRequest } from "../../core/types/requests/submit-command-request.js";
 import { AllocatePartyResponse } from "../../core/types/responses/allocate-party-response.js";
+import { GetUserResponse } from "../../core/types/responses/get-user-response.js";
+import { ListPartyToParticipantResponse } from "../../core/types/responses/list-party-to-participant-response.js";
+import { ListUserRightsResponse } from "../../core/types/responses/list-user-rights-response.js";
+import { ListUsersResponse } from "../../core/types/responses/list-users-response.js";
 import type { ListPartiesRequest as TopologyListPartiesRequest, ListPartiesResponse as TopologyListPartiesResponse, ListKeyOwnersRequest, ListKeyOwnersResponse } from "../grpc/generated/canton/com/digitalasset/canton/topology/admin/v30/topology_aggregation_service.js";
 import type { AddTransactionsRequest, AddTransactionsResponse, AuthorizeRequest, AuthorizeResponse, CreateTemporaryTopologyStoreRequest, CreateTemporaryTopologyStoreResponse, DropTemporaryTopologyStoreRequest, DropTemporaryTopologyStoreResponse, GenerateTransactionsRequest, GenerateTransactionsResponse, ImportTopologySnapshotRequest, ImportTopologySnapshotResponse, ImportTopologySnapshotV2Request, ImportTopologySnapshotV2Response, SignTransactionsRequest, SignTransactionsResponse } from "../grpc/generated/canton/com/digitalasset/canton/topology/admin/v30/topology_manager_write_service.js";
 import type { GetContractRequest, GetContractResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/contract_service.js";
 import type { AddPartyAsyncRequest, AddPartyAsyncResponse, ClearPartyOnboardingFlagRequest, ClearPartyOnboardingFlagResponse, GetHighestOffsetByTimestampRequest, GetHighestOffsetByTimestampResponse } from "../grpc/generated/canton/com/digitalasset/canton/admin/participant/v30/party_management_service.js";
 import type { GetEventsByContractIdRequest, GetEventsByContractIdResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/event_query_service.js";
 import type { CurrentTimeRequest, CurrentTimeResponse, GetIdRequest, GetIdResponse } from "../grpc/generated/canton/com/digitalasset/canton/topology/admin/v30/initialization_service.js";
-import type { ListAllRequest, ListAllResponse, ListLsuAnnouncementRequest, ListLsuAnnouncementResponse, ListLsuSequencerConnectionSuccessorRequest, ListLsuSequencerConnectionSuccessorResponse, ListMediatorSynchronizerStateRequest, ListMediatorSynchronizerStateResponse, ListSequencingParametersStateRequest, ListSequencingParametersStateResponse, ListSynchronizerParametersStateRequest, ListSynchronizerParametersStateResponse, ListPartyToParticipantRequest, ListPartyToParticipantResponse, ListVettedPackagesRequest as TopologyListVettedPackagesRequest, ListVettedPackagesResponse as TopologyListVettedPackagesResponse, ListPartyHostingLimitsRequest, ListPartyHostingLimitsResponse, ListParticipantSynchronizerPermissionRequest, ListParticipantSynchronizerPermissionResponse, ListSynchronizerTrustCertificateRequest, ListSynchronizerTrustCertificateResponse, ListPartyToKeyMappingRequest, ListPartyToKeyMappingResponse, ListOwnerToKeyMappingRequest, ListOwnerToKeyMappingResponse, ListDecentralizedNamespaceDefinitionRequest, ListDecentralizedNamespaceDefinitionResponse, ListNamespaceDelegationRequest, ListNamespaceDelegationResponse, ListSequencerSynchronizerStateRequest, ListSequencerSynchronizerStateResponse } from "../grpc/generated/canton/com/digitalasset/canton/topology/admin/v30/topology_manager_read_service.js";
-import { GetParticipantIdResponse } from "../../core/types/responses/get-participant-id-response.js";
-import type { GetPartiesRequest, GetPartiesResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/party_management_service.js";
+import type { ListAllRequest, ListAllResponse, ListLsuAnnouncementRequest, ListLsuAnnouncementResponse, ListLsuSequencerConnectionSuccessorRequest, ListLsuSequencerConnectionSuccessorResponse, ListMediatorSynchronizerStateRequest, ListMediatorSynchronizerStateResponse, ListSequencingParametersStateRequest, ListSequencingParametersStateResponse, ListSynchronizerParametersStateRequest, ListSynchronizerParametersStateResponse, ListVettedPackagesRequest as TopologyListVettedPackagesRequest, ListVettedPackagesResponse as TopologyListVettedPackagesResponse, ListPartyHostingLimitsRequest, ListPartyHostingLimitsResponse, ListParticipantSynchronizerPermissionRequest, ListParticipantSynchronizerPermissionResponse, ListSynchronizerTrustCertificateRequest, ListSynchronizerTrustCertificateResponse, ListPartyToKeyMappingRequest, ListPartyToKeyMappingResponse, ListOwnerToKeyMappingRequest, ListOwnerToKeyMappingResponse, ListDecentralizedNamespaceDefinitionRequest, ListDecentralizedNamespaceDefinitionResponse, ListNamespaceDelegationRequest, ListNamespaceDelegationResponse, ListSequencerSynchronizerStateRequest, ListSequencerSynchronizerStateResponse } from "../grpc/generated/canton/com/digitalasset/canton/topology/admin/v30/topology_manager_read_service.js";
+import type { GetParticipantIdRequest, GetParticipantIdResponse, GetPartiesRequest, GetPartiesResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/party_management_service.js";
 import type { GetResourceLimitsRequest, GetResourceLimitsResponse } from "../grpc/generated/canton/com/digitalasset/canton/admin/participant/v30/resource_management_service.js";
 import type { GetNoWaitCommitmentsFromRequest, GetNoWaitCommitmentsFromResponse, GetParticipantScheduleRequest as GetParticipantPruningScheduleRequest, GetParticipantScheduleResponse as GetParticipantPruningScheduleResponse, GetScheduleRequest as GetPruningScheduleRequest, GetScheduleResponse as GetPruningScheduleResponse } from "../grpc/generated/canton/com/digitalasset/canton/admin/pruning/v30/pruning.js";
 import type { AllocateExternalPartyRequest, AllocateExternalPartyResponse, GenerateExternalPartyTopologyRequest, GenerateExternalPartyTopologyResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/party_management_service.js";
@@ -36,7 +42,6 @@ import { ICommandSigner } from "../../core/signing/command-signer.interface.js";
 import { RequestOptions } from "../../core/types/request-options.js";
 import type { ListKnownPackagesRequest, ListKnownPackagesResponse, UploadDarFileRequest } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/package_management_service.js";
 import { UploadDarFileResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/package_management_service.js";
-import type { GetUserRequest, GetUserResponse, ListUserRightsRequest, ListUserRightsResponse, ListUsersRequest, ListUsersResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/user_management_service.js";
 import type { GetCommandStatusRequest, GetCommandStatusResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/admin/command_inspection_service.js";
 import type { GetActiveContractsPageRequest, GetActiveContractsPageResponse, GetConnectedSynchronizersRequest, GetConnectedSynchronizersResponse, GetLedgerEndRequest, GetLedgerEndResponse, GetLatestPrunedOffsetsRequest, GetLatestPrunedOffsetsResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/state_service.js";
 import { GetPackageRequest, GetPackageResponse, GetPackageStatusRequest, GetPackageStatusResponse, ListPackagesRequest, ListPackagesResponse, ListVettedPackagesRequest, ListVettedPackagesResponse } from "../grpc/generated/canton/com/daml/ledger/api/v2/package_service.js";

package/dist/transports/json/mappers/commands-mapper.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { TransportError } from "../../../core/errors/transport-error.js";
 import { ValidationError } from "../../../core/errors/validation-error.js";
 import { CreateAndExerciseCommand } from "../../../core/types/commands/create-and-exercise-command.js";
 import { CreateCommand } from "../../../core/types/commands/create-command.js";
@@ -9,8 +10,11 @@ import { ExerciseByKeyCommand } from "../../../core/types/commands/exercise-by-k
 import { ExerciseCommand } from "../../../core/types/commands/exercise-command.js";
 import { SubmitCommandResponse } from "../../../core/types/responses/submit-command-response.js";
 export function mapJsonSubmitCommandRequest(request) {
+    if (request.deduplicationPeriod !== undefined) {
+        throw new TransportError("command deduplication periods are not supported by the JSON transport");
+    }
     return {
-        commandId: randomUUID(),
+        commandId: request.commandId ?? randomUUID(),
         actAs: request.actAs,
         readAs: request.readAs,
         commands: [mapJsonCommand(request.command)],

package/dist/transports/json/mappers/parties-mapper.d.ts

@@ -13,6 +13,7 @@ export declare function mapJsonCreateParty(payload: {
 }): CreatePartyResponse;
 export declare function mapJsonAllocatePartyRequest(request: AllocatePartyRequest): {
     partyIdHint?: string;
+    userId?: string;
     localMetadata?: {
         attributes: Record<string, string>;
     };

package/dist/transports/json/mappers/parties-mapper.js

@@ -11,6 +11,7 @@ export function mapJsonCreateParty(payload) {
 export function mapJsonAllocatePartyRequest(request) {
     return {
         partyIdHint: request.partyIdHint,
+        userId: request.userId,
         localMetadata: request.displayName === undefined
             ? undefined
             : {

package/node/participant-358-synchronizer.mjs

@@ -6,6 +6,12 @@ import { SynchronizerConnectivityServiceClient } from "../dist/transports/grpc/g
 import { ListRegisteredSynchronizersResponse_Status } from "../dist/transports/grpc/generated/canton/com/digitalasset/canton/admin/participant/v30/synchronizer_connectivity_service.js";
 import { SequencerConnectionValidation } from "../dist/transports/grpc/generated/canton/com/digitalasset/canton/admin/sequencer/v30/sequencer_connection.js";
 import { VersionServiceClient } from "../dist/transports/grpc/generated/canton/com/daml/ledger/api/v2/version_service.client.js";
+import { UserManagementServiceClient } from "../dist/transports/grpc/generated/canton/com/daml/ledger/api/v2/admin/user_management_service.client.js";
+import {
+    GrantUserRightsRequest,
+    Right,
+    Right_CanReadAsAnyParty,
+} from "../dist/transports/grpc/generated/canton/com/daml/ledger/api/v2/admin/user_management_service.js";
 
 function getRequiredEnvironment(name) {
     const value = process.env[name];
@@ -128,6 +134,30 @@ async function readLedgerApiVersion() {
     }
 }
 
+async function ensureLedgerUserReadRights() {
+    const endpoint = getRequiredEnvironment("PARTICIPANT_358_LEDGER_ENDPOINT");
+    const token = process.env.PARTICIPANT_358_LEDGER_BEARER_TOKEN ?? createSharedSecretToken();
+    const userId = process.env.PARTICIPANT_358_LEDGER_USER_ID ?? "ledger-api-user";
+    const { options, transport } = createClient(endpoint, token);
+
+    try {
+        const request = GrantUserRightsRequest.create({
+            userId,
+            rights: [Right.create({
+                kind: {
+                    oneofKind: "canReadAsAnyParty",
+                    canReadAsAnyParty: Right_CanReadAsAnyParty.create(),
+                },
+            })],
+        });
+
+        await new UserManagementServiceClient(transport)
+            .grantUserRights(request, options).response;
+    } finally {
+        transport.close();
+    }
+}
+
 const command = process.argv[2];
 if (command === "export") {
     await exportSynchronizerConfig();
@@ -137,6 +167,8 @@ if (command === "export") {
     await readLedgerApiVersion();
 } else if (command === "mint-ledger-token") {
     await writeLedgerToken();
+} else if (command === "ensure-ledger-user-read-rights") {
+    await ensureLedgerUserReadRights();
 } else {
-    throw new Error("Expected 'export', 'connect', 'ledger-api-version', or 'mint-ledger-token'.");
+    throw new Error("Expected 'export', 'connect', 'ledger-api-version', 'mint-ledger-token', or 'ensure-ledger-user-read-rights'.");
 }

package/node/start-local-participant-358.sh

@@ -12,8 +12,35 @@ LEDGER_PORT="${PARTICIPANT_358_LEDGER_PORT:-8901}"
 ADMIN_PORT="${PARTICIPANT_358_ADMIN_PORT:-8902}"
 JSON_PORT="${PARTICIPANT_358_JSON_PORT:-8975}"
 SOURCE_ADMIN_ENDPOINT="${PARTICIPANT_358_SOURCE_ADMIN_ENDPOINT:-localhost:3902}"
+SYNCHRONIZER_CONFIG="$RUNTIME_DIR/registered-synchronizer.json"
+LEDGER_TOKEN_FILE="$RUNTIME_DIR/ledger-api-user.token"
 DOCKER_COMPOSE_CMD=()
 
+print_bearer_token_exports() {
+  local escaped_token_file
+  printf -v escaped_token_file '%q' "$LEDGER_TOKEN_FILE"
+  printf 'export SDK_TEST_LEDGER_BEARER_TOKEN="$(cat %s)"\n' "$escaped_token_file"
+  printf 'export SDK_TEST_LEDGER_ADMIN_BEARER_TOKEN="$(cat %s)"\n' "$escaped_token_file"
+  printf 'export SDK_TEST_PARTICIPANT_ADMIN_BEARER_TOKEN="$(cat %s)"\n' "$escaped_token_file"
+  printf 'export SDK_EXAMPLE_BEARER_TOKEN="$(cat %s)"\n' "$escaped_token_file"
+}
+
+if (( $# > 0 )); then
+  if [[ "$1" != "--refresh-token" || $# -ne 1 ]]; then
+    echo "Usage: $(basename "$0") [--refresh-token]" >&2
+    exit 1
+  elif [[ ! -d "$RUNTIME_DIR" || ! -f "$LEDGER_TOKEN_FILE" ]]; then
+    echo "Participant 3.5.8 runtime token does not exist at $LEDGER_TOKEN_FILE. Start the sidecar first." >&2
+    exit 1
+  fi
+
+  PARTICIPANT_358_LEDGER_TOKEN_FILE="$LEDGER_TOKEN_FILE" \
+    node "$SCRIPT_DIR/participant-358-synchronizer.mjs" mint-ledger-token
+  chmod 600 "$LEDGER_TOKEN_FILE"
+  print_bearer_token_exports
+  exit 0
+fi
+
 resolve_docker_compose_cmd() {
   if docker compose version >/dev/null 2>&1; then DOCKER_COMPOSE_CMD=(docker compose); return; fi
   if docker-compose version >/dev/null 2>&1; then DOCKER_COMPOSE_CMD=(docker-compose); return; fi
@@ -49,10 +76,9 @@ for port in "$LEDGER_PORT" "$ADMIN_PORT" "$JSON_PORT"; do assert_host_port_avail
 
 mkdir -p "$RUNTIME_DIR"
 chmod 700 "$RUNTIME_DIR"
-SYNCHRONIZER_CONFIG="$RUNTIME_DIR/registered-synchronizer.json"
-LEDGER_TOKEN_FILE="$RUNTIME_DIR/ledger-api-user.token"
 PARTICIPANT_358_LEDGER_TOKEN_FILE="$LEDGER_TOKEN_FILE" \
   node "$SCRIPT_DIR/participant-358-synchronizer.mjs" mint-ledger-token
+chmod 600 "$LEDGER_TOKEN_FILE"
 cat > "$RUNTIME_DIR/participant-358.env" <<EOF
 PARTICIPANT_358_SYNCHRONIZER_CONFIG=$SYNCHRONIZER_CONFIG
 PARTICIPANT_358_SOURCE_ADMIN_ENDPOINT=$SOURCE_ADMIN_ENDPOINT
@@ -170,6 +196,10 @@ if [[ "${PARTICIPANT_358_SKIP_SYNCHRONIZER_CONNECT:-0}" != "1" ]]; then
     fi
     sleep 2
   done
+
+  PARTICIPANT_358_LEDGER_ENDPOINT="localhost:$LEDGER_PORT" \
+  PARTICIPANT_358_LEDGER_BEARER_TOKEN="$(cat "$LEDGER_TOKEN_FILE")" \
+    node "$SCRIPT_DIR/participant-358-synchronizer.mjs" ensure-ledger-user-read-rights
 fi
 
 cat <<EOF
@@ -180,5 +210,5 @@ export SDK_TEST_PARTICIPANT_ADMIN_ENDPOINT=localhost:$ADMIN_PORT
 export SDK_EXAMPLE_LEDGER_ENDPOINT=localhost:$LEDGER_PORT
 export SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT=localhost:$LEDGER_PORT
 export SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT=localhost:$ADMIN_PORT
-export SDK_EXAMPLE_BEARER_TOKEN="\$(cat $LEDGER_TOKEN_FILE)"
 EOF
+print_bearer_token_exports

package/node/test-participant-358-sidecar.sh

@@ -10,6 +10,8 @@ STOP_SCRIPT="$REPO_ROOT/node/stop-local-participant-358.sh"
 grep -Fq 'export SDK_EXAMPLE_LEDGER_ENDPOINT=localhost:$LEDGER_PORT' "$START_SCRIPT"
 grep -Fq 'export SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT=localhost:$LEDGER_PORT' "$START_SCRIPT"
 grep -Fq 'export SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT=localhost:$ADMIN_PORT' "$START_SCRIPT"
+grep -Fq 'ensure-ledger-user-read-rights' "$START_SCRIPT"
+grep -Fq 'canReadAsAnyParty' "$REPO_ROOT/node/participant-358-synchronizer.mjs"
 
 tmpdir="$(mktemp -d)"
 trap 'rm -rf "$tmpdir"' EXIT
@@ -28,9 +30,15 @@ chmod +x "$stubbin/docker"
 
 runtime_dir="$tmpdir/runtime"
 docker_log="$tmpdir/docker.log"
+test_ledger_port=18901
+test_admin_port=18902
+test_json_port=18975
 PATH="$stubbin:$PATH" \
 DOCKER_LOG="$docker_log" \
 PARTICIPANT_358_RUNTIME_DIR="$runtime_dir" \
+PARTICIPANT_358_LEDGER_PORT="$test_ledger_port" \
+PARTICIPANT_358_ADMIN_PORT="$test_admin_port" \
+PARTICIPANT_358_JSON_PORT="$test_json_port" \
 PARTICIPANT_358_SKIP_SYNCHRONIZER_CONNECT=1 \
 "$START_SCRIPT"
 
@@ -48,7 +56,9 @@ grep -Fqx '          databaseName = participant358' "$runtime_dir/canton.conf"
 grep -Fqx '    admin-api {' "$runtime_dir/canton.conf"
 grep -Fqx '      address = "0.0.0.0"' "$runtime_dir/canton.conf"
 grep -Fqx '      port = 5002' "$runtime_dir/canton.conf"
-grep -Fqx '      - "127.0.0.1:8901:5001"' "$runtime_dir/compose.yaml"
+grep -Fqx "      - \"127.0.0.1:$test_ledger_port:5001\"" "$runtime_dir/compose.yaml"
+grep -Fqx "      - \"127.0.0.1:$test_admin_port:5002\"" "$runtime_dir/compose.yaml"
+grep -Fqx "      - \"127.0.0.1:$test_json_port:7575\"" "$runtime_dir/compose.yaml"
 grep -Fqx '      port = 5002' "$runtime_dir/canton.conf"
 grep -Fqx '      port = 7575' "$runtime_dir/canton.conf"
 grep -Fq 'PARTICIPANT_358_SYNCHRONIZER_CONFIG=' "$runtime_dir/participant-358.env"
@@ -66,6 +76,26 @@ if (payload.exp - payload.iat !== 300) throw new Error("token lifetime must be 3
 grep -F -- '--project-name canton-participant-358' "$docker_log"
 grep -Fqx '    name: quickstart' "$runtime_dir/compose.yaml"
 
+docker_calls_before_refresh="$(wc -l < "$docker_log")"
+refresh_output="$(
+  PATH="$stubbin:$PATH" \
+  DOCKER_LOG="$docker_log" \
+  PARTICIPANT_358_RUNTIME_DIR="$runtime_dir" \
+  "$START_SCRIPT" --refresh-token
+)"
+[[ "$(wc -l < "$docker_log")" == "$docker_calls_before_refresh" ]]
+[[ "$(stat -c '%a' "$runtime_dir/ledger-api-user.token")" == 600 ]]
+grep -Fqx "export SDK_TEST_LEDGER_BEARER_TOKEN=\"\$(cat $runtime_dir/ledger-api-user.token)\"" <<<"$refresh_output"
+grep -Fqx "export SDK_TEST_LEDGER_ADMIN_BEARER_TOKEN=\"\$(cat $runtime_dir/ledger-api-user.token)\"" <<<"$refresh_output"
+grep -Fqx "export SDK_TEST_PARTICIPANT_ADMIN_BEARER_TOKEN=\"\$(cat $runtime_dir/ledger-api-user.token)\"" <<<"$refresh_output"
+grep -Fqx "export SDK_EXAMPLE_BEARER_TOKEN=\"\$(cat $runtime_dir/ledger-api-user.token)\"" <<<"$refresh_output"
+[[ "$(wc -l <<<"$refresh_output")" == 4 ]]
+
+if "$START_SCRIPT" --unknown >/dev/null 2>&1; then
+  echo 'sidecar launcher accepted an unknown argument' >&2
+  exit 1
+fi
+
 if PATH="$stubbin:$PATH" PARTICIPANT_358_LEDGER_PORT=3901 "$START_SCRIPT" >/dev/null 2>&1; then
   echo 'sidecar launcher accepted a CN Quickstart Ledger port' >&2
   exit 1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@distrohelena/canton-typescript-sdk",
-    "version": "0.1.33",
+    "version": "0.1.36",
     "license": "Apache-2.0",
     "type": "module",
     "main": "./dist/index.js",
@@ -88,6 +88,20 @@
         "example:party:hosted": "npm run build && node --loader ts-node/esm examples/10-hosted-party.ts",
         "example:party:external": "npm run build && node --loader ts-node/esm examples/20-external-party-ed25519.ts",
         "example:party:decentralized": "npm run build && node --loader ts-node/esm examples/30-decentralized-party-ed25519.ts",
+        "example:dar:upload": "npm run build && node --loader ts-node/esm examples/40-dar-upload.ts",
+        "example:contract:create-exercise": "npm run build && node --loader ts-node/esm examples/50-create-and-exercise.ts",
+        "example:contract:query": "npm run build && node --loader ts-node/esm examples/60-query-active-contracts.ts",
+        "example:updates:stream": "npm run build && node --loader ts-node/esm examples/61-stream-updates.ts",
+        "example:user:rights": "npm run build && node --loader ts-node/esm examples/70-user-rights.ts",
+        "example:topology:party-hosting": "npm run build && node --loader ts-node/esm examples/80-topology-inspection.ts",
+        "example:workflow:atomic": "npm run build && node --loader ts-node/esm examples/90-atomic-create-and-exercise.ts",
+        "example:workflow:retry": "npm run build && node --loader ts-node/esm examples/91-idempotent-command-retry.ts",
+        "example:workflow:resume": "npm run build && node --loader ts-node/esm examples/92-resume-update-stream.ts",
+        "example:workflow:stale-contract": "npm run build && node --loader ts-node/esm examples/93-archive-and-stale-contract.ts",
+        "example:workflow:command-completion": "npm run build && node --loader ts-node/esm examples/94-command-completion-correlation.ts",
+        "example:workflow:contract-lifecycle-audit": "npm run build && node --loader ts-node/esm examples/95-contract-lifecycle-audit.ts",
+        "example:workflow:update-lookup-reconciliation": "npm run build && node --loader ts-node/esm examples/96-update-lookup-reconciliation.ts",
+        "example:workflow:pruning-preflight": "npm run build && node --loader ts-node/esm examples/97-pruning-preflight.ts",
         "lint": "eslint . --max-warnings=0",
         "lint:fix": "eslint . --fix --max-warnings=0",
         "start:local-ledger": "bash node/start-local.sh",

package/dist/cjs/core/types/health-check-status.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HealthCheckStatus = void 0;
-var HealthCheckStatus;
-(function (HealthCheckStatus) {
-    HealthCheckStatus["unknown"] = "unknown";
-    HealthCheckStatus["serving"] = "serving";
-    HealthCheckStatus["notServing"] = "notServing";
-    HealthCheckStatus["serviceUnknown"] = "serviceUnknown";
-})(HealthCheckStatus || (exports.HealthCheckStatus = HealthCheckStatus = {}));

package/dist/cjs/core/types/requests/get-ledger-api-version-request.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetLedgerApiVersionRequest = void 0;
-class GetLedgerApiVersionRequest {
-}
-exports.GetLedgerApiVersionRequest = GetLedgerApiVersionRequest;

package/dist/cjs/core/types/requests/get-package-references-request.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetPackageReferencesRequest = void 0;
-class GetPackageReferencesRequest {
-    packageId;
-    constructor(init) {
-        this.packageId = init.packageId;
-    }
-}
-exports.GetPackageReferencesRequest = GetPackageReferencesRequest;

package/dist/cjs/core/types/requests/get-participant-id-request.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetParticipantIdRequest = void 0;
-class GetParticipantIdRequest {
-    constructor() { }
-}
-exports.GetParticipantIdRequest = GetParticipantIdRequest;

package/dist/cjs/core/types/requests/get-participant-status-request.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetParticipantStatusRequest = void 0;
-class GetParticipantStatusRequest {
-}
-exports.GetParticipantStatusRequest = GetParticipantStatusRequest;

package/dist/cjs/core/types/requests/health-check-request.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HealthCheckRequest = void 0;
-class HealthCheckRequest {
-    service;
-    constructor(init = {}) {
-        this.service = init.service;
-    }
-}
-exports.HealthCheckRequest = HealthCheckRequest;

package/dist/cjs/core/types/responses/get-ledger-api-version-response.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetLedgerApiVersionResponse = void 0;
-class GetLedgerApiVersionResponse {
-    version;
-    features;
-    constructor(init) {
-        this.version = init.version;
-        this.features = init.features;
-    }
-}
-exports.GetLedgerApiVersionResponse = GetLedgerApiVersionResponse;