@fairmint/canton-node-sdk 0.0.267 → 0.0.269

package/build/src/index.js

@@ -19,5 +19,6 @@ var Canton_1 = require("./Canton");
 Object.defineProperty(exports, "Canton", { enumerable: true, get: function () { return Canton_1.Canton; } });
 __exportStar(require("./clients"), exports);
 __exportStar(require("./core"), exports);
+__exportStar(require("./da-registry"), exports);
 __exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAOkB;AANhB,gGAAA,MAAM,OAAA;AAOR,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAOkB;AANhB,gGAAA,MAAM,OAAA;AAOR,4CAA0B;AAC1B,yCAAuB;AACvB,gDAA8B;AAC9B,0CAAwB"}

package/build/src/utils/index.d.ts

@@ -3,6 +3,7 @@ export * from './canton-response-utils';
 export * from './contracts';
 export * from './external-signing';
 export * from './health';
+export * from './ledger';
 export * from './mining';
 export * from './parsers';
 export * from './party';

package/build/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/build/src/utils/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./canton-response-utils"), exports);
 __exportStar(require("./contracts"), exports);
 __exportStar(require("./external-signing"), exports);
 __exportStar(require("./health"), exports);
+__exportStar(require("./ledger"), exports);
 __exportStar(require("./mining"), exports);
 __exportStar(require("./parsers"), exports);
 __exportStar(require("./party"), exports);

package/build/src/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0DAAwC;AACxC,8CAA4B;AAC5B,qDAAmC;AACnC,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,oDAAkC;AAClC,mDAAiC;AACjC,4CAA0B;AAC1B,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0DAAwC;AACxC,8CAA4B;AAC5B,qDAAmC;AACnC,2CAAyB;AACzB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,oDAAkC;AAClC,mDAAiC;AACjC,4CAA0B;AAC1B,iDAA+B"}

package/build/src/utils/ledger/active-contracts.d.ts

@@ -0,0 +1,26 @@
+import { type LedgerJsonApiClient } from '../../clients';
+import { type ActiveContract } from './types';
+export interface GetActiveContractsByTemplateParams {
+    /** Parties whose view of the active contract set is read. Every party must be actable by the client's user. */
+    parties: string[];
+    /**
+     * Template filters, in package-name form (`#<package-name>:<Module>:<Entity>`) or package-id form
+     * (`<packageId>:<Module>:<Entity>`).
+     */
+    templateIds: string[];
+    /**
+     * When set, contracts on any other synchronizer are dropped: a submission pinned to one synchronizer cannot use them.
+     * When omitted, contracts on every connected synchronizer are returned.
+     */
+    synchronizerId?: string;
+    includeCreatedEventBlob?: boolean;
+}
+/**
+ * Reads the active contracts of the given templates visible to `parties`.
+ *
+ * Empty pages (`JsEmpty` entries, returned when nothing matches) are skipped. Malformed entries are skipped rather than
+ * throwing, matching the ledger's streaming semantics; use {@link isJsActiveContractItem} directly if strict validation
+ * is needed.
+ */
+export declare function getActiveContractsByTemplate(client: LedgerJsonApiClient, params: GetActiveContractsByTemplateParams): Promise<ActiveContract[]>;
+//# sourceMappingURL=active-contracts.d.ts.map

package/build/src/utils/ledger/active-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-contracts.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/active-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,kCAAkC;IACjD,+GAA+G;IAC/G,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B3B"}

package/build/src/utils/ledger/active-contracts.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveContractsByTemplate = getActiveContractsByTemplate;
+const errors_1 = require("../../core/errors");
+const contracts_1 = require("../contracts");
+/**
+ * Reads the active contracts of the given templates visible to `parties`.
+ *
+ * Empty pages (`JsEmpty` entries, returned when nothing matches) are skipped. Malformed entries are skipped rather than
+ * throwing, matching the ledger's streaming semantics; use {@link isJsActiveContractItem} directly if strict validation
+ * is needed.
+ */
+async function getActiveContractsByTemplate(client, params) {
+    // The underlying operation replaces an empty party list with the client's default parties; never let an explicit
+    // but empty selection fall back to reading as the validator party.
+    if (params.parties.length === 0) {
+        throw new errors_1.ValidationError('getActiveContractsByTemplate requires at least one party');
+    }
+    const items = await client.getActiveContracts({
+        parties: params.parties,
+        templateIds: params.templateIds,
+        ...(params.includeCreatedEventBlob !== undefined
+            ? { includeCreatedEventBlob: params.includeCreatedEventBlob }
+            : {}),
+    });
+    const contracts = [];
+    for (const item of items) {
+        if (!(0, contracts_1.isJsActiveContractItem)(item))
+            continue;
+        const { createdEvent, synchronizerId } = item.contractEntry.JsActiveContract;
+        if (params.synchronizerId !== undefined && synchronizerId !== params.synchronizerId)
+            continue;
+        contracts.push({
+            contractId: createdEvent.contractId,
+            templateId: createdEvent.templateId,
+            createArgument: createdEvent.createArgument,
+            synchronizerId,
+            ...(createdEvent.createdEventBlob ? { createdEventBlob: createdEvent.createdEventBlob } : {}),
+        });
+    }
+    return contracts;
+}
+//# sourceMappingURL=active-contracts.js.map

package/build/src/utils/ledger/active-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-contracts.js","sourceRoot":"","sources":["../../../../src/utils/ledger/active-contracts.ts"],"names":[],"mappings":";;;AACA,8CAAoD;AACpD,4CAAsD;AAmBtD;;;;;;GAMG;AACI,KAAK,uCACV,MAA2B,EAC3B,MAA0C;IAE1C,iHAAiH;IACjH,mEAAmE;IACnE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,wBAAe,CAAC,0DAA0D,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,CAAC,MAAM,CAAC,uBAAuB,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,EAAE;YAC7D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAA,kCAAsB,EAAC,IAAI,CAAC;YAAE,SAAS;QAC5C,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC;QAC7E,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,MAAM,CAAC,cAAc;YAAE,SAAS;QAC9F,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,cAAc,EAAE,YAAY,CAAC,cAAc;YAC3C,cAAc;YACd,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9F,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/build/src/utils/ledger/index.d.ts

@@ -0,0 +1,7 @@
+export * from './active-contracts';
+export * from './packages';
+export * from './submit-commands';
+export * from './synchronizers';
+export * from './types';
+export * from './user-rights';
+//# sourceMappingURL=index.d.ts.map

package/build/src/utils/ledger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/build/src/utils/ledger/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./active-contracts"), exports);
+__exportStar(require("./packages"), exports);
+__exportStar(require("./submit-commands"), exports);
+__exportStar(require("./synchronizers"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./user-rights"), exports);
+//# sourceMappingURL=index.js.map

package/build/src/utils/ledger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/ledger/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,6CAA2B;AAC3B,oDAAkC;AAClC,kDAAgC;AAChC,0CAAwB;AACxB,gDAA8B"}

package/build/src/utils/ledger/packages.d.ts

@@ -0,0 +1,21 @@
+import { type LedgerJsonApiClient } from '../../clients';
+import { type PreferredPackage } from './types';
+/** Ids of every package uploaded to this participant, vetted or not. */
+export declare function listUploadedPackageIds(client: LedgerJsonApiClient): Promise<string[]>;
+/**
+ * The package version each name resolves to when every one of `parties` must have it vetted on `synchronizerId`.
+ *
+ * Use this to confirm that the packages a workflow needs (for example a DA Registry bundle) are vetted by all
+ * confirming nodes before submitting package-name-form commands.
+ */
+export declare function getPreferredPackages(client: LedgerJsonApiClient, params: {
+    parties: string[];
+    packageNames: string[];
+    synchronizerId: string;
+}): Promise<PreferredPackage[]>;
+/** Uploads a DAR and vets every package in it on the given synchronizer. */
+export declare function uploadAndVetDar(client: LedgerJsonApiClient, params: {
+    darFile: Buffer;
+    synchronizerId: string;
+}): Promise<void>;
+//# sourceMappingURL=packages.d.ts.map

package/build/src/utils/ledger/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wEAAwE;AACxE,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG3F;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAS7B;AAED,4EAA4E;AAC5E,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/build/src/utils/ledger/packages.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listUploadedPackageIds = listUploadedPackageIds;
+exports.getPreferredPackages = getPreferredPackages;
+exports.uploadAndVetDar = uploadAndVetDar;
+const core_1 = require("../../core");
+/** Ids of every package uploaded to this participant, vetted or not. */
+async function listUploadedPackageIds(client) {
+    const { packageIds } = await client.listPackages();
+    return packageIds;
+}
+/**
+ * The package version each name resolves to when every one of `parties` must have it vetted on `synchronizerId`.
+ *
+ * Use this to confirm that the packages a workflow needs (for example a DA Registry bundle) are vetted by all
+ * confirming nodes before submitting package-name-form commands.
+ */
+async function getPreferredPackages(client, params) {
+    const { packageReferences } = await client.interactiveSubmissionGetPreferredPackages({
+        packageVettingRequirements: params.packageNames.map((packageName) => ({
+            parties: params.parties,
+            packageName,
+        })),
+        synchronizerId: params.synchronizerId,
+    });
+    return packageReferences;
+}
+/** Uploads a DAR and vets every package in it on the given synchronizer. */
+async function uploadAndVetDar(client, params) {
+    await client.uploadDar({
+        darFile: params.darFile,
+        vetAllPackages: true,
+        synchronizerId: (0, core_1.SynchronizerId)(params.synchronizerId),
+    });
+}
+//# sourceMappingURL=packages.js.map

package/build/src/utils/ledger/packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../../../src/utils/ledger/packages.ts"],"names":[],"mappings":";;;;;AACA,qCAA4C;AAG5C,wEAAwE;AACjE,KAAK,iCAAiC,MAA2B;IACtE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IACnD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACI,KAAK,+BACV,MAA2B,EAC3B,MAA6E;IAE7E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC;QACnF,0BAA0B,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACpE,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW;SACZ,CAAC,CAAC;QACH,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IACH,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,4EAA4E;AACrE,KAAK,0BACV,MAA2B,EAC3B,MAAmD;IAEnD,MAAM,MAAM,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAA,qBAAc,EAAC,MAAM,CAAC,cAAc,CAAC;KACtD,CAAC,CAAC;AACL,CAAC"}

package/build/src/utils/ledger/submit-commands.d.ts

@@ -0,0 +1,19 @@
+import { type LedgerJsonApiClient } from '../../clients';
+import { type LedgerSubmission, type SubmittedTransaction } from './types';
+export interface SubmitLedgerCommandsOptions {
+    /** Every command is pinned to this synchronizer. */
+    synchronizerId: string;
+    /**
+     * Package ids the participant prefers when resolving package-name-form template ids. Pinning the packages both
+     * confirming nodes vet keeps a multi-node workflow (for example a registrar and its operator) on the same code.
+     */
+    packageIdSelectionPreference?: readonly string[];
+}
+/**
+ * Submits commands and waits for the resulting transaction, returning its update id and created contracts.
+ *
+ * The command id is `${commandIdPrefix}-${randomUUID()}`: callers keep a stable, searchable prefix per logical action
+ * while each submission stays unique.
+ */
+export declare function submitLedgerCommands(client: LedgerJsonApiClient, submission: LedgerSubmission, options: SubmitLedgerCommandsOptions): Promise<SubmittedTransaction>;
+//# sourceMappingURL=submit-commands.d.ts.map

package/build/src/utils/ledger/submit-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-commands.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/submit-commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/build/src/utils/ledger/submit-commands.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitLedgerCommands = submitLedgerCommands;
+const crypto_1 = require("crypto");
+const parsers_1 = require("../parsers");
+/**
+ * Submits commands and waits for the resulting transaction, returning its update id and created contracts.
+ *
+ * The command id is `${commandIdPrefix}-${randomUUID()}`: callers keep a stable, searchable prefix per logical action
+ * while each submission stays unique.
+ */
+async function submitLedgerCommands(client, submission, options) {
+    const response = await client.submitAndWaitForTransaction({
+        // LedgerCommand mirrors the API's JSON shapes with Record<string, unknown> arguments; the client's zod-inferred
+        // parameter type uses a recursive JsonValue, so the structurally-equal commands need this one cast.
+        commands: submission.commands,
+        commandId: `${submission.commandIdPrefix}-${(0, crypto_1.randomUUID)()}`,
+        actAs: submission.actAs,
+        synchronizerId: options.synchronizerId,
+        ...(options.packageIdSelectionPreference && options.packageIdSelectionPreference.length > 0
+            ? { packageIdSelectionPreference: [...options.packageIdSelectionPreference] }
+            : {}),
+        ...(submission.disclosedContracts && submission.disclosedContracts.length > 0
+            ? { disclosedContracts: submission.disclosedContracts }
+            : {}),
+    });
+    const events = (0, parsers_1.extractEventsFromTransaction)(response);
+    const updateId = response.transaction?.updateId ?? '';
+    return {
+        updateId,
+        created: events.created.map((e) => ({ contractId: e.contractId, templateId: e.templateId })),
+    };
+}
+//# sourceMappingURL=submit-commands.js.map

package/build/src/utils/ledger/submit-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-commands.js","sourceRoot":"","sources":["../../../../src/utils/ledger/submit-commands.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAEpC,wCAA0D;AAa1D;;;;;GAKG;AACI,KAAK,+BACV,MAA2B,EAC3B,UAA4B,EAC5B,OAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC;QACxD,gHAAgH;QAChH,oGAAoG;QACpG,QAAQ,EAAE,UAAU,CAAC,QAAyF;QAC9G,SAAS,EAAE,GAAG,UAAU,CAAC,eAAe,IAAI,IAAA,mBAAU,GAAE,EAAE;QAC1D,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,GAAG,CAAC,OAAO,CAAC,4BAA4B,IAAI,OAAO,CAAC,4BAA4B,CAAC,MAAM,GAAG,CAAC;YACzF,CAAC,CAAC,EAAE,4BAA4B,EAAE,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC,EAAE;YAC7E,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,UAAU,CAAC,kBAAkB,IAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC3E,CAAC,CAAC,EAAE,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,EAAE;YACvD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAA,sCAA4B,EAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAI,QAAoD,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;IACnG,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;KAC7F,CAAC;AACJ,CAAC"}

package/build/src/utils/ledger/synchronizers.d.ts

@@ -0,0 +1,4 @@
+import { type LedgerJsonApiClient } from '../../clients';
+/** Ids of the synchronizers `party` is currently connected to. */
+export declare function getConnectedSynchronizerIds(client: LedgerJsonApiClient, party: string): Promise<string[]>;
+//# sourceMappingURL=synchronizers.d.ts.map

package/build/src/utils/ledger/synchronizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronizers.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/synchronizers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,kEAAkE;AAClE,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG/G"}

package/build/src/utils/ledger/synchronizers.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConnectedSynchronizerIds = getConnectedSynchronizerIds;
+/** Ids of the synchronizers `party` is currently connected to. */
+async function getConnectedSynchronizerIds(client, party) {
+    const { connectedSynchronizers } = await client.getConnectedSynchronizers({ party });
+    return (connectedSynchronizers ?? []).map((s) => s.synchronizerId);
+}
+//# sourceMappingURL=synchronizers.js.map

package/build/src/utils/ledger/synchronizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronizers.js","sourceRoot":"","sources":["../../../../src/utils/ledger/synchronizers.ts"],"names":[],"mappings":";;;AAEA,kEAAkE;AAC3D,KAAK,sCAAsC,MAA2B,EAAE,KAAa;IAC1F,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AACrE,CAAC"}

package/build/src/utils/ledger/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared types for reading contracts and submitting commands through the Ledger JSON API.
+ *
+ * `LedgerCommand` mirrors the API's command JSON with `Record<string, unknown>` arguments, so callers can build
+ * commands for templates the SDK has no generated types for (for example Digital Asset's proprietary Registry DARs).
+ * The schema-typed counterparts (`CreateCommand`, `CompositeCommand`, …) are exported from the package root too;
+ * `LedgerCommand` is the ergonomic variant for hand-built commands, converted at the submission boundary.
+ */
+import { type DisclosedContract } from '../../clients';
+export type { DisclosedContract };
+/** A contract as read from the active contract set, in package-id form (`<packageId>:<Module>:<Entity>`). */
+export interface ActiveContract {
+    contractId: string;
+    templateId: string;
+    createArgument: Record<string, unknown>;
+    createdEventBlob?: string;
+    synchronizerId: string;
+}
+export type LedgerCommand = {
+    CreateCommand: {
+        templateId: string;
+        createArguments: Record<string, unknown>;
+    };
+} | {
+    ExerciseCommand: {
+        templateId: string;
+        contractId: string;
+        choice: string;
+        choiceArgument: Record<string, unknown>;
+    };
+} | {
+    CreateAndExerciseCommand: {
+        templateId: string;
+        createArguments: Record<string, unknown>;
+        choice: string;
+        choiceArgument: Record<string, unknown>;
+    };
+};
+export interface LedgerSubmission {
+    /**
+     * Stable prefix identifying the logical action (for example one setup step); the submit helper appends a random
+     * suffix per submission so re-runs do not collide on the ledger's command-id deduplication.
+     */
+    commandIdPrefix: string;
+    actAs: string[];
+    commands: LedgerCommand[];
+    disclosedContracts?: DisclosedContract[];
+}
+export interface CreatedContract {
+    contractId: string;
+    templateId: string;
+}
+export interface SubmittedTransaction {
+    updateId: string;
+    created: CreatedContract[];
+}
+/** The package version a name resolves to for a set of parties on a synchronizer. */
+export interface PreferredPackage {
+    packageName: string;
+    packageId: string;
+    packageVersion: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/utils/ledger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IACE,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACjF,GACD;IACE,eAAe,EAAE;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACzC,CAAC;CACH,GACD;IACE,wBAAwB,EAAE;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACzC,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/build/src/utils/ledger/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/src/utils/ledger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/ledger/types.ts"],"names":[],"mappings":""}

package/build/src/utils/ledger/user-rights.d.ts

@@ -0,0 +1,17 @@
+import { type LedgerJsonApiClient } from '../../clients';
+export interface UserActAsStatus {
+    /** The authenticated user's id. */
+    userId: string;
+    /** Which of the requested parties the user may NOT act as. */
+    missing: string[];
+    /** Whether the user holds the ParticipantAdmin right (required to upload DARs). */
+    participantAdmin: boolean;
+}
+/**
+ * Checks which of `parties` the authenticated user may act as, and whether it is a participant admin.
+ *
+ * Every caller should name its parties explicitly: a client's default party is typically the validator party, and
+ * falling back to it would read or act as the wrong party.
+ */
+export declare function checkUserActAs(client: LedgerJsonApiClient, parties: string[]): Promise<UserActAsStatus>;
+//# sourceMappingURL=user-rights.d.ts.map

package/build/src/utils/ledger/user-rights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rights.d.ts","sourceRoot":"","sources":["../../../../src/utils/ledger/user-rights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAWD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAc7G"}

package/build/src/utils/ledger/user-rights.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkUserActAs = checkUserActAs;
+function canActAsParty(right) {
+    // The request shape nests the right under `value`; the response schema does not. Accept both.
+    return right.kind?.CanActAs?.value?.party ?? right.kind?.CanActAs?.party;
+}
+/**
+ * Checks which of `parties` the authenticated user may act as, and whether it is a participant admin.
+ *
+ * Every caller should name its parties explicitly: a client's default party is typically the validator party, and
+ * falling back to it would read or act as the wrong party.
+ */
+async function checkUserActAs(client, parties) {
+    const { user } = await client.getAuthenticatedUser({});
+    // The schema requires the user, but a misbehaving participant can still omit it; fail with a clear error.
+    const userId = user?.id;
+    if (!userId)
+        throw new Error('The ledger did not return the authenticated user');
+    const { rights } = await client.listUserRights({ userId });
+    const actable = new Set((rights ?? []).map(canActAsParty).filter((p) => p !== undefined));
+    return {
+        userId,
+        missing: parties.filter((p) => !actable.has(p)),
+        participantAdmin: (rights ?? []).some((r) => r.kind?.ParticipantAdmin !== undefined),
+    };
+}
+//# sourceMappingURL=user-rights.js.map

package/build/src/utils/ledger/user-rights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rights.js","sourceRoot":"","sources":["../../../../src/utils/ledger/user-rights.ts"],"names":[],"mappings":";;;AAeA,SAAS,aAAa,CAAC,KAAgB;IACrC,8FAA8F;IAC9F,OAAO,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACI,KAAK,yBAAyB,MAA2B,EAAE,OAAiB;IACjF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACvD,0GAA0G;IAC1G,MAAM,MAAM,GAAI,IAAoC,EAAE,EAAE,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACjF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,CACpB,CAAC,MAAM,IAAI,EAAE,CAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAC/F,CAAC;IACF,OAAO;QACL,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,gBAAgB,EAAG,CAAC,MAAM,IAAI,EAAE,CAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,KAAK,SAAS,CAAC;KACtG,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/canton-node-sdk",
-  "version": "0.0.267",
+  "version": "0.0.269",
   "description": "Canton Node SDK",
   "keywords": [
     "canton",