@agirails/sdk 2.0.1-beta → 2.0.2

package/src/cli/commands/init.ts

@@ -0,0 +1,161 @@
+/**
+ * Init Command - Initialize ACTP in the current directory
+ *
+ * Creates .actp/ directory with configuration and initial state.
+ * Supports interactive and non-interactive modes.
+ *
+ * @module cli/commands/init
+ */
+
+import * as crypto from 'crypto';
+import { Command } from 'commander';
+import {
+  saveConfig,
+  addToGitignore,
+  isInitialized,
+  getActpDir,
+  CLIConfig,
+  CLIMode,
+} from '../utils/config';
+import { Output, ExitCode } from '../utils/output';
+import { MockStateManager } from '../../runtime/MockStateManager';
+
+// ============================================================================
+// Command Definition
+// ============================================================================
+
+export function createInitCommand(): Command {
+  const cmd = new Command('init')
+    .description('Initialize ACTP in the current directory')
+    .option('-m, --mode <mode>', 'Operating mode: mock, testnet, mainnet', 'mock')
+    .option('-a, --address <address>', 'Your Ethereum address')
+    .option('-f, --force', 'Overwrite existing configuration')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output')
+    .action(async (options) => {
+      const output = new Output(
+        options.json ? 'json' : options.quiet ? 'quiet' : 'human'
+      );
+
+      try {
+        await runInit(options, output);
+      } catch (error) {
+        output.errorResult({
+          code: 'INIT_FAILED',
+          message: (error as Error).message,
+        });
+        process.exit(ExitCode.ERROR);
+      }
+    });
+
+  return cmd;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+interface InitOptions {
+  mode: string;
+  address?: string;
+  force?: boolean;
+}
+
+async function runInit(options: InitOptions, output: Output): Promise<void> {
+  const projectRoot = process.cwd();
+
+  // Check if already initialized
+  if (isInitialized(projectRoot) && !options.force) {
+    throw new Error(
+      'ACTP already initialized in this directory.\n' +
+        'Use --force to reinitialize.'
+    );
+  }
+
+  // Validate mode
+  const validModes: CLIMode[] = ['mock', 'testnet', 'mainnet'];
+  if (!validModes.includes(options.mode as CLIMode)) {
+    throw new Error(
+      `Invalid mode: "${options.mode}". Valid modes: ${validModes.join(', ')}`
+    );
+  }
+
+  const mode = options.mode as CLIMode;
+
+  // Get or generate address
+  let address = options.address;
+  if (!address) {
+    if (mode === 'mock') {
+      // Generate a random address for mock mode
+      address = '0x' + crypto.randomBytes(20).toString('hex');
+      output.info(`Generated mock address: ${address}`);
+    } else {
+      throw new Error(
+        `Address required for ${mode} mode.\n` +
+          'Use --address <your-address> to specify.'
+      );
+    }
+  }
+
+  // Validate address format
+  if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
+    throw new Error(
+      `Invalid address format: "${address}"\n` +
+        'Expected 0x-prefixed 40-character hex string.'
+    );
+  }
+
+  // Create configuration
+  const config: CLIConfig = {
+    mode,
+    address: address.toLowerCase(),
+    version: '1.0',
+  };
+
+  // Save configuration
+  saveConfig(config, projectRoot);
+  output.success('Configuration saved');
+
+  // Initialize mock state if in mock mode
+  if (mode === 'mock') {
+    const stateManager = new MockStateManager(projectRoot);
+    if (!stateManager.exists() || options.force) {
+      stateManager.reset();
+      output.success('Mock state initialized');
+    }
+
+    // Mint initial tokens for the address
+    const { MockRuntime } = await import('../../runtime/MockRuntime');
+    const runtime = new MockRuntime(stateManager);
+    await runtime.mintTokens(address.toLowerCase(), '10000000000'); // 10,000 USDC
+    output.info('Minted 10,000 USDC to your address');
+  }
+
+  // Add to gitignore
+  try {
+    addToGitignore(projectRoot);
+    output.success('Added .actp/ to .gitignore');
+  } catch {
+    output.warning('Could not update .gitignore (may not exist)');
+  }
+
+  // Output result
+  output.blank();
+  output.result(
+    {
+      initialized: true,
+      directory: getActpDir(projectRoot),
+      mode,
+      address,
+    },
+    { quietKey: 'address' }
+  );
+
+  output.blank();
+  output.print('Next steps:');
+  output.print('  1. Create a payment: actp pay <provider> <amount>');
+  output.print('  2. Check your balance: actp balance');
+  output.print('  3. List transactions: actp tx list');
+}
+
+export { runInit };

package/src/cli/commands/mint.ts

