@blockrun/llm 2.12.0 → 3.0.0

package/dist/index.js

@@ -1512,205 +1512,6 @@ var LLMClient = class _LLMClient {
     }
     throw lastError || new Error("All RPCs failed");
   }
-  // ============================================================
-  // X/Twitter endpoints (powered by AttentionVC)
-  // ============================================================
-  /**
-   * Look up X/Twitter user profiles by username.
-   *
-   * Powered by AttentionVC. $0.002 per user (min $0.02, max $0.20).
-   *
-   * @param usernames - Single username or array of usernames (without @)
-   */
-  async xUserLookup(usernames) {
-    const names = Array.isArray(usernames) ? usernames : [usernames];
-    const data = await this.requestWithPaymentRaw("/v1/x/users/lookup", { usernames: names });
-    return data;
-  }
-  /**
-   * Get followers of an X/Twitter user.
-   *
-   * Powered by AttentionVC. $0.05 per page (~200 accounts).
-   *
-   * @param username - X/Twitter username (without @)
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xFollowers(username, cursor) {
-    const body = { username };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/followers", body);
-    return data;
-  }
-  /**
-   * Get accounts an X/Twitter user is following.
-   *
-   * Powered by AttentionVC. $0.05 per page (~200 accounts).
-   *
-   * @param username - X/Twitter username (without @)
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xFollowings(username, cursor) {
-    const body = { username };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/followings", body);
-    return data;
-  }
-  /**
-   * Get detailed profile info for a single X/Twitter user.
-   *
-   * Powered by AttentionVC. $0.002 per request.
-   *
-   * @param username - X/Twitter username (without @)
-   */
-  async xUserInfo(username) {
-    const data = await this.requestWithPaymentRaw("/v1/x/users/info", { username });
-    return data;
-  }
-  /**
-   * Get verified (blue-check) followers of an X/Twitter user.
-   *
-   * Powered by AttentionVC. $0.048 per page.
-   *
-   * @param userId - X/Twitter user ID (not username)
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xVerifiedFollowers(userId, cursor) {
-    const body = { userId };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/verified-followers", body);
-    return data;
-  }
-  /**
-   * Get tweets posted by an X/Twitter user.
-   *
-   * Powered by AttentionVC. $0.032 per page.
-   *
-   * @param username - X/Twitter username (without @)
-   * @param includeReplies - Include reply tweets (default: false)
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xUserTweets(username, includeReplies = false, cursor) {
-    const body = { username, includeReplies };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/tweets", body);
-    return data;
-  }
-  /**
-   * Get tweets that mention an X/Twitter user.
-   *
-   * Powered by AttentionVC. $0.032 per page.
-   *
-   * @param username - X/Twitter username (without @)
-   * @param sinceTime - Start time filter (ISO8601 or Unix timestamp)
-   * @param untilTime - End time filter (ISO8601 or Unix timestamp)
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xUserMentions(username, sinceTime, untilTime, cursor) {
-    const body = { username };
-    if (sinceTime !== void 0) body.sinceTime = sinceTime;
-    if (untilTime !== void 0) body.untilTime = untilTime;
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/mentions", body);
-    return data;
-  }
-  /**
-   * Fetch full tweet data for up to 200 tweet IDs.
-   *
-   * Powered by AttentionVC. $0.16 per batch.
-   *
-   * @param tweetIds - Single tweet ID or array of tweet IDs (max 200)
-   */
-  async xTweetLookup(tweetIds) {
-    const ids = Array.isArray(tweetIds) ? tweetIds : [tweetIds];
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/lookup", { tweet_ids: ids });
-    return data;
-  }
-  /**
-   * Get replies to a specific tweet.
-   *
-   * Powered by AttentionVC. $0.032 per page.
-   *
-   * @param tweetId - The tweet ID to get replies for
-   * @param queryType - Sort order: 'Latest' or 'Default'
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xTweetReplies(tweetId, queryType = "Latest", cursor) {
-    const body = { tweetId, queryType };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/replies", body);
-    return data;
-  }
-  /**
-   * Get the full thread context for a tweet.
-   *
-   * Powered by AttentionVC. $0.032 per page.
-   *
-   * @param tweetId - The tweet ID to get thread for
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xTweetThread(tweetId, cursor) {
-    const body = { tweetId };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/thread", body);
-    return data;
-  }
-  /**
-   * Search X/Twitter with advanced query operators.
-   *
-   * Powered by AttentionVC. $0.032 per page.
-   *
-   * @param query - Search query (supports Twitter search operators)
-   * @param queryType - Sort order: 'Latest', 'Top', or 'Default'
-   * @param cursor - Pagination cursor from previous response
-   */
-  async xSearch(query, queryType = "Latest", cursor) {
-    const body = { query, queryType };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/search", body);
-    return data;
-  }
-  /**
-   * Get current trending topics on X/Twitter.
-   *
-   * Powered by AttentionVC. $0.002 per request.
-   */
-  async xTrending() {
-    const data = await this.requestWithPaymentRaw("/v1/x/trending", {});
-    return data;
-  }
-  /**
-   * Get rising/viral articles from X/Twitter.
-   *
-   * Powered by AttentionVC intelligence layer. $0.05 per request.
-   */
-  async xArticlesRising() {
-    const data = await this.requestWithPaymentRaw("/v1/x/articles/rising", {});
-    return data;
-  }
-  /**
-   * Get author analytics and intelligence metrics for an X/Twitter user.
-   *
-   * Powered by AttentionVC intelligence layer. $0.02 per request.
-   *
-   * @param handle - X/Twitter handle (without @)
-   */
-  async xAuthorAnalytics(handle) {
-    const data = await this.requestWithPaymentRaw("/v1/x/authors", { handle });
-    return data;
-  }
-  /**
-   * Compare two X/Twitter authors side-by-side with intelligence metrics.
-   *
-   * Powered by AttentionVC intelligence layer. $0.05 per request.
-   *
-   * @param handle1 - First X/Twitter handle (without @)
-   * @param handle2 - Second X/Twitter handle (without @)
-   */
-  async xCompareAuthors(handle1, handle2) {
-    const data = await this.requestWithPaymentRaw("/v1/x/compare", { handle1, handle2 });
-    return data;
-  }
-  // ── Prediction Markets (Powered by Predexon) ────────────────────────────
   /**
    * Query Predexon prediction market data (GET endpoints).
    *
@@ -2546,11 +2347,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;
@@ -3414,217 +3237,10 @@ var SearchClient = class {
   }
 };
 
-// src/x-client.ts
+// src/price.ts
 import { privateKeyToAccount as privateKeyToAccount10 } from "viem/accounts";
 var DEFAULT_API_URL10 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT10 = 6e4;
-var XClient = class _XClient {
-  account;
-  privateKey;
-  apiUrl;
-  timeout;
-  static deprecationWarned = false;
-  constructor(options = {}) {
-    if (!_XClient.deprecationWarned) {
-      console.warn(
-        "[@blockrun/llm] XClient: BlockRun's /v1/x/* (AttentionVC) integration was removed 2026-04-30. All calls will return HTTP 404 until a replacement X data upstream is reintroduced."
-      );
-      _XClient.deprecationWarned = true;
-    }
-    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 = privateKeyToAccount10(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
-    validateApiUrl(apiUrl);
-    this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
-  }
-  // ───────── User endpoints ─────────
-  userLookup(usernames) {
-    return this.post("/v1/x/users/lookup", { usernames });
-  }
-  userInfo(username) {
-    return this.post("/v1/x/users/info", { username });
-  }
-  followers(username, cursor) {
-    const body = { username };
-    if (cursor) body.cursor = cursor;
-    return this.post("/v1/x/users/followers", body);
-  }
-  /** `/v1/x/users/following` (singular path variant). */
-  following(username, cursor) {
-    const body = { username };
-    if (cursor) body.cursor = cursor;
-    return this.post("/v1/x/users/following", body);
-  }
-  /** `/v1/x/users/followings` (plural path variant). */
-  followings(username, cursor) {
-    const body = { username };
-    if (cursor) body.cursor = cursor;
-    return this.post("/v1/x/users/followings", body);
-  }
-  verifiedFollowers(userId, cursor) {
-    const body = { userId };
-    if (cursor) body.cursor = cursor;
-    return this.post(
-      "/v1/x/users/verified-followers",
-      body
-    );
-  }
-  userTweets(options) {
-    if (!options.username && !options.userId) {
-      throw new Error("Either username or userId is required");
-    }
-    const body = {};
-    if (options.username) body.username = options.username;
-    if (options.userId) body.userId = options.userId;
-    if (options.cursor) body.cursor = options.cursor;
-    if (options.includeReplies !== void 0) body.includeReplies = options.includeReplies;
-    return this.post("/v1/x/users/tweets", body);
-  }
-  mentions(username, options) {
-    const body = { username };
-    if (options?.sinceTime) body.sinceTime = options.sinceTime;
-    if (options?.untilTime) body.untilTime = options.untilTime;
-    if (options?.cursor) body.cursor = options.cursor;
-    return this.post("/v1/x/users/mentions", body);
-  }
-  // ───────── Tweet endpoints ─────────
-  tweetLookup(tweetIds) {
-    return this.post("/v1/x/tweets/lookup", {
-      tweet_ids: tweetIds
-    });
-  }
-  tweetReplies(tweetId, options) {
-    const body = { tweetId };
-    if (options?.cursor) body.cursor = options.cursor;
-    if (options?.queryType) body.queryType = options.queryType;
-    return this.post("/v1/x/tweets/replies", body);
-  }
-  tweetThread(tweetId, cursor) {
-    const body = { tweetId };
-    if (cursor) body.cursor = cursor;
-    return this.post("/v1/x/tweets/thread", body);
-  }
-  // ───────── Search & discovery ─────────
-  search(query, options) {
-    const body = { query };
-    if (options?.queryType) body.queryType = options.queryType;
-    if (options?.cursor) body.cursor = options.cursor;
-    return this.post("/v1/x/search", body);
-  }
-  trending() {
-    return this.post("/v1/x/trending", {});
-  }
-  articlesRising() {
-    return this.post("/v1/x/articles/rising", {});
-  }
-  // ───────── Internals ─────────
-  async post(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.payAndRetry(url, 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 payAndRetry(url, 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 || url,
-        resourceDescription: details.resource?.description || "BlockRun X API",
-        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
-        extra: details.extra
-      }
-    );
-    const retry = await this.fetchWithTimeout(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "PAYMENT-SIGNATURE": paymentPayload
-      },
-      body: JSON.stringify(body)
-    });
-    if (retry.status === 402) {
-      throw new PaymentError("Payment was rejected. Check your wallet balance.");
-    }
-    if (!retry.ok) {
-      let errorBody;
-      try {
-        errorBody = await retry.json();
-      } catch {
-        errorBody = { error: "Request failed" };
-      }
-      throw new APIError(
-        `API error after payment: ${retry.status}`,
-        retry.status,
-        sanitizeErrorResponse(errorBody)
-      );
-    }
-    return retry.json();
-  }
-  async fetchWithTimeout(url, init) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      return await fetch(url, { ...init, signal: controller.signal });
-    } finally {
-      clearTimeout(timeoutId);
-    }
-  }
-  getWalletAddress() {
-    return this.account.address;
-  }
-};
-
-// src/price.ts
-import { privateKeyToAccount as privateKeyToAccount11 } from "viem/accounts";
-var DEFAULT_API_URL11 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT11 = 3e4;
+var DEFAULT_TIMEOUT10 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -3642,12 +3258,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = privateKeyToAccount11(privateKey);
+      this.account = privateKeyToAccount10(privateKey);
     }
