@blockrun/llm 1.1.0 → 1.3.0

package/dist/index.js

@@ -573,6 +573,200 @@ var LLMClient = class {
     this.sessionTotalUsd += costUsd;
     return retryResponse.json();
   }
+  /**
+   * Make a request with automatic x402 payment handling, returning raw JSON.
+   * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+   */
+  async requestWithPaymentRaw(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(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();
+  }
+  /**
+   * Handle 402 response for raw endpoints: parse requirements, sign payment, retry.
+   */
+  async handlePaymentAndRetryRaw(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 {
+        console.debug("Failed to parse payment header from response body");
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
+        "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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
+  /**
+   * GET with automatic x402 payment handling, returning raw JSON.
+   * Used for Predexon prediction market endpoints that use GET + query params.
+   */
+  async getWithPaymentRaw(endpoint, params) {
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const url = `${this.apiUrl}${endpoint}${query}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: { "User-Agent": USER_AGENT }
+    });
+    if (response.status === 402) {
+      return this.handleGetPaymentAndRetryRaw(url, endpoint, params, 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();
+  }
+  /**
+   * Handle 402 response for GET endpoints: parse requirements, sign payment, retry with GET.
+   */
+  async handleGetPaymentAndRetryRaw(url, endpoint, params, 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 {
+        console.debug("Failed to parse payment header from response body");
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions
+      }
+    );
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const retryUrl = `${this.apiUrl}${endpoint}${query}`;
+    const retryResponse = await this.fetchWithTimeout(retryUrl, {
+      method: "GET",
+      headers: {
+        "User-Agent": USER_AGENT,
+        "PAYMENT-SIGNATURE": paymentPayload
+      }
+    });
+    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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
   /**
    * Fetch with timeout.
    */
@@ -655,6 +849,317 @@ var LLMClient = class {
     }
     return [...llmModels, ...imageModels];
   }
+  /**
+   * Edit an image using img2img.
+   *
+   * @param prompt - Text description of the desired edit
+   * @param image - Base64-encoded image or URL of the source image
+   * @param options - Optional edit parameters
+   * @returns ImageResponse with edited image URLs
+   */
+  async imageEdit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) {
+      body.mask = options.mask;
+    }
+    const data = await this.requestWithPaymentRaw("/v1/images/image2image", body);
+    return data;
+  }
+  /**
+   * Standalone search (web, X/Twitter, news).
+   *
+   * @param query - Search query
+   * @param options - Optional search parameters
+   * @returns SearchResult with summary and citations
+   */
+  async search(query, options) {
+    const body = {
+      query,
+      max_results: options?.maxResults || 10
+    };
+    if (options?.sources !== void 0) body.sources = options.sources;
+    if (options?.fromDate !== void 0) body.from_date = options.fromDate;
+    if (options?.toDate !== void 0) body.to_date = options.toDate;
+    const data = await this.requestWithPaymentRaw("/v1/search", body);
+    return data;
+  }
+  /**
+   * Get USDC balance on Base network.
+   *
+   * Automatically detects mainnet vs testnet based on API URL.
+   *
+   * @returns USDC balance as a float (6 decimal places normalized)
+   *
+   * @example
+   * const balance = await client.getBalance();
+   * console.log(`Balance: $${balance.toFixed(2)} USDC`);
+   */
+  async getBalance() {
+    const isTestnet = this.isTestnet();
+    const usdcContract = isTestnet ? "0x036CbD53842c5426634e7929541eC2318f3dCF7e" : "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    const rpcs = isTestnet ? ["https://sepolia.base.org", "https://base-sepolia-rpc.publicnode.com"] : ["https://base.publicnode.com", "https://mainnet.base.org", "https://base.meowrpc.com"];
+    const selector = "0x70a08231";
+    const paddedAddress = this.account.address.slice(2).toLowerCase().padStart(64, "0");
+    const data = selector + paddedAddress;
+    const payload = {
+      jsonrpc: "2.0",
+      method: "eth_call",
+      params: [{ to: usdcContract, data }, "latest"],
+      id: 1
+    };
+    let lastError;
+    for (const rpc of rpcs) {
+      try {
+        const response = await fetch(rpc, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload)
+        });
+        const result = await response.json();
+        const balanceRaw = parseInt(result.result || "0x0", 16);
+        return balanceRaw / 1e6;
+      } catch (e) {
+        lastError = e;
+      }
+    }
+    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).
+   *
+   * Access real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
+   * Powered by Predexon. $0.001 per request.
+   *
+   * @param path - Endpoint path, e.g. "polymarket/events", "kalshi/markets/12345"
+   * @param params - Query parameters passed to the endpoint
+   *
+   * @example
+   * const events = await client.pm("polymarket/events");
+   * const market = await client.pm("kalshi/markets/KXBTC-25MAR14");
+   * const results = await client.pm("polymarket/search", { q: "bitcoin" });
+   */
+  async pm(path5, params) {
+    return this.getWithPaymentRaw(`/v1/pm/${path5}`, params);
+  }
+  /**
+   * Structured query for Predexon prediction market data (POST endpoints).
+   *
+   * For complex queries that require a JSON body. $0.005 per request.
+   *
+   * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+   * @param query - JSON body for the structured query
+   *
+   * @example
+   * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+   */
+  async pmQuery(path5, query) {
+    return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
+  }
   /**
    * Get current session spending.
    *
@@ -748,6 +1253,31 @@ var ImageClient = class {
     }
     return this.requestWithPayment("/v1/images/generations", body);
   }
+  /**
+   * Edit an image using img2img.
+   *
+   * @param prompt - Text description of the desired edit
+   * @param image - Base64-encoded image or URL of the source image
+   * @param options - Optional edit parameters
+   * @returns ImageResponse with edited image URLs
+   *
+   * @example
+   * const result = await client.edit('Make it a painting', imageBase64);
+   * console.log(result.data[0].url);
+   */
+  async edit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) {
+      body.mask = options.mask;
+    }
+    return this.requestWithPayment("/v1/images/image2image", body);
+  }
   /**
    * List available image generation models with pricing.
    */
@@ -915,7 +1445,35 @@ function saveWallet(privateKey) {
   fs.writeFileSync(WALLET_FILE, privateKey, { mode: 384 });
   return WALLET_FILE;
 }
+function scanWallets() {
+  const home = os.homedir();
+  const results = [];
+  try {
+    const entries = fs.readdirSync(home, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.name.startsWith(".") || !entry.isDirectory()) continue;
+      const walletFile = path.join(home, entry.name, "wallet.json");
+      if (!fs.existsSync(walletFile)) continue;
+      try {
+        const data = JSON.parse(fs.readFileSync(walletFile, "utf-8"));
+        const pk = data.privateKey || "";
+        const addr = data.address || "";
+        if (pk && addr) {
+          const mtime = fs.statSync(walletFile).mtimeMs;
+          results.push({ mtime, privateKey: pk, address: addr });
+        }
+      } catch {
+        continue;
+      }
+    }
+  } catch {
+  }
+  results.sort((a, b) => b.mtime - a.mtime);
+  return results.map(({ privateKey, address }) => ({ privateKey, address }));
+}
 function loadWallet() {
+  const wallets = scanWallets();
+  if (wallets.length > 0) return wallets[0].privateKey;
   if (fs.existsSync(WALLET_FILE)) {
     const key = fs.readFileSync(WALLET_FILE, "utf-8").trim();
     if (key) return key;
@@ -1054,7 +1612,50 @@ function saveSolanaWallet(privateKey) {
   fs2.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
   return SOLANA_WALLET_FILE;
 }
+function scanSolanaWallets() {
+  const home = os2.homedir();
+  const results = [];
+  try {
+    const entries = fs2.readdirSync(home, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.name.startsWith(".") || !entry.isDirectory()) continue;
+      const solanaWalletFile = path2.join(home, entry.name, "solana-wallet.json");
+      if (fs2.existsSync(solanaWalletFile)) {
+        try {
+          const data = JSON.parse(fs2.readFileSync(solanaWalletFile, "utf-8"));
+          const pk = data.privateKey || "";
+          const addr = data.address || "";
+          if (pk && addr) {
+            const mtime = fs2.statSync(solanaWalletFile).mtimeMs;
+            results.push({ mtime, secretKey: pk, publicKey: addr });
+          }
+        } catch {
+        }
+      }
+      if (entry.name === ".brcc") {
+        const brccWalletFile = path2.join(home, entry.name, "wallet.json");
+        if (fs2.existsSync(brccWalletFile)) {
+          try {
+            const data = JSON.parse(fs2.readFileSync(brccWalletFile, "utf-8"));
+            const pk = data.privateKey || "";
+            const addr = data.address || "";
+            if (pk && addr) {
+              const mtime = fs2.statSync(brccWalletFile).mtimeMs;
+              results.push({ mtime, secretKey: pk, publicKey: addr });
+            }
+          } catch {
+          }
+        }
+      }
+    }
+  } catch {
+  }
+  results.sort((a, b) => b.mtime - a.mtime);
+  return results.map(({ secretKey, publicKey }) => ({ secretKey, publicKey }));
+}
 function loadSolanaWallet() {
+  const wallets = scanSolanaWallets();
+  if (wallets.length > 0) return wallets[0].secretKey;
   if (fs2.existsSync(SOLANA_WALLET_FILE)) {
     const key = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
     if (key) return key;
@@ -1067,10 +1668,16 @@ async function getOrCreateSolanaWallet() {
     const address2 = await solanaPublicKey(envKey);
     return { privateKey: envKey, address: address2, isNew: false };
   }
-  const fileKey = loadSolanaWallet();
-  if (fileKey) {
-    const address2 = await solanaPublicKey(fileKey);
-    return { privateKey: fileKey, address: address2, isNew: false };
+  const wallets = scanSolanaWallets();
+  if (wallets.length > 0) {
+    return { privateKey: wallets[0].secretKey, address: wallets[0].publicKey, isNew: false };
+  }
+  if (fs2.existsSync(SOLANA_WALLET_FILE)) {
+    const fileKey = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
+    if (fileKey) {
+      const address2 = await solanaPublicKey(fileKey);
+      return { privateKey: fileKey, address: address2, isNew: false };
+    }
   }
   const { address, privateKey } = createSolanaWallet();
   saveSolanaWallet(privateKey);
@@ -1152,6 +1759,149 @@ var SolanaLLMClient = class {
     const data = await response.json();
     return data.data || [];
   }
+  /**
+   * Get Solana USDC balance.
+   *
+   * @returns USDC balance as a float
+   */
+  async getBalance() {
+    const usdc_mint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+    const address = await this.getWalletAddress();
+    try {
+      const response = await fetch(this.rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "getTokenAccountsByOwner",
+          params: [address, { mint: usdc_mint }, { encoding: "jsonParsed" }]
+        })
+      });
+      const data = await response.json();
+      const accounts = data.result?.value || [];
+      if (!accounts.length) return 0;
+      let total = 0;
+      for (const acct of accounts) {
+        total += acct.account?.data?.parsed?.info?.tokenAmount?.uiAmount || 0;
+      }
+      return total;
+    } catch {
+      return 0;
+    }
+  }
+  /** Edit an image using img2img (Solana payment). */
+  async imageEdit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) body.mask = options.mask;
+    const data = await this.requestWithPaymentRaw("/v1/images/image2image", body);
+    return data;
+  }
+  /** Standalone search (Solana payment). */
+  async search(query, options) {
+    const body = { query, max_results: options?.maxResults || 10 };
+    if (options?.sources !== void 0) body.sources = options.sources;
+    if (options?.fromDate !== void 0) body.from_date = options.fromDate;
+    if (options?.toDate !== void 0) body.to_date = options.toDate;
+    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);
+  }
+  async pmQuery(path5, query) {
+    return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
+  }
   /** Get session spending. */
   getSpending() {
     return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
@@ -1251,6 +2001,188 @@ var SolanaLLMClient = class {
     this.sessionTotalUsd += costUsd;
     return retryResponse.json();
   }
+  async requestWithPaymentRaw(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT2 },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(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 handlePaymentAndRetryRaw(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.accepts || respBody.x402Version) {
+          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, SOLANA_NETWORK);
+    if (!details.network?.startsWith("solana:")) {
+      throw new PaymentError(
+        `Expected Solana payment network, got: ${details.network}. Use LLMClient for Base payments.`
+      );
+    }
+    const feePayer = details.extra?.feePayer;
+    if (!feePayer) throw new PaymentError("Missing feePayer in 402 extra field");
+    const fromAddress = await this.getWalletAddress();
+    const secretKey = await solanaKeyToBytes(this.privateKey);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createSolanaPaymentPayload(
+      secretKey,
+      fromAddress,
+      details.recipient,
+      details.amount,
+      feePayer,
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun Solana AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions,
+        rpcUrl: this.rpcUrl
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT2,
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your Solana USDC 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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
+  async getWithPaymentRaw(endpoint, params) {
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const url = `${this.apiUrl}${endpoint}${query}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: { "User-Agent": USER_AGENT2 }
+    });
+    if (response.status === 402) {
+      return this.handleGetPaymentAndRetryRaw(url, endpoint, params, 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 handleGetPaymentAndRetryRaw(url, endpoint, params, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.accepts || respBody.x402Version) {
+          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, SOLANA_NETWORK);
+    if (!details.network?.startsWith("solana:")) {
+      throw new PaymentError(
+        `Expected Solana payment network, got: ${details.network}. Use LLMClient for Base payments.`
+      );
+    }
+    const feePayer = details.extra?.feePayer;
+    if (!feePayer) throw new PaymentError("Missing feePayer in 402 extra field");
+    const fromAddress = await this.getWalletAddress();
+    const secretKey = await solanaKeyToBytes(this.privateKey);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createSolanaPaymentPayload(
+      secretKey,
+      fromAddress,
+      details.recipient,
+      details.amount,
+      feePayer,
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun Solana AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions,
+        rpcUrl: this.rpcUrl
+      }
+    );
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const retryUrl = `${this.apiUrl}${endpoint}${query}`;
+    const retryResponse = await this.fetchWithTimeout(retryUrl, {
+      method: "GET",
+      headers: {
+        "User-Agent": USER_AGENT2,
+        "PAYMENT-SIGNATURE": paymentPayload
+      }
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your Solana USDC 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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
   async fetchWithTimeout(url, options) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -1265,6 +2197,192 @@ function solanaClient(options = {}) {
   return new SolanaLLMClient({ ...options, apiUrl: SOLANA_API_URL });
 }
 
+// src/cache.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
+import * as os3 from "os";
+import * as crypto2 from "crypto";
+var CACHE_DIR = path3.join(os3.homedir(), ".blockrun", "cache");
+var DEFAULT_TTL = {
+  "/v1/x/": 3600 * 1e3,
+  "/v1/partner/": 3600 * 1e3,
+  "/v1/pm/": 1800 * 1e3,
+  "/v1/chat/": 0,
+  "/v1/search": 900 * 1e3,
+  "/v1/image": 0,
+  "/v1/models": 86400 * 1e3
+};
+function getTtl(endpoint) {
+  for (const [pattern, ttl] of Object.entries(DEFAULT_TTL)) {
+    if (endpoint.includes(pattern)) return ttl;
+  }
+  return 3600 * 1e3;
+}
+function cacheKey(endpoint, body) {
+  const keyData = JSON.stringify({ endpoint, body }, Object.keys({ endpoint, body }).sort());
+  return crypto2.createHash("sha256").update(keyData).digest("hex").slice(0, 16);
+}
+function cachePath(key) {
+  return path3.join(CACHE_DIR, `${key}.json`);
+}
+function getCached(key) {
+  const filePath = cachePath(key);
+  if (!fs3.existsSync(filePath)) return null;
+  try {
+    const raw = fs3.readFileSync(filePath, "utf-8");
+    const entry = JSON.parse(raw);
+    const ttl = entry.ttlMs ?? getTtl(entry.endpoint ?? "");
+    if (ttl <= 0) return null;
+    if (Date.now() - entry.cachedAt > ttl) {
+      try {
+        fs3.unlinkSync(filePath);
+      } catch {
+      }
+      return null;
+    }
+    return entry.response;
+  } catch {
+    return null;
+  }
+}
+function getCachedByRequest(endpoint, body) {
+  const ttl = getTtl(endpoint);
+  if (ttl <= 0) return null;
+  const key = cacheKey(endpoint, body);
+  return getCached(key);
+}
+function setCache(key, data, ttlMs) {
+  if (ttlMs <= 0) return;
+  try {
+    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+  } catch {
+  }
+  const entry = {
+    cachedAt: Date.now(),
+    response: data,
+    ttlMs
+  };
+  try {
+    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+  } catch {
+  }
+}
+function saveToCache(endpoint, body, response, costUsd = 0) {
+  const ttl = getTtl(endpoint);
+  if (ttl <= 0) return;
+  try {
+    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+  } catch {
+  }
+  const key = cacheKey(endpoint, body);
+  const entry = {
+    cachedAt: Date.now(),
+    endpoint,
+    body,
+    response,
+    costUsd
+  };
+  try {
+    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+  } catch {
+  }
+}
+function clearCache() {
+  if (!fs3.existsSync(CACHE_DIR)) return 0;
+  let count = 0;
+  try {
+    const files = fs3.readdirSync(CACHE_DIR);
+    for (const file of files) {
+      if (file.endsWith(".json")) {
+        try {
+          fs3.unlinkSync(path3.join(CACHE_DIR, file));
+          count++;
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return count;
+}
+
+// src/setup.ts
+function setupAgentWallet(options) {
+  const { address, privateKey, isNew } = getOrCreateWallet();
+  if (isNew && !options?.silent) {
+    console.error(
+      `
+BlockRun Agent Wallet Created!
+Address: ${address}
+Send USDC on Base to get started.
+`
+    );
+  }
+  return new LLMClient({ privateKey });
+}
+async function setupAgentSolanaWallet(options) {
+  const result = await getOrCreateSolanaWallet();
+  if (result.isNew && !options?.silent) {
+    console.error(
+      `
+BlockRun Solana Agent Wallet Created!
+Address: ${result.address}
+Send USDC on Solana to get started.
+`
+    );
+  }
+  return new SolanaLLMClient({ privateKey: result.privateKey });
+}
+async function status() {
+  const client = setupAgentWallet({ silent: true });
+  const address = client.getWalletAddress();
+  const balance = await client.getBalance();
+  console.log(`Wallet: ${address}`);
+  console.log(`Balance: $${balance.toFixed(2)} USDC`);
+  return { address, balance };
+}
+
+// src/cost-log.ts
+import * as fs4 from "fs";
+import * as path4 from "path";
+import * as os4 from "os";
+var DATA_DIR = path4.join(os4.homedir(), ".blockrun", "data");
+var COST_LOG_FILE = path4.join(DATA_DIR, "costs.jsonl");
+function logCost(entry) {
+  try {
+    fs4.mkdirSync(DATA_DIR, { recursive: true });
+  } catch {
+  }
+  try {
+    fs4.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
+  } catch {
+  }
+}
+function getCostSummary() {
+  if (!fs4.existsSync(COST_LOG_FILE)) {
+    return { totalUsd: 0, calls: 0, byModel: {} };
+  }
+  let totalUsd = 0;
+  let calls = 0;
+  const byModel = {};
+  try {
+    const content = fs4.readFileSync(COST_LOG_FILE, "utf-8").trim();
+    if (!content) return { totalUsd: 0, calls: 0, byModel: {} };
+    for (const line of content.split("\n")) {
+      if (!line) continue;
+      try {
+        const entry = JSON.parse(line);
+        totalUsd += entry.costUsd;
+        calls += 1;
+        byModel[entry.model] = (byModel[entry.model] || 0) + entry.costUsd;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return { totalUsd, calls, byModel };
+}
+
 // src/openai-compat.ts
 var StreamingResponse = class {
   reader;
@@ -1450,6 +2568,7 @@ export {
   USDC_SOLANA,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
+  clearCache,
   createSolanaPaymentPayload,
   createSolanaWallet,
   createWallet,
@@ -1457,6 +2576,9 @@ export {
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
+  getCached,
+  getCachedByRequest,
+  getCostSummary,
   getEip681Uri,
   getOrCreateSolanaWallet,
   getOrCreateWallet,
@@ -1464,10 +2586,18 @@ export {
   getWalletAddress,
   loadSolanaWallet,
   loadWallet,
+  logCost,
   saveSolanaWallet,
+  saveToCache,
   saveWallet,
+  scanSolanaWallets,
+  scanWallets,
+  setCache,
+  setupAgentSolanaWallet,
+  setupAgentWallet,
   solanaClient,
   solanaKeyToBytes,
   solanaPublicKey,
+  status,
   testnetClient
 };