@@ -0,0 +1,116 @@
+/**
+ * Mint Command - Mint test USDC tokens (mock mode only)
+ *
+ * Useful for testing scenarios where you need to fund accounts.
+ *
+ * @module cli/commands/mint
+ */
+
+import { Command } from 'commander';
+import { Output, ExitCode } from '../utils/output';
+import { createClient, mapError } from '../utils/client';
+import { loadConfig } from '../utils/config';
+
+// ============================================================================
+// Command Definition
+// ============================================================================
+
+export function createMintCommand(): Command {
+  const cmd = new Command('mint')
+    .description('Mint test USDC tokens (mock mode only)')
+    .argument('<address>', 'Address to mint tokens to')
+    .argument('<amount>', 'Amount to mint (in USDC, e.g., "1000")')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output')
+    .action(async (address, amount, options) => {
+      const output = new Output(
+        options.json ? 'json' : options.quiet ? 'quiet' : 'human'
+      );
+
+      try {
+        await runMint(address, amount, output);
+      } catch (error) {
+        const structuredError = mapError(error);
+        output.errorResult({
+          code: structuredError.code,
+          message: structuredError.message,
+          details: structuredError.details,
+        });
+        process.exit(ExitCode.ERROR);
+      }
+    });
+
+  return cmd;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+async function runMint(
+  address: string,
+  amount: string,
+  output: Output
+): Promise<void> {
+  // Check we're in mock mode
+  const config = loadConfig();
+  if (config.mode !== 'mock') {
+    throw new Error(
+      'Mint command only available in mock mode.\n' +
+        'You cannot mint real USDC on testnet/mainnet.'
+    );
+  }
+
+  // Validate address format
+  if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
+    throw new Error(
+      `Invalid address format: "${address}"\n` +
+        'Expected 0x-prefixed 40-character hex string.'
+    );
+  }
+
+  // Parse amount (user enters USDC, we convert to wei)
+  const amountNum = parseFloat(amount);
+  if (isNaN(amountNum) || amountNum <= 0) {
+    throw new Error(
+      `Invalid amount: "${amount}"\n` +
+        'Expected positive number (e.g., "1000" for 1000 USDC).'
+    );
+  }
+
+  // Convert to wei (USDC has 6 decimals)
+  const amountWei = Math.floor(amountNum * 1_000_000).toString();
+
+  // Create client and mint
+  const client = await createClient();
+  await client.mintTokens(address.toLowerCase(), amountWei);
+
+  // Get new balance
+  const newBalance = await client.getBalance(address.toLowerCase());
+
+  output.result(
+    {
+      address,
+      minted: `${amountNum} USDC`,
+      mintedWei: amountWei,
+      newBalance: `${formatUsdc(newBalance)} USDC`,
+    },
+    { quietKey: 'newBalance' }
+  );
+
+  output.success(`Minted ${amountNum} USDC to ${address}`);
+}
+
+/**
+ * Format USDC amount from wei to decimal
+ */
+function formatUsdc(weiAmount: string): string {
+  const amount = BigInt(weiAmount);
+  const whole = amount / 1_000_000n;
+  const decimal = amount % 1_000_000n;
+  const decimalStr = decimal.toString().padStart(6, '0').slice(0, 2);
+  const wholeFormatted = whole.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+  return `${wholeFormatted}.${decimalStr}`;
+}
+
+export { runMint };

package/src/cli/commands/pay.ts

@@ -0,0 +1,113 @@
+/**
+ * Pay Command - One-liner payment command (beginner API)
+ *
+ * The simplest way to create a payment transaction.
+ * Creates transaction, links escrow, and returns immediately.
+ *
+ * @module cli/commands/pay
+ */
+
+import { Command } from 'commander';
+import { Output, ExitCode } from '../utils/output';
+import { createClient, mapError } from '../utils/client';
+
+// ============================================================================
+// Command Definition
+// ============================================================================
+
+export function createPayCommand(): Command {
+  const cmd = new Command('pay')
+    .description('Create a payment transaction (simplest API)')
+    .argument('<to>', 'Provider address (recipient)')
+    .argument('<amount>', 'Amount to pay (e.g., "100", "100.50", "100 USDC")')
+    .option('-d, --deadline <deadline>', 'Deadline (+24h, +7d, or Unix timestamp)', '+24h')
+    .option('-w, --dispute-window <seconds>', 'Dispute window in seconds', '172800')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Output only the transaction ID')
+    .action(async (to, amount, options) => {
+      const output = new Output(
+        options.json ? 'json' : options.quiet ? 'quiet' : 'human'
+      );
+
+      try {
+        await runPay(to, amount, options, output);
+      } catch (error) {
+        const structuredError = mapError(error);
+        output.errorResult({
+          code: structuredError.code,
+          message: structuredError.message,
+          details: structuredError.details,
+        });
+        process.exit(ExitCode.ERROR);
+      }
+    });
+
+  return cmd;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+interface PayOptions {
+  deadline: string;
+  disputeWindow: string;
+}
+
+async function runPay(
+  to: string,
+  amount: string,
+  options: PayOptions,
+  output: Output
+): Promise<void> {
+  // Create spinner for human mode
+  const spinner = output.spinner('Creating payment...');
+
+  try {
+    // Create client
+    const client = await createClient();
+
+    // Parse options
+    let deadline: string | number = options.deadline;
+    if (/^\d+$/.test(options.deadline)) {
+      deadline = parseInt(options.deadline, 10);
+    }
+
+    const disputeWindow = parseInt(options.disputeWindow, 10);
+
+    // Create payment
+    const result = await client.beginner.pay({
+      to,
+      amount,
+      deadline,
+      disputeWindow,
+    });
+
+    spinner.stop(true);
+
+    // Output result
+    output.result(
+      {
+        txId: result.txId,
+        state: result.state,
+        provider: result.provider,
+        requester: result.requester,
+        amount: result.amount,
+        deadline: result.deadline,
+      },
+      { quietKey: 'txId' }
+    );
+
+    output.blank();
+    output.success('Payment created and funded!');
+    output.print('');
+    output.print('Next steps:');
+    output.print('  - Provider delivers: actp tx deliver ' + result.txId.slice(0, 10) + '...');
+    output.print('  - Check status:      actp tx status ' + result.txId.slice(0, 10) + '...');
+  } catch (error) {
+    spinner.stop(false);
+    throw error;
+  }
+}
+
+export { runPay };