@auteng/agent-utils 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,84 @@
+type Network = "base" | "base-sepolia";
+interface WalletConfig {
+    /** Path to store the wallet keypair. Default: `.auteng/wallet.json` */
+    keyPath?: string;
+    /** Network to use. Default: `base` */
+    network?: Network;
+    /** Custom RPC endpoint. Default: public Base RPC */
+    rpcUrl?: string;
+}
+interface WaitForFundingOptions {
+    /** Poll interval in milliseconds. Default: 10000 (10s) */
+    pollInterval?: number;
+    /** Timeout in milliseconds. Default: none (waits forever) */
+    timeout?: number;
+}
+
+declare const wallet: {
+    /**
+     * Create a new EVM wallet or load an existing one from disk.
+     * Idempotent: if the wallet file already exists, loads it.
+     */
+    create(opts?: WalletConfig): Promise<void>;
+    /** The wallet's public address. Throws if not created. */
+    readonly address: `0x${string}`;
+    /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */
+    checkBalance(): Promise<bigint>;
+    /**
+     * Poll until USDC balance >= minAmount.
+     * @param minAmount - minimum USDC balance in minor units (6 decimals)
+     */
+    waitForFunding(minAmount: bigint, opts?: WaitForFundingOptions): Promise<void>;
+    /**
+     * Drop-in `fetch()` replacement that handles x402 payments automatically.
+     * If the server returns 402, the library signs an EIP-3009 authorization
+     * and retries the request with payment headers.
+     */
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+};
+
+type Stack = "python" | "node";
+type Size = "small" | "med" | "large";
+interface ComputeRequest {
+    /** The code to execute */
+    code: string;
+    /** Runtime stack: 'python' (3.14) or 'node' (24 LTS) */
+    stack: Stack;
+    /** Sandbox size. Default: 'small' */
+    size?: Size;
+    /** Execution timeout in seconds. Default: per-size default */
+    timeout_seconds?: number;
+    /** Optional files to include: filename → base64 content */
+    files?: Record<string, string>;
+}
+interface ComputeResponse {
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+    execution_time_ms: number;
+}
+interface PricingTier {
+    vcpu: number;
+    ram_gb: number;
+    default_timeout_s: number;
+    max_timeout_s: number;
+    base_price_usd: number;
+    per_second_usd: number;
+}
+
+declare const compute: {
+    /**
+     * Execute sandboxed code via AutEng's x402 compute endpoint.
+     * Payment is handled automatically via the wallet's x402 layer.
+     */
+    run(request: ComputeRequest): Promise<ComputeResponse>;
+    /** Returns the pricing table for all compute sizes. */
+    pricing(): Record<Size, PricingTier>;
+    /**
+     * Override the compute endpoint URL.
+     * Default: https://x402.auteng.ai/api/x402/compute
+     */
+    setEndpoint(url: string): void;
+};
+
+export { type ComputeRequest, type ComputeResponse, type Network, type PricingTier, type Size, type Stack, type WaitForFundingOptions, type WalletConfig, compute, wallet };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+type Network = "base" | "base-sepolia";
+interface WalletConfig {
+    /** Path to store the wallet keypair. Default: `.auteng/wallet.json` */
+    keyPath?: string;
+    /** Network to use. Default: `base` */
+    network?: Network;
+    /** Custom RPC endpoint. Default: public Base RPC */
+    rpcUrl?: string;
+}
+interface WaitForFundingOptions {
+    /** Poll interval in milliseconds. Default: 10000 (10s) */
+    pollInterval?: number;
+    /** Timeout in milliseconds. Default: none (waits forever) */
+    timeout?: number;
+}
+
+declare const wallet: {
+    /**
+     * Create a new EVM wallet or load an existing one from disk.
+     * Idempotent: if the wallet file already exists, loads it.
+     */
+    create(opts?: WalletConfig): Promise<void>;
+    /** The wallet's public address. Throws if not created. */
+    readonly address: `0x${string}`;
+    /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */
+    checkBalance(): Promise<bigint>;
+    /**
+     * Poll until USDC balance >= minAmount.
+     * @param minAmount - minimum USDC balance in minor units (6 decimals)
+     */
+    waitForFunding(minAmount: bigint, opts?: WaitForFundingOptions): Promise<void>;
+    /**
+     * Drop-in `fetch()` replacement that handles x402 payments automatically.
+     * If the server returns 402, the library signs an EIP-3009 authorization
+     * and retries the request with payment headers.
+     */
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+};
+
+type Stack = "python" | "node";
+type Size = "small" | "med" | "large";
+interface ComputeRequest {
+    /** The code to execute */
+    code: string;
+    /** Runtime stack: 'python' (3.14) or 'node' (24 LTS) */
+    stack: Stack;
+    /** Sandbox size. Default: 'small' */
+    size?: Size;
+    /** Execution timeout in seconds. Default: per-size default */
+    timeout_seconds?: number;
+    /** Optional files to include: filename → base64 content */
+    files?: Record<string, string>;
+}
+interface ComputeResponse {
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+    execution_time_ms: number;
+}
+interface PricingTier {
+    vcpu: number;
+    ram_gb: number;
+    default_timeout_s: number;
+    max_timeout_s: number;
+    base_price_usd: number;
+    per_second_usd: number;
+}
+
+declare const compute: {
+    /**
+     * Execute sandboxed code via AutEng's x402 compute endpoint.
+     * Payment is handled automatically via the wallet's x402 layer.
+     */
+    run(request: ComputeRequest): Promise<ComputeResponse>;
+    /** Returns the pricing table for all compute sizes. */
+    pricing(): Record<Size, PricingTier>;
+    /**
+     * Override the compute endpoint URL.
+     * Default: https://x402.auteng.ai/api/x402/compute
+     */
+    setEndpoint(url: string): void;
+};
+
+export { type ComputeRequest, type ComputeResponse, type Network, type PricingTier, type Size, type Stack, type WaitForFundingOptions, type WalletConfig, compute, wallet };

