@agirails/sdk 2.3.0 → 2.3.3

package/src/cli/commands/register.ts

@@ -0,0 +1,233 @@
+/**
+ * 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('--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 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);
+  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/index.ts

@@ -51,6 +51,7 @@ import { createTimeCommand } from './commands/time';
 import { createPublishCommand } from './commands/publish';
 import { createPullCommand } from './commands/pull';
 import { createDiffCommand } from './commands/diff';
+import { createRegisterCommand } from './commands/register';
 
 // ============================================================================
 // Program Setup
@@ -100,6 +101,9 @@ program.addCommand(createPublishCommand());
 program.addCommand(createPullCommand());
 program.addCommand(createDiffCommand());
 
+// AIP-12: Gas-free registration
+program.addCommand(createRegisterCommand());
+
 // ============================================================================
 // Error Handling
 // ============================================================================

package/src/cli/utils/config.ts

@@ -35,8 +35,38 @@ export interface CLIConfig {
   /** Optional: RPC URL override */
   rpcUrl?: string;
 
+  /** AIP-12: Wallet type — 'auto' (Smart Wallet, gasless) or 'eoa' (traditional) */
+  wallet?: 'auto' | 'eoa';
+
+  /** AIP-12: Smart Wallet address (set when wallet=auto, used by `actp register`) */
+  smartWallet?: string;
+
+  /** AIP-12: Whether agent is registered on AgentRegistry */
+  registered?: boolean;
+
   /** Configuration version for migrations */
   version: string;
+
+  /** Agent name from AGIRAILS.md */
+  agentName?: string;
+
+  /** Agent intent: earn, pay, or both */
+  intent?: 'earn' | 'pay' | 'both';
+
+  /** Service capabilities from AGIRAILS.md */
+  capabilities?: string[];
+
+  /** Base price in USDC */
+  price?: number;
+
+  /** Max concurrent jobs */
+  concurrency?: number;
+
+  /** Payment mode: actp, x402, or both */
+  paymentMode?: 'actp' | 'x402' | 'both';
+
+  /** Budget cap in USDC */
+  budget?: number;
 }
 
 /**

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
  */
@@ -49,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;
+    };
+  };
 }
 
 /**
@@ -60,38 +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',
-    // X402Relay - atomic payment fee splitting (TODO: deploy and set address)
-    // x402Relay: '0x...',
+    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',
@@ -99,21 +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',
-    // X402Relay - atomic payment fee splitting (TODO: deploy and set address)
-    // x402Relay: '0x...',
+    agentRegistry: '0x6fB222CF3DDdf37Bcb248EE7BBBA42Fb41901de8',
+    archiveTreasury: '0x0516C411C0E8d75D17A768022819a0a4FB3cA2f2',
+    x402Relay: '0x81DFb954A3D58FEc24Fc9c946aC2C71a911609F8',
   },
   eas: {
-    // Registered 2026-02-03
     deliverySchemaUID: '0x166501e7476e2fcf9214c4c5144533c2957d56fe59d639effc1719a0658d9c9a'
   },
   gasSettings: {
@@ -125,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}`,
+    },
+  },
 };
 
 /**
@@ -174,7 +221,15 @@ export function getNetwork(network: string): NetworkConfig {
     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

@@ -13,7 +13,7 @@
 
 import { readFileSync, writeFileSync } from 'fs';
 import { Signer, keccak256, toUtf8Bytes } from 'ethers';
-import { parseAgirailsMd, computeConfigHash, computeConfigHashFromParts, serializeAgirailsMd } from './agirailsmd';
+import { parseAgirailsMd, computeConfigHash, serializeAgirailsMd } from './agirailsmd';
 import { AgentRegistryClient } from '../registry/AgentRegistryClient';
 import { AgentRegistry } from '../protocol/AgentRegistry';
 import { FilebaseClient } from '../storage/FilebaseClient';
@@ -110,7 +110,7 @@ function usdcToBaseUnits(value: number, fieldName: string): bigint {
  *
  * @throws Error if neither services nor capabilities are present
  */
