@layerzerolabs/common-canton 0.2.114 → 0.2.115

package/test/mocks/scripts/capture-unhappy-paths.ts

@@ -1,263 +0,0 @@
-#!/usr/bin/env tsx
-/// <reference types="node" />
-/**
- * Captures error scenarios (unhappy paths) for Canton API interactions.
- *
- * Usage:
- *   tsx test/mocks/scripts/capture-unhappy-paths.ts
- *
- * Output:
- *   test/mocks/captured-unhappy-paths.json
- */
-
-import type { ContractId } from '@daml/types';
-import * as path from 'path';
-
-import {
-    MnemonicSignerAdapter,
-    SignatureFormat,
-    SignatureType,
-} from '@layerzerolabs/ver-signer-adapter';
-import { CantonClient } from '../../../src/client/index.js';
-// Import SDK test contracts
-import { packageId } from '../../../src/daml/sdk-test-0.0.1/lib/index.js';
-import { SimpleAsset } from '../../../src/daml/sdk-test-0.0.1/lib/SdkTest/module.js';
-import type { Command } from '../../../src/open-api/models/index.js';
-import { Configuration } from '../../../src/open-api/runtime.js';
-import { CantonSdk } from '../../../src/sdk/index.js';
-import type { ExternalSignature } from '../../../src/types.js';
-import {
-    CANTON_URL,
-    type CapturedInteraction,
-    createCapturingFetch,
-    createOperationContext,
-    EXTERNAL_PARTY_DERIVATION_PATH,
-    EXTERNAL_PARTY_ID,
-    EXTERNAL_PARTY_JWT_TOKEN,
-    EXTERNAL_PARTY_KEY_FINGERPRINT,
-    EXTERNAL_PARTY_MNEMONIC,
-    EXTERNAL_PARTY_USER_ID,
-    INTERNAL_PARTY_ID,
-    INTERNAL_PARTY_JWT_TOKEN,
-    INTERNAL_PARTY_USER_ID,
-    printScenarioSummary,
-    saveInteractions,
-} from './capture-utils.js';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Helpers
-// ─────────────────────────────────────────────────────────────────────────────
-
-async function signWrongData(party: string): Promise<ExternalSignature> {
-    const signer = new MnemonicSignerAdapter({
-        mnemonicConfig: {
-            getMnemonic: async () => ({
-                mnemonic: EXTERNAL_PARTY_MNEMONIC,
-                path: EXTERNAL_PARTY_DERIVATION_PATH,
-            }),
-        },
-    });
-    const { createHash } = await import('crypto');
-    const wrongHash = createHash('sha256').update('this-is-wrong-data').digest();
-
-    const derSignature = await signer.sign({
-        data: wrongHash,
-        signatureType: SignatureType.ECDSA,
-        format: SignatureFormat.DER,
-    });
-
-    return {
-        party,
-        signature: Buffer.from(derSignature).toString('base64'),
-        format: 'SIGNATURE_FORMAT_DER',
-        signedBy: EXTERNAL_PARTY_KEY_FINGERPRINT,
-        signingAlgorithmSpec: 'SIGNING_ALGORITHM_SPEC_EC_DSA_SHA_256',
-    };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Scenarios
-// ─────────────────────────────────────────────────────────────────────────────
-
-async function captureNonExistentContract(sdk: CantonSdk, setOp: (n: string) => void) {
-    setOp('error_query_nonexistent_contract');
-    const fakeId =
-        '00' +
-        '00'.repeat(65) +
-        'ca1212200000000000000000000000000000000000000000000000000000000000000000';
-    try {
-        await sdk.get(fakeId as ContractId<typeof SimpleAsset>, [INTERNAL_PARTY_ID]);
-    } catch {
-        /* expected */
-    }
-}
-
-async function captureInvalidTemplateId(sdk: CantonSdk, setOp: (n: string) => void) {
-    setOp('error_invalid_template_id');
-    const cmd: Command = {
-        createCommand: {
-            templateId: 'invalid-package-id:SdkTest:SimpleAsset',
-            createArguments: {
-                owner: INTERNAL_PARTY_ID,
-                value: '100',
-                description: 'test',
-            },
-        },
-    };
-    try {
-        await sdk.submit({ actAs: [INTERNAL_PARTY_ID] }, [cmd]);
-    } catch {
-        /* expected */
-    }
-}
-
-async function captureDoubleArchive(sdk: CantonSdk, setOp: (n: string) => void) {
-    // Setup: create contract
-    setOp('double_archive_setup_create');
-    const payload = {
-        owner: INTERNAL_PARTY_ID,
-        value: '100',
-        description: 'double archive test',
-    };
-    const createCmd = sdk.buildCreate(SimpleAsset as any, payload, packageId);
-    const createResult = await sdk.submit({ actAs: [INTERNAL_PARTY_ID] }, [createCmd]);
-
-    setOp('double_archive_setup_wait');
-    const createWait = await sdk.waitForCommand(createResult.commandId, {
-        parties: [INTERNAL_PARTY_ID],
-        beginExclusive: createResult.completionOffset,
-        timeoutMs: 60_000,
-    });
-    if (createWait.status !== 'accepted') return;
-
-    setOp('double_archive_setup_fetch_id');
-    const update = await sdk.fetchTransaction(createWait.updateId, [INTERNAL_PARTY_ID]);
-    const createdWrapper = (update.events ?? []).find((e) => 'CreatedEvent' in e);
-    const contractId = (
-        createdWrapper && 'CreatedEvent' in createdWrapper
-            ? createdWrapper.CreatedEvent.contractId
-            : undefined
-    ) as ContractId<typeof SimpleAsset>;
-
-    // First archive (success)
-    setOp('double_archive_first_archive');
-    const archiveCmd1 = sdk.buildExercise(SimpleAsset.Archive, contractId, {}, packageId);
-    const archiveResult1 = await sdk.submit({ actAs: [INTERNAL_PARTY_ID] }, [archiveCmd1]);
-
-    setOp('double_archive_first_wait');
-    await sdk.waitForCommand(archiveResult1.commandId, {
-        parties: [INTERNAL_PARTY_ID],
-        beginExclusive: archiveResult1.completionOffset,
-        timeoutMs: 60_000,
-    });
-
-    // Second archive (should fail)
-    setOp('error_double_archive');
-    const archiveCmd2 = sdk.buildExercise(SimpleAsset.Archive, contractId, {}, packageId);
-    try {
-        await sdk.submit({ actAs: [INTERNAL_PARTY_ID] }, [archiveCmd2]);
-    } catch {
-        /* expected */
-    }
-}
-
-async function captureInvalidSignature(sdk: CantonSdk, setOp: (n: string) => void) {
-    setOp('invalid_signature_prepare');
-    const payload = {
-        owner: EXTERNAL_PARTY_ID,
-        value: '200',
-        description: 'invalid signature test',
-    };
-    const createCmd = sdk.buildCreate(SimpleAsset, payload, packageId);
-    const prepared = await sdk.prepareForSigning({ actAs: [EXTERNAL_PARTY_ID] }, [createCmd]);
-
-    setOp('error_invalid_signature');
-    const invalidSig = await signWrongData(EXTERNAL_PARTY_ID);
-    try {
-        await sdk.submitSigned(prepared, [invalidSig]);
-    } catch {
-        /* expected */
-    }
-}
-
-async function captureCommandTimeout(sdk: CantonSdk, setOp: (n: string) => void) {
-    setOp('error_command_timeout');
-    try {
-        await sdk.waitForCommand('fake-command-id', {
-            parties: [INTERNAL_PARTY_ID],
-            beginExclusive: 0,
-            timeoutMs: 2_000,
-        });
-    } catch {
-        /* expected */
-    }
-}
-
-async function captureUnauthorizedParty(sdk: CantonSdk, setOp: (n: string) => void) {
-    setOp('error_unauthorized_party');
-    const fakeParty = 'fake-party::1220' + '00'.repeat(32);
-    const payload = {
-        owner: fakeParty,
-        value: '100',
-        description: 'unauthorized test',
-    };
-    const cmd = sdk.buildCreate(SimpleAsset as any, payload, packageId);
-    try {
-        await sdk.submit({ actAs: [fakeParty] }, [cmd]);
-    } catch {
-        /* expected */
-    }
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Main
-// ─────────────────────────────────────────────────────────────────────────────
-
-async function main() {
-    console.log('Capturing unhappy path requests...');
-
-    const captured: CapturedInteraction[] = [];
-
-    // Internal party scenarios
-    const internalCtx = createOperationContext();
-    const internalConfig = new Configuration({
-        basePath: CANTON_URL,
-        fetchApi: createCapturingFetch({
-            captured,
-            getOperation: internalCtx.getOperation,
-            scenarioName: 'internal',
-        }),
-        headers: { Authorization: `Bearer ${INTERNAL_PARTY_JWT_TOKEN}` },
-    });
-    const internalSdk = new CantonSdk(new CantonClient(internalConfig, INTERNAL_PARTY_USER_ID));
-
-    await captureNonExistentContract(internalSdk, internalCtx.setOperation);
-    await captureInvalidTemplateId(internalSdk, internalCtx.setOperation);
-    await captureDoubleArchive(internalSdk, internalCtx.setOperation);
-    await captureCommandTimeout(internalSdk, internalCtx.setOperation);
-    await captureUnauthorizedParty(internalSdk, internalCtx.setOperation);
-
-    // External party scenarios
-    const externalCtx = createOperationContext();
-    const externalConfig = new Configuration({
-        basePath: CANTON_URL,
-        fetchApi: createCapturingFetch({
-            captured,
-            getOperation: externalCtx.getOperation,
-            scenarioName: 'external',
-        }),
-        headers: { Authorization: `Bearer ${EXTERNAL_PARTY_JWT_TOKEN}` },
-    });
-    const externalSdk = new CantonSdk(new CantonClient(externalConfig, EXTERNAL_PARTY_USER_ID));
-
-    await captureInvalidSignature(externalSdk, externalCtx.setOperation);
-
-    const outputFile = path.join(import.meta.dirname, '..', 'captured-unhappy-paths.json');
-    saveInteractions(outputFile, captured);
-    printScenarioSummary(captured);
-}
-
-main().catch((err) => {
-    console.error('Error:', err.message);
-    process.exit(1);
-});

package/test/mocks/scripts/capture-utils.ts

@@ -1,215 +0,0 @@
-/**
- * Shared utilities for capture scripts.
- */
-
-import * as fs from 'fs';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Configuration
-// ─────────────────────────────────────────────────────────────────────────────
-
-export const CANTON_URL = process.env.CANTON_URL ?? 'http://127.0.0.1:5013';
-
-// Internal party (keys managed by participant)
-export const INTERNAL_PARTY_USER_ID = process.env.INTERNAL_PARTY_USER_ID ?? '<INTERNAL_USER_ID>';
-export const INTERNAL_PARTY_JWT_TOKEN =
-    process.env.INTERNAL_PARTY_JWT_TOKEN ?? '<INTERNAL_JWT_TOKEN>';
-export const INTERNAL_PARTY_ID = process.env.INTERNAL_PARTY_ID ?? '<INTERNAL_PARTY_ID>';
-
-// External party (keys managed off-chain, signed submissions)
-export const EXTERNAL_PARTY_USER_ID = process.env.EXTERNAL_PARTY_USER_ID ?? '<EXTERNAL_USER_ID>';
-export const EXTERNAL_PARTY_JWT_TOKEN =
-    process.env.EXTERNAL_PARTY_JWT_TOKEN ?? '<EXTERNAL_JWT_TOKEN>';
-export const EXTERNAL_PARTY_ID = process.env.EXTERNAL_PARTY_ID ?? '<EXTERNAL_PARTY_ID>';
-export const EXTERNAL_PARTY_KEY_FINGERPRINT =
-    process.env.EXTERNAL_PARTY_KEY_FINGERPRINT ?? '<EXTERNAL_KEY_FINGERPRINT>';
-export const EXTERNAL_PARTY_MNEMONIC = process.env.EXTERNAL_PARTY_MNEMONIC ?? '<EXTERNAL_MNEMONIC>';
-export const EXTERNAL_PARTY_DERIVATION_PATH =
-    process.env.EXTERNAL_PARTY_DERIVATION_PATH ?? "m/44'/6767'/0'/0/0";
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Types
-// ─────────────────────────────────────────────────────────────────────────────
-
-export interface CapturedInteraction {
-    name: string;
-    scenario?: string;
-    timestamp: string;
-    request: {
-        method: string;
-        url: string;
-        path: string;
-        headers: Record<string, string>;
-        body: unknown;
-    };
-    response: {
-        status: number;
-        statusText: string;
-        headers: Record<string, string>;
-        body: unknown;
-    };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Endpoint Name Mapping
-// ─────────────────────────────────────────────────────────────────────────────
-
-const ENDPOINT_NAMES: Record<string, string> = {
-    '/v2/state/connected-synchronizers': 'get_synchronizers',
-    '/v2/state/ledger-end': 'get_ledger_end',
-    '/v2/commands/async/submit': 'submit_command',
-    '/v2/commands/completions': 'wait_completion',
-    '/v2/updates/update-by-id': 'fetch_update',
-    '/v2/events/events-by-contract-id': 'get_contract',
-    '/v2/interactive-submission/prepare': 'prepare_signing',
-    '/v2/interactive-submission/execute': 'submit_signed',
-};
-
-export function getEndpointName(path: string, method: string): string {
-    return ENDPOINT_NAMES[path] ?? `${method.toLowerCase()}_${path.replace(/\//g, '_')}`;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Operation Context
-// ─────────────────────────────────────────────────────────────────────────────
-
-export function createOperationContext() {
-    let currentOperation = 'unknown';
-
-    return {
-        setOperation(name: string) {
-            currentOperation = name;
-        },
-        getOperation() {
-            return currentOperation;
-        },
-    };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Capturing Fetch Wrapper
-// ─────────────────────────────────────────────────────────────────────────────
-
-export interface CapturingFetchOptions {
-    captured: CapturedInteraction[];
-    getOperation: () => string;
-    scenarioName?: string;
-}
-
-export function createCapturingFetch(options: CapturingFetchOptions): typeof fetch {
-    const { captured, getOperation, scenarioName } = options;
-
-    return async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {
-        const url = typeof input === 'string' ? input : input.toString();
-        const method = init?.method ?? 'GET';
-        const path = new URL(url).pathname;
-        const requestName = `${getOperation()}__${getEndpointName(path, method)}`;
-
-        // Parse request body
-        let requestBody: unknown = null;
-        if (init?.body) {
-            try {
-                requestBody = JSON.parse(init.body as string);
-            } catch {
-                requestBody = init.body;
-            }
-        }
-
-        // Extract request headers
-        const requestHeaders: Record<string, string> = {};
-        if (init?.headers) {
-            if (init.headers instanceof Headers) {
-                init.headers.forEach((value, key) => {
-                    requestHeaders[key] = value;
-                });
-            } else if (Array.isArray(init.headers)) {
-                init.headers.forEach(([key, value]) => {
-                    requestHeaders[key] = value;
-                });
-            } else {
-                for (const [key, value] of Object.entries(init.headers)) {
-                    requestHeaders[key] = value;
-                }
-            }
-        }
-
-        // Execute real fetch
-        const response = await fetch(input, init);
-
-        // Clone response to read body without consuming
-        const cloned = response.clone();
-        let responseBody: unknown;
-        const contentType = response.headers.get('content-type') ?? '';
-
-        if (contentType.includes('application/json')) {
-            try {
-                responseBody = await cloned.json();
-            } catch {
-                responseBody = await cloned.text();
-            }
-        } else {
-            responseBody = await cloned.text();
-        }
-
-        // Extract response headers
-        const responseHeaders: Record<string, string> = {};
-        response.headers.forEach((value, key) => {
-            responseHeaders[key] = value;
-        });
-
-        // Store captured interaction
-        const interaction: CapturedInteraction = {
-            name: requestName,
-            timestamp: new Date().toISOString(),
-            request: {
-                method,
-                url,
-                path,
-                headers: requestHeaders,
-                body: requestBody,
-            },
-            response: {
-                status: response.status,
-                statusText: response.statusText,
-                headers: responseHeaders,
-                body: responseBody,
-            },
-        };
-
-        if (scenarioName) {
-            interaction.scenario = scenarioName;
-        }
-
-        captured.push(interaction);
-
-        return response;
-    };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// File Output
-// ─────────────────────────────────────────────────────────────────────────────
-
-export function saveInteractions(outputFile: string, captured: CapturedInteraction[]): void {
-    fs.writeFileSync(outputFile, JSON.stringify(captured, null, 2));
-    console.log(`\n✓ Saved ${captured.length} interactions to:`);
-    console.log(`  ${outputFile}`);
-}
-
-export function printEndpointSummary(captured: CapturedInteraction[]): void {
-    const endpoints = new Set(captured.map((c) => `${c.request.method} ${c.request.path}`));
-    console.log('\nCaptured endpoints:');
-    endpoints.forEach((e) => console.log(`  - ${e}`));
-}
-
-export function printScenarioSummary(captured: CapturedInteraction[]): void {
-    const scenarios = new Map<string, number>();
-    for (const interaction of captured) {
-        const key = `${interaction.scenario}: ${interaction.response.status}`;
-        scenarios.set(key, (scenarios.get(key) ?? 0) + 1);
-    }
-    console.log('\nCaptured scenarios:');
-    scenarios.forEach((count, scenario) => {
-        console.log(`  - ${scenario} (${count} requests)`);
-    });
-}