@distrohelena/canton-typescript-sdk 0.1.33 → 0.1.35

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.35",
     "license": "Apache-2.0",
     "type": "module",
     "main": "./dist/index.js",
@@ -88,6 +88,16 @@
         "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",
         "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;

package/dist/cjs/core/types/responses/get-package-references-response.js

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

package/dist/cjs/core/types/responses/get-participant-id-response.js

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

package/dist/cjs/core/types/responses/get-participant-status-response.js

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

package/dist/cjs/core/types/responses/health-check-response.js

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

package/dist/cjs/transports/grpc/mappers/health-mapper.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapGrpcHealthCheckResponse = mapGrpcHealthCheckResponse;
-const health_check_status_js_1 = require("../../../core/types/health-check-status.js");
-const health_check_response_js_1 = require("../../../core/types/responses/health-check-response.js");
-const health_js_1 = require("../generated/canton/google/grpc/health/v1/health.js");
-function mapGrpcHealthCheckResponse(payload) {
-    return new health_check_response_js_1.HealthCheckResponse({
-        status: mapGrpcHealthStatus(payload.status),
-    });
-}
-function mapGrpcHealthStatus(status) {
-    switch (status) {
-        case health_js_1.HealthCheckResponse_ServingStatus.SERVING:
-            return health_check_status_js_1.HealthCheckStatus.serving;
-        case health_js_1.HealthCheckResponse_ServingStatus.NOT_SERVING:
-            return health_check_status_js_1.HealthCheckStatus.notServing;
-        case health_js_1.HealthCheckResponse_ServingStatus.SERVICE_UNKNOWN:
-            return health_check_status_js_1.HealthCheckStatus.serviceUnknown;
-        case health_js_1.HealthCheckResponse_ServingStatus.UNKNOWN:
-        default:
-            return health_check_status_js_1.HealthCheckStatus.unknown;
-    }
-}

package/dist/cjs/transports/grpc/mappers/participant-status-mapper.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapGrpcGetParticipantStatusRequest = mapGrpcGetParticipantStatusRequest;
-exports.mapGrpcParticipantStatusResponse = mapGrpcParticipantStatusResponse;
-const get_participant_status_response_js_1 = require("../../../core/types/responses/get-participant-status-response.js");
-const connected_synchronizer_health_js_1 = require("../../../core/types/connected-synchronizer-health.js");
-const connected_synchronizer_status_js_1 = require("../../../core/types/connected-synchronizer-status.js");
-const participant_node_status_js_1 = require("../../../core/types/participant-node-status.js");
-const participant_status_service_js_1 = require("../generated/canton/com/digitalasset/canton/admin/participant/v30/participant_status_service.js");
-const admin_status_mapper_js_1 = require("./admin-status-mapper.js");
-function mapGrpcGetParticipantStatusRequest(_request) {
-    return {};
-}
-function mapGrpcParticipantStatusResponse(payload) {
-    switch (payload.kind?.oneofKind) {
-        case "status":
-            return new get_participant_status_response_js_1.GetParticipantStatusResponse({
-                status: mapGrpcParticipantNodeStatus(payload.kind.status),
-            });
-        case "notInitialized":
-            return new get_participant_status_response_js_1.GetParticipantStatusResponse({
-                notInitialized: (0, admin_status_mapper_js_1.mapGrpcAdminNotInitializedStatus)(payload.kind.notInitialized),
-            });
-        default:
-            return new get_participant_status_response_js_1.GetParticipantStatusResponse({});
-    }
-}
-function mapGrpcParticipantNodeStatus(payload) {
-    const commonStatus = (0, admin_status_mapper_js_1.mapGrpcAdminNodeStatus)(payload.commonStatus);
-    return new participant_node_status_js_1.ParticipantNodeStatus({
-        uid: commonStatus.uid,
-        uptime: commonStatus.uptime,
-        ports: { ...commonStatus.ports },
-        active: payload.active ?? commonStatus.active,
-        topologyQueues: commonStatus.topologyQueues,
-        components: [...commonStatus.components],
-        version: commonStatus.version,
-        connectedSynchronizers: (payload.connectedSynchronizers ?? []).map((item) => mapGrpcConnectedSynchronizerStatus(item)),
-        supportedProtocolVersions: [...(payload.supportedProtocolVersions ?? [])],
-    });
-}
-function mapGrpcConnectedSynchronizerStatus(payload) {
-    return new connected_synchronizer_status_js_1.ConnectedSynchronizerStatus({
-        physicalSynchronizerId: payload.physicalSynchronizerId ?? "",
-        health: mapGrpcConnectedSynchronizerHealth(payload.health),
-    });
-}
-function mapGrpcConnectedSynchronizerHealth(value) {
-    switch (value) {
-        case participant_status_service_js_1.ConnectedSynchronizer_Health.HEALTHY:
-            return connected_synchronizer_health_js_1.ConnectedSynchronizerHealth.healthy;
-        case participant_status_service_js_1.ConnectedSynchronizer_Health.UNHEALTHY:
-            return connected_synchronizer_health_js_1.ConnectedSynchronizerHealth.unhealthy;
-        case participant_status_service_js_1.ConnectedSynchronizer_Health.UNSPECIFIED:
-        default:
-            return connected_synchronizer_health_js_1.ConnectedSynchronizerHealth.unspecified;
-    }
-}

package/dist/core/types/health-check-status.d.ts

@@ -1,6 +0,0 @@
-export declare enum HealthCheckStatus {
-    unknown = "unknown",
-    serving = "serving",
-    notServing = "notServing",
-    serviceUnknown = "serviceUnknown"
-}

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

@@ -1,7 +0,0 @@
-export var HealthCheckStatus;
-(function (HealthCheckStatus) {
-    HealthCheckStatus["unknown"] = "unknown";
-    HealthCheckStatus["serving"] = "serving";
-    HealthCheckStatus["notServing"] = "notServing";
-    HealthCheckStatus["serviceUnknown"] = "serviceUnknown";
-})(HealthCheckStatus || (HealthCheckStatus = {}));

package/dist/core/types/requests/get-ledger-api-version-request.d.ts

@@ -1,2 +0,0 @@
-export declare class GetLedgerApiVersionRequest {
-}

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

@@ -1,2 +0,0 @@
-export class GetLedgerApiVersionRequest {
-}

package/dist/core/types/requests/get-package-references-request.d.ts

@@ -1,6 +0,0 @@
-export declare class GetPackageReferencesRequest {
-    readonly packageId: string;
-    constructor(init: {
-        packageId: string;
-    });
-}

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

@@ -1,6 +0,0 @@
-export class GetPackageReferencesRequest {
-    packageId;
-    constructor(init) {
-        this.packageId = init.packageId;
-    }
-}

package/dist/core/types/requests/get-participant-id-request.d.ts

@@ -1,3 +0,0 @@
-export declare class GetParticipantIdRequest {
-    constructor();
-}