-function extractRegistrationParams(
+export function extractRegistrationParams(
   frontmatter: Record<string, unknown>
 ): { endpoint: string; serviceDescriptors: ServiceDescriptor[] } {
   // Endpoint: use frontmatter field or placeholder

package/src/erc8004/ERC8004Bridge.ts

@@ -38,6 +38,7 @@ import {
   ERC8004_IDENTITY_ABI,
   ERC8004_DEFAULT_RPC,
 } from '../types/erc8004';
+import { sdkLogger } from '../utils/Logger';
 
 // ============================================================================
 // Types
@@ -137,7 +138,7 @@ export class ERC8004Bridge {
       config.registryAddress ?? ERC8004_IDENTITY_REGISTRY[config.network];
 
     if (registryAddress === ethers.ZeroAddress) {
-      console.warn(
+      sdkLogger.warn(
         `[ERC8004] Registry not deployed on ${config.network}. Using zero address.`
       );
     }
@@ -327,7 +328,7 @@ export class ERC8004Bridge {
 
       return agentIds;
     } catch (error) {
-      console.warn(`[ERC8004] Failed to get agents for owner ${owner}:`, error);
+      sdkLogger.warn(`[ERC8004] Failed to get agents for owner ${owner}: ${error instanceof Error ? error.message : error}`);
       return [];
     }
   }
@@ -417,7 +418,7 @@ export class ERC8004Bridge {
 
       // Validate URL
       if (!url.startsWith('http://') && !url.startsWith('https://')) {
-        console.warn(`[ERC8004] Invalid agentURI scheme for ${agentId}: ${url}`);
+        sdkLogger.warn(`[ERC8004] Invalid agentURI scheme for ${agentId}: ${url}`);
         return undefined;
       }
 
@@ -434,7 +435,7 @@ export class ERC8004Bridge {
         clearTimeout(timeoutId);
 
         if (!response.ok) {
-          console.warn(
+          sdkLogger.warn(
             `[ERC8004] Metadata fetch failed for ${agentId}: HTTP ${response.status}`
           );
           return undefined;
@@ -454,7 +455,7 @@ export class ERC8004Bridge {
             : error.message
           : 'unknown error';
 
-      console.warn(`[ERC8004] Metadata fetch failed for ${agentId}: ${errorMessage}`);
+      sdkLogger.warn(`[ERC8004] Metadata fetch failed for ${agentId}: ${errorMessage}`);
       return undefined;
     }
   }

package/src/erc8004/ReputationReporter.ts

@@ -50,6 +50,7 @@ import {
   ERC8004_REPUTATION_ABI,
   ACTP_FEEDBACK_TAGS,
 } from '../types/erc8004';
+import { sdkLogger } from '../utils/Logger';
 
 // ============================================================================
 // Types
@@ -214,9 +215,8 @@ export class ReputationReporter {
       config.registryAddress ?? ERC8004_REPUTATION_REGISTRY[config.network];
 
     if (registryAddress === ethers.ZeroAddress) {
-      console.warn(
-        `[ERC8004] Reputation Registry not deployed on ${config.network}. ` +
-          'Reports will fail.'
+      sdkLogger.warn(
+        `[ERC8004] Reputation Registry not deployed on ${config.network}. Reports will fail.`
       );
     }
 
@@ -257,7 +257,7 @@ export class ReputationReporter {
 
     // Local dedup check
     if (this.reportedTxIds.has(txId)) {
-      console.warn(`[ERC8004] Already reported txId in this session: ${txId}`);
+      sdkLogger.warn(`[ERC8004] Already reported txId in this session: ${txId}`);
       return null;
     }
 
@@ -322,7 +322,7 @@ export class ReputationReporter {
 
     // Local dedup check
     if (this.reportedTxIds.has(txId)) {
-      console.warn(`[ERC8004] Already reported txId in this session: ${txId}`);
+      sdkLogger.warn(`[ERC8004] Already reported txId in this session: ${txId}`);
       return null;
     }
 
@@ -392,9 +392,8 @@ export class ReputationReporter {
         score: Number(summaryValue),
       };
     } catch (error) {
-      console.error(
-        `[ERC8004] getAgentReputation failed for ${agentId}:`,
-        error instanceof Error ? error.message : error
+      sdkLogger.error(
+        `[ERC8004] getAgentReputation failed for ${agentId}: ${error instanceof Error ? error.message : error}`
       );
       return null;
     }
@@ -449,23 +448,20 @@ export class ReputationReporter {
 
     // Check for common error cases
     if (errorMessage.includes('insufficient funds')) {
-      console.error(
-        `[ERC8004] ${method} failed for agent ${agentId}: ` +
-          'Insufficient funds for gas. Signer needs ETH/native token.'
+      sdkLogger.error(
+        `[ERC8004] ${method} failed for agent ${agentId}: Insufficient funds for gas. Signer needs ETH/native token.`
       );
     } else if (errorMessage.includes('cannot be the agent owner')) {
-      console.error(
-        `[ERC8004] ${method} failed for agent ${agentId}: ` +
-          'Caller is agent owner. ERC-8004 requires different address.'
+      sdkLogger.error(
+        `[ERC8004] ${method} failed for agent ${agentId}: Caller is agent owner. ERC-8004 requires different address.`
       );
     } else if (errorMessage.includes('user rejected')) {
-      console.warn(
+      sdkLogger.warn(
         `[ERC8004] ${method} cancelled by user for agent ${agentId}`
       );
     } else {
-      console.error(
-        `[ERC8004] ${method} failed for agent ${agentId} (tx: ${txId}): ` +
-          errorMessage
+      sdkLogger.error(
+        `[ERC8004] ${method} failed for agent ${agentId} (tx: ${txId}): ${errorMessage}`
       );
     }
   }

package/src/index.ts

@@ -178,6 +178,18 @@ export {
 
 // Wallet
 export { resolvePrivateKey, getCachedAddress } from './wallet/keystore';
+export type {
+  IWalletProvider,
+  TransactionRequest as WalletTransactionRequest,
+  TransactionReceipt as WalletTransactionReceipt,
+  WalletInfo,
+  WalletTier,
+  BatchedPayParams,
+  BatchedPayResult,
+} from './wallet/IWalletProvider';
+export { EOAWalletProvider } from './wallet/EOAWalletProvider';
+export { AutoWalletProvider } from './wallet/AutoWalletProvider';
+export type { AutoWalletConfig } from './wallet/AutoWalletProvider';
 
 // Helper utilities
 export {

package/src/level1/Agent.ts

@@ -19,7 +19,7 @@ import { RequestOptions, RequestResult, NetworkOption } from './types/Options';
 import { PricingStrategy } from './pricing/PricingStrategy';
 import { AgentLifecycleError, ServiceConfigError, ValidationError } from '../errors';
 import { validateServiceName, validatePath, LRUCache } from '../utils/security';
-import { Logger } from '../utils/Logger';
+import { Logger, sdkLogger } from '../utils/Logger';
 import { ServiceHash } from '../utils/Helpers';
 import { Semaphore } from '../utils/Semaphore';
 import { ProofGenerator } from '../protocol/ProofGenerator';
@@ -1311,21 +1311,21 @@ export class Agent extends EventEmitter {
       log: {
         debug: (message: string, meta?: any) => {
           if (agent.config.logging?.level === 'debug') {
-            console.debug(`[${job.id}] ${message}`, meta);
+            sdkLogger.debug(`[${job.id}] ${message}`, meta);
           }
         },
         info: (message: string, meta?: any) => {
           if (['debug', 'info'].includes(agent.config.logging?.level || 'info')) {
-            console.info(`[${job.id}] ${message}`, meta);
+            sdkLogger.info(`[${job.id}] ${message}`, meta);
           }
         },
         warn: (message: string, meta?: any) => {
           if (['debug', 'info', 'warn'].includes(agent.config.logging?.level || 'info')) {
-            console.warn(`[${job.id}] ${message}`, meta);
+            sdkLogger.warn(`[${job.id}] ${message}`, meta);
           }
         },
         error: (message: string, meta?: any) => {
-          console.error(`[${job.id}] ${message}`, meta);
+          sdkLogger.error(`[${job.id}] ${message}`, meta);
         },
       },