@layerzerolabs/common-canton 1.2.78 → 1.2.79

package/dist/sdk/index.js

@@ -1,5 +1,5 @@
 import '../5GUYLHA7.js';
-export { CantonSdk } from '../RQQM2SSD.js';
+export { CantonSdk } from '../ZBLS2HTS.js';
 import '../3K5JL2TP.js';
 import '../VUOMXK5T.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-canton",
-  "version": "1.2.78",
+  "version": "1.2.79",
   "private": false,
   "description": "Canton VM client and utilities",
   "license": "MIT",
@@ -32,10 +32,10 @@
     "@canton-network/core-ledger-proto": "^1.7.0",
     "@daml/types": "3.4.8",
     "@grpc/grpc-js": "^1.12.0",
-    "@layerzerolabs/common-chain-model": "1.2.78",
-    "@layerzerolabs/common-encoding-utils": "1.2.78",
-    "@layerzerolabs/common-error-utils": "1.2.78",
-    "@layerzerolabs/typescript-utils": "1.2.78",
+    "@layerzerolabs/common-chain-model": "1.2.79",
+    "@layerzerolabs/common-encoding-utils": "1.2.79",
+    "@layerzerolabs/common-error-utils": "1.2.79",
+    "@layerzerolabs/typescript-utils": "1.2.79",
     "@mojotech/json-type-validation": "^3.1.0",
     "@noble/hashes": "^1.8.0",
     "@noble/secp256k1": "1.7.1",