-    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
+    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
   }
   async price(category, symbol, options) {
     if (!symbol) throw new Error("symbol is required");
@@ -3826,9 +3442,9 @@ function buildUrl(base, query) {
 }
 
 // src/surf.ts
-import { privateKeyToAccount as privateKeyToAccount12 } from "viem/accounts";
-var DEFAULT_API_URL12 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT12 = 6e4;
+import { privateKeyToAccount as privateKeyToAccount11 } from "viem/accounts";
+var DEFAULT_API_URL11 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT11 = 6e4;
 var SURF_PREFIX = "/v1/surf";
 var SurfClient = class {
   account;
@@ -3845,11 +3461,11 @@ var SurfClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = privateKeyToAccount12(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL12;
+    this.account = privateKeyToAccount11(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT12;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
   }
   /**
    * GET a Surf endpoint. `path` is everything after `/v1/surf` (a leading
@@ -3980,6 +3596,259 @@ var SurfClient = class {
   }
 };
 
+// src/rpc.ts
+import { privateKeyToAccount as privateKeyToAccount12 } from "viem/accounts";
+var DEFAULT_API_URL12 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT12 = 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 = privateKeyToAccount12(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL12;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT12;
+  }
+  /**
+   * 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
 import { privateKeyToAccount as privateKeyToAccount13 } from "viem/accounts";
 var DEFAULT_API_URL13 = "https://blockrun.ai/api";
@@ -4774,89 +4643,6 @@ var SolanaLLMClient = class {
     const data = await this.requestWithPaymentRaw("/v1/search", body);
     return data;
   }
-  // ============================================================
-  // X/Twitter endpoints (powered by AttentionVC)
-  // ============================================================
-  async xUserLookup(usernames) {
-    const names = Array.isArray(usernames) ? usernames : [usernames];
-    const data = await this.requestWithPaymentRaw("/v1/x/users/lookup", { usernames: names });
-    return data;
-  }
-  async xFollowers(username, cursor) {
-    const body = { username };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/followers", body);
-    return data;
-  }
-  async xFollowings(username, cursor) {
-    const body = { username };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/followings", body);
-    return data;
-  }
-  async xUserInfo(username) {
-    const data = await this.requestWithPaymentRaw("/v1/x/users/info", { username });
-    return data;
-  }
-  async xVerifiedFollowers(userId, cursor) {
-    const body = { userId };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/verified-followers", body);
-    return data;
-  }
-  async xUserTweets(username, includeReplies = false, cursor) {
-    const body = { username, includeReplies };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/tweets", body);
-    return data;
-  }
-  async xUserMentions(username, sinceTime, untilTime, cursor) {
-    const body = { username };
-    if (sinceTime !== void 0) body.sinceTime = sinceTime;
-    if (untilTime !== void 0) body.untilTime = untilTime;
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/users/mentions", body);
-    return data;
-  }
-  async xTweetLookup(tweetIds) {
-    const ids = Array.isArray(tweetIds) ? tweetIds : [tweetIds];
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/lookup", { tweet_ids: ids });
-    return data;
-  }
-  async xTweetReplies(tweetId, queryType = "Latest", cursor) {
-    const body = { tweetId, queryType };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/replies", body);
-    return data;
-  }
-  async xTweetThread(tweetId, cursor) {
-    const body = { tweetId };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/tweets/thread", body);
-    return data;
-  }
-  async xSearch(query, queryType = "Latest", cursor) {
-    const body = { query, queryType };
-    if (cursor !== void 0) body.cursor = cursor;
-    const data = await this.requestWithPaymentRaw("/v1/x/search", body);
-    return data;
-  }
-  async xTrending() {
-    const data = await this.requestWithPaymentRaw("/v1/x/trending", {});
-    return data;
-  }
-  async xArticlesRising() {
-    const data = await this.requestWithPaymentRaw("/v1/x/articles/rising", {});
-    return data;
-  }
-  async xAuthorAnalytics(handle) {
-    const data = await this.requestWithPaymentRaw("/v1/x/authors", { handle });
-    return data;
-  }
-  async xCompareAuthors(handle1, handle2) {
-    const data = await this.requestWithPaymentRaw("/v1/x/compare", { handle1, handle2 });
-    return data;
-  }
   // ── Prediction Markets (Powered by Predexon) ────────────────────────────
   async pm(path5, params) {
     return this.getWithPaymentRaw(`/v1/pm/${path5}`, params);
@@ -5220,7 +5006,6 @@ var CACHE_DIR = path4.join(os4.homedir(), ".blockrun", "cache");
 var DATA_DIR = path4.join(os4.homedir(), ".blockrun", "data");
 var COST_LOG_FILE2 = path4.join(os4.homedir(), ".blockrun", "cost_log.jsonl");
 var DEFAULT_TTL = {
-  "/v1/x/": 3600 * 1e3,
   "/v1/partner/": 3600 * 1e3,
   "/v1/pm/": 1800 * 1e3,
   "/v1/chat/": 0,
@@ -5289,8 +5074,6 @@ function readableFilename(endpoint, body) {
   let ep = endpoint.replace(/\/+$/, "").split("/").pop() || "";
   if (endpoint.includes("/v1/chat/")) {
     ep = "chat";
-  } else if (endpoint.includes("/v1/x/")) {
-    ep = "x_" + ep;
   } else if (endpoint.includes("/v1/search")) {
     ep = "search";
   } else if (endpoint.includes("/v1/image")) {
@@ -5705,6 +5488,7 @@ export {
   KNOWN_PROVIDERS,
   LLMClient,
   MusicClient,
+  NETWORK_ALIASES,
   OpenAI,
   PHONE_PRICES,
   PORTRAIT_ENROLLMENT_PRICE_USD,
@@ -5712,8 +5496,11 @@ export {
   PhoneClient,
   PortraitClient,
   PriceClient,
+  RPC_PRICE_USD,
+  RpcClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH,
+  SUPPORTED_NETWORKS,
   SearchClient,
   SolanaLLMClient,
   SpeechClient,
@@ -5725,7 +5512,6 @@ export {
   VoiceClient,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
-  XClient,
   clearCache,
   createPaymentPayload,
   createSolanaPaymentPayload,