@agirails/sdk 2.2.3 → 2.3.1

package/src/config/networks.ts

@@ -15,6 +15,16 @@ import { ethers } from 'ethers';
 const BASE_SEPOLIA_RPC_URL = process.env.BASE_SEPOLIA_RPC || 'https://sepolia.base.org';
 const BASE_MAINNET_RPC_URL = process.env.BASE_MAINNET_RPC || 'https://mainnet.base.org';
 
+// AGIRAILS CDP Client API Key — safe to embed, cannot access funds/portfolios.
+// Developers can override with their own key via CDP_API_KEY env var.
+// Paymaster policy restricts sponsorship to AGIRAILS contracts only.
+const CDP_CLIENT_KEY = process.env.CDP_API_KEY || '2txciN85t41erCjveqgNnXYyHRcoo5xP';
+
+// Pimlico failover — bundler/paymaster backup if Coinbase CDP is down.
+// Safe to embed: restricted by contract allowlist (AGIRAILS contracts only).
+// Developers can override with their own key via PIMLICO_API_KEY env var.
+const PIMLICO_KEY = process.env.PIMLICO_API_KEY || 'pim_YiHmeAijzTPUvo1UMmXUiN';
+
 /**
  * Network configuration
  */
@@ -32,9 +42,11 @@ export interface NetworkConfig {
     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)