@@ -46,11 +46,11 @@
     "zod": "4.3.5"
   },
   "devDependencies": {
-    "@layerzerolabs/eslint-configuration": "^1.2.78",
-    "@layerzerolabs/tsup-configuration": "1.2.78",
-    "@layerzerolabs/typescript-configuration": "1.2.78",
-    "@layerzerolabs/vitest-configuration": "1.2.78",
-    "@layerzerolabs/vm-tooling-canton": "1.2.78",
+    "@layerzerolabs/eslint-configuration": "^1.2.79",
+    "@layerzerolabs/tsup-configuration": "1.2.79",
+    "@layerzerolabs/typescript-configuration": "1.2.79",
+    "@layerzerolabs/vitest-configuration": "1.2.79",
+    "@layerzerolabs/vm-tooling-canton": "1.2.79",
     "@vitest/coverage-v8": "4.1.10",
     "eslint": "9.39.1",
     "tsup": "^8.4.0",

package/dist/NMGEBYN4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/refresh/address-resolver.ts"],"names":["isAmuletHoldingTemplateId","templateId","endsWith","isConcreteActiveContractRef","ref","type","partyToFilter","CANTON_DEFERRED_SENDER","matchesContractStateFilter","contract","contractStateFilter","createArgument","createdEvent","Object","entries","every","key","value","actual","getCreateArgumentField","undefined","JSON","stringify","resolveExpectedSignatories","expectedSignatories","queryParty","length","map","party","isCantonDeferredSender","resolveContractStateFilter","fromEntries","isRefAlive","client","contracts","queryLiveContractsForRef","interfaceId","startsWith","packageName","moduleName","entityName","extra","slice","split","Error","packageId","getPackageId","offset","getLedgerEndOffset","queryActiveContractsByInterface","includeCreatedEventBlob","queryActiveContracts","templateIds","filter","areExpectedSignatories","views","interfaceViews","view","viewValue","viewStatus","code","queryLiveContractIdsForRef","senderParty","c","contractId","createContractAddressResolver","deps","signingParties","appendDisclosures","requireSender","resolveQueryParty","queryCache","Map","queryAsParty","cacheKey","cached","get","query","set","needsDisclosure","stakeholders","Set","signatories","observers","some","has","discloseContracts","toDisclose","disclosures","createdEventBlob","synchronizerId","resolveActiveContractId","resolveActiveContractIds","resolveActiveContracts","discloseActiveContracts","requireSenderParty"],"mappings":"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","file":"NMGEBYN4.js","sourcesContent":["import type { ICantonClient } from '../client/interface';\nimport {\n    CANTON_DEFERRED_SENDER,\n    type CantonDeferredValue,\n    isCantonDeferredSender,\n} from '../deferredValue';\nimport type { JsActiveContract } from '../open-api/models';\nimport type { CantonDisclosedContract } from '../transaction';\nimport { areExpectedSignatories, getCreateArgumentField } from '../trusted-origin';\n\n/** CIP-56 Amulet holding — DSO is the sole signatory; owner is payload/observer. */\nconst isAmuletHoldingTemplateId = (templateId: string): boolean =>\n    templateId.endsWith(':Splice.Amulet:Amulet');\n\nexport type ActiveContractRef = Extract<\n    CantonDeferredValue,\n    { type: 'activeContractId' | 'activeContractIds' }\n> & { interfaceId?: string };\n\n/** Active-contract ref whose handler party is concrete (not the sender sentinel). */\nexport type ConcreteActiveContractRef = ActiveContractRef & {\n    partyToFilter: { party: string };\n};\n\nexport const isConcreteActiveContractRef = (\n    ref: CantonDeferredValue,\n): ref is ConcreteActiveContractRef =>\n    (ref.type === 'activeContractId' || ref.type === 'activeContractIds') &&\n    ref.partyToFilter !== CANTON_DEFERRED_SENDER;\n\nexport interface ContractAddressResolverDeps {\n    client: ICantonClient;\n    senderParty?: string;\n    /** A contract is only disclosed when none of these parties is already a stakeholder on it. */\n    signingParties: string[];\n    appendDisclosures: (disclosures: CantonDisclosedContract[]) => void;\n}\n\n/**\n * Match create-argument fields, including dotted paths (`instrumentId.admin`).\n */\nexport const matchesContractStateFilter = (\n    contract: JsActiveContract,\n    contractStateFilter: ActiveContractRef['contractStateFilter'],\n): boolean => {\n    if (!contractStateFilter) return true;\n    const createArgument = contract.createdEvent.createArgument;\n    return Object.entries(contractStateFilter).every(([key, value]) => {\n        const actual = getCreateArgumentField(createArgument, key);\n        // Missing / unresolvable paths must not match (fail closed).\n        if (actual === undefined) return false;\n        return JSON.stringify(actual) === JSON.stringify(value);\n    });\n};\n\n/**\n * Resolve {@link CANTON_DEFERRED_SENDER} entries to the ACS query party.\n * Missing lists default to `[queryParty]` except CIP-56 Amulet holdings, where\n * the owner is not a signatory — omit the filter so pre-PR refs still resolve.\n */\nexport const resolveExpectedSignatories = (\n    expectedSignatories: readonly string[] | undefined,\n    queryParty: string,\n    templateId: string,\n): string[] | undefined => {\n    if (expectedSignatories?.length) {\n        return expectedSignatories.map((party) =>\n            isCantonDeferredSender(party) ? queryParty : party,\n        );\n    }\n    if (isAmuletHoldingTemplateId(templateId)) {\n        return undefined;\n    }\n    return [queryParty];\n};\n\n/** Resolve {@link CANTON_DEFERRED_SENDER} values in `contractStateFilter` to the ACS query party. */\nexport const resolveContractStateFilter = (\n    contractStateFilter: ActiveContractRef['contractStateFilter'],\n    queryParty: string,\n): ActiveContractRef['contractStateFilter'] => {\n    if (!contractStateFilter) return contractStateFilter;\n    return Object.fromEntries(\n        Object.entries(contractStateFilter).map(([key, value]) => [\n            key,\n            isCantonDeferredSender(value) ? queryParty : value,\n        ]),\n    );\n};\n\nexport const isRefAlive = async (\n    client: ICantonClient,\n    ref: CantonDeferredValue,\n): Promise<boolean> => {\n    if (!isConcreteActiveContractRef(ref)) return false;\n    const contracts = await queryLiveContractsForRef(client, ref.partyToFilter.party, ref);\n    return ref.type === 'activeContractId' ? contracts.length === 1 : contracts.length > 0;\n};\n\n/**\n * Query ACS for `party` + template, apply state filter, then\n * authenticate-then-count: keep only contracts where every resolved\n * `expectedSignatories` entry is a ledger signatory.\n *\n * `partyToFilter` is visibility (may be an observer). `expectedSignatories` is\n * authority (defaults to the query party when omitted, except Amulet holdings).\n * Optional `contractStateFilter` disambiguates / binds payload roles (supports\n * dotted paths; {@link CANTON_DEFERRED_SENDER} values resolve).\n */\nexport const queryLiveContractsForRef = async (\n    client: ICantonClient,\n    party: string,\n    ref: ActiveContractRef,\n): Promise<JsActiveContract[]> => {\n    let interfaceId = ref.interfaceId;\n    if (interfaceId?.startsWith('#')) {\n        const [packageName, moduleName, entityName, ...extra] = interfaceId.slice(1).split(':');\n        if (!packageName || !moduleName || !entityName || extra.length) {\n            throw new Error(`Invalid package-name-qualified interface ID: ${interfaceId}`);\n        }\n        const packageId = await client.getPackageId(packageName, [party]);\n        interfaceId = `${packageId}:${moduleName}:${entityName}`;\n    }\n    const offset = await client.getLedgerEndOffset();\n    const expectedSignatories = resolveExpectedSignatories(\n        ref.expectedSignatories,\n        party,\n        ref.templateId,\n    );\n    const contractStateFilter = resolveContractStateFilter(ref.contractStateFilter, party);\n    const contracts = interfaceId\n        ? await client.queryActiveContractsByInterface([party], offset, [interfaceId], {\n              includeCreatedEventBlob: true,\n          })\n        : await client.queryActiveContracts(party, offset, {\n              templateIds: [ref.templateId],\n              includeCreatedEventBlob: true,\n          });\n    return contracts.filter((contract) => {\n        if (\n            expectedSignatories !== undefined &&\n            !areExpectedSignatories(contract.createdEvent, expectedSignatories)\n        )\n            return false;\n        if (!interfaceId) return matchesContractStateFilter(contract, contractStateFilter);\n        const views = (contract.createdEvent.interfaceViews ?? []).filter(\n            (view) => view.interfaceId === interfaceId,\n        );\n        if (views.length !== 1 || views[0]!.viewValue == null || views[0]!.viewStatus?.code !== 0) {\n            return false;\n        }\n        return matchesContractStateFilter(\n            {\n                ...contract,\n                createdEvent: { ...contract.createdEvent, createArgument: views[0]!.viewValue },\n            },\n            contractStateFilter,\n        );\n    });\n};\n\n/**\n * Returns the contractIds of all live contracts matching ref.\n * Resolves {@link CANTON_DEFERRED_SENDER} to senderParty when provided; returns [] if unresolvable.\n */\nexport const queryLiveContractIdsForRef = async (\n    client: ICantonClient,\n    ref: CantonDeferredValue,\n    senderParty?: string,\n): Promise<string[]> => {\n    if (ref.type !== 'activeContractId' && ref.type !== 'activeContractIds') return [];\n    const party =\n        ref.partyToFilter === CANTON_DEFERRED_SENDER ? senderParty : ref.partyToFilter.party;\n    if (!party) return [];\n    const contracts = await queryLiveContractsForRef(client, party, ref);\n    return contracts.map((c) => c.createdEvent.contractId);\n};\n\nexport const createContractAddressResolver = (deps: ContractAddressResolverDeps) => {\n    const { client, senderParty, signingParties, appendDisclosures } = deps;\n\n    const requireSender = (templateId: string): string => {\n        if (!senderParty) {\n            throw new Error(\n                `Refresh entry for ${templateId} needs a resolved sender party, but none was provided`,\n            );\n        }\n        return senderParty;\n    };\n\n    const resolveQueryParty = ({ partyToFilter, templateId }: ActiveContractRef): string =>\n        partyToFilter === CANTON_DEFERRED_SENDER ? requireSender(templateId) : partyToFilter.party;\n\n    const queryCache = new Map<string, Promise<JsActiveContract[]>>();\n    const queryAsParty = async (ref: ActiveContractRef): Promise<JsActiveContract[]> => {\n        const party = resolveQueryParty(ref);\n        const cacheKey = JSON.stringify({ ...ref, party });\n        const cached = queryCache.get(cacheKey);\n        if (cached) return cached;\n\n        const query = (async () => {\n            const contracts = await queryLiveContractsForRef(client, party, ref);\n            if (contracts.length === 0) {\n                throw new Error(\n                    `Party ${party} has no matching active contracts of ${ref.templateId}`,\n                );\n            }\n            return contracts;\n        })();\n        queryCache.set(cacheKey, query);\n        return query;\n    };\n\n    // A signing party that is already a stakeholder can see the contract on its\n    // own stream, so only disclose to parties that aren't signatories/observers.\n    const needsDisclosure = (contract: JsActiveContract): boolean => {\n        const stakeholders = new Set([\n            ...(contract.createdEvent.signatories ?? []),\n            ...(contract.createdEvent.observers ?? []),\n        ]);\n        return !signingParties.some((party) => stakeholders.has(party));\n    };\n\n    const discloseContracts = async (\n        ref: ActiveContractRef,\n        contracts: JsActiveContract[],\n    ): Promise<void> => {\n        const toDisclose = contracts.filter(needsDisclosure);\n        if (toDisclose.length === 0) return;\n\n        const disclosures = toDisclose.map((contract) => {\n            const contractId = contract.createdEvent.contractId;\n            const createdEventBlob = contract.createdEvent.createdEventBlob;\n            if (!createdEventBlob) {\n                throw new Error(\n                    `Could not disclose ${contractId} (template ${ref.templateId}) — ACS result omitted createdEventBlob`,\n                );\n            }\n            return {\n                contractId,\n                templateId: contract.createdEvent.templateId,\n                createdEventBlob,\n                synchronizerId: contract.synchronizerId,\n            };\n        });\n        appendDisclosures(disclosures);\n    };\n\n    const resolveActiveContractId = async (ref: ActiveContractRef): Promise<string> => {\n        const contracts = await queryAsParty(ref);\n        if (contracts.length !== 1) {\n            throw new Error(\n                `Refresh for ${ref.templateId} matched ${contracts.length} contracts, but a scalar ref expects exactly one`,\n            );\n        }\n        await discloseContracts(ref, contracts);\n        return contracts[0]!.createdEvent.contractId;\n    };\n\n    const resolveActiveContractIds = async (ref: ActiveContractRef): Promise<string[]> => {\n        const contracts = await queryAsParty(ref);\n        await discloseContracts(ref, contracts);\n        return contracts.map((contract) => contract.createdEvent.contractId);\n    };\n\n    return {\n        resolveActiveContractId,\n        resolveActiveContractIds,\n        resolveActiveContracts: queryAsParty,\n        discloseActiveContracts: discloseContracts,\n        requireSenderParty: requireSender,\n    };\n};\n"]}

package/dist/RQQM2SSD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sdk/canton-sdk.ts"],"names":["CantonSdk","client","event","contractId","undefined","templateId","CantonProtocolError","createArgument","payload","buildCreate","template","packageId","parts","replace","split","createCommand","join","createArguments","encode","buildExercise","choice","args","encodedArgs","argumentEncode","exerciseCommand","choiceName","choiceArgument","submit","actors","commands","opts","prepareForSigning","submitSigned","prepared","signatures","waitForCommand","commandId","get","parties","fetchContractById","fetchTransaction","updateId","fetchTransactionByUpdateId","fetchTransactionByOffset","offset","fetchEventsByContractId","createDisclosure","connectedSynchronizers","uploadDar","dar","validateDar","listParties","listUserParties","allocateParty","partyIdHint","getPackageId","packageName","getLedgerEndOffset","queryActiveContracts","party","normalizeActiveContract","contract","e","createdEvent","synchronizerId","queryActiveContractsByParties","templateIds","queryActiveContractsByInterface","interfaceIds","queryActiveContractsForParties","templateFilter","apiOpts","perPartyResults","Promise","all","map","partyId","seen","Set","result","contracts","c","cid","has","add","normalized","push"],"mappings":"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","file":"RQQM2SSD.js","sourcesContent":["import type { Choice, ContractId, Party, Template } from '@daml/types';\n\nimport type { CantonTransaction, ICantonClient } from '../client/index';\nimport { CantonProtocolError } from '../errors';\nimport type {\n    ArchivedEvent,\n    Command,\n    CreatedEvent,\n    DisclosedContract,\n    JsActiveContract,\n} from '../open-api/models';\nimport type { CantonDisclosedContract } from '../transaction';\nimport type {\n    Contract,\n    ExternalSignature,\n    NormalizedActiveContract,\n    PreparedTransaction,\n    SubmitActors,\n    SubmitResult,\n    WaitOptions,\n    WaitResult,\n} from '../types';\n\n/**\n * High-level SDK for Canton/DAML contract operations.\n *\n * Users interact with this SDK, not CantonClient directly.\n *\n * @example\n * ```ts\n * import { CantonClient, CantonSdk } from '@layerzerolabs/common-canton';\n *\n * const client = new CantonClient(config, userId);\n * const sdk = new CantonSdk(client);\n *\n * await sdk.submit({ actAs: [party] }, [cmd]);\n * ```\n */\nexport class CantonSdk {\n    readonly #client: ICantonClient;\n\n    constructor(client: ICantonClient) {\n        this.#client = client;\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Private Helpers\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Validate and extract contract fields from a CreatedEvent.\n     * Returns undefined if event is undefined (contract not found).\n     */\n    #validateContractEvent<T extends object>(\n        event: { templateId?: string; contractId?: string; createArgument?: unknown } | undefined,\n        contractId: ContractId<T>,\n    ): Contract<T> | undefined {\n        if (!event) return undefined;\n\n        if (!event.templateId) {\n            throw new CantonProtocolError('Contract response missing templateId', {\n                contractId,\n            });\n        }\n        if (!event.contractId) {\n            throw new CantonProtocolError('Contract response missing contractId', {\n                contractId,\n            });\n        }\n        if (event.createArgument === undefined) {\n            throw new CantonProtocolError('Contract response missing createArgument', {\n                contractId,\n            });\n        }\n        return {\n            templateId: event.templateId,\n            contractId: event.contractId as ContractId<T>,\n            payload: event.createArgument as T,\n        };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Command Builders\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Build a create command using a generated DAML template.\n     *\n     * @param template The generated DAML template (e.g., StateCommitment)\n     * @param payload The contract payload\n     * @param packageId The package ID from the generated package's index.js\n     */\n    buildCreate<T extends object, K, I extends string>(\n        template: Template<T, K, I>,\n        payload: T,\n        packageId: string,\n    ): Command {\n        // Generated templateId format: '#packageName:Module:Entity'\n        // Canton API needs: 'packageId:Module:Entity'\n        const parts = template.templateId.replace(/^#/, '').split(':');\n        parts[0] = packageId;\n\n        return {\n            createCommand: {\n                templateId: parts.join(':'),\n                createArguments: template.encode(payload),\n            },\n        };\n    }\n\n    /**\n     * Build an exercise command using a generated DAML choice.\n     *\n     * @param choice The generated DAML choice (e.g., StateCommitment.Archive)\n     * @param contractId The contract ID to exercise on\n     * @param args The choice arguments\n     * @param packageId The package ID from the generated package's index.js\n     */\n    buildExercise<T extends object, C, R, K>(\n        choice: Choice<T, C, R, K>,\n        contractId: ContractId<T>,\n        args: C,\n        packageId: string,\n    ): Command {\n        // Generated templateId format: '#packageName:Module:Entity'\n        // Canton API needs: 'packageId:Module:Entity'\n        const parts = choice.template().templateId.replace(/^#/, '').split(':');\n        parts[0] = packageId;\n\n        const encodedArgs = choice.argumentEncode(args);\n\n        return {\n            exerciseCommand: {\n                templateId: parts.join(':'),\n                contractId,\n                choice: choice.choiceName,\n                choiceArgument: encodedArgs,\n            },\n        };\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Submission (networked)\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Submit commands to the ledger.\n     */\n    submit(\n        actors: SubmitActors,\n        commands: Command[],\n        opts?: { disclosedContracts?: DisclosedContract[]; commandId?: string },\n    ): Promise<SubmitResult> {\n        return this.#client.submit(actors, commands, opts);\n    }\n\n    /**\n     * Prepare commands for off-chain signing by external parties.\n     */\n    prepareForSigning(\n        actors: SubmitActors,\n        commands: Command[],\n        opts?: { disclosedContracts?: DisclosedContract[]; commandId?: string },\n    ): Promise<PreparedTransaction> {\n        return this.#client.prepareForSigning(actors, commands, opts);\n    }\n\n    /**\n     * Submit a pre-signed transaction (external party flow).\n     */\n    submitSigned(\n        prepared: PreparedTransaction,\n        signatures: ExternalSignature[],\n    ): Promise<SubmitResult> {\n        return this.#client.submitSigned(prepared, signatures);\n    }\n\n    /**\n     * Wait for a command to be accepted or rejected.\n     */\n    waitForCommand(commandId: string, opts: WaitOptions): Promise<WaitResult> {\n        return this.#client.waitForCommand(commandId, opts);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Queries\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Fetch a specific contract by ID.\n     * Returns undefined if archived or not visible.\n     *\n     * @param contractId The contract ID to fetch\n     * @param parties Parties to use for visibility filtering\n     */\n    async get<T extends object>(\n        contractId: ContractId<T>,\n        parties: Party[],\n    ): Promise<Contract<T> | undefined> {\n        const event = await this.#client.fetchContractById(contractId, parties);\n        return this.#validateContractEvent(event, contractId);\n    }\n\n    /**\n     * Fetch an update (transaction) by its ID.\n     *\n     * Use this to get created contract IDs after a command is accepted.\n     * The updateId comes from WaitResult.updateId.\n     *\n     * @param updateId The update ID from WaitResult\n     * @param parties Parties to filter events\n     * @returns Parsed update with events\n     *\n     * @example\n     * ```ts\n     * const waitResult = await sdk.waitForCommand(commandId, opts);\n     * if (waitResult.status === 'accepted') {\n     *     const tx = await sdk.fetchTransaction(waitResult.updateId, [party]);\n     *     const createdIds = (tx.events ?? [])\n     *         .filter(e => 'CreatedEvent' in e)\n     *         .map(e => e.CreatedEvent.contractId);\n     * }\n     * ```\n     */\n    fetchTransaction(updateId: string, parties: string[]): Promise<CantonTransaction> {\n        return this.#client.fetchTransactionByUpdateId(updateId, parties);\n    }\n\n    /**\n     * Fetch a transaction by its offset.\n     *\n     * @param offset The ledger offset\n     * @param parties Parties to filter events\n     * @returns Parsed transaction with events and timestamps\n     */\n    fetchTransactionByOffset(offset: number, parties: string[]): Promise<CantonTransaction> {\n        return this.#client.fetchTransactionByOffset(offset, parties);\n    }\n\n    /**\n     * Fetch both the created and archived events for a contract by ID.\n     *\n     * @param contractId - The contract ID to look up\n     * @param parties - Parties to use for visibility filtering\n     */\n    fetchEventsByContractId(\n        contractId: string,\n        parties: string[],\n    ): Promise<{ created: CreatedEvent | undefined; archived: ArchivedEvent | undefined }> {\n        return this.#client.fetchEventsByContractId(contractId, parties);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Disclosure\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Create a disclosure for a contract.\n     *\n     * Disclosures allow a party to share a contract's content with another party\n     * who isn't a stakeholder, enabling them to exercise choices that reference it.\n     *\n     * @param contractId The contract to create disclosure for\n     * @param parties Parties that have visibility to the contract\n     * @returns The disclosed contract, or undefined if contract not found\n     *\n     * @example\n     * ```ts\n     * // Alice creates disclosure for Bob to use\n     * const disclosure = await aliceSdk.createDisclosure(contractId, [aliceParty]);\n     * if (disclosure) {\n     *     // Bob uses the disclosure in his submission\n     *     await bobSdk.submit(\n     *         { actAs: [bobParty] },\n     *         [command],\n     *         { disclosedContracts: [disclosure] }\n     *     );\n     * }\n     * ```\n     */\n    createDisclosure<T extends object>(\n        contractId: ContractId<T>,\n        parties: Party[],\n    ): Promise<CantonDisclosedContract | undefined> {\n        return this.#client.createDisclosure(contractId, parties);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Utilities\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Get connected synchronizers.\n     */\n    connectedSynchronizers(): Promise<string[]> {\n        return this.#client.connectedSynchronizers();\n    }\n\n    /**\n     * Upload a DAR to the participant node.\n     *\n     * POST /v2/dars\n     *\n     * @param opts.skipIfVetted - If true, treat KNOWN_PACKAGE_VERSION errors as success\n     */\n    uploadDar(\n        dar: Uint8Array<ArrayBuffer>,\n        opts?: { vetAllPackages?: boolean; synchronizerId?: string; skipIfVetted?: boolean },\n    ): Promise<object> {\n        return this.#client.uploadDar(dar, opts);\n    }\n\n    /**\n     * Validate a DAR for upgrade compatibility against the current vetting state.\n     *\n     * POST /v2/dars/validate\n     */\n    validateDar(dar: Uint8Array<ArrayBuffer>, opts?: { synchronizerId?: string }): Promise<void> {\n        return this.#client.validateDar(dar, opts);\n    }\n\n    /**\n     * List all known parties on the participant node.\n     *\n     * GET /v2/parties\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\n     */\n    listParties(opts?: {\n        pageSize?: number;\n        pageToken?: string;\n    }): Promise<{ parties: string[]; nextPageToken?: string }> {\n        return this.#client.listParties(opts);\n    }\n\n    /**\n     * List the parties the configured user can act/read as.\n     *\n     * Narrower than {@link listParties} (all parties on the node): use this when a\n     * call needs the caller's own read-scoped parties.\n     */\n    listUserParties(): Promise<string[]> {\n        return this.#client.listUserParties();\n    }\n\n    /**\n     * Allocate a new party on the participant node.\n     *\n     * POST /v2/parties\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    allocateParty(\n        partyIdHint: string,\n        opts?: { userId?: string; synchronizerId?: string; identityProviderId?: string },\n    ): Promise<string> {\n        return this.#client.allocateParty(partyIdHint, opts);\n    }\n\n    /**\n     * Get the package ID for a package by name.\n     *\n     * POST /v2/interactive-submission/preferred-packages\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    getPackageId(\n        packageName: string,\n        parties: string[],\n        opts?: { synchronizerId?: string },\n    ): Promise<string> {\n        return this.#client.getPackageId(packageName, parties, opts);\n    }\n\n    // ─────────────────────────────────────────────────────────────────────────\n    // Active Contracts Query\n    // ─────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Get the current ledger end offset.\n     *\n     * GET /v2/state/ledger-end\n     *\n     * @returns The current ledger end offset\n     */\n    getLedgerEndOffset(): Promise<number> {\n        return this.#client.getLedgerEndOffset();\n    }\n\n    /**\n     * Query active contracts at a given offset with optional template filtering.\n     *\n     * POST /v2/state/active-contracts\n     *\n     * @param party - Party to query as (for visibility)\n     * @param offset - Ledger offset to query at\n     * @param opts.templateIds - Template IDs to filter by (e.g., \"packageId:Module:Template\")\n     * @param opts.limit - Maximum number of contracts to return\n     * @returns Array of active contracts\n     *\n     * @example\n     * ```ts\n     * const offset = await sdk.getLedgerEndOffset();\n     * const contracts = await sdk.queryActiveContracts(party, offset, {\n     *     templateIds: ['packageId:SimpleRequest:SimpleRequest'],\n     *     limit: 100,\n     * });\n     * for (const contract of contracts) {\n     *     console.log(contract.createdEvent.contractId, contract.createdEvent.templateId);\n     * }\n     * ```\n     */\n    queryActiveContracts(\n        party: string,\n        offset: number,\n        opts?: { templateIds?: string[]; limit?: number; includeCreatedEventBlob?: boolean },\n    ): Promise<JsActiveContract[]> {\n        return this.#client.queryActiveContracts(party, offset, opts);\n    }\n\n    /**\n     * Normalize a ledger API JsActiveContract to a flat shape (contractId, templateId, payload, synchronizerId).\n     * Useful when you only need these fields and not createdEvent / reassignmentCounter.\n     */\n    static normalizeActiveContract(contract: JsActiveContract): NormalizedActiveContract {\n        const e = contract.createdEvent;\n        return {\n            contractId: e.contractId,\n            templateId: e.templateId,\n            payload: e.createArgument,\n            synchronizerId: contract.synchronizerId,\n        };\n    }\n\n    /**\n     * Query active contracts visible to any of the given parties (single API call).\n     */\n    queryActiveContractsByParties(\n        parties: string[],\n        offset: number,\n        templateIds: string[],\n        opts?: { limit?: number },\n    ): Promise<JsActiveContract[]> {\n        return this.#client.queryActiveContractsByParties(parties, offset, templateIds, opts);\n    }\n\n    /**\n     * Query active contracts visible to any of the given parties that implement\n     * the given interfaces (single API call).\n     */\n    queryActiveContractsByInterface(\n        parties: string[],\n        offset: number,\n        interfaceIds: string[],\n        opts?: { limit?: number; includeCreatedEventBlob?: boolean },\n    ): Promise<JsActiveContract[]> {\n        return this.#client.queryActiveContractsByInterface(parties, offset, interfaceIds, opts);\n    }\n\n    /**\n     * Query active contracts visible to any of the given parties, deduplicated by contractId.\n     * Returns normalized contracts (flat shape). Use when you need a merged view across multiple parties.\n     *\n     * @param parties - Party IDs to query as (contracts visible to any party are included, each contract once)\n     * @param opts - Optional templateIds and limit (passed per-party to the ledger API); optional templateFilter (applied after fetch)\n     */\n    async queryActiveContractsForParties(\n        parties: string[],\n        opts?: {\n            templateIds?: string[];\n            limit?: number;\n            /** If provided, only contracts whose templateId passes this predicate are returned. */\n            templateFilter?: (templateId: string) => boolean;\n        },\n    ): Promise<NormalizedActiveContract[]> {\n        const offset = await this.#client.getLedgerEndOffset();\n        const { templateFilter, ...apiOpts } = opts ?? {};\n        const perPartyResults = await Promise.all(\n            parties.map((partyId) => this.#client.queryActiveContracts(partyId, offset, apiOpts)),\n        );\n        const seen = new Set<string>();\n        const result: NormalizedActiveContract[] = [];\n        for (const contracts of perPartyResults) {\n            for (const c of contracts) {\n                const cid = c.createdEvent.contractId;\n                if (!seen.has(cid)) {\n                    seen.add(cid);\n                    const normalized = CantonSdk.normalizeActiveContract(c);\n                    if (!templateFilter || templateFilter(normalized.templateId)) {\n                        result.push(normalized);\n                    }\n                }\n            }\n        }\n        return result;\n    }\n}\n"]}