@agirails/sdk 2.5.3 → 2.5.5

package/src/cli/commands/register.ts

@@ -1,247 +0,0 @@
-/**
- * Register Command — Register agent on AgentRegistry for gas-free transactions.
- *
- * Parses AGIRAILS.md for service descriptors and endpoint, then registers
- * on-chain via a single gasless UserOp (bootstrap-allowed).
- *
- * For testnet: also mints 1000 test USDC in the same UserOp.
- *
- * WARNING: This creates a NEW Smart Wallet address (different from EOA).
- * Old EOA reputation/history does not transfer.
- *
- * @module cli/commands/register
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { Command } from 'commander';
-import { Output, ExitCode } from '../utils/output';
-import { loadConfig, updateConfig } from '../utils/config';
-import { resolvePrivateKey } from '../../wallet/keystore';
-
-// ============================================================================
-// Command Definition
-// ============================================================================
-
-export function createRegisterCommand(): Command {
-  const cmd = new Command('register')
-    .description('Register agent on AgentRegistry for gas-free transactions')
-    .option('--endpoint <url>', 'Service endpoint URL (overrides AGIRAILS.md)')
-    .option('--force-legacy', 'Bypass deprecation and run legacy registration')
-    .option('--json', 'Output as JSON')
-    .option('-q, --quiet', 'Minimal output')
-    .action(async (options) => {
-      const output = new Output(
-        options.json ? 'json' : options.quiet ? 'quiet' : 'human'
-      );
-
-      // Deprecation warning
-      output.warning(
-        'DEPRECATED: "actp register" is deprecated. Use "actp publish" instead.\n' +
-        '  "actp publish" saves config locally. On-chain activation happens\n' +
-        '  automatically on your first payment (lazy publish).'
-      );
-      output.blank();
-
-      if (!options.forceLegacy) {
-        output.print('To proceed anyway, use: actp register --force-legacy');
-        return;
-      }
-
-      try {
-        await runRegister(options, output);
-      } catch (error) {
-        output.errorResult({
-          code: 'REGISTER_FAILED',
-          message: (error as Error).message,
-        });
-        process.exit(ExitCode.ERROR);
-      }
-    });
-
-  return cmd;
-}
-
-// ============================================================================
-// Implementation
-// ============================================================================
-
-async function runRegister(
-  options: { endpoint?: string },
-  output: Output
-): Promise<void> {
-  const projectRoot = process.cwd();
-
-  // Load config
-  const config = loadConfig(projectRoot);
-  if (!config) {
-    throw new Error(
-      'ACTP not initialized. Run "actp init" first.'
-    );
-  }
-
-  if (config.mode === 'mock') {
-    throw new Error('Registration is not available in mock mode.');
-  }
-
-  // Resolve private key
-  const privateKey = await resolvePrivateKey(projectRoot, { network: config.mode });
-  if (!privateKey) {
-    throw new Error(
-      'No wallet found. Run "actp init" first to generate a wallet.'
-    );
-  }
-
-  // Parse AGIRAILS.md for service descriptors
-  const { parseAgirailsMd } = await import('../../config/agirailsmd');
-  const { extractRegistrationParams } = await import('../../config/publishPipeline');
-
-  const agirailsMdPath = path.join(projectRoot, 'AGIRAILS.md');
-  let endpoint = options.endpoint || '';
-  let serviceDescriptors;
-
-  if (fs.existsSync(agirailsMdPath)) {
-    const content = fs.readFileSync(agirailsMdPath, 'utf-8');
-    const parsed = parseAgirailsMd(content);
-    const regParams = extractRegistrationParams(parsed.frontmatter);
-    endpoint = options.endpoint || regParams.endpoint;
-    serviceDescriptors = regParams.serviceDescriptors;
-    output.info(`Parsed ${serviceDescriptors.length} service(s) from AGIRAILS.md`);
-  } else {
-    // No AGIRAILS.md — use minimal defaults
-    const { ethers: ethersLib } = await import('ethers');
-    const serviceType = 'general';
-    serviceDescriptors = [{
-      serviceTypeHash: ethersLib.keccak256(ethersLib.toUtf8Bytes(serviceType)),
-      serviceType,
-      schemaURI: '',
-      minPrice: 0n,
-      maxPrice: 1_000_000_000n, // 1000 USDC
-      avgCompletionTime: 3600,
-      metadataCID: '',
-    }];
-    output.warning('No AGIRAILS.md found. Using default "general" service descriptor.');
-    output.info('Create AGIRAILS.md with services to customize registration.');
-  }
-
-  // Dynamic imports
-  const { ethers } = await import('ethers');
-  const { getNetwork } = await import('../../config/networks');
-  const { AutoWalletProvider } = await import('../../wallet/AutoWalletProvider');
-  const { buildRegisterAgentBatch, buildTestnetInitBatch } = await import('../../wallet/aa/TransactionBatcher');
-
-  const network = config.mode === 'testnet' ? 'base-sepolia' : 'base-mainnet';
-  const networkConfig = getNetwork(network);
-
-  if (!networkConfig.aa) {
-    throw new Error(
-      `AA configuration not available for ${config.mode}. ` +
-      'Smart Wallet registration requires AA support.'
-    );
-  }
-
-  if (!networkConfig.contracts.agentRegistry) {
-    throw new Error(
-      'AgentRegistry contract not deployed yet. Registration not available.'
-    );
-  }
-
-  const rpcUrl = networkConfig.rpcUrl;
-  const provider = new ethers.JsonRpcProvider(rpcUrl);
-  const signer = new ethers.Wallet(privateKey, provider);
-
-  output.info('Creating Smart Wallet...');
-
-  const autoWallet = await AutoWalletProvider.create({
-    signer,
-    provider,
-    chainId: networkConfig.chainId,
-    actpKernelAddress: networkConfig.contracts.actpKernel,
-    bundler: {
-      primaryUrl: networkConfig.aa.bundlerUrls.coinbase,
-      backupUrl: networkConfig.aa.bundlerUrls.pimlico,
-    },
-    paymaster: {
-      primaryUrl: networkConfig.aa.paymasterUrls.coinbase,
-      backupUrl: networkConfig.aa.paymasterUrls.pimlico,
-    },
-  });
-
-  const smartWalletAddress = autoWallet.getAddress();
-  output.info(`Smart Wallet: ${smartWalletAddress}`);
-
-  if (smartWalletAddress.toLowerCase() !== config.address.toLowerCase()) {
-    output.warning(
-      `This creates a NEW address: ${smartWalletAddress}\n` +
-      `  Your current address: ${config.address}\n` +
-      '  Old address reputation/history does NOT transfer.'
-    );
-  }
-
-  // Build batch — testnet gets register + mint, mainnet gets register only
-  let calls;
-  if (config.mode === 'testnet') {
-    output.info('Testnet mode: will register + mint 1000 test USDC in one UserOp');
-    calls = buildTestnetInitBatch({
-      agentRegistryAddress: networkConfig.contracts.agentRegistry,
-      endpoint,
-      serviceDescriptors,
-      mockUsdcAddress: networkConfig.contracts.usdc,
-      recipient: smartWalletAddress,
-      mintAmount: '1000000000', // 1000 USDC
-    });
-  } else {
-    calls = buildRegisterAgentBatch(
-      networkConfig.contracts.agentRegistry,
-      endpoint,
-      serviceDescriptors
-    );
-  }
-
-  // Convert SmartWalletCall[] to TransactionRequest[]
-  const txRequests = calls.map((c) => ({
-    to: c.target,
-    data: c.data,
-    value: c.value.toString(),
-  }));
-
-  output.info('Submitting registration (gasless UserOp)...');
-
-  const receipt = await autoWallet.sendBatchTransaction(txRequests);
-
-  if (!receipt.success) {
-    throw new Error(`Registration UserOp failed: ${receipt.hash}`);
-  }
-
-  output.success('Agent registered on AgentRegistry');
-  if (config.mode === 'testnet') {
-    output.success('Minted 1,000 test USDC to Smart Wallet');
-  }
-
-  // Update config: flip address to Smart Wallet, mark as registered
-  updateConfig({
-    address: smartWalletAddress.toLowerCase(),
-    smartWallet: smartWalletAddress.toLowerCase(),
-    registered: true,
-  }, projectRoot);
-  output.info('Config updated: address set to Smart Wallet');
-
-  output.blank();
-  output.result(
-    {
-      registered: true,
-      smartWallet: smartWalletAddress,
-      services: serviceDescriptors.length,
-      txHash: receipt.hash,
-      ...(config.mode === 'testnet' && { mintedUSDC: '1000' }),
-    },
-    { quietKey: 'smartWallet' }
-  );
-
-  output.blank();
-  output.print('Your agent now has gas-free transactions!');
-  output.print(`Smart Wallet address: ${smartWalletAddress}`);
-  output.print('');
-  output.print('To use gas-free mode, add to your agent config:');
-  output.print('  wallet: "auto"');
-}

package/src/cli/commands/simulate.ts

@@ -1,345 +0,0 @@
-/**
- * Simulate Command - Dry-run commands without executing
- *
- * Agent-first feature: Preview what a command would do
- * without actually executing it. Perfect for:
- * - Testing scripts before running on mainnet
- * - Understanding fee calculations
- * - Validating input parameters
- *
- * @module cli/commands/simulate
- */
-
-import { Command } from 'commander';
-import { Output, ExitCode, fmt } from '../utils/output';
-import { loadConfig } from '../utils/config';
-import { mapError } from '../utils/client';
-import { BaseAdapter } from '../../adapters/BaseAdapter';
-
-// ============================================================================
-// Command Definition
-// ============================================================================
-
-export function createSimulateCommand(): Command {
-  const cmd = new Command('simulate')
-    .description('Dry-run a command without executing (agent-first feature)');
-
-  cmd.addCommand(createSimulatePayCommand());
-  cmd.addCommand(createSimulateFeeCommand());
-
-  return cmd;
-}
-
-// ============================================================================
-// simulate pay
-// ============================================================================
-
-function createSimulatePayCommand(): Command {
-  return new Command('pay')
-    .description('Simulate a payment transaction')
-    .argument('<to>', 'Provider address')
-    .argument('<amount>', 'Amount to pay')
-    .option('-d, --deadline <deadline>', 'Deadline (+24h, +7d, or Unix timestamp)', '+24h')
-    .option('--json', 'Output as JSON')
-    .action(async (to, amount, options) => {
-      const output = new Output(options.json ? 'json' : 'human');
-
-      try {
-        await runSimulatePay(to, amount, options, output);
-      } catch (error) {
-        const structuredError = mapError(error);
-        output.errorResult({
-          code: structuredError.code,
-          message: structuredError.message,
-        });
-        process.exit(ExitCode.ERROR);
-      }
-    });
-}
-
-interface SimulatePayOptions {
-  deadline: string;
-  json?: boolean;
-}
-
-async function runSimulatePay(
-  to: string,
-  amount: string,
-  options: SimulatePayOptions,
-  output: Output
-): Promise<void> {
-  const config = loadConfig();
-
-  // Create a mock adapter just for parsing
-  const adapter = new SimulationAdapter(config.address);
-
-  // Validate and parse inputs
-  const validation = adapter.validatePayment(to, amount, options.deadline);
-
-  if (!validation.valid) {
-    output.result({
-      valid: false,
-      errors: validation.errors,
-    });
-    process.exit(ExitCode.INVALID_INPUT);
-  }
-
-  // Calculate fee
-  const amountWei = validation.parsedAmount!;
-  const feeCalculation = calculateFee(amountWei);
-
-  const result = {
-    valid: true,
-    simulation: {
-      action: 'CREATE_AND_FUND_TRANSACTION',
-      provider: to.toLowerCase(),
-      requester: config.address.toLowerCase(),
-      amount: formatUsdc(amountWei.toString()) + ' USDC',
-      amountWei: amountWei.toString(),
-      deadline: new Date(validation.parsedDeadline! * 1000).toISOString(),
-      deadlineUnix: validation.parsedDeadline,
-    },
-    fees: {
-      platformFee: formatUsdc(feeCalculation.fee.toString()) + ' USDC',
-      platformFeeWei: feeCalculation.fee.toString(),
-      feeRate: feeCalculation.effectiveRate,
-      providerReceives: formatUsdc(feeCalculation.providerReceives.toString()) + ' USDC',
-      minimumApplied: feeCalculation.minimumApplied,
-    },
-    requirements: {
-      requiredBalance: formatUsdc((amountWei + feeCalculation.fee).toString()) + ' USDC',
-      mode: config.mode,
-    },
-    warnings: validation.warnings,
-  };
-
-  if (options.json) {
-    output.result(result);
-  } else {
-    output.section('Simulation Results');
-    output.print('');
-    output.print(fmt.bold('Transaction Details:'));
-    output.keyValue('  Action', 'Create and fund transaction');
-    output.keyValue('  Provider', to);
-    output.keyValue('  Amount', result.simulation.amount);
-    output.keyValue('  Deadline', result.simulation.deadline);
-    output.print('');
-    output.print(fmt.bold('Fee Breakdown (1% + $0.05 min):'));
-    output.keyValue('  Platform Fee', result.fees.platformFee);
-    output.keyValue('  Effective Rate', result.fees.feeRate);
-    output.keyValue('  Provider Receives', result.fees.providerReceives);
-    if (feeCalculation.minimumApplied) {
-      output.print(fmt.yellow('  (Minimum fee applied - amount < $5)'));
-    }
-    output.print('');
-    output.print(fmt.bold('Requirements:'));
-    output.keyValue('  Required Balance', result.requirements.requiredBalance);
-    output.keyValue('  Mode', result.requirements.mode);
-
-    if (validation.warnings && validation.warnings.length > 0) {
-      output.print('');
-      output.print(fmt.yellow('Warnings:'));
-      for (const warning of validation.warnings) {
-        output.print(fmt.yellow(`  - ${warning}`));
-      }
-    }
-
-    output.print('');
-    output.success('Simulation complete - no transaction created');
-  }
-}
-
-// ============================================================================
-// simulate fee
-// ============================================================================
-
-function createSimulateFeeCommand(): Command {
-  return new Command('fee')
-    .description('Calculate fee for a given amount')
-    .argument('<amount>', 'Amount to calculate fee for')
-    .option('--json', 'Output as JSON')
-    .action(async (amount, options) => {
-      const output = new Output(options.json ? 'json' : 'human');
-
-      try {
-        // Parse amount
-        const adapter = new SimulationAdapter('0x0000000000000000000000000000000000000000');
-        const parsedAmount = adapter.parseAmountPublic(amount);
-
-        const feeCalc = calculateFee(parsedAmount);
-
-        const result = {
-          amount: formatUsdc(parsedAmount.toString()) + ' USDC',
-          amountWei: parsedAmount.toString(),
-          fee: formatUsdc(feeCalc.fee.toString()) + ' USDC',
-          feeWei: feeCalc.fee.toString(),
-          effectiveRate: feeCalc.effectiveRate,
-          providerReceives: formatUsdc(feeCalc.providerReceives.toString()) + ' USDC',
-          totalRequired: formatUsdc((parsedAmount + feeCalc.fee).toString()) + ' USDC',
-          minimumApplied: feeCalc.minimumApplied,
-        };
-
-        if (options.json) {
-          output.result(result);
-        } else {
-          output.section('Fee Calculation');
-          output.keyValue('Amount', result.amount);
-          output.keyValue('Platform Fee', result.fee);
-          output.keyValue('Effective Rate', result.effectiveRate);
-          output.keyValue('Provider Receives', result.providerReceives);
-          output.keyValue('Total Required', result.totalRequired);
-          if (feeCalc.minimumApplied) {
-            output.print('');
-            output.info('Minimum fee ($0.05) applied because amount < $5');
-          }
-        }
-      } catch (error) {
-        const structuredError = mapError(error);
-        output.errorResult({
-          code: structuredError.code,
-          message: structuredError.message,
-        });
-        process.exit(ExitCode.ERROR);
-      }
-    });
-}
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-/**
- * Extended adapter for simulation purposes
- */
-class SimulationAdapter extends BaseAdapter {
-  constructor(requesterAddress: string) {
-    super(requesterAddress);
-  }
-
-  /**
-   * Validate payment parameters without executing
-   */
-  validatePayment(
-    to: string,
-    amount: string | number,
-    deadline?: string | number
-  ): {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    parsedAmount?: bigint;
-    parsedDeadline?: number;
-  } {
-    const errors: string[] = [];
-    const warnings: string[] = [];
-    let parsedAmount: bigint | undefined;
-    let parsedDeadline: number | undefined;
-
-    // Validate address
-    try {
-      this.validateAddress(to, 'to');
-    } catch (e) {
-      errors.push((e as Error).message);
-    }
-
-    // Validate amount
-    try {
-      parsedAmount = this.parseAmount(amount);
-
-      // Check for small amount warning
-      if (parsedAmount < 5_000_000n) {
-        // Less than $5
-        warnings.push('Amount is below $5 - minimum fee ($0.05) will apply');
-      }
-    } catch (e) {
-      errors.push((e as Error).message);
-    }
-
-    // Validate deadline
-    try {
-      const currentTime = Math.floor(Date.now() / 1000);
-      parsedDeadline = this.parseDeadline(deadline, currentTime);
-
-      if (parsedDeadline <= currentTime) {
-        errors.push('Deadline must be in the future');
-      }
-
-      // Check for short deadline warning
-      const hoursUntilDeadline = (parsedDeadline - currentTime) / 3600;
-      if (hoursUntilDeadline < 1) {
-        warnings.push('Deadline is less than 1 hour from now');
-      }
-    } catch (e) {
-      errors.push((e as Error).message);
-    }
-
-    // Check self-payment
-    if (to.toLowerCase() === this.requesterAddress.toLowerCase()) {
-      errors.push('Cannot pay yourself');
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors,
-      warnings,
-      parsedAmount,
-      parsedDeadline,
-    };
-  }
-
-  /**
-   * Public access to parseAmount for fee calculation
-   */
-  parseAmountPublic(amount: string | number): bigint {
-    return this.parseAmount(amount);
-  }
-}
-
-/**
- * Calculate platform fee based on AGIRAILS fee model:
- * - 1% of transaction amount
- * - $0.05 minimum
- */
-function calculateFee(amountWei: bigint): {
-  fee: bigint;
-  providerReceives: bigint;
-  effectiveRate: string;
-  minimumApplied: boolean;
-} {
-  // 1% fee
-  const percentFee = amountWei / 100n;
-
-  // $0.05 minimum in wei (6 decimals)
-  const minimumFeeWei = 50_000n;
-
-  // Apply minimum
-  const fee = percentFee > minimumFeeWei ? percentFee : minimumFeeWei;
-  const minimumApplied = percentFee < minimumFeeWei;
-
-  // Calculate what provider receives (amount minus fee)
-  const providerReceives = amountWei - fee;
-
-  // Calculate effective rate
-  const effectiveRatePercent = (Number(fee) / Number(amountWei)) * 100;
-  const effectiveRate = effectiveRatePercent.toFixed(2) + '%';
-
-  return {
-    fee,
-    providerReceives,
-    effectiveRate,
-    minimumApplied,
-  };
-}
-
-/**
- * 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);
-  return `${whole}.${decimalStr}`;
-}
-
-export { runSimulatePay, calculateFee };