package/dist/index.js

@@ -0,0 +1,273 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  compute: () => compute,
+  wallet: () => wallet
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/wallet/index.ts
+var import_node_path2 = require("path");
+
+// src/wallet/keypair.ts
+var import_accounts = require("viem/accounts");
+function createKeypair() {
+  const privateKey = (0, import_accounts.generatePrivateKey)();
+  const account = (0, import_accounts.privateKeyToAccount)(privateKey);
+  return { privateKey, account };
+}
+function loadKeypair(privateKey) {
+  const account = (0, import_accounts.privateKeyToAccount)(privateKey);
+  return { account };
+}
+
+// src/wallet/storage.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+function readWalletFile(path) {
+  if (!(0, import_node_fs.existsSync)(path)) return null;
+  const raw = (0, import_node_fs.readFileSync)(path, "utf-8");
+  return JSON.parse(raw);
+}
+function writeWalletFile(path, data) {
+  (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(path), { recursive: true });
+  (0, import_node_fs.writeFileSync)(path, JSON.stringify(data, null, 2) + "\n", {
+    mode: 384
+  });
+}
+
+// src/wallet/types.ts
+var NETWORK_CONFIG = {
+  base: {
+    chainId: 8453,
+    usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    rpcUrl: "https://mainnet.base.org"
+  },
+  "base-sepolia": {
+    chainId: 84532,
+    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    rpcUrl: "https://sepolia.base.org"
+  }
+};
+
+// src/wallet/balance.ts
+async function getUsdcBalance(address, network, rpcUrl) {
+  const config = NETWORK_CONFIG[network];
+  const url = rpcUrl ?? config.rpcUrl;
+  const paddedAddress = address.slice(2).toLowerCase().padStart(64, "0");
+  const data = `0x70a08231${paddedAddress}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "eth_call",
+      params: [{ to: config.usdcAddress, data }, "latest"]
+    })
+  });
+  const json = await res.json();
+  if (json.error) {
+    throw new Error(`RPC error: ${JSON.stringify(json.error)}`);
+  }
+  return BigInt(json.result ?? "0x0");
+}
+
+// src/x402/index.ts
+var import_client = require("@x402/core/client");
+var import_client2 = require("@x402/evm/exact/client");
+var import_evm = require("@x402/evm");
+var import_fetch = require("@x402/fetch");
+var import_accounts2 = require("viem/accounts");
+var import_viem = require("viem");
+var import_chains = require("viem/chains");
+function createPaymentFetch(privateKey, network = "base", rpcUrl) {
+  const account = (0, import_accounts2.privateKeyToAccount)(privateKey);
+  const chain = network === "base" ? import_chains.base : import_chains.baseSepolia;
+  const publicClient = (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)(rpcUrl)
+  });
+  const signer = (0, import_evm.toClientEvmSigner)(account, publicClient);
+  const client = new import_client.x402Client();
+  (0, import_client2.registerExactEvmScheme)(client, { signer });
+  return (0, import_fetch.wrapFetchWithPayment)(fetch, client);
+}
+
+// src/wallet/index.ts
+var _account = null;
+var _privateKey = null;
+var _network = "base";
+var _rpcUrl;
+var _paymentFetch = null;
+function ensureCreated() {
+  if (!_account) {
+    throw new Error("Wallet not initialized. Call wallet.create() first.");
+  }
+}
+var wallet = {
+  /**
+   * Create a new EVM wallet or load an existing one from disk.
+   * Idempotent: if the wallet file already exists, loads it.
+   */
+  async create(opts) {
+    const keyPath = (0, import_node_path2.resolve)(opts?.keyPath ?? ".auteng/wallet.json");
+    _network = opts?.network ?? "base";
+    _rpcUrl = opts?.rpcUrl;
+    const existing = readWalletFile(keyPath);
+    if (existing) {
+      _privateKey = existing.privateKey;
+      const { account } = loadKeypair(existing.privateKey);
+      _account = account;
+      _network = existing.network;
+    } else {
+      const { privateKey, account } = createKeypair();
+      _privateKey = privateKey;
+      _account = account;
+      writeWalletFile(keyPath, {
+        privateKey,
+        address: account.address,
+        network: _network
+      });
+    }
+    _paymentFetch = createPaymentFetch(_privateKey, _network, _rpcUrl);
+  },
+  /** The wallet's public address. Throws if not created. */
+  get address() {
+    ensureCreated();
+    return _account.address;
+  },
+  /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */
+  async checkBalance() {
+    ensureCreated();
+    return getUsdcBalance(_account.address, _network, _rpcUrl);
+  },
+  /**
+   * Poll until USDC balance >= minAmount.
+   * @param minAmount - minimum USDC balance in minor units (6 decimals)
+   */
+  async waitForFunding(minAmount, opts) {
+    ensureCreated();
+    const interval = opts?.pollInterval ?? 1e4;
+    const deadline = opts?.timeout ? Date.now() + opts.timeout : null;
+    while (true) {
+      const balance = await getUsdcBalance(_account.address, _network, _rpcUrl);
+      if (balance >= minAmount) return;
+      if (deadline && Date.now() >= deadline) {
+        throw new Error(`Funding timeout: balance ${balance} < required ${minAmount}`);
+      }
+      await new Promise((r) => setTimeout(r, interval));
+    }
+  },
+  /**
+   * Drop-in `fetch()` replacement that handles x402 payments automatically.
+   * If the server returns 402, the library signs an EIP-3009 authorization
+   * and retries the request with payment headers.
+   */
+  async fetch(input, init) {
+    ensureCreated();
+    if (!_paymentFetch) {
+      throw new Error("Payment layer not initialized");
+    }
+    return _paymentFetch(input, init);
+  }
+};
+
+// src/compute/index.ts
+var DEFAULT_ENDPOINT = "https://x402.auteng.ai/api/x402/compute";
+var _endpoint = DEFAULT_ENDPOINT;
+var PRICING = {
+  small: {
+    vcpu: 2,
+    ram_gb: 1,
+    default_timeout_s: 30,
+    max_timeout_s: 300,
+    base_price_usd: 2e-3,
+    per_second_usd: 5e-5
+  },
+  med: {
+    vcpu: 4,
+    ram_gb: 4,
+    default_timeout_s: 60,
+    max_timeout_s: 600,
+    base_price_usd: 8e-3,
+    per_second_usd: 12e-5
+  },
+  large: {
+    vcpu: 8,
+    ram_gb: 16,
+    default_timeout_s: 120,
+    max_timeout_s: 3600,
+    base_price_usd: 0.03,
+    per_second_usd: 25e-5
+  }
+};
+var compute = {
+  /**
+   * Execute sandboxed code via AutEng's x402 compute endpoint.
+   * Payment is handled automatically via the wallet's x402 layer.
+   */
+  async run(request) {
+    if (!request.code) {
+      throw new Error("compute.run: 'code' is required");
+    }
+    if (!request.stack) {
+      throw new Error("compute.run: 'stack' is required");
+    }
+    const body = {
+      code: request.code,
+      stack: request.stack,
+      size: request.size ?? "small",
+      ...request.timeout_seconds != null && {
+        timeout_seconds: request.timeout_seconds
+      },
+      ...request.files != null && { files: request.files }
+    };
+    const response = await wallet.fetch(_endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new Error(`Compute request failed (${response.status}): ${text}`);
+    }
+    return await response.json();
+  },
+  /** Returns the pricing table for all compute sizes. */
+  pricing() {
+    return { ...PRICING };
+  },
+  /**
+   * Override the compute endpoint URL.
+   * Default: https://x402.auteng.ai/api/x402/compute
+   */
+  setEndpoint(url) {
+    _endpoint = url;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compute,
+  wallet
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/wallet/index.ts","../src/wallet/keypair.ts","../src/wallet/storage.ts","../src/wallet/types.ts","../src/wallet/balance.ts","../src/x402/index.ts","../src/compute/index.ts"],"sourcesContent":["export { wallet } from \"./wallet/index.js\"\nexport { compute } from \"./compute/index.js\"\n\nexport type { WalletConfig, WaitForFundingOptions, Network } from \"./wallet/types.js\"\nexport type { ComputeRequest, ComputeResponse, PricingTier, Stack, Size } from \"./compute/types.js\"\n","import { resolve } from \"node:path\"\nimport type { PrivateKeyAccount } from \"viem\"\nimport { createKeypair, loadKeypair } from \"./keypair.js\"\nimport { readWalletFile, writeWalletFile } from \"./storage.js\"\nimport { getUsdcBalance } from \"./balance.js\"\nimport { createPaymentFetch } from \"../x402/index.js\"\nimport type { Network, WalletConfig, WaitForFundingOptions } from \"./types.js\"\n\n// --- Internal state ---\n\nlet _account: PrivateKeyAccount | null = null\nlet _privateKey: `0x${string}` | null = null\nlet _network: Network = \"base\"\nlet _rpcUrl: string | undefined\nlet _paymentFetch: typeof globalThis.fetch | null = null\n\nfunction ensureCreated(): void {\n  if (!_account) {\n    throw new Error(\"Wallet not initialized. Call wallet.create() first.\")\n  }\n}\n\n// --- Public API ---\n\nexport const wallet = {\n  /**\n   * Create a new EVM wallet or load an existing one from disk.\n   * Idempotent: if the wallet file already exists, loads it.\n   */\n  async create(opts?: WalletConfig): Promise<void> {\n    const keyPath = resolve(opts?.keyPath ?? \".auteng/wallet.json\")\n    _network = opts?.network ?? \"base\"\n    _rpcUrl = opts?.rpcUrl\n\n    const existing = readWalletFile(keyPath)\n    if (existing) {\n      _privateKey = existing.privateKey\n      const { account } = loadKeypair(existing.privateKey)\n      _account = account\n      _network = existing.network\n    } else {\n      const { privateKey, account } = createKeypair()\n      _privateKey = privateKey\n      _account = account\n      writeWalletFile(keyPath, {\n        privateKey,\n        address: account.address,\n        network: _network,\n      })\n    }\n\n    _paymentFetch = createPaymentFetch(_privateKey!, _network, _rpcUrl)\n  },\n\n  /** The wallet's public address. Throws if not created. */\n  get address(): `0x${string}` {\n    ensureCreated()\n    return _account!.address\n  },\n\n  /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */\n  async checkBalance(): Promise<bigint> {\n    ensureCreated()\n    return getUsdcBalance(_account!.address, _network, _rpcUrl)\n  },\n\n  /**\n   * Poll until USDC balance >= minAmount.\n   * @param minAmount - minimum USDC balance in minor units (6 decimals)\n   */\n  async waitForFunding(minAmount: bigint, opts?: WaitForFundingOptions): Promise<void> {\n    ensureCreated()\n    const interval = opts?.pollInterval ?? 10_000\n    const deadline = opts?.timeout ? Date.now() + opts.timeout : null\n\n    while (true) {\n      const balance = await getUsdcBalance(_account!.address, _network, _rpcUrl)\n      if (balance >= minAmount) return\n\n      if (deadline && Date.now() >= deadline) {\n        throw new Error(`Funding timeout: balance ${balance} < required ${minAmount}`)\n      }\n\n      await new Promise((r) => setTimeout(r, interval))\n    }\n  },\n\n  /**\n   * Drop-in `fetch()` replacement that handles x402 payments automatically.\n   * If the server returns 402, the library signs an EIP-3009 authorization\n   * and retries the request with payment headers.\n   */\n  async fetch(input: string | URL | Request, init?: RequestInit): Promise<Response> {\n    ensureCreated()\n    if (!_paymentFetch) {\n      throw new Error(\"Payment layer not initialized\")\n    }\n    return _paymentFetch(input, init)\n  },\n}\n","import { generatePrivateKey, privateKeyToAccount } from \"viem/accounts\"\nimport type { PrivateKeyAccount } from \"viem\"\n\nexport function createKeypair(): {\n  privateKey: `0x${string}`\n  account: PrivateKeyAccount\n} {\n  const privateKey = generatePrivateKey()\n  const account = privateKeyToAccount(privateKey)\n  return { privateKey, account }\n}\n\nexport function loadKeypair(privateKey: `0x${string}`): {\n  account: PrivateKeyAccount\n} {\n  const account = privateKeyToAccount(privateKey)\n  return { account }\n}\n","import { mkdirSync, readFileSync, writeFileSync, existsSync } from \"node:fs\"\nimport { dirname } from \"node:path\"\nimport type { WalletFile } from \"./types.js\"\n\nexport function readWalletFile(path: string): WalletFile | null {\n  if (!existsSync(path)) return null\n  const raw = readFileSync(path, \"utf-8\")\n  return JSON.parse(raw) as WalletFile\n}\n\nexport function writeWalletFile(path: string, data: WalletFile): void {\n  mkdirSync(dirname(path), { recursive: true })\n  writeFileSync(path, JSON.stringify(data, null, 2) + \"\\n\", {\n    mode: 0o600,\n  })\n}\n","export type Network = \"base\" | \"base-sepolia\"\n\nexport interface WalletConfig {\n  /** Path to store the wallet keypair. Default: `.auteng/wallet.json` */\n  keyPath?: string\n  /** Network to use. Default: `base` */\n  network?: Network\n  /** Custom RPC endpoint. Default: public Base RPC */\n  rpcUrl?: string\n}\n\nexport interface WalletFile {\n  privateKey: `0x${string}`\n  address: `0x${string}`\n  network: Network\n}\n\nexport interface WaitForFundingOptions {\n  /** Poll interval in milliseconds. Default: 10000 (10s) */\n  pollInterval?: number\n  /** Timeout in milliseconds. Default: none (waits forever) */\n  timeout?: number\n}\n\nexport const NETWORK_CONFIG: Record<Network, { chainId: number; usdcAddress: `0x${string}`; rpcUrl: string }> = {\n  base: {\n    chainId: 8453,\n    usdcAddress: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n    rpcUrl: \"https://mainnet.base.org\",\n  },\n  \"base-sepolia\": {\n    chainId: 84532,\n    usdcAddress: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n    rpcUrl: \"https://sepolia.base.org\",\n  },\n}\n","import type { Network } from \"./types.js\"\nimport { NETWORK_CONFIG } from \"./types.js\"\n\n/**\n * Read USDC balance for `address` via a direct `eth_call` to the USDC\n * contract's `balanceOf(address)` function. No viem client needed — just\n * a plain JSON-RPC POST.\n */\nexport async function getUsdcBalance(address: `0x${string}`, network: Network, rpcUrl?: string): Promise<bigint> {\n  const config = NETWORK_CONFIG[network]\n  const url = rpcUrl ?? config.rpcUrl\n\n  // balanceOf(address) selector = 0x70a08231\n  const paddedAddress = address.slice(2).toLowerCase().padStart(64, \"0\")\n  const data = `0x70a08231${paddedAddress}`\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      jsonrpc: \"2.0\",\n      id: 1,\n      method: \"eth_call\",\n      params: [{ to: config.usdcAddress, data }, \"latest\"],\n    }),\n  })\n\n  const json = (await res.json()) as { result?: string; error?: unknown }\n  if (json.error) {\n    throw new Error(`RPC error: ${JSON.stringify(json.error)}`)\n  }\n  return BigInt(json.result ?? \"0x0\")\n}\n","import { x402Client } from \"@x402/core/client\"\nimport { registerExactEvmScheme } from \"@x402/evm/exact/client\"\nimport { toClientEvmSigner } from \"@x402/evm\"\nimport { wrapFetchWithPayment } from \"@x402/fetch\"\nimport { privateKeyToAccount } from \"viem/accounts\"\nimport { createPublicClient, http } from \"viem\"\nimport { base, baseSepolia } from \"viem/chains\"\nimport type { Network } from \"../wallet/types.js\"\n\n/**\n * Create a fetch function that automatically handles x402 payments.\n * When the server returns 402, the SDK signs an EIP-3009 authorization\n * using the provided private key and retries with payment headers.\n */\nexport function createPaymentFetch(\n  privateKey: `0x${string}`,\n  network: Network = \"base\",\n  rpcUrl?: string\n): typeof globalThis.fetch {\n  const account = privateKeyToAccount(privateKey)\n  const chain = network === \"base\" ? base : baseSepolia\n  const publicClient = createPublicClient({\n    chain,\n    transport: http(rpcUrl),\n  })\n  const signer = toClientEvmSigner(account, publicClient)\n\n  const client = new x402Client()\n  registerExactEvmScheme(client, { signer })\n  return wrapFetchWithPayment(fetch, client)\n}\n","import { wallet } from \"../wallet/index.js\"\nimport type { ComputeRequest, ComputeResponse, PricingTier, Size } from \"./types.js\"\n\nconst DEFAULT_ENDPOINT = \"https://x402.auteng.ai/api/x402/compute\"\n\nlet _endpoint = DEFAULT_ENDPOINT\n\nconst PRICING: Record<Size, PricingTier> = {\n  small: {\n    vcpu: 2,\n    ram_gb: 1,\n    default_timeout_s: 30,\n    max_timeout_s: 300,\n    base_price_usd: 0.002,\n    per_second_usd: 0.00005,\n  },\n  med: {\n    vcpu: 4,\n    ram_gb: 4,\n    default_timeout_s: 60,\n    max_timeout_s: 600,\n    base_price_usd: 0.008,\n    per_second_usd: 0.00012,\n  },\n  large: {\n    vcpu: 8,\n    ram_gb: 16,\n    default_timeout_s: 120,\n    max_timeout_s: 3600,\n    base_price_usd: 0.03,\n    per_second_usd: 0.00025,\n  },\n}\n\nexport const compute = {\n  /**\n   * Execute sandboxed code via AutEng's x402 compute endpoint.\n   * Payment is handled automatically via the wallet's x402 layer.\n   */\n  async run(request: ComputeRequest): Promise<ComputeResponse> {\n    if (!request.code) {\n      throw new Error(\"compute.run: 'code' is required\")\n    }\n    if (!request.stack) {\n      throw new Error(\"compute.run: 'stack' is required\")\n    }\n\n    const body = {\n      code: request.code,\n      stack: request.stack,\n      size: request.size ?? \"small\",\n      ...(request.timeout_seconds != null && {\n        timeout_seconds: request.timeout_seconds,\n      }),\n      ...(request.files != null && { files: request.files }),\n    }\n\n    const response = await wallet.fetch(_endpoint, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    })\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\")\n      throw new Error(`Compute request failed (${response.status}): ${text}`)\n    }\n\n    return (await response.json()) as ComputeResponse\n  },\n\n  /** Returns the pricing table for all compute sizes. */\n  pricing(): Record<Size, PricingTier> {\n    return { ...PRICING }\n  },\n\n  /**\n   * Override the compute endpoint URL.\n   * Default: https://x402.auteng.ai/api/x402/compute\n   */\n  setEndpoint(url: string): void {\n    _endpoint = url\n  },\n}\n"],"mappings":"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","names":["import_node_path","import_client","import_accounts"]}

package/dist/index.mjs

@@ -0,0 +1,245 @@
+// src/wallet/index.ts
+import { resolve } from "path";
+
+// src/wallet/keypair.ts
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+function createKeypair() {
+  const privateKey = generatePrivateKey();
+  const account = privateKeyToAccount(privateKey);
+  return { privateKey, account };
+}
+function loadKeypair(privateKey) {
+  const account = privateKeyToAccount(privateKey);
+  return { account };
+}
+
+// src/wallet/storage.ts
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "fs";
+import { dirname } from "path";
+function readWalletFile(path) {
+  if (!existsSync(path)) return null;
+  const raw = readFileSync(path, "utf-8");
+  return JSON.parse(raw);
+}
+function writeWalletFile(path, data) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, JSON.stringify(data, null, 2) + "\n", {
+    mode: 384
+  });
+}
+
+// src/wallet/types.ts
+var NETWORK_CONFIG = {
+  base: {
+    chainId: 8453,
+    usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    rpcUrl: "https://mainnet.base.org"
+  },
+  "base-sepolia": {
+    chainId: 84532,
+    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    rpcUrl: "https://sepolia.base.org"
+  }
+};
+
+// src/wallet/balance.ts
+async function getUsdcBalance(address, network, rpcUrl) {
+  const config = NETWORK_CONFIG[network];
+  const url = rpcUrl ?? config.rpcUrl;
+  const paddedAddress = address.slice(2).toLowerCase().padStart(64, "0");
+  const data = `0x70a08231${paddedAddress}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "eth_call",
+      params: [{ to: config.usdcAddress, data }, "latest"]
+    })
+  });
+  const json = await res.json();
+  if (json.error) {
+    throw new Error(`RPC error: ${JSON.stringify(json.error)}`);
+  }
+  return BigInt(json.result ?? "0x0");
+}
+
+// src/x402/index.ts
+import { x402Client } from "@x402/core/client";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
+import { toClientEvmSigner } from "@x402/evm";
+import { wrapFetchWithPayment } from "@x402/fetch";
+import { privateKeyToAccount as privateKeyToAccount2 } from "viem/accounts";
+import { createPublicClient, http } from "viem";
+import { base, baseSepolia } from "viem/chains";
+function createPaymentFetch(privateKey, network = "base", rpcUrl) {
+  const account = privateKeyToAccount2(privateKey);
+  const chain = network === "base" ? base : baseSepolia;
+  const publicClient = createPublicClient({
+    chain,
+    transport: http(rpcUrl)
+  });
+  const signer = toClientEvmSigner(account, publicClient);
+  const client = new x402Client();
+  registerExactEvmScheme(client, { signer });
+  return wrapFetchWithPayment(fetch, client);
+}
+
+// src/wallet/index.ts
+var _account = null;
+var _privateKey = null;
+var _network = "base";
+var _rpcUrl;
+var _paymentFetch = null;
+function ensureCreated() {
+  if (!_account) {
+    throw new Error("Wallet not initialized. Call wallet.create() first.");
+  }
+}
+var wallet = {
+  /**
+   * Create a new EVM wallet or load an existing one from disk.
+   * Idempotent: if the wallet file already exists, loads it.
+   */
+  async create(opts) {
+    const keyPath = resolve(opts?.keyPath ?? ".auteng/wallet.json");
+    _network = opts?.network ?? "base";
+    _rpcUrl = opts?.rpcUrl;
+    const existing = readWalletFile(keyPath);
+    if (existing) {
+      _privateKey = existing.privateKey;
+      const { account } = loadKeypair(existing.privateKey);
+      _account = account;
+      _network = existing.network;
+    } else {
+      const { privateKey, account } = createKeypair();
+      _privateKey = privateKey;
+      _account = account;
+      writeWalletFile(keyPath, {
+        privateKey,
+        address: account.address,
+        network: _network
+      });
+    }
+    _paymentFetch = createPaymentFetch(_privateKey, _network, _rpcUrl);
+  },
+  /** The wallet's public address. Throws if not created. */
+  get address() {
+    ensureCreated();
+    return _account.address;
+  },
+  /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */
+  async checkBalance() {
+    ensureCreated();
+    return getUsdcBalance(_account.address, _network, _rpcUrl);
+  },
+  /**
+   * Poll until USDC balance >= minAmount.
+   * @param minAmount - minimum USDC balance in minor units (6 decimals)
+   */
+  async waitForFunding(minAmount, opts) {
+    ensureCreated();
+    const interval = opts?.pollInterval ?? 1e4;
+    const deadline = opts?.timeout ? Date.now() + opts.timeout : null;
+    while (true) {
+      const balance = await getUsdcBalance(_account.address, _network, _rpcUrl);
+      if (balance >= minAmount) return;
+      if (deadline && Date.now() >= deadline) {
+        throw new Error(`Funding timeout: balance ${balance} < required ${minAmount}`);
+      }
+      await new Promise((r) => setTimeout(r, interval));
+    }
+  },
+  /**
+   * Drop-in `fetch()` replacement that handles x402 payments automatically.
+   * If the server returns 402, the library signs an EIP-3009 authorization
+   * and retries the request with payment headers.
+   */
+  async fetch(input, init) {
+    ensureCreated();
+    if (!_paymentFetch) {
+      throw new Error("Payment layer not initialized");
+    }
+    return _paymentFetch(input, init);
+  }
+};
+
+// src/compute/index.ts
+var DEFAULT_ENDPOINT = "https://x402.auteng.ai/api/x402/compute";
+var _endpoint = DEFAULT_ENDPOINT;
+var PRICING = {
+  small: {
+    vcpu: 2,
+    ram_gb: 1,
+    default_timeout_s: 30,
+    max_timeout_s: 300,
+    base_price_usd: 2e-3,
+    per_second_usd: 5e-5
+  },
+  med: {
+    vcpu: 4,
+    ram_gb: 4,
+    default_timeout_s: 60,
+    max_timeout_s: 600,
+    base_price_usd: 8e-3,
+    per_second_usd: 12e-5
+  },
+  large: {
+    vcpu: 8,
+    ram_gb: 16,
+    default_timeout_s: 120,
+    max_timeout_s: 3600,
+    base_price_usd: 0.03,
+    per_second_usd: 25e-5
+  }
+};
+var compute = {
+  /**
+   * Execute sandboxed code via AutEng's x402 compute endpoint.
+   * Payment is handled automatically via the wallet's x402 layer.
+   */
+  async run(request) {
+    if (!request.code) {
+      throw new Error("compute.run: 'code' is required");
+    }
+    if (!request.stack) {
+      throw new Error("compute.run: 'stack' is required");
+    }
+    const body = {
+      code: request.code,
+      stack: request.stack,
+      size: request.size ?? "small",
+      ...request.timeout_seconds != null && {
+        timeout_seconds: request.timeout_seconds
+      },
+      ...request.files != null && { files: request.files }
+    };
+    const response = await wallet.fetch(_endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new Error(`Compute request failed (${response.status}): ${text}`);
+    }
+    return await response.json();
+  },
+  /** Returns the pricing table for all compute sizes. */
+  pricing() {
+    return { ...PRICING };
+  },
+  /**
+   * Override the compute endpoint URL.
+   * Default: https://x402.auteng.ai/api/x402/compute
+   */
+  setEndpoint(url) {
+    _endpoint = url;
+  }
+};
+export {
+  compute,
+  wallet
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wallet/index.ts","../src/wallet/keypair.ts","../src/wallet/storage.ts","../src/wallet/types.ts","../src/wallet/balance.ts","../src/x402/index.ts","../src/compute/index.ts"],"sourcesContent":["import { resolve } from \"node:path\"\nimport type { PrivateKeyAccount } from \"viem\"\nimport { createKeypair, loadKeypair } from \"./keypair.js\"\nimport { readWalletFile, writeWalletFile } from \"./storage.js\"\nimport { getUsdcBalance } from \"./balance.js\"\nimport { createPaymentFetch } from \"../x402/index.js\"\nimport type { Network, WalletConfig, WaitForFundingOptions } from \"./types.js\"\n\n// --- Internal state ---\n\nlet _account: PrivateKeyAccount | null = null\nlet _privateKey: `0x${string}` | null = null\nlet _network: Network = \"base\"\nlet _rpcUrl: string | undefined\nlet _paymentFetch: typeof globalThis.fetch | null = null\n\nfunction ensureCreated(): void {\n  if (!_account) {\n    throw new Error(\"Wallet not initialized. Call wallet.create() first.\")\n  }\n}\n\n// --- Public API ---\n\nexport const wallet = {\n  /**\n   * Create a new EVM wallet or load an existing one from disk.\n   * Idempotent: if the wallet file already exists, loads it.\n   */\n  async create(opts?: WalletConfig): Promise<void> {\n    const keyPath = resolve(opts?.keyPath ?? \".auteng/wallet.json\")\n    _network = opts?.network ?? \"base\"\n    _rpcUrl = opts?.rpcUrl\n\n    const existing = readWalletFile(keyPath)\n    if (existing) {\n      _privateKey = existing.privateKey\n      const { account } = loadKeypair(existing.privateKey)\n      _account = account\n      _network = existing.network\n    } else {\n      const { privateKey, account } = createKeypair()\n      _privateKey = privateKey\n      _account = account\n      writeWalletFile(keyPath, {\n        privateKey,\n        address: account.address,\n        network: _network,\n      })\n    }\n\n    _paymentFetch = createPaymentFetch(_privateKey!, _network, _rpcUrl)\n  },\n\n  /** The wallet's public address. Throws if not created. */\n  get address(): `0x${string}` {\n    ensureCreated()\n    return _account!.address\n  },\n\n  /** Check USDC balance on Base. Returns balance in minor units (6 decimals). */\n  async checkBalance(): Promise<bigint> {\n    ensureCreated()\n    return getUsdcBalance(_account!.address, _network, _rpcUrl)\n  },\n\n  /**\n   * Poll until USDC balance >= minAmount.\n   * @param minAmount - minimum USDC balance in minor units (6 decimals)\n   */\n  async waitForFunding(minAmount: bigint, opts?: WaitForFundingOptions): Promise<void> {\n    ensureCreated()\n    const interval = opts?.pollInterval ?? 10_000\n    const deadline = opts?.timeout ? Date.now() + opts.timeout : null\n\n    while (true) {\n      const balance = await getUsdcBalance(_account!.address, _network, _rpcUrl)\n      if (balance >= minAmount) return\n\n      if (deadline && Date.now() >= deadline) {\n        throw new Error(`Funding timeout: balance ${balance} < required ${minAmount}`)\n      }\n\n      await new Promise((r) => setTimeout(r, interval))\n    }\n  },\n\n  /**\n   * Drop-in `fetch()` replacement that handles x402 payments automatically.\n   * If the server returns 402, the library signs an EIP-3009 authorization\n   * and retries the request with payment headers.\n   */\n  async fetch(input: string | URL | Request, init?: RequestInit): Promise<Response> {\n    ensureCreated()\n    if (!_paymentFetch) {\n      throw new Error(\"Payment layer not initialized\")\n    }\n    return _paymentFetch(input, init)\n  },\n}\n","import { generatePrivateKey, privateKeyToAccount } from \"viem/accounts\"\nimport type { PrivateKeyAccount } from \"viem\"\n\nexport function createKeypair(): {\n  privateKey: `0x${string}`\n  account: PrivateKeyAccount\n} {\n  const privateKey = generatePrivateKey()\n  const account = privateKeyToAccount(privateKey)\n  return { privateKey, account }\n}\n\nexport function loadKeypair(privateKey: `0x${string}`): {\n  account: PrivateKeyAccount\n} {\n  const account = privateKeyToAccount(privateKey)\n  return { account }\n}\n","import { mkdirSync, readFileSync, writeFileSync, existsSync } from \"node:fs\"\nimport { dirname } from \"node:path\"\nimport type { WalletFile } from \"./types.js\"\n\nexport function readWalletFile(path: string): WalletFile | null {\n  if (!existsSync(path)) return null\n  const raw = readFileSync(path, \"utf-8\")\n  return JSON.parse(raw) as WalletFile\n}\n\nexport function writeWalletFile(path: string, data: WalletFile): void {\n  mkdirSync(dirname(path), { recursive: true })\n  writeFileSync(path, JSON.stringify(data, null, 2) + \"\\n\", {\n    mode: 0o600,\n  })\n}\n","export type Network = \"base\" | \"base-sepolia\"\n\nexport interface WalletConfig {\n  /** Path to store the wallet keypair. Default: `.auteng/wallet.json` */\n  keyPath?: string\n  /** Network to use. Default: `base` */\n  network?: Network\n  /** Custom RPC endpoint. Default: public Base RPC */\n  rpcUrl?: string\n}\n\nexport interface WalletFile {\n  privateKey: `0x${string}`\n  address: `0x${string}`\n  network: Network\n}\n\nexport interface WaitForFundingOptions {\n  /** Poll interval in milliseconds. Default: 10000 (10s) */\n  pollInterval?: number\n  /** Timeout in milliseconds. Default: none (waits forever) */\n  timeout?: number\n}\n\nexport const NETWORK_CONFIG: Record<Network, { chainId: number; usdcAddress: `0x${string}`; rpcUrl: string }> = {\n  base: {\n    chainId: 8453,\n    usdcAddress: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n    rpcUrl: \"https://mainnet.base.org\",\n  },\n  \"base-sepolia\": {\n    chainId: 84532,\n    usdcAddress: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n    rpcUrl: \"https://sepolia.base.org\",\n  },\n}\n","import type { Network } from \"./types.js\"\nimport { NETWORK_CONFIG } from \"./types.js\"\n\n/**\n * Read USDC balance for `address` via a direct `eth_call` to the USDC\n * contract's `balanceOf(address)` function. No viem client needed — just\n * a plain JSON-RPC POST.\n */\nexport async function getUsdcBalance(address: `0x${string}`, network: Network, rpcUrl?: string): Promise<bigint> {\n  const config = NETWORK_CONFIG[network]\n  const url = rpcUrl ?? config.rpcUrl\n\n  // balanceOf(address) selector = 0x70a08231\n  const paddedAddress = address.slice(2).toLowerCase().padStart(64, \"0\")\n  const data = `0x70a08231${paddedAddress}`\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      jsonrpc: \"2.0\",\n      id: 1,\n      method: \"eth_call\",\n      params: [{ to: config.usdcAddress, data }, \"latest\"],\n    }),\n  })\n\n  const json = (await res.json()) as { result?: string; error?: unknown }\n  if (json.error) {\n    throw new Error(`RPC error: ${JSON.stringify(json.error)}`)\n  }\n  return BigInt(json.result ?? \"0x0\")\n}\n","import { x402Client } from \"@x402/core/client\"\nimport { registerExactEvmScheme } from \"@x402/evm/exact/client\"\nimport { toClientEvmSigner } from \"@x402/evm\"\nimport { wrapFetchWithPayment } from \"@x402/fetch\"\nimport { privateKeyToAccount } from \"viem/accounts\"\nimport { createPublicClient, http } from \"viem\"\nimport { base, baseSepolia } from \"viem/chains\"\nimport type { Network } from \"../wallet/types.js\"\n\n/**\n * Create a fetch function that automatically handles x402 payments.\n * When the server returns 402, the SDK signs an EIP-3009 authorization\n * using the provided private key and retries with payment headers.\n */\nexport function createPaymentFetch(\n  privateKey: `0x${string}`,\n  network: Network = \"base\",\n  rpcUrl?: string\n): typeof globalThis.fetch {\n  const account = privateKeyToAccount(privateKey)\n  const chain = network === \"base\" ? base : baseSepolia\n  const publicClient = createPublicClient({\n    chain,\n    transport: http(rpcUrl),\n  })\n  const signer = toClientEvmSigner(account, publicClient)\n\n  const client = new x402Client()\n  registerExactEvmScheme(client, { signer })\n  return wrapFetchWithPayment(fetch, client)\n}\n","import { wallet } from \"../wallet/index.js\"\nimport type { ComputeRequest, ComputeResponse, PricingTier, Size } from \"./types.js\"\n\nconst DEFAULT_ENDPOINT = \"https://x402.auteng.ai/api/x402/compute\"\n\nlet _endpoint = DEFAULT_ENDPOINT\n\nconst PRICING: Record<Size, PricingTier> = {\n  small: {\n    vcpu: 2,\n    ram_gb: 1,\n    default_timeout_s: 30,\n    max_timeout_s: 300,\n    base_price_usd: 0.002,\n    per_second_usd: 0.00005,\n  },\n  med: {\n    vcpu: 4,\n    ram_gb: 4,\n    default_timeout_s: 60,\n    max_timeout_s: 600,\n    base_price_usd: 0.008,\n    per_second_usd: 0.00012,\n  },\n  large: {\n    vcpu: 8,\n    ram_gb: 16,\n    default_timeout_s: 120,\n    max_timeout_s: 3600,\n    base_price_usd: 0.03,\n    per_second_usd: 0.00025,\n  },\n}\n\nexport const compute = {\n  /**\n   * Execute sandboxed code via AutEng's x402 compute endpoint.\n   * Payment is handled automatically via the wallet's x402 layer.\n   */\n  async run(request: ComputeRequest): Promise<ComputeResponse> {\n    if (!request.code) {\n      throw new Error(\"compute.run: 'code' is required\")\n    }\n    if (!request.stack) {\n      throw new Error(\"compute.run: 'stack' is required\")\n    }\n\n    const body = {\n      code: request.code,\n      stack: request.stack,\n      size: request.size ?? \"small\",\n      ...(request.timeout_seconds != null && {\n        timeout_seconds: request.timeout_seconds,\n      }),\n      ...(request.files != null && { files: request.files }),\n    }\n\n    const response = await wallet.fetch(_endpoint, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    })\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\")\n      throw new Error(`Compute request failed (${response.status}): ${text}`)\n    }\n\n    return (await response.json()) as ComputeResponse\n  },\n\n  /** Returns the pricing table for all compute sizes. */\n  pricing(): Record<Size, PricingTier> {\n    return { ...PRICING }\n  },\n\n  /**\n   * Override the compute endpoint URL.\n   * Default: https://x402.auteng.ai/api/x402/compute\n   */\n  setEndpoint(url: string): void {\n    _endpoint = url\n  },\n}\n"],"mappings":"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","names":["privateKeyToAccount"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@auteng/agent-utils",
+  "version": "0.1.0",
+  "description": "Utility belt for autonomous AI agents — wallet, compute, and more",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "viem": "^2.39.0",
+    "@x402/core": "^2.2.0",
+    "@x402/evm": "^2.2.0",
+    "@x402/fetch": "^2.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.5",
+    "rimraf": "^5.0.10",
+    "@types/node": "^20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}