@blockrun/llm 2.11.1 → 2.13.0

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   KNOWN_PROVIDERS: () => KNOWN_PROVIDERS,
   LLMClient: () => LLMClient,
   MusicClient: () => MusicClient,
+  NETWORK_ALIASES: () => NETWORK_ALIASES,
   OpenAI: () => OpenAI,
   PHONE_PRICES: () => PHONE_PRICES,
   PORTRAIT_ENROLLMENT_PRICE_USD: () => PORTRAIT_ENROLLMENT_PRICE_USD,
@@ -46,10 +47,14 @@ __export(index_exports, {
   PhoneClient: () => PhoneClient,
   PortraitClient: () => PortraitClient,
   PriceClient: () => PriceClient,
+  RPC_PRICE_USD: () => RPC_PRICE_USD,
+  RpcClient: () => RpcClient,
   SOLANA_NETWORK: () => SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH: () => SOLANA_WALLET_FILE,
+  SUPPORTED_NETWORKS: () => SUPPORTED_NETWORKS,
   SearchClient: () => SearchClient,
   SolanaLLMClient: () => SolanaLLMClient,
+  SpeechClient: () => SpeechClient,
   SurfClient: () => SurfClient,
   USDC_BASE: () => USDC_BASE,
   USDC_BASE_CONTRACT: () => USDC_BASE_CONTRACT,
@@ -2398,11 +2403,210 @@ var MusicClient = class {
   }
 };
 
-// src/video.ts
+// src/speech.ts
 var import_accounts5 = require("viem/accounts");
 var DEFAULT_API_URL4 = "https://blockrun.ai/api";
-var DEFAULT_MODEL3 = "xai/grok-imagine-video";
+var DEFAULT_MODEL3 = "elevenlabs/flash-v2.5";
+var DEFAULT_SOUNDFX_MODEL = "elevenlabs/sound-effects";
 var DEFAULT_TIMEOUT4 = 12e4;
+var SpeechClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = (0, import_accounts5.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL4;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT4;
+  }
+  /**
+   * Synthesize speech from text (OpenAI-compatible TTS).
+   *
+   * Price scales with character count: (chars / 1000) x model rate,
+   * minimum $0.001/request. Synthesis is synchronous.
+   *
+   * @param input - Text to synthesize. Per-model character caps apply
+   *                (flash/turbo 40k, multilingual-v2 10k, v3 5k).
+   * @param options - Optional model / voice / format / speed
+   * @returns SpeechResponse with audio URL, format, and character count
+   *
+   * @example
+   * const result = await client.generate('Welcome to BlockRun.', { voice: 'george' });
+   * console.log(result.data[0].url); // audio URL (mp3 by default)
+   */
+  async generate(input, options) {
+    const body = {
+      model: options?.model || DEFAULT_MODEL3,
+      input
+    };
+    if (options?.voice) body.voice = options.voice;
+    if (options?.responseFormat) body.response_format = options.responseFormat;
+    if (options?.speed !== void 0) body.speed = options.speed;
+    return this.requestWithPayment("/v1/audio/speech", body);
+  }
+  /** OpenAI-style alias for {@link generate}. */
+  speak(input, options) {
+    return this.generate(input, options);
+  }
+  /**
+   * Generate a cinematic sound effect from a text prompt.
+   *
+   * Flat $0.05/generation, up to 22 seconds of audio.
+   *
+   * @param text - Sound effect description (max 1000 chars).
+   *               E.g. 'rain on a tin roof', 'sci-fi door whoosh'
+   * @param options - Optional duration / prompt influence / format
+   * @returns SpeechResponse with audio URL and format
+   *
+   * @example
+   * const fx = await client.soundEffect('crackling campfire at night');
+   * console.log(fx.data[0].url);
+   */
+  async soundEffect(text, options) {
+    const body = {
+      model: options?.model || DEFAULT_SOUNDFX_MODEL,
+      text
+    };
+    if (options?.durationSeconds !== void 0) body.duration_seconds = options.durationSeconds;
+    if (options?.promptInfluence !== void 0) body.prompt_influence = options.promptInfluence;
+    if (options?.responseFormat) body.response_format = options.responseFormat;
+    return this.requestWithPayment("/v1/audio/sound-effects", body);
+  }
+  /**
+   * List available voices for TTS (free, rate-limited 60 req/min/IP).
+   *
+   * Pass a voice's `alias` (if present) or `voice_id` as the `voice`
+   * option to {@link generate}.
+   */
+  async listVoices() {
+    const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/audio/voices`, {
+      method: "GET"
+    });
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    const payload = await response.json();
+    return payload.data || [];
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, endpoint, body, response);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, endpoint, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          paymentHeader = btoa(JSON.stringify(respBody));
+        }
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}${endpoint}`,
+        resourceDescription: details.resource?.description || "BlockRun Voice",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    const data = await retryResponse.json();
+    this.sessionCalls++;
+    const paidUsd = Number(details.amount) / 1e6;
+    if (Number.isFinite(paidUsd)) this.sessionTotalUsd += paidUsd;
+    const txHash = retryResponse.headers.get("x-payment-receipt") || retryResponse.headers.get("X-Payment-Receipt");
+    if (txHash) data.txHash = txHash;
+    return data;
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
+// src/video.ts
+var import_accounts6 = require("viem/accounts");
+var DEFAULT_API_URL5 = "https://blockrun.ai/api";
+var DEFAULT_MODEL4 = "xai/grok-imagine-video";
+var DEFAULT_TIMEOUT5 = 12e4;
 var POLL_INTERVAL_MS2 = 5e3;
 var DEFAULT_GENERATE_BUDGET_MS = 3e5;
 var MAX_TIMEOUT_SECONDS = 600;
@@ -2423,11 +2627,11 @@ var VideoClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts5.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL4;
+    this.account = (0, import_accounts6.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL5;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT4;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT5;
   }
   /**
    * Generate a short video clip from a text prompt (or text + image).
@@ -2450,11 +2654,33 @@ var VideoClient = class {
         "realFaceAssetId must be a Token360 asset id matching 'ta_[A-Za-z0-9]+' (e.g. 'ta_abc123xyz')"
       );
     }
+    if (options?.lastFrameUrl && !options?.imageUrl) {
+      throw new Error(
+        "lastFrameUrl requires imageUrl: imageUrl seeds the FIRST frame and lastFrameUrl the FINAL frame \u2014 send both."
+      );
+    }
+    if (options?.lastFrameUrl && options?.realFaceAssetId) {
+      throw new Error(
+        "lastFrameUrl and realFaceAssetId are mutually exclusive; first-and-last-frame uses imageUrl + lastFrameUrl."
+      );
+    }
+    if (options?.referenceImageUrls?.length) {
+      if (options.imageUrl || options.lastFrameUrl || options.realFaceAssetId) {
+        throw new Error(
+          "referenceImageUrls is mutually exclusive with imageUrl, lastFrameUrl, and realFaceAssetId."
+        );
+      }
+      if (options.referenceImageUrls.length > 9) {
+        throw new Error("referenceImageUrls accepts at most 9 images.");
+      }
+    }
     const body = {
-      model: options?.model || DEFAULT_MODEL3,
+      model: options?.model || DEFAULT_MODEL4,
       prompt
     };
     if (options?.imageUrl) body.image_url = options.imageUrl;
+    if (options?.lastFrameUrl) body.last_frame_url = options.lastFrameUrl;
+    if (options?.referenceImageUrls?.length) body.reference_image_urls = options.referenceImageUrls;
     if (options?.realFaceAssetId) body.real_face_asset_id = options.realFaceAssetId;
     if (options?.durationSeconds !== void 0) body.duration_seconds = options.durationSeconds;
     if (options?.aspectRatio) body.aspect_ratio = options.aspectRatio;
@@ -2609,9 +2835,9 @@ var VideoClient = class {
 };
 
 // src/voice.ts
-var import_accounts6 = require("viem/accounts");
-var DEFAULT_API_URL5 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT5 = 6e4;
+var import_accounts7 = require("viem/accounts");
+var DEFAULT_API_URL6 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT6 = 6e4;
 var CALL_PRICE_USD = 0.54;
 var VALID_MODELS = /* @__PURE__ */ new Set(["base", "enhanced", "turbo"]);
 var VoiceClient = class {
@@ -2631,11 +2857,11 @@ var VoiceClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts6.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL5;
+    this.account = (0, import_accounts7.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT5;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
   }
   /**
    * Initiate an AI-powered outbound phone call.
@@ -2810,9 +3036,9 @@ var VoiceClient = class {
 };
 
 // src/phone.ts
-var import_accounts7 = require("viem/accounts");
-var DEFAULT_API_URL6 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT6 = 6e4;
+var import_accounts8 = require("viem/accounts");
+var DEFAULT_API_URL7 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT7 = 6e4;
 var PHONE_PRICES = Object.freeze({
   lookup: 0.01,
   "lookup/fraud": 0.05,
@@ -2850,11 +3076,11 @@ var PhoneClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts7.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
+    this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
   }
   /** EVM wallet address used for payments. */
   getWalletAddress() {
@@ -3029,9 +3255,9 @@ var PhoneClient = class {
 };
 
 // src/portrait.ts
-var import_accounts8 = require("viem/accounts");
-var DEFAULT_API_URL7 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT7 = 6e4;
+var import_accounts9 = require("viem/accounts");
+var DEFAULT_API_URL8 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT8 = 6e4;
 var PORTRAIT_ENROLLMENT_PRICE_USD = 0.01;
 var PortraitClient = class {
   account;
@@ -3050,11 +3276,11 @@ var PortraitClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    this.account = (0, import_accounts9.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
   }
   /** EVM wallet address used for payments. */
   getWalletAddress() {
@@ -3183,9 +3409,9 @@ var PortraitClient = class {
 };
 
 // src/search.ts
-var import_accounts9 = require("viem/accounts");
-var DEFAULT_API_URL8 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT8 = 6e4;
+var import_accounts10 = require("viem/accounts");
+var DEFAULT_API_URL9 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT9 = 6e4;
 var SearchClient = class {
   account;
   privateKey;
@@ -3201,11 +3427,11 @@ var SearchClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts9.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
+    this.account = (0, import_accounts10.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL9;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
   }
   async search(query, options) {
     if (!query || query.length > 1e3) {
@@ -3319,9 +3545,9 @@ var SearchClient = class {
 };
 
 // src/x-client.ts
-var import_accounts10 = require("viem/accounts");
-var DEFAULT_API_URL9 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT9 = 6e4;
+var import_accounts11 = require("viem/accounts");
+var DEFAULT_API_URL10 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT10 = 6e4;
 var XClient = class _XClient {
   account;
   privateKey;
@@ -3344,11 +3570,11 @@ var XClient = class _XClient {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts10.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL9;
+    this.account = (0, import_accounts11.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
   }
   // ───────── User endpoints ─────────
   userLookup(usernames) {
@@ -3526,9 +3752,9 @@ var XClient = class _XClient {
 };
 
 // src/price.ts
-var import_accounts11 = require("viem/accounts");
-var DEFAULT_API_URL10 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT10 = 3e4;
+var import_accounts12 = require("viem/accounts");
+var DEFAULT_API_URL11 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT11 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -3546,12 +3772,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = (0, import_accounts11.privateKeyToAccount)(privateKey);
+      this.account = (0, import_accounts12.privateKeyToAccount)(privateKey);
     }
-    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
+    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
   }
   async price(category, symbol, options) {
     if (!symbol) throw new Error("symbol is required");
@@ -3730,9 +3956,9 @@ function buildUrl(base, query) {
 }
 
 // src/surf.ts
-var import_accounts12 = require("viem/accounts");
-var DEFAULT_API_URL11 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT11 = 6e4;
+var import_accounts13 = require("viem/accounts");
+var DEFAULT_API_URL12 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT12 = 6e4;
 var SURF_PREFIX = "/v1/surf";
 var SurfClient = class {
   account;
@@ -3749,11 +3975,11 @@ var SurfClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts12.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
+    this.account = (0, import_accounts13.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL12;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT12;
   }
   /**
    * GET a Surf endpoint. `path` is everything after `/v1/surf` (a leading
@@ -3884,10 +4110,263 @@ var SurfClient = class {
   }
 };
 
+// src/rpc.ts
+var import_accounts14 = require("viem/accounts");
+var DEFAULT_API_URL13 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT13 = 6e4;
+var RPC_PRICE_USD = 2e-3;
+var SUPPORTED_NETWORKS = [
+  // EVM
+  "ethereum",
+  "base",
+  "arbitrum",
+  "arbitrum-nova",
+  "optimism",
+  "polygon",
+  "bsc",
+  "avalanche",
+  "fantom",
+  "cronos",
+  "celo",
+  "gnosis",
+  "zksync",
+  "berachain",
+  "unichain",
+  "monad",
+  "chiliz",
+  "moonbeam",
+  "aurora",
+  "flare",
+  "oasis",
+  "kaia",
+  "sonic",
+  "xdc",
+  "abstract",
+  "hyperevm",
+  "plume",
+  "ronin",
+  "rootstock",
+  // Non-EVM (JSON-RPC-compatible)
+  "solana",
+  "bitcoin",
+  "litecoin",
+  "dogecoin",
+  "bitcoin-cash",
+  "near",
+  "sui",
+  "ripple",
+  "polkadot",
+  "kusama",
+  "zcash"
+];
+var NETWORK_ALIASES = {
+  eth: "ethereum",
+  arb: "arbitrum",
+  "arbitrum-one": "arbitrum",
+  "arb-one": "arbitrum",
+  "arb-nova": "arbitrum-nova",
+  op: "optimism",
+  matic: "polygon",
+  pol: "polygon",
+  bnb: "bsc",
+  binance: "bsc",
+  "binance-smart-chain": "bsc",
+  avax: "avalanche",
+  ftm: "fantom",
+  bera: "berachain",
+  klaytn: "kaia",
+  chz: "chiliz",
+  hyperliquid: "hyperevm",
+  rsk: "rootstock",
+  sol: "solana",
+  btc: "bitcoin",
+  ltc: "litecoin",
+  doge: "dogecoin",
+  bch: "bitcoin-cash",
+  xrp: "ripple",
+  xrpl: "ripple",
+  dot: "polkadot",
+  zec: "zcash"
+};
+var RpcClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = (0, import_accounts14.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL13;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT13;
+  }
+  /**
+   * Make a single JSON-RPC 2.0 call. Flat $0.002.
+   *
+   * @param network - Chain name (e.g. "ethereum", "base", "solana") or a
+   *                  common alias ("eth", "sol", "matic", ...). See
+   *                  SUPPORTED_NETWORKS / NETWORK_ALIASES.
+   * @param method - Chain RPC method, e.g. "eth_blockNumber", "eth_call",
+   *                 "eth_getBalance" (EVM) or "getSlot", "getAccountInfo"
+   *                 (Solana).
+   * @param params - Method-specific params array (optional).
+   * @returns RpcResponse with `result` (or JSON-RPC `error`), plus
+   *          `network`, `cacheHit` and `txHash` metadata.
+   *
+   * @example
+   * const block = await client.call('ethereum', 'eth_blockNumber');
+   * console.log(parseInt(block.result as string, 16));
+   */
+  async call(network, method, params) {
+    const body = { jsonrpc: "2.0", id: 1, method };
+    if (params !== void 0) body.params = params;
+    const { data, headers } = await this.requestWithPayment(network, body);
+    return this.toResponse(data, headers);
+  }
+  /**
+   * Make a JSON-RPC 2.0 batch call. Priced per element ($0.002 x N).
+   *
+   * @param network - Chain name or alias (see {@link call}).
+   * @param requests - Requests, each with a `method` and optional
+   *                   `params` / `id`. `jsonrpc` and missing ids are
+   *                   filled in automatically.
+   * @returns Array of RpcResponse, in upstream order.
+   *
+   * @example
+   * const out = await client.batch('base', [
+   *   { method: 'eth_blockNumber' },
+   *   { method: 'eth_gasPrice' },
+   * ]);
+   */
+  async batch(network, requests) {
+    if (!requests.length) {
+      throw new Error("batch requires at least one request");
+    }
+    const body = requests.map((req, i) => {
+      if (!req.method) throw new Error(`batch request ${i} is missing 'method'`);
+      return { jsonrpc: "2.0", id: i + 1, ...req };
+    });
+    const { data, headers } = await this.requestWithPayment(network, body);
+    const items = Array.isArray(data) ? data : [data];
+    return items.map((item) => this.toResponse(item, headers));
+  }
+  toResponse(data, headers) {
+    const base = data !== null && typeof data === "object" && !Array.isArray(data) ? { ...data } : { result: data };
+    const network = headers.get("x-network");
+    if (network) base.network = network;
+    base.cacheHit = (headers.get("x-cache") || "").toUpperCase() === "HIT";
+    const txHash = headers.get("x-payment-receipt") || headers.get("X-Payment-Receipt");
+    if (txHash) base.txHash = txHash;
+    return base;
+  }
+  async requestWithPayment(network, body) {
+    const endpoint = `/v1/rpc/${network}`;
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, endpoint, body, response);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return { data: await response.json(), headers: response.headers };
+  }
+  async handlePaymentAndRetry(url, endpoint, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          paymentHeader = btoa(JSON.stringify(respBody));
+        }
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}${endpoint}`,
+        resourceDescription: details.resource?.description || "BlockRun Multi-chain RPC",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    this.sessionCalls++;
+    const paidUsd = Number(details.amount) / 1e6;
+    if (Number.isFinite(paidUsd)) this.sessionTotalUsd += paidUsd;
+    return { data: await retryResponse.json(), headers: retryResponse.headers };
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
 // src/blockrun.ts
-var import_accounts13 = require("viem/accounts");
-var DEFAULT_API_URL12 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT12 = 6e4;
+var import_accounts15 = require("viem/accounts");
+var DEFAULT_API_URL14 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT14 = 6e4;
 var DEFAULT_POLL_INTERVAL_MS = 5e3;
 var DEFAULT_POLL_BUDGET_MS = 3e5;
 var MAX_SIGNED_AUTH_SECONDS = 600;
@@ -3908,11 +4387,11 @@ var BlockrunClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts13.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL12;
+    this.account = (0, import_accounts15.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL14;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT12;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT14;
   }
   /**
    * GET a BlockRun endpoint. `path` is everything after `/api` (a leading
@@ -4263,7 +4742,7 @@ function sleep(ms) {
 }
 
 // src/wallet.ts
-var import_accounts14 = require("viem/accounts");
+var import_accounts16 = require("viem/accounts");
 var fs2 = __toESM(require("fs"), 1);
 var path2 = __toESM(require("path"), 1);
 var os2 = __toESM(require("os"), 1);
@@ -4272,8 +4751,8 @@ var BASE_CHAIN_ID2 = "8453";
 var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
 var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
-  const privateKey = (0, import_accounts14.generatePrivateKey)();
-  const account = (0, import_accounts14.privateKeyToAccount)(privateKey);
+  const privateKey = (0, import_accounts16.generatePrivateKey)();
+  const account = (0, import_accounts16.privateKeyToAccount)(privateKey);
   return {
     address: account.address,
     privateKey
@@ -4329,12 +4808,12 @@ function loadWallet() {
 function getOrCreateWallet() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    const account = (0, import_accounts14.privateKeyToAccount)(envKey);
+    const account = (0, import_accounts16.privateKeyToAccount)(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = (0, import_accounts14.privateKeyToAccount)(fileKey);
+    const account = (0, import_accounts16.privateKeyToAccount)(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -4344,11 +4823,11 @@ function getOrCreateWallet() {
 function getWalletAddress() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    return (0, import_accounts14.privateKeyToAccount)(envKey).address;
+    return (0, import_accounts16.privateKeyToAccount)(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return (0, import_accounts14.privateKeyToAccount)(fileKey).address;
+    return (0, import_accounts16.privateKeyToAccount)(fileKey).address;
   }
   return null;
 }
@@ -4528,7 +5007,7 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT13 = 6e4;
+var DEFAULT_TIMEOUT15 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
 var DEFAULT_SOLANA_RPC_URL = "https://sol.blockrun.ai/api/v1/solana/rpc";
@@ -4578,7 +5057,7 @@ var SolanaLLMClient = class {
     const rpc = resolveRpcConfig(options.rpcUrl, options.rpcHeaders);
     this.rpcUrl = rpc.url;
     this.rpcHeaders = rpc.headers;
-    this.timeout = options.timeout || DEFAULT_TIMEOUT13;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT15;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -5492,7 +5971,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-var import_accounts15 = require("viem/accounts");
+var import_accounts17 = require("viem/accounts");
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -5505,7 +5984,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = (0, import_accounts15.privateKeyToAccount)(this._privateKey);
+    this._account = (0, import_accounts17.privateKeyToAccount)(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -5610,6 +6089,7 @@ var AnthropicClient = class {
   KNOWN_PROVIDERS,
   LLMClient,
   MusicClient,
+  NETWORK_ALIASES,
   OpenAI,
   PHONE_PRICES,
   PORTRAIT_ENROLLMENT_PRICE_USD,
@@ -5617,10 +6097,14 @@ var AnthropicClient = class {
   PhoneClient,
   PortraitClient,
   PriceClient,
+  RPC_PRICE_USD,
+  RpcClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH,
+  SUPPORTED_NETWORKS,
   SearchClient,
   SolanaLLMClient,
+  SpeechClient,
   SurfClient,
   USDC_BASE,
   USDC_BASE_CONTRACT,