@fairmint/canton-node-sdk 0.0.222 → 0.0.223

package/scripts/generate-operation-tests.ts

@@ -1,198 +0,0 @@
-#!/usr/bin/env tsx
-
-import * as fs from 'fs';
-import { glob } from 'glob';
-import * as path from 'path';
-
-interface OperationInfo {
-  name: string;
-  filePath: string;
-  testPath: string;
-  paramsSchema: string;
-  method: string;
-  endpoint: string;
-}
-
-async function findOperations(): Promise<OperationInfo[]> {
-  const operations: OperationInfo[] = [];
-
-  // Find all operation files
-  const operationFiles = await glob('src/clients/**/*.ts', {
-    ignore: ['**/index.ts', '**/register.ts', '**/schemas/**', '**/*.generated.ts'],
-  });
-
-  for (const file of operationFiles) {
-    const content = fs.readFileSync(file, 'utf-8');
-
-    // Check if this is an operation file by looking for createApiOperation
-    if (content.includes('createApiOperation')) {
-      const nameMatch = content.match(/export const (\w+) = createApiOperation/);
-      if (nameMatch?.[1]) {
-        const name = nameMatch[1];
-        const methodMatch = content.match(/method:\s*['"`]([A-Z]+)['"`]/);
-        const endpointMatch = content.match(/endpoint\s*=\s*['"`]([^'"`]+)['"`]/);
-        const paramsSchemaMatch = content.match(/paramsSchema:\s*(\w+)/);
-
-        const method = methodMatch?.[1] ?? 'GET';
-        const endpoint = endpointMatch?.[1] ?? '/unknown';
-        const paramsSchema = paramsSchemaMatch?.[1] ?? 'z.any()';
-
-        // Generate test path
-        const relativePath = path.relative('src', file);
-        const testPath = `test/${relativePath.replace('.ts', '.test.ts')}`;
-
-        operations.push({
-          name,
-          filePath: file,
-          testPath,
-          paramsSchema,
-          method,
-          endpoint,
-        });
-      }
-    }
-  }
-
-  return operations;
-}
-
-function generateTestContent(operation: OperationInfo): string {
-  const importPath = path
-    .relative(path.dirname(operation.testPath), path.dirname(operation.filePath))
-    .replace(/\\/g, '/');
-  const mockClientPath = path.relative(path.dirname(operation.testPath), 'test/utils').replace(/\\/g, '/');
-  const configPath = path.relative(path.dirname(operation.testPath), 'test/config').replace(/\\/g, '/');
-
-  const isValidatorApi = operation.filePath.includes('validator-api');
-
-  let mockClientClass = 'MockLedgerJsonApiClient';
-  let apiUrlKey = 'LEDGER_JSON_API';
-
-  if (isValidatorApi) {
-    mockClientClass = 'MockValidatorApiClient';
-    apiUrlKey = 'VALIDATOR_API';
-  }
-
-  return `import { ${mockClientClass} } from '${mockClientPath}';
-import { ${operation.name} } from '${importPath}/${operation.name}';
-import { mockClientConfig, mockApiUrls } from '${configPath}/testConfig';
-
-describe('${operation.name} Operation', () => {
-  let mockClient: ${mockClientClass};
-  let operation: InstanceType<typeof ${operation.name}>;
-
-  beforeEach(() => {
-    mockClient = new ${mockClientClass}(mockClientConfig);
-    operation = new ${operation.name}(mockClient);
-    mockClient.clearMocks();
-  });
-
-  describe('Network Activity Validation', () => {
-    it('should make a ${operation.method} request to the correct endpoint', async () => {
-      // Arrange
-      const params = ${operation.paramsSchema === 'z.any()' ? '{}' : '{}'};
-      const mockResponse = {};
-      const expectedUrl = \`\${mockApiUrls.${apiUrlKey}}${operation.endpoint}\`;
-
-      mockClient.setMockResponse(expectedUrl, mockResponse);
-
-      // Act
-      const result = await operation.execute(params);
-
-      // Assert
-      expect(result).toEqual(mockResponse);
-
-      const requests = mockClient.getRequests();
-      expect(requests).toHaveLength(1);
-
-      const request = requests[0];
-      expect(request).toBeDefined();
-      expect(request!.method).toBe('${operation.method}');
-      expect(request!.url).toBe(expectedUrl);
-    });
-
-    it('should include proper headers in the request', async () => {
-      // Arrange
-      const params = ${operation.paramsSchema === 'z.any()' ? '{}' : '{}'};
-      const mockResponse = {};
-      const expectedUrl = \`\${mockApiUrls.${apiUrlKey}}${operation.endpoint}\`;
-
-      mockClient.setMockResponse(expectedUrl, mockResponse);
-
-      // Act
-      await operation.execute(params);
-
-      // Assert
-      const request = mockClient.getLastRequest();
-      expect(request).toBeDefined();
-      expect(request?.headers).toBeDefined();
-    });
-  });
-
-  describe('Error Handling', () => {
-    it('should propagate network errors', async () => {
-      // Arrange
-      const params = ${operation.paramsSchema === 'z.any()' ? '{}' : '{}'};
-      const expectedUrl = \`\${mockApiUrls.${apiUrlKey}}${operation.endpoint}\`;
-      const networkError = new Error('Network error');
-
-      mockClient.setMockError(expectedUrl, networkError);
-
-      // Act & Assert
-      await expect(operation.execute(params)).rejects.toThrow('Network error');
-
-      const requests = mockClient.getRequests();
-      expect(requests).toHaveLength(1);
-    });
-  });
-
-  describe('Parameter Validation', () => {
-    it('should accept valid parameters', async () => {
-      // Arrange
-      const params = ${operation.paramsSchema === 'z.any()' ? '{}' : '{}'};
-      const mockResponse = {};
-      const expectedUrl = \`\${mockApiUrls.${apiUrlKey}}${operation.endpoint}\`;
-
-      mockClient.setMockResponse(expectedUrl, mockResponse);
-
-      // Act & Assert
-      await expect(operation.execute(params)).resolves.toEqual(mockResponse);
-    });
-  });
-});
-`;
-}
-
-async function generateTests(): Promise<void> {
-  console.log('Finding operations...');
-  const operations = await findOperations();
-
-  console.log(`Found ${operations.length} operations`);
-
-  for (const operation of operations) {
-    // Create test directory if it doesn't exist
-    const testDir = path.dirname(operation.testPath);
-    if (!fs.existsSync(testDir)) {
-      fs.mkdirSync(testDir, { recursive: true });
-    }
-
-    // Check if test already exists
-    if (fs.existsSync(operation.testPath)) {
-      console.log(`Test already exists: ${operation.testPath}`);
-      continue;
-    }
-
-    const testContent = generateTestContent(operation);
-    fs.writeFileSync(operation.testPath, testContent);
-    console.log(`Generated test: ${operation.testPath}`);
-  }
-
-  console.log('Test generation complete');
-}
-
-if (require.main === module) {
-  generateTests().catch((error) => {
-    console.error('Error generating tests:', error);
-    process.exit(1);
-  });
-}

package/scripts/grant-user-rights.ts

@@ -1,213 +0,0 @@
-#!/usr/bin/env tsx
-import 'dotenv/config';
-import { CantonRuntime, EnvLoader, LedgerJsonApiClient, ValidatorApiClient } from '../src';
-import type { GrantUserRightsParams } from '../src/clients/ledger-json-api/schemas/operations/users';
-import type { NetworkType } from '../src/core/types';
-
-/** Rights type expected by grant/revoke APIs (with value wrapper) */
-type GrantableRight = NonNullable<GrantUserRightsParams['rights']>[number];
-
-/** Create default admin rights for a user */
-function createAdminRights(): GrantableRight[] {
-  return [
-    {
-      kind: {
-        ParticipantAdmin: { value: {} },
-      },
-    },
-  ];
-}
-
-/** Create CanExecuteAsAnyParty rights for a user */
-function createExecuteAsAnyPartyRights(): GrantableRight[] {
-  return [
-    {
-      kind: {
-        CanExecuteAsAnyParty: { value: {} },
-      },
-    },
-  ];
-}
-
-/** Create CanReadAsAnyParty rights for a user */
-function createReadAsAnyPartyRights(): GrantableRight[] {
-  return [
-    {
-      kind: {
-        CanReadAsAnyParty: { value: {} },
-      },
-    },
-  ];
-}
-
-/** Create party-specific rights for a user */
-function createPartyRights(partyId: string): GrantableRight[] {
-  return [
-    {
-      kind: {
-        CanActAs: { value: { party: partyId } },
-      },
-    },
-  ];
-}
-
-async function main(): Promise<void> {
-  console.log('=== Grant User Rights Utility ===\n');
-
-  // Parse command line arguments
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log(`
-Usage: tsx scripts/grant-user-rights.ts [options]
-
-Options:
-  --user-id <id>              User ID to grant rights to (defaults to authenticated user)
-  --party-id <id>             Party ID for party-specific rights (optional)
-  --admin                     Grant ParticipantAdmin rights (default if no other right specified)
-  --execute-any-party         Grant CanExecuteAsAnyParty rights
-  --read-any-party            Grant CanReadAsAnyParty rights
-  --network <network>         Target network (devnet|testnet|mainnet, defaults to CANTON_CURRENT_NETWORK)
-  --provider <provider>       Target provider (defaults to CANTON_CURRENT_PROVIDER)
-  --help, -h                  Show this help message
-
-Examples:
-  # Grant admin rights to authenticated user (uses current network/provider from env)
-  npm run grant-user-rights -- --admin
-
-  # Grant CanExecuteAsAnyParty rights to authenticated user
-  npm run grant-user-rights -- --execute-any-party
-
-  # Grant CanReadAsAnyParty rights to authenticated user
-  npm run grant-user-rights -- --read-any-party
-
-  # Grant admin rights to specific user on devnet/intellect
-  npm run grant-user-rights -- --user-id "5" --admin --network devnet --provider intellect
-
-  # Grant party rights to authenticated user
-  npm run grant-user-rights -- --party-id "alice::party1"
-    `);
-    process.exit(0);
-  }
-
-  // Parse arguments
-  const userIdIndex = args.indexOf('--user-id');
-  const targetUserId = userIdIndex !== -1 ? args[userIdIndex + 1] : undefined;
-
-  const partyIdIndex = args.indexOf('--party-id');
-  const partyId = partyIdIndex !== -1 ? args[partyIdIndex + 1] : undefined;
-
-  const executeAnyParty = args.includes('--execute-any-party');
-  const readAnyParty = args.includes('--read-any-party');
-
-  const networkIndex = args.indexOf('--network');
-  const network = networkIndex !== -1 ? (args[networkIndex + 1] as NetworkType) : undefined;
-
-  const providerIndex = args.indexOf('--provider');
-  const provider = providerIndex !== -1 ? args[providerIndex + 1] : undefined;
-
-  // Determine which rights to grant
-  let rights: GrantableRight[];
-  let rightsType: string;
-
-  if (partyId) {
-    rights = createPartyRights(partyId);
-    rightsType = 'Party Rights (CanActAs)';
-  } else if (executeAnyParty) {
-    rights = createExecuteAsAnyPartyRights();
-    rightsType = 'CanExecuteAsAnyParty';
-  } else if (readAnyParty) {
-    rights = createReadAsAnyPartyRights();
-    rightsType = 'CanReadAsAnyParty';
-  } else {
-    rights = createAdminRights();
-    rightsType = 'ParticipantAdmin';
-  }
-
-  console.log('Configuration:');
-  console.log(`  Network: ${network ?? 'from CANTON_CURRENT_NETWORK'}`);
-  console.log(`  Provider: ${provider ?? 'from CANTON_CURRENT_PROVIDER'}`);
-  if (targetUserId) {
-    console.log(`  Target User ID: ${targetUserId}`);
-  } else {
-    console.log(`  Target User ID: <will auto-detect from authenticated user>`);
-  }
-  if (partyId) {
-    console.log(`  Party ID: ${partyId}`);
-  }
-  console.log(`  Rights Type: ${rightsType}\n`);
-
-  try {
-    const configOptions = {
-      ...(network !== undefined && { network }),
-      ...(provider !== undefined && { provider }),
-    };
-    const runtime = new CantonRuntime(EnvLoader.getConfig('LEDGER_JSON_API', configOptions));
-    const client = new LedgerJsonApiClient(runtime);
-    const validatorClient = new ValidatorApiClient(runtime);
-
-    console.log(`Connected to Ledger JSON API`);
-
-    // If no target user ID provided, get the authenticated user
-    let resolvedUserId: string;
-    if (!targetUserId) {
-      console.log('Fetching authenticated user ID...');
-      const authenticatedUser = await validatorClient.getValidatorUserInfo();
-      resolvedUserId = authenticatedUser.user_name;
-      console.log(`Using authenticated user: ${resolvedUserId}`);
-    } else {
-      resolvedUserId = targetUserId;
-      console.log(`Target user: ${resolvedUserId}`);
-    }
-
-    console.log(`\nRights to grant: ${JSON.stringify(rights, null, 2)}`);
-
-    // Check current rights
-    console.log('\nChecking current rights...');
-    try {
-      const currentRights = await client.listUserRights({
-        userId: resolvedUserId,
-      });
-      console.log(`Current rights count: ${currentRights.rights?.length ?? 0}`);
-    } catch (error) {
-      console.log(`Could not list current rights: ${error instanceof Error ? error.message : String(error)}`);
-    }
-
-    // Grant the rights
-    console.log('\nGranting rights...');
-    const result = await client.grantUserRights({
-      userId: resolvedUserId,
-      rights,
-    });
-
-    console.log(`\n✓ Successfully granted ${result.newlyGrantedRights?.length ?? 0} new rights`);
-    if (result.newlyGrantedRights && result.newlyGrantedRights.length > 0) {
-      console.log(`\nNewly granted rights:`);
-      console.log(JSON.stringify(result.newlyGrantedRights, null, 2));
-    } else {
-      console.log('\n(Rights may have already existed)');
-    }
-
-    // Verify by listing rights again
-    console.log('\nVerifying...');
-    const finalRights = await client.listUserRights({
-      userId: resolvedUserId,
-    });
-    console.log(`Final rights count: ${finalRights.rights?.length ?? 0}`);
-
-    console.log('\n✓ Done!');
-  } catch (error) {
-    console.error('\n✗ Failed to grant rights:');
-    console.error(`  ${error instanceof Error ? error.message : String(error)}`);
-    if (error instanceof Error && error.stack) {
-      console.error(`\nStack trace:`);
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/scripts/list-identity-providers.ts

@@ -1,46 +0,0 @@
-#!/usr/bin/env tsx
-import 'dotenv/config';
-import { CantonRuntime, EnvLoader, LedgerJsonApiClient } from '../src';
-
-/** List all configured identity providers in the Canton system */
-async function main(): Promise<void> {
-  console.log('=== List Identity Providers ===\n');
-
-  try {
-    const client = new LedgerJsonApiClient(new CantonRuntime(EnvLoader.getConfig('LEDGER_JSON_API')));
-
-    console.log('Fetching identity provider configs...\n');
-    const result = await client.listIdentityProviderConfigs({});
-
-    if (result.identityProviderConfigs.length === 0) {
-      console.log('No identity providers configured.');
-      return;
-    }
-
-    console.log(`Found ${result.identityProviderConfigs.length} identity provider(s):\n`);
-
-    result.identityProviderConfigs.forEach((config, index) => {
-      console.log(`${index + 1}. Identity Provider ID: "${config.identityProviderId}"`);
-      console.log(`   Issuer: ${config.issuer}`);
-      console.log(`   JWKS URL: ${config.jwksUrl}`);
-      console.log(`   Audience: ${config.audience ?? 'N/A'}`);
-      console.log(`   Is Deactivated: ${config.isDeactivated}`);
-      console.log('');
-    });
-
-    console.log('✓ Done!');
-  } catch (error) {
-    console.error('\n✗ Failed to list identity providers:');
-    console.error(`  ${error instanceof Error ? error.message : String(error)}`);
-    if (error instanceof Error && error.stack) {
-      console.error(`\nStack trace:`);
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/scripts/localnet/localnet-cloud.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../localnet-cloud.sh" "$@"

package/scripts/localnet/localnet-status.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../localnet-status.sh"

package/scripts/localnet/setup-localnet.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../setup-localnet.sh"

package/scripts/localnet/setup-quickstart-localnet.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../setup-quickstart-localnet.sh"

package/scripts/localnet/start-localnet.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../start-localnet.sh"

package/scripts/localnet/stop-localnet.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "${SCRIPT_DIR}/../stop-localnet.sh"