@blockrun/llm 2.12.0 → 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,8 +47,11 @@ __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,
@@ -2650,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_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;
@@ -4084,10 +4110,263 @@ var SurfClient = class {
   }
 };
 
-// src/blockrun.ts
+// 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_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;
@@ -4108,11 +4387,11 @@ var BlockrunClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts14.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL13;
+    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_TIMEOUT13;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT14;
   }
   /**
    * GET a BlockRun endpoint. `path` is everything after `/api` (a leading
@@ -4463,7 +4742,7 @@ function sleep(ms) {
 }
 
 // src/wallet.ts
-var import_accounts15 = 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);
@@ -4472,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_accounts15.generatePrivateKey)();
-  const account = (0, import_accounts15.privateKeyToAccount)(privateKey);
+  const privateKey = (0, import_accounts16.generatePrivateKey)();
+  const account = (0, import_accounts16.privateKeyToAccount)(privateKey);
   return {
     address: account.address,
     privateKey
@@ -4529,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_accounts15.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_accounts15.privateKeyToAccount)(fileKey);
+    const account = (0, import_accounts16.privateKeyToAccount)(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -4544,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_accounts15.privateKeyToAccount)(envKey).address;
+    return (0, import_accounts16.privateKeyToAccount)(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return (0, import_accounts15.privateKeyToAccount)(fileKey).address;
+    return (0, import_accounts16.privateKeyToAccount)(fileKey).address;
   }
   return null;
 }
@@ -4728,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_TIMEOUT14 = 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";
@@ -4778,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_TIMEOUT14;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT15;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -5692,7 +5971,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-var import_accounts16 = require("viem/accounts");
+var import_accounts17 = require("viem/accounts");
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -5705,7 +5984,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = (0, import_accounts16.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(/\/$/, "");
@@ -5810,6 +6089,7 @@ var AnthropicClient = class {
   KNOWN_PROVIDERS,
   LLMClient,
   MusicClient,
+  NETWORK_ALIASES,
   OpenAI,
   PHONE_PRICES,
   PORTRAIT_ENROLLMENT_PRICE_USD,
@@ -5817,8 +6097,11 @@ var AnthropicClient = class {
   PhoneClient,
   PortraitClient,
   PriceClient,
+  RPC_PRICE_USD,
+  RpcClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH,
+  SUPPORTED_NETWORKS,
   SearchClient,
   SolanaLLMClient,
   SpeechClient,

package/dist/index.d.cts

@@ -460,6 +460,45 @@ interface VoiceInfo {
     preview_url?: string;
     [key: string]: unknown;
 }
+interface RpcClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 60000 — upstream gateway timeout is 20s) */
+    timeout?: number;
+}
+/** A JSON-RPC 2.0 error object. */
+interface RpcError {
+    code?: number;
+    message?: string;
+    data?: unknown;
+}
+/**
+ * Response from a multi-chain JSON-RPC call.
+ *
+ * Standard JSON-RPC 2.0 envelope plus BlockRun gateway metadata pulled
+ * from response headers (X-Network / X-Cache / X-Payment-Receipt).
+ */
+interface RpcResponse<T = unknown> {
+    jsonrpc?: string;
+    id?: string | number | null;
+    result?: T;
+    error?: RpcError;
+    /** Canonical network key, e.g. "ethereum" (from X-Network) */
+    network?: string;
+    /** Served from the gateway's method-aware cache (from X-Cache) */
+    cacheHit?: boolean;
+    /** x402 settlement tx hash (single calls) */
+    txHash?: string;
+}
+/** A single request in a JSON-RPC batch (jsonrpc/id auto-filled if omitted). */
+interface RpcBatchRequest {
+    method: string;
+    params?: unknown[];
+    id?: string | number;
+    jsonrpc?: string;
+}
 /** Built-in Bland.ai voice presets. Any string is accepted (custom voice IDs work too). */
 type VoicePreset = "nat" | "josh" | "maya" | "june" | "paige" | "derek" | "florian";
 /** Bland.ai conversation model tier. */
