@fairmint/canton-node-sdk 0.0.210 → 0.0.211

package/build/src/utils/amulet/external-party-transfer-offer.d.ts

@@ -0,0 +1,73 @@
+import { type LedgerJsonApiClient } from '../../clients/ledger-json-api';
+import { type ValidatorApiClient } from '../../clients/validator-api';
+import { type ExecuteExternalTransactionAndWaitResult } from '../external-signing/execute-external-transaction';
+export declare const CANTON_TRANSFER_OFFER_TEMPLATE_ID = "#splice-wallet:Splice.Wallet.TransferOffer:TransferOffer";
+export interface CantonDisclosedContract {
+    readonly contractId: string;
+    readonly templateId: string;
+    readonly createdEventBlob: string;
+    readonly synchronizerId: string;
+}
+export interface TransferOfferDisclosure {
+    readonly contract: CantonDisclosedContract;
+    readonly raw: Record<string, unknown>;
+}
+export interface PrepareExternalPartyTransferOfferAcceptanceOptions {
+    readonly ledgerClient: LedgerJsonApiClient;
+    readonly validatorClient?: ValidatorApiClient;
+    /** Provider/source party that created the offer. Used for synchronizer and active-contract disclosure lookup. */
+    readonly providerPartyId: string;
+    readonly userId: string;
+    readonly acceptingPartyId: string;
+    readonly offerContractId: string;
+    readonly commandId?: string;
+    readonly synchronizerId?: string;
+    readonly disclosedContract?: CantonDisclosedContract;
+    readonly verboseHashing?: boolean;
+}
+export interface PreparedExternalPartyTransferOfferAcceptance {
+    readonly offerContractId: string;
+    readonly acceptingPartyId: string;
+    readonly commandId: string;
+    readonly synchronizerId: string;
+    readonly preparedTransaction: string;
+    readonly preparedTransactionHashHex: string;
+    readonly hashingSchemeVersion: string;
+    readonly offerDisclosure: TransferOfferDisclosure;
+    readonly raw: Record<string, unknown>;
+}
+export interface SubmitExternalPartyTransferOfferAcceptanceOptions {
+    readonly ledgerClient: LedgerJsonApiClient;
+    readonly userId: string;
+    readonly acceptingPartyId: string;
+    readonly publicKeyBase64: string;
+    readonly publicKeyFingerprint?: string | null;
+    readonly preparedTransaction: string;
+    readonly preparedTransactionHashHex: string;
+    readonly signatureBase64: string;
+    readonly hashingSchemeVersion?: string;
+    readonly submissionId?: string;
+}
+export interface SubmittedExternalPartyTransferOfferAcceptance extends ExecuteExternalTransactionAndWaitResult {
+    readonly acceptingPartyId: string;
+}
+/**
+ * Prepares `TransferOffer_Accept` for an externally hosted party.
+ *
+ * The returned `preparedTransactionHashHex` is the value the end-user key must sign outside the SDK. The helper fetches
+ * the transfer-offer disclosed contract from the validator wallet API when available and falls back to Ledger active
+ * contracts for the provider/source party.
+ */
+export declare function prepareExternalPartyTransferOfferAcceptance(options: PrepareExternalPartyTransferOfferAcceptanceOptions): Promise<PreparedExternalPartyTransferOfferAcceptance>;
+/** Verifies the end-user signature and executes a prepared `TransferOffer_Accept`, waiting for the update id. */
+export declare function submitExternalPartyTransferOfferAcceptance(options: SubmitExternalPartyTransferOfferAcceptanceOptions): Promise<SubmittedExternalPartyTransferOfferAcceptance>;
+export declare function readRequiredTransferOfferDisclosedContract(input: {
+    readonly ledgerClient: LedgerJsonApiClient;
+    readonly validatorClient?: ValidatorApiClient;
+    readonly providerPartyId: string;
+    readonly offerContractId: string;
+    readonly synchronizerId: string;
+}): Promise<TransferOfferDisclosure>;
+export declare function readTransferOfferDisclosedContractFromList(source: unknown, offerContractId: string, synchronizerId: string): TransferOfferDisclosure | null;
+export declare function readTransferOfferDisclosedContractFromActiveContracts(source: unknown, offerContractId: string, expectedSynchronizerId?: string): TransferOfferDisclosure | null;
+//# sourceMappingURL=external-party-transfer-offer.d.ts.map

