@fairmint/canton-node-sdk 0.0.221 → 0.0.223

package/scripts/prepare-release.ts

@@ -1,222 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Prepare Release Script
- *
- * Prepares a new release by incrementing version and generating changelog.
- *
- * Usage: npm run prepare-release
- *
- * Features:
- *
- * - Increments patch version in package.json
- * - Checks both npm registry and git tags to determine next version
- * - Creates changelog from commits since last tag
- * - Links commits to GitHub PRs
- * - Safe for local testing (no git operations)
- * - Saves changelog to CHANGELOG.md
- */
-
-import { execSync } from 'child_process';
-import fs from 'fs';
-import path from 'path';
-
-interface PackageJson {
-  name: string;
-  version: string;
-  [key: string]: unknown;
-}
-
-/** Check if a git tag exists */
-function tagExists(tag: string): boolean {
-  try {
-    execSync(`git rev-parse "refs/tags/${tag}"`, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/** Get the latest version from npm registry */
-function getNpmLatestVersion(packageName: string): string | null {
-  try {
-    const version = execSync(`npm view ${packageName} version 2>/dev/null`, {
-      encoding: 'utf8',
-    }).trim();
-    return version || null;
-  } catch {
-    return null;
-  }
-}
-
-/** Check if a version exists on npm registry */
-function npmVersionExists(packageName: string, version: string): boolean {
-  try {
-    const versions = execSync(`npm view ${packageName} versions --json 2>/dev/null`, {
-      encoding: 'utf8',
-    });
-    const versionList = JSON.parse(versions) as string[];
-    return versionList.includes(version);
-  } catch {
-    return false;
-  }
-}
-
-/** Parse version string into components */
-function parseVersion(version: string): { major: number; minor: number; patch: number } | null {
-  const parts = version.split('.').map(Number);
-  if (parts.length !== 3 || parts.some(isNaN)) {
-    return null;
-  }
-  const major = parts[0];
-  const minor = parts[1];
-  const patch = parts[2];
-  if (major === undefined || minor === undefined || patch === undefined) {
-    return null;
-  }
-  return { major, minor, patch };
-}
-
-/** Find the next available version by checking both git tags and npm registry */
-function findNextAvailableVersion(packageName: string, major: number, minor: number, startPatch: number): string {
-  let patch = startPatch;
-  let version: string;
-
-  do {
-    patch++;
-    version = `${major}.${minor}.${patch}`;
-  } while (tagExists(`v${version}`) || npmVersionExists(packageName, version));
-
-  return version;
-}
-
-/** Get the highest version from git tags and npm, then find next available */
-function determineNextVersion(packageName: string, currentVersion: string): string {
-  const current = parseVersion(currentVersion);
-  if (!current) {
-    throw new Error(`Invalid version format: ${currentVersion}`);
-  }
-
-  // Get latest version from npm registry
-  const npmVersion = getNpmLatestVersion(packageName);
-  const npm = npmVersion ? parseVersion(npmVersion) : null;
-
-  // Get latest version from git tags
-  let gitVersion: string | null = null;
-  try {
-    gitVersion = execSync('git describe --tags --abbrev=0 2>/dev/null', {
-      encoding: 'utf8',
-    }).trim();
-    if (gitVersion.startsWith('v')) {
-      gitVersion = gitVersion.slice(1);
-    }
-  } catch {
-    gitVersion = null;
-  }
-  const git = gitVersion ? parseVersion(gitVersion) : null;
-
-  // Determine the highest patch version among current, npm, and git
-  let highestPatch = current.patch;
-
-  if (npm?.major === current.major && npm.minor === current.minor) {
-    highestPatch = Math.max(highestPatch, npm.patch);
-  }
-
-  if (git?.major === current.major && git.minor === current.minor) {
-    highestPatch = Math.max(highestPatch, git.patch);
-  }
-
-  console.log(`Current version: ${currentVersion}`);
-  console.log(`NPM latest version: ${npmVersion ?? 'not found'}`);
-  console.log(`Git latest tag: ${gitVersion ? `v${gitVersion}` : 'not found'}`);
-  console.log(`Highest patch in ${current.major}.${current.minor}.x: ${highestPatch}`);
-
-  // Find next available version starting from the highest
-  return findNextAvailableVersion(packageName, current.major, current.minor, highestPatch);
-}
-
-/**
- * Prepare release by incrementing version and generating changelog This script can be run locally to test the release
- * process
- */
-function prepareRelease(): void {
-  try {
-    // Read package.json
-    const packageJsonPath: string = path.join(process.cwd(), 'package.json');
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as PackageJson;
-
-    const currentVersion: string = packageJson.version;
-    const packageName: string = packageJson.name;
-
-    // Find next available version by checking both npm and git tags
-    const newVersion: string = determineNextVersion(packageName, currentVersion);
-
-    // Update version in package.json (without git tag)
-    packageJson.version = newVersion;
-    fs.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
-
-    // Generate changelog since last tag or main branch
-    let commits: string;
-    let lastTag: string | null = null;
-    try {
-      lastTag = execSync('git describe --tags --abbrev=0 2>/dev/null', {
-        encoding: 'utf8',
-      }).trim();
-
-      commits = execSync(`git log --oneline --format="%s" ${lastTag}..HEAD`, {
-        encoding: 'utf8',
-      }).trim();
-    } catch {
-      // No previous tag, get commits ahead of main branch
-
-      commits = execSync('git log --oneline --format="%s" main..HEAD', {
-        encoding: 'utf8',
-      }).trim();
-    }
-
-    if (!commits) {
-      return;
-    }
-
-    // Extract PR numbers and create changelog
-    const commitLines: string[] = commits.split('\n').map((commit: string): string => `- ${commit}`);
-
-    const changelog: string = commitLines.join('\n');
-
-    // Create detailed tag message
-    const _tagMessage = `Release v${newVersion}\n\nChanges:\n${changelog}`;
-
-    console.log('Release tag prepared:', _tagMessage);
-
-    // Save changelog to file for reference
-    const changelogPath: string = path.join(process.cwd(), 'CHANGELOG.md');
-
-    // Add previous version link if available
-    const previousVersionLink: string = lastTag
-      ? `\n[Previous version: ${lastTag}](https://github.com/Fairmint/canton-node-sdk/releases/tag/${lastTag})`
-      : '';
-
-    const changelogContent = `# Changelog for v${newVersion}\n\n${changelog}${previousVersionLink}\n\n`;
-
-    // Prepend to existing changelog if it exists
-    if (fs.existsSync(changelogPath)) {
-      const existingChangelog: string = fs.readFileSync(changelogPath, 'utf8');
-      fs.writeFileSync(changelogPath, changelogContent + existingChangelog);
-    } else {
-      fs.writeFileSync(changelogPath, changelogContent);
-    }
-
-    console.log('Changelog updated successfully');
-    console.log('Release preparation complete');
-  } catch (_error) {
-    console.error('Error preparing release:', _error);
-    process.exit(1);
-  }
-}
-
-// Run the script
-if (require.main === module) {
-  prepareRelease();
-}
-
-export { prepareRelease };

package/scripts/revoke-user-rights.ts

@@ -1,219 +0,0 @@
-#!/usr/bin/env tsx
-import 'dotenv/config';
-import { CantonRuntime, EnvLoader, LedgerJsonApiClient, ValidatorApiClient } from '../src';
-import type { RevokeUserRightsParams } 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 RevokableRight = NonNullable<RevokeUserRightsParams['rights']>[number];
-
-/** Create party-specific rights for revoke operation */
-function createPartyRightsForRevoke(partyId: string): RevokableRight[] {
-  return [
-    {
-      kind: {
-        CanActAs: { value: { party: partyId } },
-      },
-    },
-  ];
-}
-
-/** Create admin rights for revoke operation */
-function createAdminRightsForRevoke(): RevokableRight[] {
-  return [
-    {
-      kind: {
-        ParticipantAdmin: { value: {} },
-      },
-    },
-  ];
-}
-
-/** Create CanExecuteAsAnyParty rights for revoke operation */
-function createExecuteAsAnyPartyRightsForRevoke(): RevokableRight[] {
-  return [
-    {
-      kind: {
-        CanExecuteAsAnyParty: { value: {} },
-      },
-    },
-  ];
-}
-
-/** Create CanReadAsAnyParty rights for revoke operation */
-function createReadAsAnyPartyRightsForRevoke(): RevokableRight[] {
-  return [
-    {
-      kind: {
-        CanReadAsAnyParty: { value: {} },
-      },
-    },
-  ];
-}
-
-async function main(): Promise<void> {
-  console.log('=== Revoke 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/revoke-user-rights.ts [options]
-
-Options:
-  --user-id <id>              User ID to revoke rights from (defaults to authenticated user)
-  --party-id <id>             Party ID for party-specific rights (optional)
-  --admin                     Revoke ParticipantAdmin rights
-  --execute-any-party         Revoke CanExecuteAsAnyParty rights
-  --read-any-party            Revoke 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:
-  # Revoke admin rights from authenticated user (uses current network/provider from env)
-  npm run revoke-user-rights -- --admin
-
-  # Revoke CanExecuteAsAnyParty rights from authenticated user
-  npm run revoke-user-rights -- --execute-any-party
-
-  # Revoke CanReadAsAnyParty rights from authenticated user
-  npm run revoke-user-rights -- --read-any-party
-
-  # Revoke admin rights from specific user on devnet/intellect
-  npm run revoke-user-rights -- --user-id "5" --admin --network devnet --provider intellect
-
-  # Revoke party rights from authenticated user
-  npm run revoke-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 admin = args.includes('--admin');
-  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 revoke
-  let rights: RevokableRight[];
-  let rightsType: string;
-
-  if (partyId) {
-    rights = createPartyRightsForRevoke(partyId);
-    rightsType = 'Party Rights (CanActAs)';
-  } else if (executeAnyParty) {
-    rights = createExecuteAsAnyPartyRightsForRevoke();
-    rightsType = 'CanExecuteAsAnyParty';
-  } else if (readAnyParty) {
-    rights = createReadAsAnyPartyRightsForRevoke();
-    rightsType = 'CanReadAsAnyParty';
-  } else if (admin) {
-    rights = createAdminRightsForRevoke();
-    rightsType = 'ParticipantAdmin';
-  } else {
-    console.error(
-      'Error: You must specify which rights to revoke (--admin, --execute-any-party, --read-any-party, or --party-id)'
-    );
-    process.exit(1);
-  }
-
-  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 revoke: ${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)}`);
-    }
-
-    // Revoke the rights
-    console.log('\nRevoking rights...');
-    const result = await client.revokeUserRights({
-      userId: resolvedUserId,
-      rights,
-    });
-
-    console.log(`\n✓ Successfully revoked ${result.newlyRevokedRights?.length ?? 0} rights`);
-    if (result.newlyRevokedRights && result.newlyRevokedRights.length > 0) {
-      console.log(`\nNewly revoked rights:`);
-      console.log(JSON.stringify(result.newlyRevokedRights, null, 2));
-    } else {
-      console.log('\n(No rights were revoked - they may not have 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 revoke 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/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-quickstart-localnet.sh"

package/scripts/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}/localnet-cloud.sh" setup

package/scripts/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}/localnet-cloud.sh" start

package/scripts/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}/localnet-cloud.sh" stop