@@ -578,6 +617,22 @@ interface VideoGenerateOptions {
      * with `imageUrl`. Real-person likeness is not supported on BlockRun.
      */
     realFaceAssetId?: string;
+    /**
+     * First-and-last-frame interpolation: a second image that seeds the FINAL
+     * frame so the model tweens from `imageUrl` → `lastFrameUrl`. Requires
+     * `imageUrl` (the first frame) and a Seedance model
+     * (bytedance/seedance-1.5-pro, seedance-2.0, or seedance-2.0-fast).
+     * Priced identically to image-to-video. Mutually exclusive with
+     * `realFaceAssetId`.
+     */
+    lastFrameUrl?: string;
+    /**
+     * Omni / multi-reference: up to 9 reference image URLs for character/style
+     * consistency (**Seedance 2.0 only**). Cite them as "image 1", "image 2"
+     * in the prompt. Mutually exclusive with `imageUrl` / `lastFrameUrl` /
+     * `realFaceAssetId`.
+     */
+    referenceImageUrls?: string[];
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
     /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
@@ -2296,6 +2351,125 @@ declare class SurfClient {
     getWalletAddress(): string;
 }
 
+/**
+ * BlockRun RPC Client - Multi-chain JSON-RPC (Tatum gateway) via x402 micropayments.
+ *
+ * One endpoint, 40+ chains: Ethereum, Base, Solana, Polygon, BSC, Arbitrum,
+ * Optimism, Avalanche, Bitcoin, Sui, and more. Standard JSON-RPC 2.0
+ * passthrough — no API key, pay-per-call in USDC.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Usage:
+ *   import { RpcClient } from '@blockrun/llm';
+ *
+ *   const client = new RpcClient({ privateKey: '0x...' });
+ *
+ *   // EVM chains speak eth_* JSON-RPC
+ *   const block = await client.call('ethereum', 'eth_blockNumber');
+ *   console.log(block.result); // e.g. "0x1499f7c"
+ *
+ *   const balance = await client.call('base', 'eth_getBalance', [
+ *     '0x4200000000000000000000000000000000000006',
+ *     'latest',
+ *   ]);
+ *
+ *   // Non-EVM chains speak their native JSON-RPC
+ *   const slot = await client.call('solana', 'getSlot');
+ *
+ *   // Batch: one payment, per-element pricing ($0.002 x N)
+ *   const out = await client.batch('polygon', [
+ *     { method: 'eth_blockNumber' },
+ *     { method: 'eth_gasPrice' },
+ *   ]);
+ *
+ * Pricing:
+ *   Flat $0.002 per JSON-RPC call; a batch charges per element.
+ *
+ * Networks:
+ *   40 curated chains (see SUPPORTED_NETWORKS) plus common aliases
+ *   (eth, arb, op, matic, bnb, avax, sol, btc, xrp, dot, ...). Unknown but
+ *   well-formed slugs fall through to a generic `{slug}-mainnet` gateway
+ *   attempt, so new Tatum chains work without an SDK update.
+ */
+
+/**
+ * Flat price per JSON-RPC call (batch = N x this). Informational only —
+ * the actual quote always comes from the 402 challenge.
+ */
+declare const RPC_PRICE_USD = 0.002;
+/**
+ * Curated chains accepted by /v1/rpc/{network}. Mirrors the backend chain
+ * registry (verified live 2026-06-07). EVM chains use eth_* JSON-RPC;
+ * non-EVM (Solana / UTXO / NEAR / Sui / XRP Ledger / Polkadot) speak their
+ * own JSON-RPC dialect.
+ */
+declare const SUPPORTED_NETWORKS: readonly ["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", "solana", "bitcoin", "litecoin", "dogecoin", "bitcoin-cash", "near", "sui", "ripple", "polkadot", "kusama", "zcash"];
+type RpcNetwork = (typeof SUPPORTED_NETWORKS)[number] | (string & {});
+/** Common short names the gateway also accepts (resolved server-side). */
+declare const NETWORK_ALIASES: Record<string, string>;
+/**
+ * BlockRun Multi-chain RPC Client.
+ *
+ * Standard JSON-RPC 2.0 access to 40+ chains through BlockRun's Tatum
+ * gateway with automatic x402 micropayments on Base chain.
+ *
+ * Flat $0.002 per call; a JSON-RPC batch charges per element.
+ */
+declare class RpcClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: RpcClientOptions);
+    /**
+     * 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));
+     */
+    call<T = unknown>(network: RpcNetwork, method: string, params?: unknown[]): Promise<RpcResponse<T>>;
+    /**
+     * 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' },
+     * ]);
+     */
+    batch(network: RpcNetwork, requests: RpcBatchRequest[]): Promise<RpcResponse[]>;
+    private toResponse;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * BlockrunClient — the x402-paying HTTP primitive for the BlockRun gateway.
  *
@@ -3083,4 +3257,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, type ResponseFormat, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, XClient, type XClientOptions, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsOptions, type XMentionsResponse, type XSearchOptions, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesOptions, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XUserTweetsOptions, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, type RoutingDecision, type RoutingProfile, type RoutingTier, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, XClient, type XClientOptions, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsOptions, type XMentionsResponse, type XSearchOptions, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesOptions, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XUserTweetsOptions, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };