@layerzerolabs/common-canton 0.2.126 → 0.2.127

package/dist/client/canton-client.js

@@ -1,5 +1,4 @@
-export { CantonClient } from '../M3ULJ2LD.js';
-import '../4G6A7TFX.js';
+export { CantonClient } from '../BKOBBVMB.js';
 import '../TZTIULG5.js';
 import '../6CPYXAOF.js';
 import '../Q3CWBD5A.js';
@@ -284,6 +283,7 @@ import '../TVDUWBAO.js';
 import '../Q7CJWR7Y.js';
 import '../V6427LHF.js';
 import '../KBNUN3MF.js';
+import '../4G6A7TFX.js';
 import '../A7Z5O57E.js';
 import '../VUOMXK5T.js';
 //# sourceMappingURL=canton-client.js.map

package/dist/client/index.js

@@ -1,13 +1,7 @@
 import '../7JX6NIYS.js';
 export { buildMultiTransactionSignatures, buildSignedTransaction } from '../WKC6X2E3.js';
 import '../IIWYAFUO.js';
-export { CantonClient } from '../M3ULJ2LD.js';
-export { AMULET_INSTRUMENT_ID, fetchAmuletContext, fetchDsoParty, injectExternalPartyAmuletRules } from '../4G6A7TFX.js';
-export { CantonGrpcClient } from '../NRSV2VHQ.js';
-import '../RVQWP4JU.js';
-import '../CXQSVBVW.js';
-export { computeDecentralizedNamespace, computeMultiTransactionHash } from '../QAKOQQ7E.js';
-export { cantonMultihash, computeCantonFingerprint, computePublicKeyFingerprint, extractTransactions } from '../WLV6EHDB.js';
+export { CantonClient } from '../BKOBBVMB.js';
 import '../TZTIULG5.js';
 import '../6CPYXAOF.js';
 import '../Q3CWBD5A.js';
@@ -292,6 +286,12 @@ import '../TVDUWBAO.js';
 import '../Q7CJWR7Y.js';
 import '../V6427LHF.js';
 import '../KBNUN3MF.js';
+export { AMULET_INSTRUMENT_ID, fetchAmuletContext, fetchDsoParty, injectExternalPartyAmuletRules } from '../4G6A7TFX.js';
+export { CantonGrpcClient } from '../NRSV2VHQ.js';
+import '../RVQWP4JU.js';
+import '../CXQSVBVW.js';
+export { computeDecentralizedNamespace, computeMultiTransactionHash } from '../QAKOQQ7E.js';
+export { cantonMultihash, computeCantonFingerprint, computePublicKeyFingerprint, extractTransactions } from '../WLV6EHDB.js';
 import '../CMDFOA7C.js';
 import '../A7Z5O57E.js';
 import '../VUOMXK5T.js';

package/dist/client/interface.d.ts

@@ -173,6 +173,57 @@ export interface ICantonClient {
         synchronizerId?: string;
         identityProviderId?: string;
     }): Promise<string>;
+    /**
+     * Generate unsigned topology transactions for an external party.
+     *
+     * POST /v2/parties/external/generate-topology
+     *
+     * Returns the deterministic partyId derived from partyHint + publicKey, plus
+     * a multiHash (base64) covering all generated transactions that the external party
+     * owner must sign before calling allocateExternalParty.
+     */
+    generateExternalPartyTopology(args: {
+        partyHint: string;
+        publicKey: {
+            format: string;
+            keyData: string;
+            keySpec: string;
+        };
+        localParticipantObservationOnly: boolean;
+        confirmationThreshold: number;
+    }): Promise<{
+        partyId: string;
+        topologyTransactions: string[];
+        multiHash: string;
+        synchronizerId: string;
+    }>;
+    /**
+     * Submit signed topology transactions to register an external party.
+     *
+     * POST /v2/parties/external/allocate
+     *
+     * @param args.synchronizerId - Target synchronizer
+     * @param args.topologyTransactions - Unsigned transactions from generateExternalPartyTopology
+     * @param args.multiHashSignatures - Signatures over the multiHash from generateExternalPartyTopology
+     * @returns The allocated party ID
+     */
+    allocateExternalParty(args: {
+        synchronizerId: string;
+        topologyTransactions: string[];
+        multiHashSignatures: Array<{
+            format: string;
+            signature: string;
+            signedBy: string;
+            signingAlgorithmSpec: string;
+        }>;
+    }): Promise<string>;
+    /**
+     * Grant canActAs right for a party to the current service user.
+     * Idempotent — safe to call even if the right is already granted.
+     *
+     * POST /v2/users/{userId}/rights
+     */
+    grantCanActAs(partyId: string): Promise<void>;
     /**
      * Get the package ID for a package by name.
      *

package/dist/client/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/client/interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/client/interface.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,5 @@
 import './AQJMQQ4W.js';
-export { buildCantonDeployedContractAddressRef, qualifiedTemplateName } from './I6Z5XG3N.js';
-export { resolveCantonTransaction } from './5TZ63V42.js';
-export { createContractAddressResolver, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef } from './QRFMJ32P.js';
+export { resolveCantonTransaction } from './333Q6X6C.js';
 export { wrapLzSdk } from './RJSKBZMO.js';
 export { substituteCidsToRefs, substituteRefsToCids } from './57KDDFEU.js';
 import './5GUYLHA7.js';
@@ -9,15 +7,11 @@ export { CantonSdk } from './SLTAV2JF.js';
 import './7JX6NIYS.js';
 export { buildMultiTransactionSignatures, buildSignedTransaction } from './WKC6X2E3.js';
 import './IIWYAFUO.js';
+export { createContractAddressResolver, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef } from './QRFMJ32P.js';
+export { buildCantonDeployedContractAddressRef, qualifiedTemplateName } from './I6Z5XG3N.js';
 export { parseMinFeeValue } from './M3GPMXME.js';
-export { createCantonChainProvider, parseCantonChainUri } from './QPVJEMY5.js';
-export { CantonClient } from './M3ULJ2LD.js';
-export { AMULET_INSTRUMENT_ID, fetchAmuletContext, fetchDsoParty, injectExternalPartyAmuletRules } from './4G6A7TFX.js';
-export { CantonGrpcClient } from './NRSV2VHQ.js';
-import './RVQWP4JU.js';
-import './CXQSVBVW.js';
-export { computeDecentralizedNamespace, computeMultiTransactionHash } from './QAKOQQ7E.js';
-export { cantonMultihash, computeCantonFingerprint, computePublicKeyFingerprint, extractTransactions } from './WLV6EHDB.js';
+export { createCantonChainProvider, parseCantonChainUri } from './OHXAJ35V.js';
+export { CantonClient } from './BKOBBVMB.js';
 import './TZTIULG5.js';
 import './6CPYXAOF.js';
 import './Q3CWBD5A.js';
@@ -302,6 +296,12 @@ import './TVDUWBAO.js';
 import './Q7CJWR7Y.js';
 import './V6427LHF.js';
 export { Configuration, ResponseError } from './KBNUN3MF.js';
+export { AMULET_INSTRUMENT_ID, fetchAmuletContext, fetchDsoParty, injectExternalPartyAmuletRules } from './4G6A7TFX.js';
+export { CantonGrpcClient } from './NRSV2VHQ.js';
+import './RVQWP4JU.js';
+import './CXQSVBVW.js';
+export { computeDecentralizedNamespace, computeMultiTransactionHash } from './QAKOQQ7E.js';
+export { cantonMultihash, computeCantonFingerprint, computePublicKeyFingerprint, extractTransactions } from './WLV6EHDB.js';
 export { CommandStatus, IntLikeSchema, buildTemplateId, canonicalizeDamlDecimal, smallestUnitsToDamlDecimal } from './4WZTQJXP.js';
 import './35ELVFTS.js';
 export { ClientCredentialsTokenProvider } from './V2H2WXKE.js';

package/dist/provider.js

@@ -1,11 +1,5 @@
-export { createCantonChainProvider, parseCantonChainUri } from './QPVJEMY5.js';
-import './M3ULJ2LD.js';
-import './4G6A7TFX.js';
-import './NRSV2VHQ.js';
-import './RVQWP4JU.js';
-import './CXQSVBVW.js';
-import './QAKOQQ7E.js';
-import './WLV6EHDB.js';
+export { createCantonChainProvider, parseCantonChainUri } from './OHXAJ35V.js';
+import './BKOBBVMB.js';
 import './TZTIULG5.js';
 import './6CPYXAOF.js';
 import './Q3CWBD5A.js';
@@ -290,6 +284,12 @@ import './TVDUWBAO.js';
 import './Q7CJWR7Y.js';
 import './V6427LHF.js';
 import './KBNUN3MF.js';
+import './4G6A7TFX.js';
+import './NRSV2VHQ.js';
+import './RVQWP4JU.js';
+import './CXQSVBVW.js';
+import './QAKOQQ7E.js';
+import './WLV6EHDB.js';
 import './V2H2WXKE.js';
 import './SCEF7TLZ.js';
 import './CMDFOA7C.js';

package/dist/refresh/index.js

@@ -1,9 +1,9 @@
 import '../AQJMQQ4W.js';
-export { buildCantonDeployedContractAddressRef, qualifiedTemplateName } from '../I6Z5XG3N.js';
-export { resolveCantonTransaction } from '../5TZ63V42.js';
-export { createContractAddressResolver, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef } from '../QRFMJ32P.js';
+export { resolveCantonTransaction } from '../333Q6X6C.js';
 export { wrapLzSdk } from '../RJSKBZMO.js';
 export { substituteCidsToRefs, substituteRefsToCids } from '../57KDDFEU.js';
+export { createContractAddressResolver, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef } from '../QRFMJ32P.js';
+export { buildCantonDeployedContractAddressRef, qualifiedTemplateName } from '../I6Z5XG3N.js';
 import '../4G6A7TFX.js';
 import '../Z35TKEFU.js';
 import '../A7Z5O57E.js';

package/dist/refresh/resolve.js

@@ -1,6 +1,6 @@
-export { resolveCantonTransaction } from '../5TZ63V42.js';
-import '../QRFMJ32P.js';
+export { resolveCantonTransaction } from '../333Q6X6C.js';
 import '../57KDDFEU.js';
+import '../QRFMJ32P.js';
 import '../4G6A7TFX.js';
 import '../Z35TKEFU.js';
 import '../A7Z5O57E.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-canton",
-  "version": "0.2.126",
+  "version": "0.2.127",
   "private": false,
   "description": "Canton VM client and utilities",
   "license": "MIT",
@@ -32,10 +32,10 @@
     "@protobuf-ts/runtime-rpc": "^2.11.1",
     "es-toolkit": "^1.39.10",
     "zod": "4.3.5",
-    "@layerzerolabs/common-chain-model": "0.2.126",
-    "@layerzerolabs/common-encoding-utils": "0.2.126",
-    "@layerzerolabs/typescript-utils": "0.2.126",
-    "@layerzerolabs/common-error-utils": "0.2.126"
+    "@layerzerolabs/typescript-utils": "0.2.127",
+    "@layerzerolabs/common-encoding-utils": "0.2.127",
+    "@layerzerolabs/common-error-utils": "0.2.127",
+    "@layerzerolabs/common-chain-model": "0.2.127"
   },
   "devDependencies": {
     "@types/node": "^22.18.6",
@@ -44,11 +44,11 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.2.6",
-    "@layerzerolabs/eslint-configuration": "^0.2.126",
-    "@layerzerolabs/typescript-configuration": "0.2.126",
-    "@layerzerolabs/tsup-configuration": "0.2.126",
-    "@layerzerolabs/vitest-configuration": "0.2.126",
-    "@layerzerolabs/vm-tooling-canton": "0.2.126"
+    "@layerzerolabs/eslint-configuration": "^0.2.127",
+    "@layerzerolabs/tsup-configuration": "0.2.127",
+    "@layerzerolabs/typescript-configuration": "0.2.127",
+    "@layerzerolabs/vm-tooling-canton": "0.2.127",
+    "@layerzerolabs/vitest-configuration": "0.2.127"
   },
   "publishConfig": {
     "access": "public",

package/src/client/canton-client.ts

@@ -13,6 +13,8 @@ import {
     type PostV2InteractiveSubmissionExecuteRequest,
     type PostV2InteractiveSubmissionPreferredPackagesRequest,
     type PostV2InteractiveSubmissionPrepareRequest,
+    type PostV2PartiesExternalAllocateRequest,
+    type PostV2PartiesExternalGenerateTopologyRequest,
 } from '../open-api/apis/DefaultApi';
 import {
     type ArchivedEvent,
@@ -431,6 +433,115 @@ export class CantonClient implements ICantonClient {
         return party;
     }
 
+    /**
+     * Generate unsigned topology transactions for an external party.
+     *
+     * POST /v2/parties/external/generate-topology
+     */
+    async generateExternalPartyTopology(args: {
+        partyHint: string;
+        publicKey: { format: string; keyData: string; keySpec: string };
+        localParticipantObservationOnly: boolean;
+        confirmationThreshold: number;
+    }): Promise<{
+        partyId: string;
+        topologyTransactions: string[];
+        multiHash: string;
+        synchronizerId: string;
+    }> {
+        const synchronizerId = await this.#ensureSynchronizerId();
+        const request: PostV2PartiesExternalGenerateTopologyRequest = {
+            generateExternalPartyTopologyRequest: {
+                synchronizer: synchronizerId,
+                partyHint: args.partyHint,
+                publicKey: args.publicKey,
+                localParticipantObservationOnly: args.localParticipantObservationOnly,
+                confirmationThreshold: args.confirmationThreshold,
+            },
+        };
+
+        let response;
+        try {
+            response = await this.#api.postV2PartiesExternalGenerateTopology(request);
+        } catch (err: unknown) {
+            throw await this.#throwApiError(err, 'External party topology generation');
+        }
+
+        if (!response.partyId || !response.multiHash) {
+            throw new CantonProtocolError(
+                'generateExternalPartyTopology response missing partyId or multiHash',
+            );
+        }
+
+        return {
+            partyId: response.partyId,
+            topologyTransactions: response.topologyTransactions ?? [],
+            multiHash: response.multiHash,
+            synchronizerId,
+        };
+    }
+
+    /**
+     * Submit signed topology transactions to register an external party.
+     *
+     * POST /v2/parties/external/allocate
+     */
+    async allocateExternalParty(args: {
+        synchronizerId: string;
+        topologyTransactions: string[];
+        multiHashSignatures: Array<{
+            format: string;
+            signature: string;
+            signedBy: string;
+            signingAlgorithmSpec: string;
+        }>;
+    }): Promise<string> {
+        const request: PostV2PartiesExternalAllocateRequest = {
+            allocateExternalPartyRequest: {
+                synchronizer: args.synchronizerId,
+                onboardingTransactions: args.topologyTransactions.map((tx) => ({
+                    transaction: tx,
+                })),
+                multiHashSignatures: args.multiHashSignatures,
+                identityProviderId: '',
+            },
+        };
+
+        let response;
+        try {
+            response = await this.#api.postV2PartiesExternalAllocate(request);
+        } catch (err: unknown) {
+            throw await this.#throwApiError(err, 'External party allocation');
+        }
+
+        if (!response.partyId) {
+            throw new CantonProtocolError('allocateExternalParty response missing partyId');
+        }
+
+        return response.partyId;
+    }
+
+    /**
+     * Grant canActAs right for a party to the current service user.
+     * Idempotent — safe to call even if the right is already granted.
+     *
+     * POST /v2/users/{userId}/rights
+     */
+    async grantCanActAs(partyId: string): Promise<void> {
+        try {
+            await this.#api.postV2UsersUserIdRights({
+                userId: this.#userId,
+                grantUserRightsRequest: {
+                    userId: this.#userId,
+                    rights: [{ kind: { canActAs: { value: { party: partyId } } } }],
+                    identityProviderId: '',
+                },
+            });
+        } catch (err: unknown) {
+            throw await this.#throwApiError(err, `Grant canActAs for party ${partyId}`);
+        }
+    }
+
     /**
      * Get the package ID for a package by name.
      *

package/src/client/interface.ts

@@ -217,6 +217,56 @@ export interface ICantonClient {
         opts?: { userId?: string; synchronizerId?: string; identityProviderId?: string },
     ): Promise<string>;
 
+    /**
+     * Generate unsigned topology transactions for an external party.
+     *
+     * POST /v2/parties/external/generate-topology
+     *
+     * Returns the deterministic partyId derived from partyHint + publicKey, plus
+     * a multiHash (base64) covering all generated transactions that the external party
+     * owner must sign before calling allocateExternalParty.
+     */
+    generateExternalPartyTopology(args: {
+        partyHint: string;
+        publicKey: { format: string; keyData: string; keySpec: string };
+        localParticipantObservationOnly: boolean;
+        confirmationThreshold: number;
+    }): Promise<{
+        partyId: string;
+        topologyTransactions: string[];
+        multiHash: string;
+        synchronizerId: string;
+    }>;
+
+    /**
+     * Submit signed topology transactions to register an external party.
+     *
+     * POST /v2/parties/external/allocate
+     *
+     * @param args.synchronizerId - Target synchronizer
+     * @param args.topologyTransactions - Unsigned transactions from generateExternalPartyTopology
+     * @param args.multiHashSignatures - Signatures over the multiHash from generateExternalPartyTopology
+     * @returns The allocated party ID
+     */
+    allocateExternalParty(args: {
+        synchronizerId: string;
+        topologyTransactions: string[];
+        multiHashSignatures: Array<{
+            format: string;
+            signature: string;
+            signedBy: string;
+            signingAlgorithmSpec: string;
+        }>;
+    }): Promise<string>;
+
+    /**
+     * Grant canActAs right for a party to the current service user.
+     * Idempotent — safe to call even if the right is already granted.
+     *
+     * POST /v2/users/{userId}/rights
+     */
+    grantCanActAs(partyId: string): Promise<void>;
+
     /**
      * Get the package ID for a package by name.
      *

package/dist/M3ULJ2LD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client/canton-client.ts"],"names":["CantonClient","config","userId","wallet","DefaultApi","CantonProtocolError","getDsoParty","walletUrl","tokenProvider","fetchDsoParty","getToken","getAmuletContextWithExternalRules","instrumentId","amuletContext","disclosedContracts","fetchAmuletContext","contextWithRules","externalPartyAmuletRulesCid","injectExternalPartyAmuletRules","obj","key","undefined","pascal","charAt","toUpperCase","slice","camel","toLowerCase","err","resp","response","json","catch","context","body","JSON","stringify","parties","includeCreatedEventBlob","Object","fromEntries","map","p","cumulative","identifierFilter","wildcardFilter","value","event","contractId","templateId","createdEventBlob","preparedTransaction","preparedTransactionHash","hashingSchemeVersion","connectedSynchronizers","getV2StateConnectedSynchronizers","synchronizers","s","synchronizerId","filter","id","once","CantonTransportError","uploadDar","dar","opts","bytes","byteOffset","byteLength","buffer","Blob","type","request","vetAllPackages","postV2Dars","skipIfVetted","code","skipped","reason","details","validateDar","then","postV2DarsValidate","listParties","getV2Parties","pageSize","pageToken","partyDetails","party","nextPageToken","listUserRights","apiResponse","getV2UsersUserIdRightsRaw","raw","rights","listUserParties","Set","right","kind","CanActAs","CanReadAs","add","allocateParty","partyIdHint","postV2Parties","allocatePartyRequest","identityProviderId","getPackageId","packageName","getPreferredPackagesRequest","packageVettingRequirements","postV2InteractiveSubmissionPreferredPackages","packageRef","packageReferences","find","ref","packageId","submit","actors","commands","commandId","randomUUID","ledgerEndResponse","getV2StateLedgerEnd","completionOffset","offset","jsCommands","actAs","readAs","postV2CommandsAsyncSubmit","waitForCommand","timeoutMs","poll","limit","streamIdleTimeoutMs","initialBackoffMs","backoffMs","initial","maxBackoffMs","max","beginExclusive","currentBackoff","deadline","Date","now","completionStreamRequest","rawResponse","postV2CommandsCompletionsRaw","responseText","text","completions","parse","item","normalized","completionResponse","offsetCheckpoint","checkpoint","checkpointOffset","Math","completionWrapper","completion","completionCommandId","status","updateId","error","message","remainingTime","sleepTime","min","Promise","resolve","setTimeout","lastCheckedOffset","getEventsByContractIdRequest","eventFormat","filtersByParty","verbose","postV2EventsEventsByContractId","archived","created","createdEvent","createDisclosure","validated","fetchContractById","fetchEventsByContractId","archivedEvent","fetchTransactionByUpdateId","postV2UpdatesUpdateByIdRaw","getUpdateByIdRequest","updateFormat","updateResponse","fetchTransactionByOffset","postV2UpdatesUpdateByOffsetRaw","getUpdateByOffsetRequest","prepareForSigning","jsPrepareSubmissionRequest","verboseHashing","packageIdSelectionPreference","postV2InteractiveSubmissionPrepare","submitSigned","prepared","signatures","jsExecuteSubmissionRequest","partySignatures","sig","format","signature","signedBy","signingAlgorithmSpec","deduplicationPeriod","deduplicationDuration","seconds","nanos","submissionId","postV2InteractiveSubmissionExecute","getLedgerEndOffset","queryActiveContracts","queryActiveContractsByParties","templateIds","queryActiveContractsByInterface","interfaceIds","cumulativeFilter","postV2StateActiveContractsRaw","getActiveContractsRequest","activeAtOffset","rawJson","contractEntry","JsActiveContract","contract","JsActiveContractFromJSON","getUpdates","endInclusive","postV2UpdatesRaw","getUpdatesRequest","includeTransactions","transactionShape","updateResponses","update","length","templateFilter","interfaceId","interfaceFilter","includeInterfaceView","notFoundMessage","Transaction"],"mappings":"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","file":"M3ULJ2LD.js","sourcesContent":["import type { ContractId } from '@daml/types';\nimport { once } from 'es-toolkit';\nimport { randomUUID } from 'node:crypto';\n\nimport { CantonProtocolError, CantonTransportError } from '../errors';\nimport {\n    DefaultApi,\n    type PostV2CommandsAsyncSubmitRequest,\n    type PostV2CommandsCompletionsRequest,\n    type PostV2DarsRequest,\n    type PostV2DarsValidateRequest,\n    type PostV2EventsEventsByContractIdRequest,\n    type PostV2InteractiveSubmissionExecuteRequest,\n    type PostV2InteractiveSubmissionPreferredPackagesRequest,\n    type PostV2InteractiveSubmissionPrepareRequest,\n} from '../open-api/apis/DefaultApi';\nimport {\n    type ArchivedEvent,\n    type Command,\n    type CreatedEvent,\n    type CumulativeFilter,\n    type DisclosedContract,\n    type JsActiveContract,\n    JsActiveContractFromJSON,\n} from '../open-api/models';\nimport type { Configuration } from '../open-api/runtime';\nimport type {\n    ExternalSignature,\n    PreparedTransaction,\n    SubmitActors,\n    SubmitResult,\n    UserRight,\n    WaitOptions,\n    WaitResult,\n} from '../types';\nimport {\n    type AmuletContextResult,\n    type CantonClientWalletConfig,\n    fetchAmuletContext,\n    fetchDsoParty,\n    injectExternalPartyAmuletRules,\n    type InstrumentId,\n} from './amulet';\nimport type {\n    CantonTransaction,\n    CantonUpdate,\n    CantonUpdateResponse,\n    ICantonClient,\n} from './interface';\n\n/**\n * CantonClient - The engine layer for Canton ledger operations.\n *\n * Responsibilities:\n * - Synchronizer discovery and caching\n * - Command submission and completion waiting\n * - Disclosed contract building\n * - JSON normalization (temporary workaround)\n *\n * This class uses composition (not inheritance) to wrap the generated API,\n * exposing only the minimal surface needed for ledger app operations.\n */\nexport class CantonClient implements ICantonClient {\n    readonly #api: DefaultApi;\n    readonly #userId: string;\n    readonly #wallet?: CantonClientWalletConfig;\n    #dsoParty?: string;\n\n    constructor(\n        config: Configuration,\n        userId: string = 'participant_admin',\n        wallet?: CantonClientWalletConfig,\n    ) {\n        this.#api = new DefaultApi(config);\n        this.#userId = userId;\n        this.#wallet = wallet;\n    }\n\n    #requireWallet(): CantonClientWalletConfig {\n        if (!this.#wallet) {\n            throw new CantonProtocolError(\n                'CantonClient has no wallet config (walletUrl + tokenProvider); amulet endpoints are unavailable',\n            );\n        }\n        return this.#wallet;\n    }\n\n    async getDsoParty(): Promise<string> {\n        const { walletUrl, tokenProvider } = this.#requireWallet();\n        if (this.#dsoParty) return this.#dsoParty;\n        this.#dsoParty = await fetchDsoParty(walletUrl, await tokenProvider.getToken());\n        return this.#dsoParty;\n    }\n\n    /** Amulet ChoiceContext with ExternalPartyAmuletRules injected — required by every flow hitting FeeUtils.validateContext. */\n    async getAmuletContextWithExternalRules(\n        instrumentId: InstrumentId,\n    ): Promise<AmuletContextResult> {\n        const { walletUrl, tokenProvider } = this.#requireWallet();\n        const { amuletContext, disclosedContracts } = await fetchAmuletContext(\n            walletUrl,\n            await tokenProvider.getToken(),\n            instrumentId,\n        );\n        const { amuletContext: contextWithRules, externalPartyAmuletRulesCid } =\n            injectExternalPartyAmuletRules(amuletContext, disclosedContracts);\n        return { amuletContext: contextWithRules, disclosedContracts, externalPartyAmuletRulesCid };\n    }\n\n    /**\n     * Get a property from an object, trying PascalCase first then camelCase.\n     * Canton API returns PascalCase but OpenAPI expects camelCase.\n     */\n    #getField<T>(obj: Record<string, unknown> | undefined, key: string): T | undefined {\n        if (!obj) return undefined;\n        const pascal = key.charAt(0).toUpperCase() + key.slice(1);\n        const camel = key.charAt(0).toLowerCase() + key.slice(1);\n        return (obj[pascal] ?? obj[camel]) as T | undefined;\n    }\n\n    /**\n     * Try to extract error body from API response.\n     * Returns the parsed body or null if extraction fails.\n     */\n    async #extractErrorBody(err: unknown): Promise<Record<string, unknown> | null> {\n        if (err && typeof err === 'object' && 'response' in err) {\n            const resp = (err as { response: Response }).response;\n            if (resp && typeof resp.json === 'function') {\n                return (await resp.json().catch(() => null)) as Record<string, unknown> | null;\n            }\n        }\n        return null;\n    }\n\n    /**\n     * Throw a CantonProtocolError with extracted error details from API response.\n     * Handles the common pattern of extracting JSON error details from failed requests.\n     *\n     * @param err - The caught error\n     * @param context - Description of the operation (e.g., \"DAR upload\", \"Party allocation\")\n     * @throws CantonProtocolError with extracted error details, or re-throws original error\n     */\n    async #throwApiError(err: unknown, context: string): Promise<never> {\n        const body = await this.#extractErrorBody(err);\n        if (body) {\n            throw new CantonProtocolError(`${context} failed: ${JSON.stringify(body)}`);\n        }\n        throw err;\n    }\n\n    /**\n     * Build party-based filter object for event queries.\n     */\n    #buildPartyFilters(parties: string[], includeCreatedEventBlob: boolean) {\n        return Object.fromEntries(\n            parties.map((p) => [\n                p,\n                {\n                    cumulative: [\n                        {\n                            identifierFilter: {\n                                wildcardFilter: { value: { includeCreatedEventBlob } },\n                            },\n                        },\n                    ],\n                },\n            ]),\n        );\n    }\n\n    /**\n     * Validate and extract disclosure fields from a CreatedEvent.\n     */\n    #validateDisclosureEvent(\n        event: { templateId?: string; contractId?: string; createdEventBlob?: string },\n        contractId: ContractId<unknown>,\n    ): { templateId: string; contractId: string; createdEventBlob: string } {\n        if (!event.templateId) {\n            throw new CantonProtocolError('Disclosure response missing templateId', {\n                contractId,\n            });\n        }\n        if (!event.contractId) {\n            throw new CantonProtocolError('Disclosure response missing contractId', {\n                contractId,\n            });\n        }\n        if (!event.createdEventBlob) {\n            throw new CantonProtocolError('Disclosure response missing createdEventBlob', {\n                contractId,\n            });\n        }\n        return {\n            templateId: event.templateId,\n            contractId: event.contractId,\n            createdEventBlob: event.createdEventBlob,\n        };\n    }\n\n    /**\n     * Validate and extract prepared transaction fields from a prepare response.\n     */\n    #validatePrepareResponse(response: {\n        preparedTransaction?: string;\n        preparedTransactionHash?: string;\n        hashingSchemeVersion?: string;\n    }): {\n        preparedTransaction: string;\n        preparedTransactionHash: string;\n        hashingSchemeVersion: string;\n    } {\n        if (!response.preparedTransaction) {\n            throw new CantonProtocolError('Prepare response missing preparedTransaction');\n        }\n        if (!response.preparedTransactionHash) {\n            throw new CantonProtocolError('Prepare response missing preparedTransactionHash');\n        }\n        if (!response.hashingSchemeVersion) {\n            throw new CantonProtocolError('Prepare response missing hashingSchemeVersion');\n        }\n        return {\n            preparedTransaction: response.preparedTransaction,\n            preparedTransactionHash: response.preparedTransactionHash,\n            hashingSchemeVersion: response.hashingSchemeVersion,\n        };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Synchronizer Discovery\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Returns all connected synchronizer IDs.\n     */\n    async connectedSynchronizers(): Promise<string[]> {\n        const response = await this.#api.getV2StateConnectedSynchronizers();\n        const synchronizers = response.connectedSynchronizers ?? [];\n        return synchronizers.map((s) => s.synchronizerId).filter((id): id is string => !!id);\n    }\n\n    /**\n     * Internal: ensures we have a cached synchronizer ID, fetching if needed.\n     */\n    #ensureSynchronizerId = once(async (): Promise<string> => {\n        const [id] = await this.connectedSynchronizers();\n\n        if (!id) {\n            throw new CantonTransportError('No connected synchronizers found');\n        }\n\n        return id;\n    });\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // DAR Upload / Validation\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Upload a DAR (Daml Archive) to the participant node.\n     *\n     * @param dar - Raw DAR bytes.\n     * @param opts.vetAllPackages - Whether to vet all packages in the DAR.\n     * @param opts.synchronizerId - Synchronizer to upload to (auto-detected if omitted).\n     * @param opts.skipIfVetted - If true, silently succeeds when the DAR is already vetted.\n     */\n    async uploadDar(\n        dar: Uint8Array<ArrayBuffer>,\n        opts: { vetAllPackages?: boolean; synchronizerId?: string; skipIfVetted?: boolean } = {},\n    ): Promise<object> {\n        // Extract the underlying ArrayBuffer, handling views that don't start at offset 0\n        const bytes =\n            dar.byteOffset === 0 && dar.byteLength === dar.buffer.byteLength\n                ? dar.buffer\n                : dar.buffer.slice(dar.byteOffset, dar.byteOffset + dar.byteLength);\n        const body = new Blob([bytes], { type: 'application/octet-stream' });\n        const synchronizerId = opts.synchronizerId ?? (await this.#ensureSynchronizerId());\n        const request: PostV2DarsRequest = {\n            body,\n            vetAllPackages: opts.vetAllPackages,\n            synchronizerId,\n        };\n\n        try {\n            return await this.#api.postV2Dars(request);\n        } catch (err: unknown) {\n            // If skipIfVetted, treat KNOWN_PACKAGE_VERSION as a no-op success\n            if (opts.skipIfVetted) {\n                const body = await this.#extractErrorBody(err);\n                if (body) {\n                    if (body.code === 'KNOWN_PACKAGE_VERSION') {\n                        return { skipped: true, reason: 'already_vetted', details: body };\n                    }\n                    throw new CantonProtocolError(`DAR upload failed: ${JSON.stringify(body)}`);\n                }\n            }\n            throw await this.#throwApiError(err, 'DAR upload');\n        }\n    }\n\n    /**\n     * Validate a DAR against the participant without uploading it.\n     *\n     * @param dar - Raw DAR bytes.\n     * @param opts.synchronizerId - Synchronizer to validate against (auto-detected if omitted).\n     */\n    async validateDar(\n        dar: Uint8Array<ArrayBuffer>,\n        opts: { synchronizerId?: string } = {},\n    ): Promise<void> {\n        const bytes =\n            dar.byteOffset === 0 && dar.byteLength === dar.buffer.byteLength\n                ? dar.buffer\n                : dar.buffer.slice(dar.byteOffset, dar.byteOffset + dar.byteLength);\n        const body = new Blob([bytes], { type: 'application/octet-stream' });\n        const request: PostV2DarsValidateRequest = {\n            body,\n            synchronizerId: opts.synchronizerId,\n        };\n\n        if (!request.synchronizerId) {\n            return this.#ensureSynchronizerId().then((synchronizerId) =>\n                this.#api.postV2DarsValidate({ ...request, synchronizerId }),\n            );\n        }\n\n        return this.#api.postV2DarsValidate(request);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Party Management\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * List all known parties on the participant node.\n     *\n     * @param opts.pageSize - Maximum number of results per page\n     * @param opts.pageToken - Pagination token from previous response\n     * @returns Array of party IDs and pagination token\n     */\n    async listParties(\n        opts: { pageSize?: number; pageToken?: string } = {},\n    ): Promise<{ parties: string[]; nextPageToken: string }> {\n        const response = await this.#api.getV2Parties({\n            pageSize: opts.pageSize,\n            pageToken: opts.pageToken,\n        });\n\n        return {\n            parties: response.partyDetails?.map((p) => p.party) ?? [],\n            nextPageToken: response.nextPageToken,\n        };\n    }\n\n    /**\n     * Return the rights granted to the current user (this.#userId).\n     *\n     * Bypasses the OpenAPI generator's typed `Kind` converter, which is\n     * broken: `instanceOfKindOneOf` checks lowercase `canActAs in value`, but\n     * `KindOneOfFromJSONTyped` reads uppercase `json['CanActAs']`, so the\n     * typed client returns every `kind` as `{}`. We parse the raw JSON\n     * ourselves to preserve the actual variant payload.\n     */\n    async listUserRights(): Promise<UserRight[]> {\n        const apiResponse = await this.#api.getV2UsersUserIdRightsRaw({\n            userId: this.#userId,\n        });\n        const raw = (await apiResponse.raw.json()) as { rights?: UserRight[] };\n        return raw.rights ?? [];\n    }\n\n    /**\n     * Return the parties the current user has CanActAs or CanReadAs rights\n     * for. Convenience wrapper over `listUserRights()` for the common case\n     * where the caller just needs party-scoped access (e.g. to query events\n     * or fetch transactions).\n     *\n     * Use this instead of `listParties()` when the caller only has scoped\n     * rights — `listParties()` returns *all* parties on the participant\n     * (including DSO, splice parties), and Canton returns 403 if you query\n     * as a party you can't read.\n     */\n    async listUserParties(): Promise<string[]> {\n        const rights = await this.listUserRights();\n        const parties = new Set<string>();\n        for (const right of rights) {\n            // Only `CanActAs` / `CanReadAs` carry a party; the other four\n            // variants (ParticipantAdmin, IdentityProviderAdmin,\n            // CanReadAsAnyParty, CanExecuteAsAnyParty) have empty payloads.\n            const party = right.kind.CanActAs?.value.party ?? right.kind.CanReadAs?.value.party;\n            if (party !== undefined) {\n                parties.add(party);\n            }\n        }\n        return [...parties];\n    }\n\n    /**\n     * Allocate a new party on the participant node.\n     *\n     * @param partyIdHint - A hint for the party ID (e.g., \"alice\", \"bob\")\n     * @param opts.userId - User who gets actAs rights (empty string = no user)\n     * @param opts.synchronizerId - Synchronizer to allocate on (auto-detected if omitted)\n     * @param opts.identityProviderId - Identity provider ID (empty string = default)\n     * @returns The allocated party ID\n     */\n    async allocateParty(\n        partyIdHint: string,\n        opts: { userId?: string; synchronizerId?: string; identityProviderId?: string } = {},\n    ): Promise<string> {\n        const synchronizerId = opts.synchronizerId ?? (await this.#ensureSynchronizerId());\n\n        let response;\n        try {\n            response = await this.#api.postV2Parties({\n                allocatePartyRequest: {\n                    partyIdHint,\n                    synchronizerId,\n                    userId: opts.userId ?? '',\n                    identityProviderId: opts.identityProviderId ?? '',\n                },\n            });\n        } catch (err: unknown) {\n            throw await this.#throwApiError(err, 'Party allocation');\n        }\n\n        const party = response.partyDetails?.party;\n        if (!party) {\n            throw new CantonProtocolError('Party allocation response missing party ID');\n        }\n\n        return party;\n    }\n\n    /**\n     * Get the package ID for a package by name.\n     *\n     * @param packageName - The package name (e.g., \"layerzero-oft\")\n     * @param parties - Parties whose vetting state should be considered\n     * @param opts.synchronizerId - Synchronizer to query (auto-detected if omitted)\n     * @returns The package ID (hash)\n     */\n    async getPackageId(\n        packageName: string,\n        parties: string[],\n        opts: { synchronizerId?: string } = {},\n    ): Promise<string> {\n        const synchronizerId = opts.synchronizerId ?? (await this.#ensureSynchronizerId());\n\n        const request: PostV2InteractiveSubmissionPreferredPackagesRequest = {\n            getPreferredPackagesRequest: {\n                packageVettingRequirements: [\n                    {\n                        packageName,\n                        parties,\n                    },\n                ],\n                synchronizerId,\n            },\n        };\n\n        let response;\n        try {\n            response = await this.#api.postV2InteractiveSubmissionPreferredPackages(request);\n        } catch (err: unknown) {\n            throw await this.#throwApiError(err, 'Package lookup');\n        }\n\n        const packageRef = response.packageReferences?.find(\n            (ref) => ref.packageName === packageName,\n        );\n        if (!packageRef?.packageId) {\n            throw new CantonProtocolError(\n                `Package \"${packageName}\" not found or not vetted for parties`,\n            );\n        }\n\n        return packageRef.packageId;\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Command Submission\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Submit a batch of commands atomically.\n     *\n     * @returns commandId and completionOffset for use with waitForCommand()\n     */\n    async submit(\n        actors: SubmitActors,\n        commands: Command[],\n        opts: { disclosedContracts?: DisclosedContract[]; commandId?: string } = {},\n    ): Promise<SubmitResult> {\n        const synchronizerId = await this.#ensureSynchronizerId();\n        const commandId = opts.commandId ?? randomUUID();\n\n        // Snapshot ledger end before submission so waitForCommand knows where to start polling\n        const ledgerEndResponse = await this.#api.getV2StateLedgerEnd();\n        const completionOffset = ledgerEndResponse.offset;\n\n        const request: PostV2CommandsAsyncSubmitRequest = {\n            jsCommands: {\n                commandId,\n                actAs: actors.actAs,\n                readAs: actors.readAs ?? actors.actAs,\n                userId: this.#userId,\n                synchronizerId,\n                commands,\n                disclosedContracts: opts.disclosedContracts,\n            },\n        };\n\n        try {\n            await this.#api.postV2CommandsAsyncSubmit(request);\n        } catch (err: unknown) {\n            throw await this.#throwApiError(err, 'Command submission');\n        }\n\n        return { commandId, completionOffset };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Completion Waiting / Reconciliation\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Wait for a command to be accepted or rejected.\n     *\n     * Uses bounded exponential backoff to avoid hammering the participant.\n     */\n    async waitForCommand(commandId: string, opts: WaitOptions): Promise<WaitResult> {\n        const { parties, timeoutMs = 30_000, poll = {} } = opts;\n\n        const limit = poll.limit ?? 50;\n        const streamIdleTimeoutMs = poll.streamIdleTimeoutMs ?? 1000;\n        const initialBackoffMs = poll.backoffMs?.initial ?? 100;\n        const maxBackoffMs = poll.backoffMs?.max ?? 5000;\n\n        let beginExclusive = opts.beginExclusive ?? 0;\n        let currentBackoff = initialBackoffMs;\n        const deadline = Date.now() + timeoutMs;\n\n        // Poll the completions stream until we find our commandId or timeout\n        while (Date.now() < deadline) {\n            const request: PostV2CommandsCompletionsRequest = {\n                completionStreamRequest: {\n                    beginExclusive,\n                    parties,\n                    userId: this.#userId,\n                },\n                limit,\n                streamIdleTimeoutMs,\n            };\n\n            const rawResponse = await this.#api.postV2CommandsCompletionsRaw(request);\n            const responseText = await rawResponse.raw.text();\n            const completions = JSON.parse(responseText) as unknown[];\n\n            // Scan each completion for our commandId\n            for (const item of completions) {\n                const normalized = item as Record<string, unknown>;\n                const completionResponse = this.#getField<Record<string, unknown>>(\n                    normalized,\n                    'completionResponse',\n                );\n                if (!completionResponse) continue;\n\n                // Handle offsetCheckpoint responses (no commandId)\n                const offsetCheckpoint = this.#getField<Record<string, unknown>>(\n                    completionResponse,\n                    'offsetCheckpoint',\n                );\n                if (offsetCheckpoint) {\n                    const checkpoint =\n                        this.#getField<Record<string, unknown>>(offsetCheckpoint, 'value') ??\n                        offsetCheckpoint;\n                    const checkpointOffset = this.#getField<number>(checkpoint, 'offset');\n                    if (checkpointOffset !== undefined) {\n                        beginExclusive = Math.max(beginExclusive, checkpointOffset);\n                    }\n                    continue;\n                }\n\n                // Navigate: completionResponse.completion.value\n                const completionWrapper = this.#getField<Record<string, unknown>>(\n                    completionResponse,\n                    'completion',\n                );\n                const completion =\n                    this.#getField<Record<string, unknown>>(completionWrapper, 'value') ??\n                    completionWrapper;\n                if (!completion) continue;\n\n                const offset = this.#getField<number>(completion, 'offset');\n                const completionCommandId = this.#getField<string>(completion, 'commandId');\n\n                // Found our command — check gRPC status to determine accept/reject\n                if (completionCommandId === commandId) {\n                    const status = this.#getField<{\n                        code?: number;\n                        message?: string;\n                        details?: unknown;\n                    }>(completion, 'status');\n\n                    // code === 0 or status undefined means success (gRPC OK)\n                    if (!status || status.code === 0) {\n                        return {\n                            status: 'accepted',\n                            commandId,\n                            updateId: this.#getField<string>(completion, 'updateId') ?? '',\n                            offset: offset ?? 0,\n                        };\n                    } else {\n                        return {\n                            status: 'rejected',\n                            commandId,\n                            offset: offset ?? 0,\n                            error: {\n                                code: status.code,\n                                message: status.message ?? 'Unknown rejection',\n                                details: status.details,\n                            },\n                        };\n                    }\n                }\n\n                // Not our command — advance offset cursor past it\n                if (offset !== undefined) {\n                    beginExclusive = Math.max(beginExclusive, offset);\n                }\n            }\n\n            // Bounded exponential backoff\n            const remainingTime = deadline - Date.now();\n            const sleepTime = Math.min(currentBackoff, remainingTime, maxBackoffMs);\n            if (sleepTime > 0) {\n                await new Promise((resolve) => setTimeout(resolve, sleepTime));\n            }\n            currentBackoff = Math.min(currentBackoff * 2, maxBackoffMs);\n        }\n\n        return { status: 'timeout', commandId, lastCheckedOffset: beginExclusive };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Disclosed Contracts\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Fetch active contract's created event by ID.\n     * Returns undefined if contract doesn't exist or is archived.\n     */\n    async #fetchActiveContractEvent(\n        contractId: ContractId<unknown>,\n        parties: string[],\n        includeCreatedEventBlob: boolean,\n    ): Promise<CreatedEvent | undefined> {\n        const request: PostV2EventsEventsByContractIdRequest = {\n            getEventsByContractIdRequest: {\n                contractId,\n                eventFormat: {\n                    filtersByParty: this.#buildPartyFilters(parties, includeCreatedEventBlob),\n                    verbose: false,\n                },\n            },\n        };\n\n        const response = await this.#api.postV2EventsEventsByContractId(request);\n\n        // If archived, contract is not active\n        if (response.archived) return undefined;\n\n        return response.created?.createdEvent;\n    }\n\n    /**\n     * Build a disclosure for a contract.\n     *\n     * @param contractId - The contract ID to create disclosure for\n     * @param parties - Parties that have visibility to the contract\n     * @returns DisclosedContract if visible, undefined if not found\n     * @throws CantonProtocolError if contract visible but blob missing (server/config mismatch)\n     */\n    async createDisclosure(\n        contractId: ContractId<unknown>,\n        parties: string[],\n    ): Promise<DisclosedContract | undefined> {\n        const synchronizerId = await this.#ensureSynchronizerId();\n        const created = await this.#fetchActiveContractEvent(contractId, parties, true);\n\n        if (!created) return undefined;\n\n        const validated = this.#validateDisclosureEvent(created, contractId);\n        return {\n            ...validated,\n            synchronizerId,\n        };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Internal: Active Contract Queries (used by CantonSdk)\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Fetch a single contract by ID.\n     *\n     * @param contractId The contract ID to fetch\n     * @param parties Parties to use for filtering (required for non-admin tokens)\n     */\n    async fetchContractById(\n        contractId: ContractId<unknown>,\n        parties: string[],\n    ): Promise<CreatedEvent | undefined> {\n        return this.#fetchActiveContractEvent(contractId, parties, false);\n    }\n\n    /**\n     * Fetch both the created and archived events for a contract by ID.\n     * Unlike fetchContractById, this preserves archival information.\n     */\n    async fetchEventsByContractId(\n        contractId: string,\n        parties: string[],\n    ): Promise<{ created: CreatedEvent | undefined; archived: ArchivedEvent | undefined }> {\n        const request: PostV2EventsEventsByContractIdRequest = {\n            getEventsByContractIdRequest: {\n                contractId,\n                eventFormat: {\n                    filtersByParty: this.#buildPartyFilters(parties, false),\n                    verbose: false,\n                },\n            },\n        };\n\n        const response = await this.#api.postV2EventsEventsByContractId(request);\n\n        return {\n            created: response.created?.createdEvent,\n            archived: response.archived?.archivedEvent,\n        };\n    }\n\n    /**\n     * Fetch an update (transaction) by its ID.\n     * @param updateId The update ID from a completion\n     * @param parties Parties to use for the query filter\n     * @returns The full update response\n     */\n    async fetchTransactionByUpdateId(\n        updateId: string,\n        parties: string[],\n    ): Promise<CantonTransaction> {\n        const response = await this.#api.postV2UpdatesUpdateByIdRaw({\n            getUpdateByIdRequest: {\n                updateId,\n                updateFormat: this.#buildUpdateFormat(parties),\n            },\n        });\n\n        const updateResponse: CantonUpdateResponse = await response.raw.json();\n        return this.#parseTransactionFromUpdate(\n            updateResponse,\n            `Update ${updateId} is not a transaction`,\n        );\n    }\n\n    /**\n     * Fetch a transaction by its offset.\n     * @param offset - The ledger offset\n     * @param parties - Parties to use for the query filter\n     * @returns The full transaction including recordTime\n     */\n    async fetchTransactionByOffset(offset: number, parties: string[]): Promise<CantonTransaction> {\n        const response = await this.#api.postV2UpdatesUpdateByOffsetRaw({\n            getUpdateByOffsetRequest: {\n                offset,\n                updateFormat: this.#buildUpdateFormat(parties),\n            },\n        });\n\n        const updateResponse: CantonUpdateResponse = await response.raw.json();\n        return this.#parseTransactionFromUpdate(\n            updateResponse,\n            `Update at offset ${offset} is not a transaction`,\n        );\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // External Party / Interactive Submission\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Prepare commands for external party signing.\n     *\n     * Returns a typed PreparedTransaction that preserves the contract type\n     * through the signing flow. After signing, use submitSigned() to submit.\n     *\n     * @typeparam T The contract payload type (phantom type for type safety)\n     *\n     * @example\n     * ```ts\n     * const prepared = await client.prepareForSigning<Oft>({ actAs: [party] }, [cmd]);\n     * const signature = await sign(prepared.preparedTransactionHash);\n     * await client.submitSigned(prepared, [signature]);\n     * ```\n     */\n    async prepareForSigning(\n        actors: SubmitActors,\n        commands: Command[],\n        opts: { disclosedContracts?: DisclosedContract[]; commandId?: string } = {},\n    ): Promise<PreparedTransaction> {\n        const synchronizerId = await this.#ensureSynchronizerId();\n        const commandId = opts.commandId ?? randomUUID();\n\n        const request: PostV2InteractiveSubmissionPrepareRequest = {\n            jsPrepareSubmissionRequest: {\n                userId: this.#userId,\n                commandId,\n                commands,\n                actAs: actors.actAs,\n                readAs: actors.readAs ?? actors.actAs,\n                disclosedContracts: opts.disclosedContracts,\n                synchronizerId,\n                verboseHashing: false,\n                packageIdSelectionPreference: [],\n            },\n        };\n\n        let response;\n        try {\n            response = await this.#api.postV2InteractiveSubmissionPrepare(request);\n        } catch (error: unknown) {\n            throw await this.#throwApiError(error, 'Interactive submission prepare');\n        }\n        const validated = this.#validatePrepareResponse(response);\n\n        return {\n            ...validated,\n            hashingSchemeVersion:\n                validated.hashingSchemeVersion as PreparedTransaction['hashingSchemeVersion'],\n            commandId,\n        };\n    }\n\n    /**\n     * Submit a pre-signed transaction.\n     *\n     * The generic type T flows from prepareForSigning() for type documentation.\n     */\n    async submitSigned(\n        prepared: PreparedTransaction,\n        signatures: ExternalSignature[],\n    ): Promise<SubmitResult> {\n        // Snapshot ledger end so the caller can poll for completion from this point\n        const ledgerEndResponse = await this.#api.getV2StateLedgerEnd();\n        const completionOffset = ledgerEndResponse.offset;\n\n        const request: PostV2InteractiveSubmissionExecuteRequest = {\n            jsExecuteSubmissionRequest: {\n                preparedTransaction: prepared.preparedTransaction,\n                // Map each ExternalSignature into the Canton per-party signature format\n                partySignatures: {\n                    signatures: signatures.map((sig) => ({\n                        party: sig.party,\n                        signatures: [\n                            {\n                                format: sig.format,\n                                signature: sig.signature,\n                                signedBy: sig.signedBy,\n                                signingAlgorithmSpec: sig.signingAlgorithmSpec,\n                            },\n                        ],\n                    })),\n                },\n                deduplicationPeriod: {\n                    deduplicationDuration: {\n                        value: { seconds: 3600, nanos: 0 }, // 1 hour default\n                    },\n                },\n                submissionId: randomUUID(),\n                userId: this.#userId,\n                hashingSchemeVersion: prepared.hashingSchemeVersion,\n            },\n        };\n\n        try {\n            await this.#api.postV2InteractiveSubmissionExecute(request);\n        } catch (error: unknown) {\n            throw await this.#throwApiError(error, 'Interactive submission execute');\n        }\n\n        return { commandId: prepared.commandId, completionOffset };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Active Contracts Query\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Get the current ledger end offset.\n     */\n    async getLedgerEndOffset(): Promise<number> {\n        const response = await this.#api.getV2StateLedgerEnd();\n        return response.offset;\n    }\n\n    /**\n     * Query active contracts at a given offset with optional template filtering.\n     *\n     * @param party - Party to query as\n     * @param offset - Ledger offset for the snapshot\n     * @param opts.templateIds - Optional template IDs to filter by\n     * @param opts.limit - Maximum number of contracts to return\n     */\n    async queryActiveContracts(\n        party: string,\n        offset: number,\n        opts?: { templateIds?: string[]; limit?: number },\n    ): Promise<JsActiveContract[]> {\n        return this.queryActiveContractsByParties([party], offset, opts?.templateIds ?? [], {\n            limit: opts?.limit,\n        });\n    }\n\n    /**\n     * Query active contracts visible to any of the given parties.\n     *\n     * Single API call with all parties in filtersByParty.\n     *\n     * @param parties - Parties to query as (for visibility)\n     * @param offset - Ledger offset for the snapshot\n     * @param templateIds - Template IDs to filter by\n     * @param opts.limit - Maximum number of contracts to return\n     */\n    async queryActiveContractsByParties(\n        parties: string[],\n        offset: number,\n        templateIds: string[],\n        opts?: { limit?: number },\n    ): Promise<JsActiveContract[]> {\n        return this.#fetchActiveContracts(\n            parties,\n            offset,\n            this.#buildCumulativeFilters(templateIds),\n            opts,\n        );\n    }\n\n    /**\n     * Query active contracts visible to any of the given parties that implement\n     * the given interfaces.\n     *\n     * @param parties - Parties to query as (for visibility)\n     * @param offset - Ledger offset for the snapshot\n     * @param interfaceIds - Interface IDs to filter by (e.g. \"#package:Module:Interface\")\n     * @param opts.limit - Maximum number of contracts to return\n     */\n    async queryActiveContractsByInterface(\n        parties: string[],\n        offset: number,\n        interfaceIds: string[],\n        opts?: { limit?: number },\n    ): Promise<JsActiveContract[]> {\n        return this.#fetchActiveContracts(\n            parties,\n            offset,\n            this.#buildInterfaceCumulativeFilters(interfaceIds),\n            opts,\n        );\n    }\n\n    async #fetchActiveContracts(\n        parties: string[],\n        offset: number,\n        cumulativeFilter: CumulativeFilter[],\n        opts?: { limit?: number },\n    ): Promise<JsActiveContract[]> {\n        const filtersByParty = Object.fromEntries(\n            parties.map((party) => [party, { cumulative: cumulativeFilter }]),\n        );\n\n        const rawResponse = await this.#api.postV2StateActiveContractsRaw({\n            getActiveContractsRequest: {\n                filter: { filtersByParty },\n                verbose: true,\n                activeAtOffset: offset,\n            },\n            limit: opts?.limit,\n        });\n\n        // Raw response is an array of streamed entries; extract and deserialize contracts\n        type RawActiveContractsResponse = Array<{\n            contractEntry?: { JsActiveContract?: Record<string, unknown> };\n        }>;\n        const rawJson: RawActiveContractsResponse = await rawResponse.raw.json();\n\n        return rawJson\n            .map((item) => item.contractEntry?.JsActiveContract)\n            .filter((contract): contract is Record<string, unknown> => contract != null)\n            .map((contract) => JsActiveContractFromJSON(contract));\n    }\n\n    /**\n     * Stream transactions from a given offset.\n     *\n     * Uses `updateFormat` with `TRANSACTION_SHAPE_LEDGER_EFFECTS` so consumers\n     * receive `ExercisedEvent`s (e.g. the request-poller depends on\n     * `Request_Create` exercise results). The deprecated legacy `filter`\n     * shape would default to `ACS_DELTA`, which only emits Created/Archived\n     * events and silently drops every exercise on the wire.\n     *\n     * @param party - Party to query as\n     * @param beginExclusive - Start offset (exclusive)\n     * @param endInclusive - End offset (inclusive)\n     * @param opts.templateIds - Optional template IDs to filter by\n     * @param opts.limit - Maximum number of transactions to return\n     */\n    async getUpdates(\n        party: string,\n        beginExclusive: number,\n        endInclusive: number,\n        opts?: { templateIds?: string[]; limit?: number },\n    ): Promise<CantonUpdate[]> {\n        const eventFormat = {\n            filtersByParty: {\n                [party]: { cumulative: this.#buildCumulativeFilters(opts?.templateIds) },\n            },\n            verbose: false,\n        };\n        const rawResponse = await this.#api.postV2UpdatesRaw({\n            getUpdatesRequest: {\n                beginExclusive,\n                endInclusive,\n                verbose: false,\n                updateFormat: {\n                    includeTransactions: {\n                        eventFormat,\n                        transactionShape: 'TRANSACTION_SHAPE_LEDGER_EFFECTS' as const,\n                    },\n                },\n            },\n            limit: opts?.limit,\n        });\n\n        const updateResponses: CantonUpdateResponse[] = await rawResponse.raw.json();\n\n        return updateResponses.map((response) => response.update);\n    }\n\n    /**\n     * Build cumulative filters for party-based queries.\n     * If templateIds provided, filters by those templates; otherwise uses wildcard.\n     */\n    #buildCumulativeFilters(templateIds?: string[]): CumulativeFilter[] {\n        if (templateIds?.length) {\n            return templateIds.map((templateId) => ({\n                identifierFilter: {\n                    templateFilter: { value: { templateId, includeCreatedEventBlob: false } },\n                },\n            }));\n        }\n        return [\n            { identifierFilter: { wildcardFilter: { value: { includeCreatedEventBlob: false } } } },\n        ];\n    }\n\n    /**\n     * Build cumulative filters for interface-based ACS queries.\n     * If interfaceIds provided, filters by those interfaces; otherwise uses wildcard.\n     */\n    #buildInterfaceCumulativeFilters(interfaceIds?: string[]): CumulativeFilter[] {\n        if (interfaceIds?.length) {\n            return interfaceIds.map((interfaceId) => ({\n                identifierFilter: {\n                    interfaceFilter: {\n                        value: {\n                            interfaceId,\n                            includeInterfaceView: true,\n                            includeCreatedEventBlob: false,\n                        },\n                    },\n                },\n            }));\n        }\n        return [\n            { identifierFilter: { wildcardFilter: { value: { includeCreatedEventBlob: false } } } },\n        ];\n    }\n\n    /**\n     * Build the standard update format for fetching transactions.\n     */\n    #buildUpdateFormat(parties: string[]) {\n        return {\n            includeTransactions: {\n                eventFormat: {\n                    filtersByParty: this.#buildPartyFilters(parties, false),\n                    verbose: false,\n                },\n                transactionShape: 'TRANSACTION_SHAPE_LEDGER_EFFECTS' as const,\n            },\n        };\n    }\n\n    /**\n     * Parse an update response and extract the transaction.\n     * The response structure is: { update: { Transaction: { value: CantonTransaction } } }\n     */\n    #parseTransactionFromUpdate(\n        json: CantonUpdateResponse,\n        notFoundMessage: string,\n    ): CantonTransaction {\n        // Update can be a Transaction, Reassignment, TopologyTransaction, or OffsetCheckpoint\n        if (!('Transaction' in json.update)) {\n            throw new CantonProtocolError(notFoundMessage);\n        }\n\n        return json.update.Transaction.value;\n    }\n}\n"]}