package/build/src/utils/amulet/external-party-transfer-offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-party-transfer-offer.d.ts","sourceRoot":"","sources":["../../../../src/utils/amulet/external-party-transfer-offer.ts"],"names":[],"mappings":"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"}

package/build/src/utils/amulet/external-party-transfer-offer.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID = void 0;
+exports.prepareExternalPartyTransferOfferAcceptance = prepareExternalPartyTransferOfferAcceptance;
+exports.submitExternalPartyTransferOfferAcceptance = submitExternalPartyTransferOfferAcceptance;
+exports.readRequiredTransferOfferDisclosedContract = readRequiredTransferOfferDisclosedContract;
+exports.readTransferOfferDisclosedContractFromList = readTransferOfferDisclosedContractFromList;
+exports.readTransferOfferDisclosedContractFromActiveContracts = readTransferOfferDisclosedContractFromActiveContracts;
+const node_crypto_1 = require("node:crypto");
+const errors_1 = require("../../core/errors");
+const utils_1 = require("../../core/utils");
+const canton_response_utils_1 = require("../canton-response-utils");
+const canton_protocol_1 = require("../external-signing/canton-protocol");
+const execute_external_transaction_1 = require("../external-signing/execute-external-transaction");
+const external_party_onboarding_1 = require("../external-signing/external-party-onboarding");
+const prepare_external_transaction_1 = require("../external-signing/prepare-external-transaction");
+exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID = '#splice-wallet:Splice.Wallet.TransferOffer:TransferOffer';
+/**
+ * Prepares `TransferOffer_Accept` for an externally hosted party.
+ *
+ * The returned `preparedTransactionHashHex` is the value the end-user key must sign outside the SDK. The helper fetches
+ * the transfer-offer disclosed contract from the validator wallet API when available and falls back to Ledger active
+ * contracts for the provider/source party.
+ */
+async function prepareExternalPartyTransferOfferAcceptance(options) {
+    validateRequiredString('providerPartyId', options.providerPartyId);
+    validateRequiredString('userId', options.userId);
+    validateRequiredString('acceptingPartyId', options.acceptingPartyId);
+    validateRequiredString('offerContractId', options.offerContractId);
+    const connectedSynchronizerId = await readRequiredConnectedSynchronizerId(options.ledgerClient, options.providerPartyId);
+    if (options.synchronizerId && options.synchronizerId !== connectedSynchronizerId) {
+        throw new errors_1.ValidationError('Prepared transfer-offer synchronizer no longer matches the provider synchronizer', {
+            expectedSynchronizerId: options.synchronizerId,
+            connectedSynchronizerId,
+        });
+    }
+    const synchronizerId = connectedSynchronizerId;
+    const offerDisclosure = options.disclosedContract
+        ? readCallerTransferOfferDisclosure(options.disclosedContract, options.offerContractId, synchronizerId)
+        : await readRequiredTransferOfferDisclosedContract({
+            ledgerClient: options.ledgerClient,
+            providerPartyId: options.providerPartyId,
+            offerContractId: options.offerContractId,
+            synchronizerId,
+            ...(options.validatorClient ? { validatorClient: options.validatorClient } : {}),
+        });
+    const prepared = await (0, prepare_external_transaction_1.prepareExternalTransaction)({
+        ledgerClient: options.ledgerClient,
+        commands: [
+            {
+                ExerciseCommand: {
+                    templateId: exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID,
+                    contractId: options.offerContractId,
+                    choice: 'TransferOffer_Accept',
+                    choiceArgument: {},
+                },
+            },
+        ],
+        commandId: options.commandId ?? `accept-transfer-offer-${(0, node_crypto_1.randomUUID)()}`,
+        userId: options.userId,
+        actAs: [options.acceptingPartyId],
+        readAs: [options.acceptingPartyId],
+        disclosedContracts: [offerDisclosure.contract],
+        synchronizerId,
+        verboseHashing: options.verboseHashing ?? false,
+        packageIdSelectionPreference: [],
+    });
+    return {
+        offerContractId: options.offerContractId,
+        acceptingPartyId: options.acceptingPartyId,
+        commandId: prepared.commandId,
+        synchronizerId,
+        preparedTransaction: (0, canton_response_utils_1.readRequiredString)(prepared, 'preparedTransaction', 'transfer-offer accept prepare'),
+        preparedTransactionHashHex: (0, canton_protocol_1.preparedTransactionHashToHex)((0, canton_response_utils_1.readRequiredString)(prepared, 'preparedTransactionHash', 'transfer-offer accept prepare'), 'transfer-offer accept prepare'),
+        hashingSchemeVersion: readOptionalString(prepared, 'hashingSchemeVersion') ?? 'HASHING_SCHEME_VERSION_V2',
+        offerDisclosure,
+        raw: (0, canton_response_utils_1.objectOrEmpty)(prepared),
+    };
+}
+function readCallerTransferOfferDisclosure(contract, offerContractId, synchronizerId) {
+    if (contract.contractId !== offerContractId) {
+        throw new errors_1.ValidationError('Disclosed transfer-offer contract ID does not match offerContractId', {
+            contractId: contract.contractId,
+            offerContractId,
+        });
+    }
+    if (contract.synchronizerId !== synchronizerId) {
+        throw new errors_1.ValidationError('Disclosed transfer-offer synchronizer does not match the provider synchronizer', {
+            disclosedSynchronizerId: contract.synchronizerId,
+            synchronizerId,
+        });
+    }
+    validateRequiredString('disclosedContract.templateId', contract.templateId);
+    validateRequiredString('disclosedContract.createdEventBlob', contract.createdEventBlob);
+    return {
+        contract,
+        raw: { source: 'caller' },
+    };
+}
+/** Verifies the end-user signature and executes a prepared `TransferOffer_Accept`, waiting for the update id. */
+async function submitExternalPartyTransferOfferAcceptance(options) {
+    validateRequiredString('userId', options.userId);
+    const publicKeyFingerprint = (0, canton_protocol_1.assertCantonPartyMatchesPublicKey)({
+        partyId: options.acceptingPartyId,
+        publicKeyBase64: options.publicKeyBase64,
+        ...(options.publicKeyFingerprint !== undefined ? { publicKeyFingerprint: options.publicKeyFingerprint } : {}),
+    });
+    (0, canton_protocol_1.assertCantonHashSignature)({
+        publicKeyBase64: options.publicKeyBase64,
+        hashHex: options.preparedTransactionHashHex,
+        signatureBase64: options.signatureBase64,
+    });
+    const result = await (0, execute_external_transaction_1.executeExternalTransactionAndWait)({
+        ledgerClient: options.ledgerClient,
+        userId: options.userId,
+        preparedTransaction: options.preparedTransaction,
+        hashingSchemeVersion: options.hashingSchemeVersion ?? 'HASHING_SCHEME_VERSION_V2',
+        submissionId: options.submissionId ?? (0, node_crypto_1.randomUUID)(),
+        partySignatures: [
+            {
+                party: options.acceptingPartyId,
+                signatures: [
+                    {
+                        signature: options.signatureBase64,
+                        signedBy: publicKeyFingerprint,
+                        format: external_party_onboarding_1.CANTON_RAW_SIGNATURE_FORMAT,
+                        signingAlgorithmSpec: external_party_onboarding_1.CANTON_ED25519_SIGNATURE_ALGORITHM,
+                    },
+                ],
+            },
+        ],
+    });
+    return {
+        ...result,
+        acceptingPartyId: options.acceptingPartyId,
+    };
+}
+async function readRequiredTransferOfferDisclosedContract(input) {
+    if (input.validatorClient) {
+        try {
+            const offerList = await input.validatorClient.listTransferOffers();
+            const disclosed = readTransferOfferDisclosedContractFromList(offerList, input.offerContractId, input.synchronizerId);
+            if (disclosed)
+                return disclosed;
+        }
+        catch {
+            // Fall through to Ledger active contracts; some validator deployments do not expose created_event_blob here.
+        }
+    }
+    const activeContracts = await input.ledgerClient.getActiveContracts({
+        parties: [input.providerPartyId],
+        templateIds: [exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID],
+        includeCreatedEventBlob: true,
+    });
+    const disclosed = readTransferOfferDisclosedContractFromActiveContracts(activeContracts, input.offerContractId, input.synchronizerId);
+    if (disclosed)
+        return disclosed;
+    throw new errors_1.OperationError('Canton transfer-offer disclosure was unavailable. Retry after the offer is visible on the ledger.', errors_1.OperationErrorCode.MISSING_CONTRACT, { offerContractId: input.offerContractId });
+}
+function readTransferOfferDisclosedContractFromList(source, offerContractId, synchronizerId) {
+    const sourceOffers = (0, utils_1.isRecord)(source) ? source['offers'] : undefined;
+    const offers = Array.isArray(sourceOffers) ? sourceOffers : source;
+    if (!Array.isArray(offers))
+        return null;
+    for (const offer of offers) {
+        const disclosed = readDisclosedContractFromPossibleOffer(offer, offerContractId, synchronizerId);
+        if (disclosed)
+            return disclosed;
+    }
+    return null;
+}
+function readTransferOfferDisclosedContractFromActiveContracts(source, offerContractId, expectedSynchronizerId) {
+    if (!Array.isArray(source))
+        return null;
+    for (const item of source) {
+        const contractEntry = (0, utils_1.isRecord)(item) ? (0, canton_response_utils_1.objectOrEmpty)(item['contractEntry']) : {};
+        const activeContract = (0, canton_response_utils_1.objectOrEmpty)(contractEntry['JsActiveContract']);
+        const createdEvent = (0, canton_response_utils_1.objectOrEmpty)(activeContract['createdEvent']);
+        const contractId = readFirstString([createdEvent], ['contractId', 'contract_id']);
+        if (contractId !== offerContractId)
+            continue;
+        const templateId = readFirstString([createdEvent], ['templateId', 'template_id']) ?? exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID;
+        const createdEventBlob = readFirstString([createdEvent], ['createdEventBlob', 'created_event_blob']);
+        const synchronizerId = readFirstString(activeContract, [
+            'synchronizerId',
+            'synchronizer_id',
+            'domainId',
+            'domain_id',
+        ]);
+        if (!createdEventBlob || !synchronizerId)
+            continue;
+        if (expectedSynchronizerId && synchronizerId !== expectedSynchronizerId)
+            continue;
+        return {
+            contract: {
+                contractId,
+                templateId,
+                createdEventBlob,
+                synchronizerId,
+            },
+            raw: {
+                source: 'ledger-active-contracts',
+                contract: (0, utils_1.isRecord)(item) ? item : {},
+            },
+        };
+    }
+    return null;
+}
+function readDisclosedContractFromPossibleOffer(source, offerContractId, defaultSynchronizerId) {
+    if (!(0, utils_1.isRecord)(source))
+        return null;
+    const transferOffer = (0, canton_response_utils_1.objectOrEmpty)(source['transfer_offer']);
+    const transferOfferContract = (0, canton_response_utils_1.objectOrEmpty)(transferOffer['contract']);
+    const offer = (0, canton_response_utils_1.objectOrEmpty)(source['offer']);
+    const offerContract = (0, canton_response_utils_1.objectOrEmpty)(offer['contract']);
+    const contract = (0, canton_response_utils_1.objectOrEmpty)(source['contract']);
+    const records = [source, contract, offer, offerContract, transferOffer, transferOfferContract];
+    for (const record of records) {
+        const contractId = readFirstString(record, ['contractId', 'contract_id']);
+        if (contractId !== offerContractId)
+            continue;
+        const createdEventBlob = readFirstString(record, ['createdEventBlob', 'created_event_blob']);
+        if (!createdEventBlob)
+            continue;
+        const templateId = readFirstString(record, ['templateId', 'template_id']) ?? exports.CANTON_TRANSFER_OFFER_TEMPLATE_ID;
+        const synchronizerId = readFirstString(record, ['synchronizerId', 'synchronizer_id', 'domainId', 'domain_id']) ?? defaultSynchronizerId;
+        if (synchronizerId !== defaultSynchronizerId)
+            continue;
+        return {
+            contract: {
+                contractId,
+                templateId,
+                createdEventBlob,
+                synchronizerId,
+            },
+            raw: {
+                source: 'validator-transfer-offers',
+                contract: source,
+            },
+        };
+    }
+    return null;
+}
+async function readRequiredConnectedSynchronizerId(ledgerClient, providerPartyId) {
+    const raw = await ledgerClient.getConnectedSynchronizers({ party: providerPartyId });
+    const synchronizerId = parseRequiredSingleSynchronizerId(raw);
+    if (synchronizerId)
+        return synchronizerId;
+    throw new errors_1.OperationError('Canton provider did not report a connected synchronizer', errors_1.OperationErrorCode.MISSING_DOMAIN_ID);
+}
+function parseRequiredSingleSynchronizerId(raw) {
+    if (!(0, utils_1.isRecord)(raw) && !Array.isArray(raw))
+        return null;
+    const direct = (0, utils_1.isRecord)(raw) ? raw['connectedSynchronizers'] : undefined;
+    const itemsField = (0, utils_1.isRecord)(raw) ? raw['items'] : undefined;
+    const items = Array.isArray(raw)
+        ? raw
+        : Array.isArray(direct)
+            ? direct
+            : Array.isArray(itemsField)
+                ? itemsField
+                : [];
+    const synchronizerIds = [];
+    for (const item of items) {
+        if (typeof item === 'string' && item.trim()) {
+            synchronizerIds.push(item);
+            continue;
+        }
+        if (!(0, utils_1.isRecord)(item)) {
+            continue;
+        }
+        for (const key of ['synchronizerId', 'synchronizer', 'domainId', 'id']) {
+            const value = item[key];
+            if (typeof value === 'string' && value.trim()) {
+                synchronizerIds.push(value);
+                break;
+            }
+        }
+    }
+    const uniqueSynchronizerIds = new Set(synchronizerIds);
+    if (uniqueSynchronizerIds.size > 1) {
+        throw new errors_1.OperationError('Canton provider reported multiple connected synchronizers', errors_1.OperationErrorCode.MISSING_DOMAIN_ID, { synchronizerIds });
+    }
+    return synchronizerIds[0] ?? null;
+}
+function validateRequiredString(name, value) {
+    if (!value.trim()) {
+        throw new errors_1.ValidationError(`${name} is required`, { [name]: value });
+    }
+}
+function readOptionalString(source, key) {
+    if (!(0, utils_1.isRecord)(source) || !(key in source))
+        return null;
+    const value = source[key];
+    return typeof value === 'string' && value.trim() ? value : null;
+}
+function readFirstString(records, keys) {
+    const sources = Array.isArray(records) ? records : [records];
+    for (const record of sources) {
+        for (const key of keys) {
+            const value = record[key];
+            if (typeof value === 'string' && value.trim())
+                return value;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=external-party-transfer-offer.js.map

package/build/src/utils/amulet/external-party-transfer-offer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-party-transfer-offer.js","sourceRoot":"","sources":["../../../../src/utils/amulet/external-party-transfer-offer.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 export * from './external-party-cc-transfer';
+export * from './external-party-transfer-offer';
 export * from './get-amulets-for-transfer';
 export * from './get-locked-amulets';
 export * from './offers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/amulet/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/amulet/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}

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

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./external-party-cc-transfer"), exports);
+__exportStar(require("./external-party-transfer-offer"), exports);
 __exportStar(require("./get-amulets-for-transfer"), exports);
 __exportStar(require("./get-locked-amulets"), exports);
 __exportStar(require("./offers"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/amulet/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,6DAA2C;AAC3C,uDAAqC;AACrC,2CAAyB;AACzB,0DAAwC;AACxC,2DAAyC;AACzC,4DAA0C;AAC1C,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/amulet/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,kEAAgD;AAChD,6DAA2C;AAC3C,uDAAqC;AACrC,2CAAyB;AACzB,0DAAwC;AACxC,2DAAyC;AACzC,4DAA0C;AAC1C,0CAAwB"}

package/build/src/utils/canton-response-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function readRequiredString(source: unknown, key: string, operation: string): string;
+export declare function objectOrEmpty(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=canton-response-utils.d.ts.map

package/build/src/utils/canton-response-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canton-response-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE"}

package/build/src/utils/canton-response-utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRequiredString = readRequiredString;
+exports.objectOrEmpty = objectOrEmpty;
+const errors_1 = require("../core/errors");
+const utils_1 = require("../core/utils");
+function readRequiredString(source, key, operation) {
+    if ((0, utils_1.isRecord)(source) && key in source) {
+        const value = source[key];
+        if (typeof value === 'string' && value.trim())
+            return value;
+    }
+    throw new errors_1.OperationError(`Canton ${operation} response did not include ${key}`, errors_1.OperationErrorCode.TRANSACTION_FAILED);
+}
+function objectOrEmpty(value) {
+    return (0, utils_1.isRecord)(value) ? value : {};
+}
+//# sourceMappingURL=canton-response-utils.js.map

package/build/src/utils/canton-response-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canton-response-utils.js","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":";;AAGA,gDASC;AAED,sCAEC;AAhBD,2CAAoE;AACpE,yCAAyC;AAEzC,SAAgB,kBAAkB,CAAC,MAAe,EAAE,GAAW,EAAE,SAAiB;IAChF,IAAI,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,uBAAc,CACtB,UAAU,SAAS,6BAA6B,GAAG,EAAE,EACrD,2BAAkB,CAAC,kBAAkB,CACtC,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC"}

package/build/src/utils/external-signing/canton-protocol.d.ts

@@ -0,0 +1,57 @@
+export interface CantonPartyPublicKeyInput {
+    readonly partyId: string;
+    readonly publicKeyBase64: string;
+    readonly publicKeyFingerprint?: string | null;
+}
+export interface CantonHashSignatureInput {
+    readonly publicKeyBase64: string;
+    readonly hashHex: string;
+    readonly signatureBase64: string;
+}
+export interface Ed25519SignatureInput {
+    readonly publicKeyBase64: string;
+    readonly payload: Buffer | Uint8Array | string;
+    readonly signatureBase64: string;
+    readonly failureMessage?: string;
+}
+/** Normalizes a raw or DER-wrapped Ed25519 public key into Canton's DER X.509 SubjectPublicKeyInfo base64 format. */
+export declare function normalizeEd25519PublicKeyForCanton(publicKeyBase64: string): string;
+/** Extracts and validates the raw 32-byte Ed25519 public key from raw or DER X.509 base64 input. */
+export declare function extractRawEd25519PublicKey(publicKeyBase64: string): Buffer;
+/** Converts a raw or DER-wrapped Ed25519 public key into the equivalent Solana address. */
+export declare function deriveSolanaAddressFromEd25519PublicKeyBase64(publicKeyBase64: string): string;
+/** Derives the Canton fingerprint suffix for an Ed25519 external-party key. */
+export declare function deriveCantonEd25519PublicKeyFingerprint(publicKeyBase64: string): string;
+/** Builds a deterministic external party id from a party hint/prefix and a Canton public-key fingerprint. */
+export declare function buildExternalPartyId(partyHint: string, publicKeyFingerprint: string): string;
+/** Extracts the public-key fingerprint suffix from a Canton party id. */
+export declare function extractPublicKeyFingerprint(partyId: string): string;
+/**
+ * Verifies that a party id fingerprint and optional caller-supplied fingerprint match a submitted Ed25519 public key.
+ *
+ * Returns the derived fingerprint when the party/key binding is valid.
+ */
+export declare function assertCantonPartyMatchesPublicKey(input: CantonPartyPublicKeyInput): string;
+/** Converts a Canton hash from hex, base64, or base64url into lowercase hex. */
+export declare function normalizeCantonHashToHex(hash: string, operation?: string): string;
+/** Validates and lowercases a submitted Canton SHA-256 multihash hex value. */
+export declare function assertCantonSha256MultihashHex(value: string): string;
+/** Converts a hex-encoded hash into base64 bytes for browser wallet signing. */
+export declare function hashHexToBase64(hashHex: string): string;
+/** Verifies an Ed25519 signature over a hex-encoded Canton hash. */
+export declare function assertCantonHashSignature(input: CantonHashSignatureInput): void;
+/** Verifies an Ed25519 signature against a raw payload using a raw or DER-wrapped public key. */
+export declare function assertEd25519Signature(input: Ed25519SignatureInput): void;
+/** Produces stable JSON for token/signature payloads by sorting object keys and omitting undefined values. */
+export declare function canonicalizeCantonProtocolPayload(payload: unknown): string;
+/** Hashes a canonicalized protocol payload with SHA-256. */
+export declare function hashCantonProtocolPayload(payload: unknown): string;
+/** Builds an HMAC-bound token for a prepared Canton transaction or topology payload. */
+export declare function buildCantonPrepareToken(secret: string, payload: Record<string, unknown>): string;
+/** Verifies that a submitted prepare token exactly binds to the expected prepared Canton payload. */
+export declare function assertCantonPrepareToken(secret: string, token: string, expectedPayload: Record<string, unknown>): void;
+/** Computes the SHA-256 hex digest of a base64 prepared transaction blob for token binding. */
+export declare function hashPreparedTransaction(preparedTransaction: string): string;
+/** Converts a base64/base64url prepared transaction hash returned by interactive submission into lowercase hex. */
+export declare function preparedTransactionHashToHex(hashBase64: string, operation?: string): string;
+//# sourceMappingURL=canton-protocol.d.ts.map

package/build/src/utils/external-signing/canton-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canton-protocol.d.ts","sourceRoot":"","sources":["../../../../src/utils/external-signing/canton-protocol.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qHAAqH;AACrH,wBAAgB,kCAAkC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,oGAAoG;AACpG,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAY1E;AAED,2FAA2F;AAC3F,wBAAgB,6CAA6C,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,+EAA+E;AAC/E,wBAAgB,uCAAuC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED,6GAA6G;AAC7G,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAU5F;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAkB1F;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAc,GAAG,MAAM,CAkBtF;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAO/E;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAQzE;AAED,8GAA8G;AAC9G,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE1E;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAElE;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKhG;AAED,qGAAqG;AACrG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAUN;AAQD,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,mHAAmH;AACnH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,SAAmC,GAAG,MAAM,CAiBrH"}