@agirails/sdk 2.0.4 → 2.2.1

package/src/cli/commands/init.ts

@@ -8,6 +8,8 @@
  */
 
 import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
 import { Command } from 'commander';
 import {
   saveConfig,
@@ -30,6 +32,10 @@ export function createInitCommand(): Command {
     .option('-m, --mode <mode>', 'Operating mode: mock, testnet, mainnet', 'mock')
     .option('-a, --address <address>', 'Your Ethereum address')
     .option('-f, --force', 'Overwrite existing configuration')
+    .option('--scaffold', 'Generate a starter agent.ts file')
+    .option('--intent <intent>', 'Agent intent: earn, pay, or both (default: earn)')
+    .option('--service <name>', 'Service name (default: my-service)')
+    .option('--price <usdc>', 'Base price in USDC (default: 1)')
     .option('--json', 'Output as JSON')
     .option('-q, --quiet', 'Minimal output')
     .action(async (options) => {
@@ -55,10 +61,16 @@ export function createInitCommand(): Command {
 // Implementation
 // ============================================================================
 
+type ScaffoldIntent = 'earn' | 'pay' | 'both';
+
 interface InitOptions {
   mode: string;
   address?: string;
   force?: boolean;
+  scaffold?: boolean;
+  intent?: string;
+  service?: string;
+  price?: string;
 }
 
 async function runInit(options: InitOptions, output: Output): Promise<void> {
@@ -151,11 +163,162 @@ async function runInit(options: InitOptions, output: Output): Promise<void> {
     { quietKey: 'address' }
   );
 
+  // Generate scaffold if requested
+  if (options.scaffold) {
+    await runScaffold(options, mode, output);
+  } else {
+    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');
+    output.print('');
+    output.print('Tip: Use --scaffold to generate a starter agent.ts');
+  }
+}
+
+// ============================================================================
+// Scaffold
+// ============================================================================
+
+async function runScaffold(
+  options: InitOptions,
+  mode: CLIMode,
+  output: Output,
+): Promise<void> {
+  const validIntents: ScaffoldIntent[] = ['earn', 'pay', 'both'];
+  const intent: ScaffoldIntent = (options.intent as ScaffoldIntent) || 'earn';
+
+  if (!validIntents.includes(intent)) {
+    throw new Error(
+      `Invalid intent: "${options.intent}". Valid intents: ${validIntents.join(', ')}`
+    );
+  }
+
+  const service = options.service || 'my-service';
+  const price = options.price || '1';
+  const agentFile = path.join(process.cwd(), 'agent.ts');
+
+  // Check if file already exists
+  if (fs.existsSync(agentFile) && !options.force) {
+    output.warning('agent.ts already exists. Use --force to overwrite.');
+    return;
+  }
+
+  // Derive agent name from directory
+  const agentName = path.basename(process.cwd());
+
+  // Get template and substitute variables
+  const template = getTemplate(intent);
+  const content = template
+    .replace(/\{\{service\}\}/g, service)
+    .replace(/\{\{mode\}\}/g, mode)
+    .replace(/\{\{price\}\}/g, price)
+    .replace(/\{\{name\}\}/g, agentName);
+
+  // Atomic write
+  const tempFile = `${agentFile}.tmp`;
+  try {
+    fs.writeFileSync(tempFile, content, 'utf-8');
+    fs.renameSync(tempFile, agentFile);
+  } catch (error) {
+    if (fs.existsSync(tempFile)) {
+      try { fs.unlinkSync(tempFile); } catch { /* ignore */ }
+    }
+    throw error;
+  }
+
+  output.success(`Generated agent.ts (intent: ${intent})`);
   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');
+  output.print('  1. Edit agent.ts with your logic');
+  output.print('  2. Run: npx ts-node agent.ts');
+  output.print('  3. Check balance: actp balance');
+}
+
+function getTemplate(intent: ScaffoldIntent): string {
+  switch (intent) {
+    case 'earn':
+      return TEMPLATE_EARN;
+    case 'pay':
+      return TEMPLATE_PAY;
+    case 'both':
+      return TEMPLATE_BOTH;
+  }
 }
 
+// ============================================================================
+// Templates
+// ============================================================================
+
+const TEMPLATE_EARN = `import { provide } from '@agirails/sdk';
+
+const provider = provide('{{service}}', async (job) => {
+  console.log(\`Job received: \${job.id} (\${job.budget} USDC)\`);
+
+  // TODO: Replace with your actual work
+  const result = await processJob(job.input);
+
+  return result;
+}, {
+  network: '{{mode}}',
+  filter: { minBudget: {{price}} },
+});
+
+async function processJob(input: any): Promise<any> {
+  // Your logic here
+  return { status: 'completed', output: input };
+}
+
+console.log(\`Provider listening for '{{service}}' jobs...\`);
+`;
+
+const TEMPLATE_PAY = `import { request } from '@agirails/sdk';
+
+async function main() {
+  const { result, transaction } = await request('{{service}}', {
+    input: { /* your data here */ },
+    budget: {{price}},
+    network: '{{mode}}',
+  });
+
+  console.log('Result:', result);
+  console.log('Transaction:', transaction.id);
+  console.log('Fee:', transaction.fee, 'USDC');
+}
+
+main().catch(console.error);
+`;
+
+const TEMPLATE_BOTH = `import { Agent } from '@agirails/sdk';
+
+async function main() {
+  const agent = new Agent({
+    name: '{{name}}',
+    network: '{{mode}}',
+    behavior: {
+      autoAccept: true,
+      concurrency: 10,
+    },
+  });
+
+  // Provide a service
+  agent.provide('{{service}}', async (job, ctx) => {
+    ctx.progress(50, 'Working...');
+
+    // TODO: Replace with your actual work
+    return { status: 'completed', output: job.input };
+  });
+
+  agent.on('payment:received', (data) => {
+    console.log(\`Earned \${data.amount} USDC\`);
+  });
+
+  await agent.start();
+  console.log(\`Agent '{{name}}' running on {{mode}}\`);
+}
+
+main().catch(console.error);
+`;
+
 export { runInit };

package/src/config/networks.ts

@@ -30,6 +30,8 @@ export interface NetworkConfig {
     eas: string; // EAS contract address
     easSchemaRegistry: string; // EAS SchemaRegistry contract
     agentRegistry?: string; // AIP-7 Agent Registry (optional until deployed)
+    identityRegistry?: string; // AIP-7 ERC-1056 DID Registry (optional until deployed)
+    archiveTreasury?: string; // AIP-7 Archive Treasury for Arweave funding (optional until deployed)
   };
   eas: {
     deliverySchemaUID: string; // AIP-4 delivery proof schema
@@ -38,6 +40,13 @@ export interface NetworkConfig {
     maxFeePerGas: bigint;
     maxPriorityFeePerGas: bigint;
   };
+  /**
+   * Maximum transaction amount in USDC (human-readable, e.g., 100 = $100)
+   *
+   * SECURITY: Limits exposure on unaudited mainnet contracts.
+   * Set to undefined for no limit (testnet only).
+   */
+  maxTransactionAmount?: number;
 }
 
 /**
@@ -49,15 +58,19 @@ export const BASE_SEPOLIA: NetworkConfig = {
   rpcUrl: BASE_SEPOLIA_RPC_URL,
   blockExplorer: 'https://sepolia.basescan.org',
   contracts: {
-    // Redeployed 2025-12-10 by Arha (new deployer wallet 0x42a2f11555b9363fb7ebdcdc76d7cb26e01dcb00)
-    actpKernel: '0xD199070F8e9FB9a127F6Fe730Bc13300B4b3d962',
-    escrowVault: '0x948b9Ea081C4Cec1E112Af2e539224c531d4d585',
+    // Redeployed 2026-02-06 with agentId support
+    actpKernel: '0x469CBADbACFFE096270594F0a31f0EEC53753411',
+    escrowVault: '0x57f888261b629bB380dfb983f5DA6c70Ff2D49E5',
     usdc: '0x444b4e1A65949AB2ac75979D5d0166Eb7A248Ccb', // MockUSDC
     // EAS contracts (Base native deployment)
     eas: '0x4200000000000000000000000000000000000021',
     easSchemaRegistry: '0x4200000000000000000000000000000000000020',
     // AIP-7 Agent Registry (deployed 2025-12-11)
-    agentRegistry: '0xFed6914Aa70c0a53E9c7Cc4d2Ae159e4748fb09D'
+    agentRegistry: '0xFed6914Aa70c0a53E9c7Cc4d2Ae159e4748fb09D',
+    // AIP-7 Identity Registry - ERC-1056 DID Registry (deployed 2026-01-09)
+    identityRegistry: '0xF64F748C7802a68Cb936a9213881fE74e83FDA97',
+    // AIP-7 Archive Treasury - Arweave funding (deployed 2026-01-09)
+    archiveTreasury: '0xeB75DE7cF5ce77ab15BB0fFa3a2A79e6aaa554B0'
   },
   eas: {
     // Deployed 2025-11-23 - AIP-4 delivery proof schema
@@ -82,22 +95,31 @@ export const BASE_MAINNET: NetworkConfig = {
   rpcUrl: BASE_MAINNET_RPC_URL,
   blockExplorer: 'https://basescan.org',
   contracts: {
-    // NOT DEPLOYED: Will throw error via validateNetworkConfig()
-    actpKernel: '0x0000000000000000000000000000000000000000',
-    escrowVault: '0x0000000000000000000000000000000000000000',
+    // Deployed 2026-02-03
+    actpKernel: '0xeaE4D6925510284dbC45C8C64bb8104a079D4c60',
+    escrowVault: '0xb7bCadF7F26f0761995d95105DFb2346F81AF02D',
     usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // Official USDC on Base
     // EAS contracts (Base native deployment)
     eas: '0x4200000000000000000000000000000000000021',
-    easSchemaRegistry: '0x4200000000000000000000000000000000000020'
+    easSchemaRegistry: '0x4200000000000000000000000000000000000020',
+    // AIP-7 contracts
+    agentRegistry: '0xbf9Aa0FC291A06A4dFA943c3E0Ad41E7aE20DF02',
+    archiveTreasury: '0x64B8f93fef2D2E749F5E88586753343F73246012'
   },
   eas: {
-    // NOT DEPLOYED: Requires mainnet schema registration
-    deliverySchemaUID: '0x0000000000000000000000000000000000000000000000000000000000000000'
+    // Registered 2026-02-03
+    deliverySchemaUID: '0x166501e7476e2fcf9214c4c5144533c2957d56fe59d639effc1719a0658d9c9a'
   },
   gasSettings: {
     maxFeePerGas: ethers.parseUnits('0.5', 'gwei'),
     maxPriorityFeePerGas: ethers.parseUnits('0.1', 'gwei')
-  }
+  },
+  /**
+   * SECURITY: $1,000 max transaction limit until contracts are audited.
+   * This limits exposure in case of undiscovered vulnerabilities.
+   * Will be removed/increased after formal security audit.
+   */
+  maxTransactionAmount: 1000
 };
 
 /**
@@ -134,7 +156,9 @@ export function getNetwork(network: string): NetworkConfig {
       usdc: config.contracts.usdc,
       eas: config.contracts.eas,
       easSchemaRegistry: config.contracts.easSchemaRegistry,
-      agentRegistry: config.contracts.agentRegistry
+      agentRegistry: config.contracts.agentRegistry,
+      identityRegistry: config.contracts.identityRegistry,
+      archiveTreasury: config.contracts.archiveTreasury
     },
     eas: {
       deliverySchemaUID: config.eas.deliverySchemaUID