@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 { Command } from 'commander';
+import { Output } from '../utils/output';
+export declare function createInitCommand(): Command;
+interface InitOptions {
+    mode: string;
+    address?: string;
+    force?: boolean;
+}
+declare function runInit(options: InitOptions, output: Output): Promise<void>;
+export { runInit };
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAOnD,wBAAgB,iBAAiB,IAAI,OAAO,CAyB3C;AAMD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,iBAAe,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+F1E;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * 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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = exports.createInitCommand = void 0;
+const crypto = __importStar(require("crypto"));
+const commander_1 = require("commander");
+const config_1 = require("../utils/config");
+const output_1 = require("../utils/output");
+const MockStateManager_1 = require("../../runtime/MockStateManager");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createInitCommand() {
+    const cmd = new commander_1.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_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runInit(options, output);
+        }
+        catch (error) {
+            output.errorResult({
+                code: 'INIT_FAILED',
+                message: error.message,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+    return cmd;
+}
+exports.createInitCommand = createInitCommand;
+async function runInit(options, output) {
+    const projectRoot = process.cwd();
+    // Check if already initialized
+    if ((0, config_1.isInitialized)(projectRoot) && !options.force) {
+        throw new Error('ACTP already initialized in this directory.\n' +
+            'Use --force to reinitialize.');
+    }
+    // Validate mode
+    const validModes = ['mock', 'testnet', 'mainnet'];
+    if (!validModes.includes(options.mode)) {
+        throw new Error(`Invalid mode: "${options.mode}". Valid modes: ${validModes.join(', ')}`);
+    }
+    const mode = options.mode;
+    // 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 = {
+        mode,
+        address: address.toLowerCase(),
+        version: '1.0',
+    };
+    // Save configuration
+    (0, config_1.saveConfig)(config, projectRoot);
+    output.success('Configuration saved');
+    // Initialize mock state if in mock mode
+    if (mode === 'mock') {
+        const stateManager = new MockStateManager_1.MockStateManager(projectRoot);
+        if (!stateManager.exists() || options.force) {
+            stateManager.reset();
+            output.success('Mock state initialized');
+        }
+        // Mint initial tokens for the address
+        const { MockRuntime } = await Promise.resolve().then(() => __importStar(require('../../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 {
+        (0, config_1.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: (0, config_1.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');
+}
+exports.runInit = runInit;
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/mint.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 } from '../utils/output';
+export declare function createMintCommand(): Command;
+declare function runMint(address: string, amount: string, output: Output): Promise<void>;
+export { runMint };
+//# sourceMappingURL=mint.d.ts.map

package/dist/cli/commands/mint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAQnD,wBAAgB,iBAAiB,IAAI,OAAO,CA0B3C;AAMD,iBAAe,OAAO,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgDf;AAcD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/commands/mint.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Mint Command - Mint test USDC tokens (mock mode only)
+ *
+ * Useful for testing scenarios where you need to fund accounts.
+ *
+ * @module cli/commands/mint
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMint = exports.createMintCommand = void 0;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+const config_1 = require("../utils/config");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createMintCommand() {
+    const cmd = new commander_1.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_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runMint(address, amount, output);
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+    return cmd;
+}
+exports.createMintCommand = createMintCommand;
+// ============================================================================
+// Implementation
+// ============================================================================
+async function runMint(address, amount, output) {
+    // Check we're in mock mode
+    const config = (0, config_1.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 * 1000000).toString();
+    // Create client and mint
+    const client = await (0, client_1.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}`);
+}
+exports.runMint = runMint;
+/**
+ * Format USDC amount from wei to decimal
+ */
+function formatUsdc(weiAmount) {
+    const amount = BigInt(weiAmount);
+    const whole = amount / 1000000n;
+    const decimal = amount % 1000000n;
+    const decimalStr = decimal.toString().padStart(6, '0').slice(0, 2);
+    const wholeFormatted = whole.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    return `${wholeFormatted}.${decimalStr}`;
+}
+//# sourceMappingURL=mint.js.map

package/dist/cli/commands/mint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.js","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/pay.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 } from '../utils/output';
+export declare function createPayCommand(): Command;
+interface PayOptions {
+    deadline: string;
+    disputeWindow: string;
+}
+declare function runPay(to: string, amount: string, options: PayOptions, output: Output): Promise<void>;
+export { runPay };
+//# sourceMappingURL=pay.d.ts.map

package/dist/cli/commands/pay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pay.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pay.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAOnD,wBAAgB,gBAAgB,IAAI,OAAO,CA4B1C;AAMD,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iBAAe,MAAM,CACnB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cli/commands/pay.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPay = exports.createPayCommand = void 0;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createPayCommand() {
+    const cmd = new commander_1.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_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runPay(to, amount, options, output);
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+    return cmd;
+}
+exports.createPayCommand = createPayCommand;
+async function runPay(to, amount, options, output) {
+    // Create spinner for human mode
+    const spinner = output.spinner('Creating payment...');
+    try {
+        // Create client
+        const client = await (0, client_1.createClient)();
+        // Parse options
+        let deadline = 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;
+    }
+}
+exports.runPay = runPay;
+//# sourceMappingURL=pay.js.map

package/dist/cli/commands/pay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pay.js","sourceRoot":"","sources":["../../../src/cli/commands/pay.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/simulate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 } from '../utils/output';
+export declare function createSimulateCommand(): Command;
+interface SimulatePayOptions {
+    deadline: string;
+    json?: boolean;
+}
+declare function runSimulatePay(to: string, amount: string, options: SimulatePayOptions, output: Output): Promise<void>;
+/**
+ * Calculate platform fee based on AGIRAILS fee model:
+ * - 1% of transaction amount
+ * - $0.05 minimum
+ */
+declare function calculateFee(amountWei: bigint): {
+    fee: bigint;
+    providerReceives: bigint;
+    effectiveRate: string;
+    minimumApplied: boolean;
+};
+export { runSimulatePay, calculateFee };
+//# sourceMappingURL=simulate.d.ts.map

package/dist/cli/commands/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AASxD,wBAAgB,qBAAqB,IAAI,OAAO,CAQ/C;AA6BD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,iBAAe,cAAc,CAC3B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgFf;AAoJD;;;;GAIG;AACH,iBAAS,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAwBA;AAaD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}