@distrohelena/canton-typescript-sdk 0.1.37 → 0.1.39

package/README.md

@@ -369,6 +369,45 @@ localnet and is never part of the normal test suite:
 PARTICIPANT_358_SMOKE_TEST=1 npm run test:participant-358-sidecar-smoke
 ```
 
+### Optional Splice image overrides
+
+`canton-localnet-start` normally launches the Canton and Splice images pinned
+by the CN Quickstart checkout's own `.env` (`SPLICE_VERSION`). To exercise the
+SDK against a different Splice release instead, without editing that
+checkout, use one of:
+
+```bash
+canton-localnet-splice-0.7.0-start
+canton-localnet-splice-0.7.0-stop
+
+canton-localnet-splice-0.6.14-start
+canton-localnet-splice-0.6.14-stop
+
+canton-localnet-splice-0.6.13-start
+canton-localnet-splice-0.6.13-stop
+
+canton-localnet-splice-0.6.12-start
+canton-localnet-splice-0.6.12-stop
+```
+
+These are thin wrappers around the normal launchers that default `IMAGE_TAG`
+to `0.7.0`, `0.6.14`, `0.6.13`, or `0.6.12` respectively before delegating to
+them; every other launcher option (extra participants, ES256, TLS,
+`AUTH_MODE`) still applies. Set `IMAGE_TAG` yourself beforehand to target a
+different version through the same wrappers.
+
+`npm run test:live` (with `EXTRA_PARTICIPANTS=4`) has been run against each of
+`0.7.0`, `0.6.14`, `0.6.13`, and `0.6.12` and passes on all four. Two
+intermittent failures were observed and are environment-timing issues
+unrelated to the Splice version under test: a PQS/scribe first-boot ingestion
+race (`live-query-parity`, self-resolves on retry) and a dedicated
+participant needing the domain's ACS reconciliation interval to elapse before
+a safe pruning point exists (`live-query-pruning`). Separately, Splice 0.7.0
+ships a Canton participant reporting Ledger API version `3.5.11`, which the
+workflow examples' compatibility guard (`examples/shared/workflow-compatibility.ts`)
+does not yet accept (it allows only `3.5.7`/`3.5.8`); those examples fail
+against the `0.7.0` launcher until that guard is updated.
+
 ### Optional ES256 bearer tokens
 
 Set `LOCALNET_ES256_JWT=1` when starting the localnet to add ES256 JWT

package/dist/cjs/query/canonical/query-normalizer.js

@@ -28,6 +28,8 @@ function normalizeFindMany(relation, args = {}) {
         const source = object(args, "findMany args");
         assertKnown(source, ["parties", "where", "select", "include", "orderBy", "skip", "take"], relation);
         const page = normalizePage(source);
+        // A top-level take of 0 means "no limit", matching skip: 0's existing "no offset" meaning.
+        const take = page.take === 0 ? undefined : page.take;
         const predicate = source.where === undefined ? undefined : normalizePredicate(relation, source.where);
         return {
             kind: "findMany",
@@ -36,9 +38,9 @@ function normalizeFindMany(relation, args = {}) {
             predicate,
             select: source.select === undefined ? undefined : normalizeSelection(relation, source.select),
             includes: source.include === undefined ? [] : normalizeIncludes(relation, source.include),
-            orderBy: normalizeOrderBy(relation, source.orderBy, relation === "contracts" || source.orderBy !== undefined || page.skip > 0 || page.take !== undefined),
+            orderBy: normalizeOrderBy(relation, source.orderBy, relation === "contracts" || source.orderBy !== undefined || page.skip > 0 || take !== undefined),
             skip: page.skip,
-            take: page.take,
+            take,
             activeOnly: relation === "contracts" && provesActive(predicate),
         };
     });

package/dist/cjs/query/grpc/grpc-query-client.js

@@ -80,6 +80,10 @@ class DefaultGrpcQueryDataProvider {
             return cachedContractsDataset(cached.contracts, cached.activeAtOffset, this.options.endpointScope ?? "ledger");
         }
         else if (needsHistory) {
+            console.warn(`[GrpcQueryClient] Falling back to a full ledger replay from offset 0 for a "${query.relation}" query. `
+                + "This is expensive and should be an extreme edge case. It is usually triggered by a \"contracts\" query "
+                + "that does not explicitly prove `active: true` (so archived contracts may be in scope), or by querying "
+                + "\"transactions\"/\"events\"/\"exercises\" directly. Add an explicit active:true filter if only current state is needed.");
             const endInclusive = cached?.activeAtOffset ?? (await this.options.stateService.getLedgerEndAsync({})).offset;
             const history = await this.snapshots.readHistoryAsync(endInclusive);
             const transactions = history.updates.flatMap((response) => response.update.oneofKind === "transaction" ? [response.update.transaction] : []);
@@ -95,7 +99,13 @@ class DefaultGrpcQueryDataProvider {
         }
         const endInclusive = cached?.activeAtOffset ?? (await this.options.stateService.getLedgerEndAsync({})).offset;
         if (query.relation === "packages" || query.relation === "contractTypes" || query.relation === "exerciseTypes") {
-            return (0, grpc_relation_mapper_js_1.createGrpcQueryDataset)((0, grpc_relation_mapper_js_1.mapGrpcQueryRelationFragment)([]), await this.packages.readAllAsync(), endInclusive, this.options.endpointScope ?? "ledger");
+            // A proven-active where/include on "contracts" (see predicateRequiresHistory/includesRequireHistory)
+            // can put "contracts" in the closure here without needsHistory being true, so the ACS still has to
+            // be read — otherwise that where/include would silently resolve against an empty row set.
+            const contractsFragment = closure.has("contracts")
+                ? (0, grpc_relation_mapper_js_1.mapGrpcQueryRelationFragment)([], (await this.snapshots.readActiveContractsAsync(endInclusive, partiesFor(query))).activeContracts)
+                : (0, grpc_relation_mapper_js_1.mapGrpcQueryRelationFragment)([]);
+            return (0, grpc_relation_mapper_js_1.createGrpcQueryDataset)(contractsFragment, await this.packages.readAllAsync(), endInclusive, this.options.endpointScope ?? "ledger");
         }
         else if (query.relation === "watermark") {
             return (0, grpc_relation_mapper_js_1.createGrpcQueryDataset)((0, grpc_relation_mapper_js_1.mapGrpcQueryRelationFragment)([]), [], endInclusive, this.options.endpointScope ?? "ledger");
@@ -160,10 +170,22 @@ function predicateRequiresHistory(relation, predicate) {
         return false;
     }
     const target = query_schema_js_1.queryRelationEdges[relation]?.[predicate.edge]?.target;
-    return target === "contracts" || target === "transactions" || target === "events" || target === "exercises" || target !== undefined && predicateRequiresHistory(target, predicate.predicate);
+    if (target === "contracts") {
+        // "every"/"none" must see archived rows too (an archived row can silently violate "every",
+        // or an unseen one could exist for "none"); only "some"/"one" ask "does an active row match?",
+        // which the active contract set alone already answers completely.
+        const provenActiveOnly = (predicate.quantifier === "some" || predicate.quantifier === "one") && predicateProvesActive(predicate.predicate);
+        return !provenActiveOnly;
+    }
+    return target === "transactions" || target === "events" || target === "exercises" || target !== undefined && predicateRequiresHistory(target, predicate.predicate);
 }
 function includesRequireHistory(relation, includes) {
-    return includes.some((include) => include.relation === "contracts" || include.relation === "transactions" || include.relation === "events" || include.relation === "exercises" || predicateRequiresHistory(include.relation, include.predicate) || includesRequireHistory(include.relation, include.includes));
+    return includes.some((include) => {
+        if (include.relation === "contracts") {
+            return !predicateProvesActive(include.predicate);
+        }
+        return include.relation === "transactions" || include.relation === "events" || include.relation === "exercises" || predicateRequiresHistory(include.relation, include.predicate) || includesRequireHistory(include.relation, include.includes);
+    });
 }
 function relationClosure(query) {
     const relations = new Set([query.relation]);

package/dist/query/canonical/query-normalizer.js

@@ -19,6 +19,8 @@ export function normalizeFindMany(relation, args = {}) {
         const source = object(args, "findMany args");
         assertKnown(source, ["parties", "where", "select", "include", "orderBy", "skip", "take"], relation);
         const page = normalizePage(source);
+        // A top-level take of 0 means "no limit", matching skip: 0's existing "no offset" meaning.
+        const take = page.take === 0 ? undefined : page.take;
         const predicate = source.where === undefined ? undefined : normalizePredicate(relation, source.where);
         return {
             kind: "findMany",
@@ -27,9 +29,9 @@ export function normalizeFindMany(relation, args = {}) {
             predicate,
             select: source.select === undefined ? undefined : normalizeSelection(relation, source.select),
             includes: source.include === undefined ? [] : normalizeIncludes(relation, source.include),
-            orderBy: normalizeOrderBy(relation, source.orderBy, relation === "contracts" || source.orderBy !== undefined || page.skip > 0 || page.take !== undefined),
+            orderBy: normalizeOrderBy(relation, source.orderBy, relation === "contracts" || source.orderBy !== undefined || page.skip > 0 || take !== undefined),
             skip: page.skip,
-            take: page.take,
+            take,
             activeOnly: relation === "contracts" && provesActive(predicate),
         };
     });

package/dist/query/grpc/grpc-query-client.js

@@ -76,6 +76,10 @@ class DefaultGrpcQueryDataProvider {
             return cachedContractsDataset(cached.contracts, cached.activeAtOffset, this.options.endpointScope ?? "ledger");
         }
         else if (needsHistory) {
+            console.warn(`[GrpcQueryClient] Falling back to a full ledger replay from offset 0 for a "${query.relation}" query. `
+                + "This is expensive and should be an extreme edge case. It is usually triggered by a \"contracts\" query "
+                + "that does not explicitly prove `active: true` (so archived contracts may be in scope), or by querying "
+                + "\"transactions\"/\"events\"/\"exercises\" directly. Add an explicit active:true filter if only current state is needed.");
             const endInclusive = cached?.activeAtOffset ?? (await this.options.stateService.getLedgerEndAsync({})).offset;
             const history = await this.snapshots.readHistoryAsync(endInclusive);
             const transactions = history.updates.flatMap((response) => response.update.oneofKind === "transaction" ? [response.update.transaction] : []);
@@ -91,7 +95,13 @@ class DefaultGrpcQueryDataProvider {
         }
         const endInclusive = cached?.activeAtOffset ?? (await this.options.stateService.getLedgerEndAsync({})).offset;
         if (query.relation === "packages" || query.relation === "contractTypes" || query.relation === "exerciseTypes") {
-            return createGrpcQueryDataset(mapGrpcQueryRelationFragment([]), await this.packages.readAllAsync(), endInclusive, this.options.endpointScope ?? "ledger");
+            // A proven-active where/include on "contracts" (see predicateRequiresHistory/includesRequireHistory)
+            // can put "contracts" in the closure here without needsHistory being true, so the ACS still has to
+            // be read — otherwise that where/include would silently resolve against an empty row set.
+            const contractsFragment = closure.has("contracts")
+                ? mapGrpcQueryRelationFragment([], (await this.snapshots.readActiveContractsAsync(endInclusive, partiesFor(query))).activeContracts)
+                : mapGrpcQueryRelationFragment([]);
+            return createGrpcQueryDataset(contractsFragment, await this.packages.readAllAsync(), endInclusive, this.options.endpointScope ?? "ledger");
         }
         else if (query.relation === "watermark") {
             return createGrpcQueryDataset(mapGrpcQueryRelationFragment([]), [], endInclusive, this.options.endpointScope ?? "ledger");
@@ -156,10 +166,22 @@ function predicateRequiresHistory(relation, predicate) {
         return false;
     }
     const target = queryRelationEdges[relation]?.[predicate.edge]?.target;
-    return target === "contracts" || target === "transactions" || target === "events" || target === "exercises" || target !== undefined && predicateRequiresHistory(target, predicate.predicate);
+    if (target === "contracts") {
+        // "every"/"none" must see archived rows too (an archived row can silently violate "every",
+        // or an unseen one could exist for "none"); only "some"/"one" ask "does an active row match?",
+        // which the active contract set alone already answers completely.
+        const provenActiveOnly = (predicate.quantifier === "some" || predicate.quantifier === "one") && predicateProvesActive(predicate.predicate);
+        return !provenActiveOnly;
+    }
+    return target === "transactions" || target === "events" || target === "exercises" || target !== undefined && predicateRequiresHistory(target, predicate.predicate);
 }
 function includesRequireHistory(relation, includes) {
-    return includes.some((include) => include.relation === "contracts" || include.relation === "transactions" || include.relation === "events" || include.relation === "exercises" || predicateRequiresHistory(include.relation, include.predicate) || includesRequireHistory(include.relation, include.includes));
+    return includes.some((include) => {
+        if (include.relation === "contracts") {
+            return !predicateProvesActive(include.predicate);
+        }
+        return include.relation === "transactions" || include.relation === "events" || include.relation === "exercises" || predicateRequiresHistory(include.relation, include.predicate) || includesRequireHistory(include.relation, include.includes);
+    });
 }
 function relationClosure(query) {
     const relations = new Set([query.relation]);

package/dist/query/model-types.d.ts

@@ -91,6 +91,7 @@ export type ToOneRelationArgs<TWhere, TSelect, TOrderBy, TInclude> = true | {
     readonly include?: TInclude;
 };
 export interface ToManyRelationArgs<TWhere, TSelect, TOrderBy, TInclude> extends QueryPageArgs {
+    /** Required to bound to-many includes; unlike top-level `findMany`, `take: 0` here still means zero rows. */
     readonly take: number;
     readonly where?: TWhere;
     readonly select?: TSelect;
@@ -228,6 +229,7 @@ export type ContractOrderBy = readonly [
     ...readonly OneFieldOrderBy<Pick<ContractRow, ContractOrderField>>[]
 ];
 export type ContractSelect = RowSelect<ContractRow>;
+/** `take: 0` returns all matching rows (no limit), matching `skip: 0`'s "no offset" meaning. */
 export interface ContractFindManyArgs extends QueryPageArgs {
     readonly parties?: readonly string[];
     readonly where?: ContractWhere;

package/dist/query/query-client.d.ts

@@ -1,5 +1,6 @@
 import { QuerySource } from "./query-source.js";
 import { ContractTypeOrderBy, ContractTypeResult, ContractTypeSelect, ContractTypeUnique, ContractTypeWhere, ContractTypeGroupByArgs, ContractTypeGroupRow, ContractCountArgs, ContractFindManyArgs, ContractFindUniqueArgs, ContractGroupByArgs, ContractGroupRow, ContractResult, EventOrderBy, EventResult, EventGroupByArgs, EventGroupRow, EventSelect, EventUnique, EventWhere, ExerciseOrderBy, ExerciseResult, ExerciseSelect, ExerciseTypeOrderBy, ExerciseTypeResult, ExerciseTypeSelect, ExerciseTypeUnique, ExerciseTypeWhere, ExerciseTypeGroupByArgs, ExerciseTypeGroupRow, ExerciseWhere, ExerciseGroupByArgs, ExerciseGroupRow, PackageOrderBy, PackageResult, PackageSelect, PackageUnique, PackageWhere, PackageGroupByArgs, PackageGroupRow, TransactionOrderBy, TransactionResult, TransactionSelect, TransactionUnique, TransactionWhere, TransactionGroupByArgs, TransactionGroupRow, WatermarkOrderBy, WatermarkRow, WatermarkSelect, WatermarkUnique, WatermarkWhere, WatermarkGroupByArgs, WatermarkGroupRow, ContractTypeInclude, EventInclude, ExerciseInclude, ExerciseTypeInclude, PackageInclude, TransactionInclude, JsonProjectionResult } from "./model-types.js";
+/** `take: 0` returns all matching rows (no limit), matching `skip: 0`'s "no offset" meaning. */
 export interface FindManyArgs<TWhere, TSelect, TOrderBy, TInclude = never> {
     readonly where?: TWhere;
     readonly select?: TSelect;

package/node/start-local-splice-0.6.12.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.12}"
+exec "${START_LOCAL_SCRIPT:-$SCRIPT_DIR/start-local.sh}" "$@"

package/node/start-local-splice-0.6.13.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.13}"
+exec "${START_LOCAL_SCRIPT:-$SCRIPT_DIR/start-local.sh}" "$@"

package/node/start-local-splice-0.6.14.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.14}"
+exec "${START_LOCAL_SCRIPT:-$SCRIPT_DIR/start-local.sh}" "$@"

package/node/start-local-splice-0.7.0.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.7.0}"
+exec "${START_LOCAL_SCRIPT:-$SCRIPT_DIR/start-local.sh}" "$@"

package/node/stop-local-splice-0.6.12.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.12}"
+exec "${STOP_LOCAL_SCRIPT:-$SCRIPT_DIR/stop-local.sh}" "$@"

package/node/stop-local-splice-0.6.13.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.13}"
+exec "${STOP_LOCAL_SCRIPT:-$SCRIPT_DIR/stop-local.sh}" "$@"

package/node/stop-local-splice-0.6.14.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.6.14}"
+exec "${STOP_LOCAL_SCRIPT:-$SCRIPT_DIR/stop-local.sh}" "$@"

package/node/stop-local-splice-0.7.0.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+export IMAGE_TAG="${IMAGE_TAG:-0.7.0}"
+exec "${STOP_LOCAL_SCRIPT:-$SCRIPT_DIR/stop-local.sh}" "$@"

package/node/test-start-local-splice-0.6.12.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+START_SCRIPT="$REPO_ROOT/node/start-local-splice-0.6.12.sh"
+
+[[ -x "$START_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-start-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(START_LOCAL_SCRIPT="$stub" "$START_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.12' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag START_LOCAL_SCRIPT="$stub" "$START_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-start-local-splice-0.6.12.sh: all cases passed"

package/node/test-start-local-splice-0.6.13.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+START_SCRIPT="$REPO_ROOT/node/start-local-splice-0.6.13.sh"
+
+[[ -x "$START_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-start-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(START_LOCAL_SCRIPT="$stub" "$START_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.13' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag START_LOCAL_SCRIPT="$stub" "$START_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-start-local-splice-0.6.13.sh: all cases passed"

package/node/test-start-local-splice-0.6.14.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+START_SCRIPT="$REPO_ROOT/node/start-local-splice-0.6.14.sh"
+
+[[ -x "$START_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-start-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(START_LOCAL_SCRIPT="$stub" "$START_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.14' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag START_LOCAL_SCRIPT="$stub" "$START_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-start-local-splice-0.6.14.sh: all cases passed"

package/node/test-start-local-splice-0.7.0.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+START_SCRIPT="$REPO_ROOT/node/start-local-splice-0.7.0.sh"
+
+[[ -x "$START_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-start-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(START_LOCAL_SCRIPT="$stub" "$START_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.7.0' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag START_LOCAL_SCRIPT="$stub" "$START_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-start-local-splice-0.7.0.sh: all cases passed"

package/node/test-stop-local-splice-0.6.12.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+STOP_SCRIPT="$REPO_ROOT/node/stop-local-splice-0.6.12.sh"
+
+[[ -x "$STOP_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-stop-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.12' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-stop-local-splice-0.6.12.sh: all cases passed"

package/node/test-stop-local-splice-0.6.13.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+STOP_SCRIPT="$REPO_ROOT/node/stop-local-splice-0.6.13.sh"
+
+[[ -x "$STOP_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-stop-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.13' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-stop-local-splice-0.6.13.sh: all cases passed"

package/node/test-stop-local-splice-0.6.14.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+STOP_SCRIPT="$REPO_ROOT/node/stop-local-splice-0.6.14.sh"
+
+[[ -x "$STOP_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-stop-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.6.14' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-stop-local-splice-0.6.14.sh: all cases passed"

package/node/test-stop-local-splice-0.7.0.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+STOP_SCRIPT="$REPO_ROOT/node/stop-local-splice-0.7.0.sh"
+
+[[ -x "$STOP_SCRIPT" ]]
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+stub="$tmpdir/stub-stop-local.sh"
+cat > "$stub" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'IMAGE_TAG=%s\n' "${IMAGE_TAG:-}"
+printf 'args=%s\n' "$*"
+EOF
+chmod +x "$stub"
+
+default_output="$(STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT" one two)"
+grep -Fqx 'IMAGE_TAG=0.7.0' <<<"$default_output"
+grep -Fqx 'args=one two' <<<"$default_output"
+
+override_output="$(IMAGE_TAG=custom-tag STOP_LOCAL_SCRIPT="$stub" "$STOP_SCRIPT")"
+grep -Fqx 'IMAGE_TAG=custom-tag' <<<"$override_output"
+
+echo "test-stop-local-splice-0.7.0.sh: all cases passed"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@distrohelena/canton-typescript-sdk",
-    "version": "0.1.37",
+    "version": "0.1.39",
     "license": "Apache-2.0",
     "type": "module",
     "main": "./dist/index.js",
@@ -15,7 +15,15 @@
         "canton-localnet-start": "node/start-local.sh",
         "canton-localnet-stop": "node/stop-local.sh",
         "canton-localnet-participant-358-start": "node/start-local-participant-358.sh",
-        "canton-localnet-participant-358-stop": "node/stop-local-participant-358.sh"
+        "canton-localnet-participant-358-stop": "node/stop-local-participant-358.sh",
+        "canton-localnet-splice-0.7.0-start": "node/start-local-splice-0.7.0.sh",
+        "canton-localnet-splice-0.7.0-stop": "node/stop-local-splice-0.7.0.sh",
+        "canton-localnet-splice-0.6.14-start": "node/start-local-splice-0.6.14.sh",
+        "canton-localnet-splice-0.6.14-stop": "node/stop-local-splice-0.6.14.sh",
+        "canton-localnet-splice-0.6.13-start": "node/start-local-splice-0.6.13.sh",
+        "canton-localnet-splice-0.6.13-stop": "node/stop-local-splice-0.6.13.sh",
+        "canton-localnet-splice-0.6.12-start": "node/start-local-splice-0.6.12.sh",
+        "canton-localnet-splice-0.6.12-stop": "node/stop-local-splice-0.6.12.sh"
     },
     "keywords": [
         "canton",
@@ -109,10 +117,26 @@
         "stop:local-ledger": "bash node/stop-local.sh",
         "start:local-participant-358": "bash node/start-local-participant-358.sh",
         "stop:local-participant-358": "bash node/stop-local-participant-358.sh",
+        "start:local-ledger-splice-0.7.0": "bash node/start-local-splice-0.7.0.sh",
+        "stop:local-ledger-splice-0.7.0": "bash node/stop-local-splice-0.7.0.sh",
+        "start:local-ledger-splice-0.6.14": "bash node/start-local-splice-0.6.14.sh",
+        "stop:local-ledger-splice-0.6.14": "bash node/stop-local-splice-0.6.14.sh",
+        "start:local-ledger-splice-0.6.13": "bash node/start-local-splice-0.6.13.sh",
+        "stop:local-ledger-splice-0.6.13": "bash node/stop-local-splice-0.6.13.sh",
+        "start:local-ledger-splice-0.6.12": "bash node/start-local-splice-0.6.12.sh",
+        "stop:local-ledger-splice-0.6.12": "bash node/stop-local-splice-0.6.12.sh",
         "test:start-local-script": "bash node/test-start-local.sh",
         "test:stop-local-script": "bash node/test-stop-local.sh",
         "test:participant-358-sidecar-script": "bash node/test-participant-358-sidecar.sh",
         "test:participant-358-sidecar-smoke": "bash node/test-participant-358-sidecar-smoke.sh",
+        "test:start-local-splice-0.7.0-script": "bash node/test-start-local-splice-0.7.0.sh",
+        "test:stop-local-splice-0.7.0-script": "bash node/test-stop-local-splice-0.7.0.sh",
+        "test:start-local-splice-0.6.14-script": "bash node/test-start-local-splice-0.6.14.sh",
+        "test:stop-local-splice-0.6.14-script": "bash node/test-stop-local-splice-0.6.14.sh",
+        "test:start-local-splice-0.6.13-script": "bash node/test-start-local-splice-0.6.13.sh",
+        "test:stop-local-splice-0.6.13-script": "bash node/test-stop-local-splice-0.6.13.sh",
+        "test:start-local-splice-0.6.12-script": "bash node/test-start-local-splice-0.6.12.sh",
+        "test:stop-local-splice-0.6.12-script": "bash node/test-stop-local-splice-0.6.12.sh",
         "test": "vitest run --exclude 'tests/live/**' --maxWorkers=1 --testTimeout=15000",
         "test:property": "vitest run tests/property --maxWorkers=1 --testTimeout=15000",
         "test:live": "vitest run --dir tests/live --maxWorkers=1 --testTimeout=15000",