+    x402Relay?: string; // X402Relay for atomic payment fee splitting (optional until deployed)
   };
   eas: {
     deliverySchemaUID: string; // AIP-4 delivery proof schema
+    configSnapshotSchemaUID?: string; // AGIRAILS.md config snapshot schema
   };
   gasSettings: {
     maxFeePerGas: bigint;
@@ -47,6 +59,27 @@ export interface NetworkConfig {
    * Set to undefined for no limit (testnet only).
    */
   maxTransactionAmount?: number;
+
+  /**
+   * AIP-12: Account Abstraction (AA) configuration.
+   * EntryPoint v0.6 + CoinbaseSmartWallet.
+   */
+  aa?: {
+    /** ERC-4337 EntryPoint v0.6 address */
+    entryPoint: string;
+    /** CoinbaseSmartWallet factory address */
+    smartWalletFactory: string;
+    /** Bundler RPC URLs */
+    bundlerUrls: {
+      coinbase: string;
+      pimlico?: string;
+    };
+    /** Paymaster RPC URLs (ERC-7677) */
+    paymasterUrls: {
+      coinbase: string;
+      pimlico?: string;
+    };
+  };
 }
 
 /**
@@ -58,36 +91,44 @@ export const BASE_SEPOLIA: NetworkConfig = {
   rpcUrl: BASE_SEPOLIA_RPC_URL,
   blockExplorer: 'https://sepolia.basescan.org',
   contracts: {
-    // 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',
-    // AIP-7 Identity Registry - ERC-1056 DID Registry (deployed 2026-01-09)
+    agentRegistry: '0xDd6D66924B43419F484aE981F174b803487AF25A',
     identityRegistry: '0xF64F748C7802a68Cb936a9213881fE74e83FDA97',
-    // AIP-7 Archive Treasury - Arweave funding (deployed 2026-01-09)
-    archiveTreasury: '0xeB75DE7cF5ce77ab15BB0fFa3a2A79e6aaa554B0'
+    archiveTreasury: '0xeB75DE7cF5ce77ab15BB0fFa3a2A79e6aaa554B0',
+    x402Relay: '0x4DCD02b276Dbeab57c265B72435e90507b6Ac81A',
   },
   eas: {
-    // Deployed 2025-11-23 - AIP-4 delivery proof schema
     deliverySchemaUID: '0x1b0ebdf0bd20c28ec9d5362571ce8715a55f46e81c3de2f9b0d8e1b95fb5ffce'
   },
   gasSettings: {
     maxFeePerGas: ethers.parseUnits('2', 'gwei'),
     maxPriorityFeePerGas: ethers.parseUnits('1', 'gwei')
-  }
+  },
+  // AIP-12: Account Abstraction
+  aa: {
+    entryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
+    smartWalletFactory: '0xBA5ED110eFDBa3D005bfC882d75358ACBbB85842',
+    bundlerUrls: {
+      // Coinbase CDP bundler — set CDP_API_KEY env var
+      coinbase: process.env.CDP_BUNDLER_URL || `https://api.developer.coinbase.com/rpc/v1/base-sepolia/${CDP_CLIENT_KEY}`,
+      // Pimlico backup bundler — set PIMLICO_API_KEY env var
+      pimlico: process.env.PIMLICO_BUNDLER_URL || `https://api.pimlico.io/v2/84532/rpc?apikey=${PIMLICO_KEY}`,
+    },
+    paymasterUrls: {
+      // Coinbase CDP paymaster — same endpoint as bundler
+      coinbase: process.env.CDP_PAYMASTER_URL || `https://api.developer.coinbase.com/rpc/v1/base-sepolia/${CDP_CLIENT_KEY}`,
+      // Pimlico failover paymaster
+      pimlico: process.env.PIMLICO_PAYMASTER_URL || `https://api.pimlico.io/v2/84532/rpc?apikey=${PIMLICO_KEY}`,
+    },
+  },
 };
 
 /**
  * Base Mainnet Configuration
- *
- * WARNING: Mainnet contracts are NOT YET DEPLOYED.
- * Using 'base-mainnet' will throw an error until contracts are deployed.
- * Use 'base-sepolia' for testnet development.
  */
 export const BASE_MAINNET: NetworkConfig = {
   name: 'Base Mainnet',
@@ -95,19 +136,16 @@ export const BASE_MAINNET: NetworkConfig = {
   rpcUrl: BASE_MAINNET_RPC_URL,
   blockExplorer: 'https://basescan.org',
   contracts: {
-    // Deployed 2026-02-03
-    actpKernel: '0xeaE4D6925510284dbC45C8C64bb8104a079D4c60',
-    escrowVault: '0xb7bCadF7F26f0761995d95105DFb2346F81AF02D',
-    usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // Official USDC on Base
-    // EAS contracts (Base native deployment)
+    actpKernel: '0x132B9eB321dBB57c828B083844287171BDC92d29',
+    escrowVault: '0x6aAF45882c4b0dD34130ecC790bb5Ec6be7fFb99',
+    usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
     eas: '0x4200000000000000000000000000000000000021',
     easSchemaRegistry: '0x4200000000000000000000000000000000000020',
-    // AIP-7 contracts
-    agentRegistry: '0xbf9Aa0FC291A06A4dFA943c3E0Ad41E7aE20DF02',
-    archiveTreasury: '0x64B8f93fef2D2E749F5E88586753343F73246012'
+    agentRegistry: '0x6fB222CF3DDdf37Bcb248EE7BBBA42Fb41901de8',
+    archiveTreasury: '0x0516C411C0E8d75D17A768022819a0a4FB3cA2f2',
+    x402Relay: '0x81DFb954A3D58FEc24Fc9c946aC2C71a911609F8',
   },
   eas: {
-    // Registered 2026-02-03
     deliverySchemaUID: '0x166501e7476e2fcf9214c4c5144533c2957d56fe59d639effc1719a0658d9c9a'
   },
   gasSettings: {
@@ -119,7 +157,22 @@ export const BASE_MAINNET: NetworkConfig = {
    * This limits exposure in case of undiscovered vulnerabilities.
    * Will be removed/increased after formal security audit.
    */
-  maxTransactionAmount: 1000
+  maxTransactionAmount: 1000,
+  // AIP-12: Account Abstraction
+  aa: {
+    entryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
+    smartWalletFactory: '0xBA5ED110eFDBa3D005bfC882d75358ACBbB85842',
+    bundlerUrls: {
+      coinbase: process.env.CDP_BUNDLER_URL || `https://api.developer.coinbase.com/rpc/v1/base/${CDP_CLIENT_KEY}`,
+      // Pimlico backup bundler — set PIMLICO_API_KEY env var
+      pimlico: process.env.PIMLICO_BUNDLER_URL || `https://api.pimlico.io/v2/8453/rpc?apikey=${PIMLICO_KEY}`,
+    },
+    paymasterUrls: {
+      coinbase: process.env.CDP_PAYMASTER_URL || `https://api.developer.coinbase.com/rpc/v1/base/${CDP_CLIENT_KEY}`,
+      // Pimlico failover paymaster
+      pimlico: process.env.PIMLICO_PAYMASTER_URL || `https://api.pimlico.io/v2/8453/rpc?apikey=${PIMLICO_KEY}`,
+    },
+  },
 };
 
 /**
@@ -158,15 +211,25 @@ export function getNetwork(network: string): NetworkConfig {
       easSchemaRegistry: config.contracts.easSchemaRegistry,
       agentRegistry: config.contracts.agentRegistry,
       identityRegistry: config.contracts.identityRegistry,
-      archiveTreasury: config.contracts.archiveTreasury
+      archiveTreasury: config.contracts.archiveTreasury,
+      x402Relay: config.contracts.x402Relay
     },
     eas: {
-      deliverySchemaUID: config.eas.deliverySchemaUID
+      deliverySchemaUID: config.eas.deliverySchemaUID,
+      configSnapshotSchemaUID: config.eas.configSnapshotSchemaUID
     },
     gasSettings: {
       maxFeePerGas: config.gasSettings.maxFeePerGas,
       maxPriorityFeePerGas: config.gasSettings.maxPriorityFeePerGas
-    }
+    },
+    ...(config.aa ? {
+      aa: {
+        entryPoint: config.aa.entryPoint,
+        smartWalletFactory: config.aa.smartWalletFactory,
+        bundlerUrls: { ...config.aa.bundlerUrls },
+        paymasterUrls: { ...config.aa.paymasterUrls },
+      }
+    } : {}),
   };
 }
 

package/src/config/publishPipeline.ts

@@ -0,0 +1,276 @@
+/**
+ * Publish Pipeline - AGIRAILS.md → IPFS → Arweave → On-Chain
+ *
+ * Orchestrates the full publish flow:
+ * 1. Read AGIRAILS.md → parse → compute configHash
+ * 2. Upload to Filebase (IPFS pinning)
+ * 3. Upload to Arweave (permanent storage) [optional]
+ * 4. Call AgentRegistry.publishConfig(cid, hash) on-chain
+ * 5. Update AGIRAILS.md frontmatter with config_hash and published_at
+ *
+ * @module config/publishPipeline
+ */
+
+import { readFileSync, writeFileSync } from 'fs';
+import { Signer, keccak256, toUtf8Bytes } from 'ethers';
+import { parseAgirailsMd, computeConfigHash, serializeAgirailsMd } from './agirailsmd';
+import { AgentRegistryClient } from '../registry/AgentRegistryClient';
+import { AgentRegistry } from '../protocol/AgentRegistry';
+import { FilebaseClient } from '../storage/FilebaseClient';
+import { ArweaveClient } from '../storage/ArweaveClient';
+import { ServiceDescriptor } from '../types';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface PublishOptions {
+  /** Path to AGIRAILS.md file */
+  path: string;
+  /** Network name (for registry address lookup) */
+  network: string;
+  /** AgentRegistry contract address */
+  registryAddress: string;
+  /** Signer for on-chain transactions */
+  signer: Signer;
+  /** Filebase client for IPFS upload */
+  filebaseClient: FilebaseClient;
+  /** Arweave client for permanent storage (optional) */
+  arweaveClient?: ArweaveClient;
+  /** Skip Arweave upload (dev mode) */
+  skipArweave?: boolean;
+  /** Dry run - compute and show but don't execute */
+  dryRun?: boolean;
+  /** Gas settings */
+  gasSettings?: {
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+  };
+}
+
+export interface PublishResult {
+  /** IPFS CID of the uploaded AGIRAILS.md */
+  cid: string;
+  /** Canonical config hash (bytes32) */
+  configHash: string;
+  /** On-chain transaction hash */
+  txHash?: string;
+  /** Arweave transaction ID (if uploaded) */
+  arweaveTxId?: string;
+  /** Whether this was a dry run */
+  dryRun: boolean;
+  /** Whether the agent was auto-registered during this publish */
+  registered?: boolean;
+}
+
+// ============================================================================
+// Registration Helpers
+// ============================================================================
+
+export const PENDING_ENDPOINT = 'https://pending.agirails.io';
+
+/** Default values for capabilities-to-services conversion */
+const SERVICE_DEFAULTS = {
+  schemaURI: '',
+  minPrice: 0n,
+  maxPrice: 1_000_000_000n, // 1000 USDC
+  avgCompletionTime: 3600,  // 1 hour
+  metadataCID: '',
+};
+
+/** Max safe USDC value before BigInt conversion loses precision */
+const MAX_SAFE_USDC = Math.floor(Number.MAX_SAFE_INTEGER / 1_000_000);
+
+/** Validate service type format (must match contract requirements) */
+function validateServiceType(serviceType: string, source: string): void {
+  if (!serviceType) {
+    throw new Error(`Empty service type in ${source}`);
+  }
+  if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(serviceType)) {
+    throw new Error(
+      `Invalid service type "${serviceType}" in ${source}. ` +
+      'Must be lowercase alphanumeric with hyphens (e.g., "text-generation").'
+    );
+  }
+}
+
+/** Convert human-readable USDC to 6-decimal base units with overflow check */
+function usdcToBaseUnits(value: number, fieldName: string): bigint {
+  if (value < 0) throw new Error(`${fieldName} cannot be negative`);
+  if (value > MAX_SAFE_USDC) throw new Error(`${fieldName} exceeds maximum safe value (${MAX_SAFE_USDC} USDC)`);
+  return BigInt(Math.round(value * 1_000_000));
+}
+
+/**
+ * Extract registration params from AGIRAILS.md frontmatter.
+ *
+ * Supports two formats:
+ * - `services`: full ServiceDescriptor objects with pricing
+ * - `capabilities`: simple string list, auto-converted with defaults
+ *
+ * @throws Error if neither services nor capabilities are present
+ */
+export function extractRegistrationParams(
+  frontmatter: Record<string, unknown>
+): { endpoint: string; serviceDescriptors: ServiceDescriptor[] } {
+  // Endpoint: use frontmatter field or placeholder
+  const endpoint = typeof frontmatter.endpoint === 'string' && frontmatter.endpoint
+    ? frontmatter.endpoint
+    : PENDING_ENDPOINT;
+
+  // Try explicit services first
+  if (Array.isArray(frontmatter.services) && frontmatter.services.length > 0) {
+    const serviceDescriptors = (frontmatter.services as Record<string, unknown>[]).map(svc => {
+      const serviceType = String(svc.type || svc.service_type || '').trim().toLowerCase();
+      validateServiceType(serviceType, 'services');
+
+      // Parse price range: "1.0-100.0" or separate min/max
+      let minPrice = SERVICE_DEFAULTS.minPrice;
+      let maxPrice = SERVICE_DEFAULTS.maxPrice;
+      if (typeof svc.price === 'string' && svc.price.includes('-')) {
+        const [min, max] = svc.price.split('-').map(Number);
+        minPrice = usdcToBaseUnits(min, 'min_price');
+        maxPrice = usdcToBaseUnits(max, 'max_price');
+      } else {
+        if (svc.min_price !== undefined) minPrice = usdcToBaseUnits(Number(svc.min_price), 'min_price');
+        if (svc.max_price !== undefined) maxPrice = usdcToBaseUnits(Number(svc.max_price), 'max_price');
+      }
+
+      return {
+        serviceTypeHash: keccak256(toUtf8Bytes(serviceType)),
+        serviceType,
+        schemaURI: String(svc.schema_uri || svc.schemaURI || SERVICE_DEFAULTS.schemaURI),
+        minPrice,
+        maxPrice,
+        avgCompletionTime: Number(svc.avg_completion_time || svc.avgCompletionTime || SERVICE_DEFAULTS.avgCompletionTime),
+        metadataCID: String(svc.metadata_cid || svc.metadataCID || SERVICE_DEFAULTS.metadataCID),
+      };
+    });
+    return { endpoint, serviceDescriptors };
+  }
+
+  // Fallback: convert capabilities list to services with defaults
+  if (Array.isArray(frontmatter.capabilities) && frontmatter.capabilities.length > 0) {
+    const serviceDescriptors = (frontmatter.capabilities as string[]).map(cap => {
+      const serviceType = String(cap).trim().toLowerCase();
+      validateServiceType(serviceType, 'capabilities');
+      return {
+        serviceTypeHash: keccak256(toUtf8Bytes(serviceType)),
+        serviceType,
+        schemaURI: SERVICE_DEFAULTS.schemaURI,
+        minPrice: SERVICE_DEFAULTS.minPrice,
+        maxPrice: SERVICE_DEFAULTS.maxPrice,
+        avgCompletionTime: SERVICE_DEFAULTS.avgCompletionTime,
+        metadataCID: SERVICE_DEFAULTS.metadataCID,
+      };
+    });
+    return { endpoint, serviceDescriptors };
+  }
+
+  throw new Error(
+    'AGIRAILS.md must have "services" or "capabilities" in frontmatter for agent registration.\n' +
+    'Add at least one, e.g.:\n' +
+    '  capabilities:\n' +
+    '    - text-generation\n'
+  );
+}
+
+// ============================================================================
+// Pipeline
+// ============================================================================
+
+/**
+ * Execute the full publish pipeline.
+ *
+ * @param options - Publish configuration
+ * @returns Publish result with CID, hash, and transaction hashes
+ */
+export async function publishAgirailsMd(options: PublishOptions): Promise<PublishResult> {
+  const {
+    path,
+    registryAddress,
+    signer,
+    filebaseClient,
+    arweaveClient,
+    skipArweave = false,
+    dryRun = false,
+    gasSettings,
+  } = options;
+
+  // Step 1: Read and parse
+  const content = readFileSync(path, 'utf-8');
+  const { frontmatter, body } = parseAgirailsMd(content);
+  const { configHash } = computeConfigHash(content);
+
+  if (dryRun) {
+    return {
+      cid: '(dry-run)',
+      configHash,
+      dryRun: true,
+      registered: false,
+    };
+  }
+
+  // Step 2: Upload raw AGIRAILS.md to IPFS via Filebase
+  // Upload the actual markdown file (not a JSON wrapper) so CID points to the real file
+  const ipfsResult = await filebaseClient.uploadBinary(
+    Buffer.from(content, 'utf-8'),
+    'text/markdown',
+    { metadata: { type: 'agirails-config', version: '1.0' } }
+  );
+  const cid = ipfsResult.cid;
+
+  // Step 3: Upload to Arweave (optional)
+  // Arweave stores the JSON-structured form for archival querying.
+  // uploadJSON already sets Content-Type: application/json and Protocol: AGIRAILS as defaults.
+  let arweaveTxId: string | undefined;
+  if (!skipArweave && arweaveClient) {
+    const arweaveResult = await arweaveClient.uploadJSON(
+      { frontmatter, body, _format: 'agirails.md.v1' },
+      [
+        { name: 'Type', value: 'agent-config' },
+        { name: 'ConfigHash', value: configHash },
+        { name: 'IPFS-CID', value: cid },
+      ]
+    );
+    arweaveTxId = arweaveResult.txId;
+  }
+
+  // Step 4: Auto-register if needed, then publish on-chain
+  const registry = new AgentRegistry(registryAddress, signer, gasSettings);
+  const registryClient = new AgentRegistryClient(registryAddress, signer, gasSettings);
+  let registered = false;
+
+  const signerAddress = await signer.getAddress();
+  const profile = await registry.getAgent(signerAddress);
+
+  if (!profile) {
+    // Not registered — extract params from frontmatter and auto-register
+    const regParams = extractRegistrationParams(frontmatter);
+    await registry.registerAgent(regParams);
+    registered = true;
+  }
+
+  const { txHash } = await registryClient.publishConfig(cid, configHash);
+
+  // Step 5: Update frontmatter with publish metadata
+  const updatedFrontmatter = {
+    ...frontmatter,
+    config_hash: configHash,
+    published_at: new Date().toISOString(),
+    config_cid: cid,
+    ...(arweaveTxId ? { arweave_tx: arweaveTxId } : {}),
+  };
+
+  const updatedContent = serializeAgirailsMd(updatedFrontmatter, body);
+  writeFileSync(path, updatedContent, 'utf-8');
+
+  return {
+    cid,
+    configHash,
+    txHash,
+    arweaveTxId,
+    dryRun: false,
+    registered,
+  };
+}