@blockrun/llm 1.0.0 → 1.2.0

package/dist/index.js

@@ -1,4 +1,9 @@
-import "./chunk-2ESYSVXG.js";
+import {
+  __require,
+  __toCommonJS,
+  index_esm_exports,
+  init_index_esm
+} from "./chunk-KRDGCX7W.js";
 
 // src/client.ts
 import { privateKeyToAccount } from "viem/accounts";
@@ -34,6 +39,10 @@ import { route, DEFAULT_ROUTING_CONFIG } from "@blockrun/clawrouter";
 import { signTypedData } from "viem/accounts";
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+var USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+var DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+var DEFAULT_COMPUTE_UNIT_LIMIT = 8e3;
 var USDC_DOMAIN = {
   name: "USD Coin",
   version: "2",
@@ -106,6 +115,66 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
   };
   return btoa(JSON.stringify(paymentData));
 }
+async function createSolanaPaymentPayload(secretKey, fromAddress, recipient, amount, feePayer, options = {}) {
+  const { Connection, PublicKey, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } = await import("./index.esm-SXKIFLA7.js");
+  const { getAssociatedTokenAddress, createTransferCheckedInstruction, getMint } = await import("./esm-PTFDM6PE.js");
+  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
+  const connection = new Connection(rpcUrl);
+  const keypair = Keypair.fromSecretKey(secretKey);
+  const feePayerPubkey = new PublicKey(feePayer);
+  const ownerPubkey = keypair.publicKey;
+  const tokenMint = new PublicKey(USDC_SOLANA);
+  const payToPubkey = new PublicKey(recipient);
+  const mintInfo = await getMint(connection, tokenMint);
+  const sourceATA = await getAssociatedTokenAddress(tokenMint, ownerPubkey, false);
+  const destinationATA = await getAssociatedTokenAddress(tokenMint, payToPubkey, false);
+  const { blockhash } = await connection.getLatestBlockhash();
+  const setComputeUnitPriceIx = ComputeBudgetProgram.setComputeUnitPrice({
+    microLamports: DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS
+  });
+  const setComputeUnitLimitIx = ComputeBudgetProgram.setComputeUnitLimit({
+    units: DEFAULT_COMPUTE_UNIT_LIMIT
+  });
+  const transferIx = createTransferCheckedInstruction(
+    sourceATA,
+    tokenMint,
+    destinationATA,
+    ownerPubkey,
+    BigInt(amount),
+    mintInfo.decimals
+  );
+  const messageV0 = new TransactionMessage({
+    payerKey: feePayerPubkey,
+    recentBlockhash: blockhash,
+    instructions: [setComputeUnitLimitIx, setComputeUnitPriceIx, transferIx]
+  }).compileToV0Message();
+  const transaction = new VersionedTransaction(messageV0);
+  transaction.sign([keypair]);
+  const serializedTx = Buffer.from(transaction.serialize()).toString("base64");
+  const paymentData = {
+    x402Version: 2,
+    resource: {
+      url: options.resourceUrl || "https://blockrun.ai/api/v1/chat/completions",
+      description: options.resourceDescription || "BlockRun AI API call",
+      mimeType: "application/json"
+    },
+    accepted: {
+      scheme: "exact",
+      network: SOLANA_NETWORK,
+      amount,
+      asset: USDC_SOLANA,
+      payTo: recipient,
+      maxTimeoutSeconds: options.maxTimeoutSeconds || 300,
+      extra: options.extra || { feePayer }
+    },
+    payload: {
+      transaction: serializedTx
+    },
+    extensions: options.extensions || {}
+  };
+  return btoa(JSON.stringify(paymentData));
+}
 function parsePaymentRequired(headerValue) {
   try {
     const decoded = atob(headerValue);
@@ -304,7 +373,7 @@ var LLMClient = class {
    * ```ts
    * const result = await client.smartChat('What is 2+2?');
    * console.log(result.response); // '4'
-   * console.log(result.model); // 'google/gemini-2.5-flash'
+   * console.log(result.model); // 'google/gemini-2.5-flash-lite'
    * console.log(result.routing.savings); // 0.78 (78% savings)
    * ```
    *
@@ -504,6 +573,103 @@ 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();
+  }
   /**
    * Fetch with timeout.
    */
@@ -586,6 +752,285 @@ 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;
+  }
   /**
    * Get current session spending.
    *
@@ -679,6 +1124,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.
    */
@@ -947,6 +1417,482 @@ Check my balance: ${links.basescan}`;
 var WALLET_FILE_PATH = WALLET_FILE;
 var WALLET_DIR_PATH = WALLET_DIR;
 
+// src/solana-wallet.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+var WALLET_DIR2 = path2.join(os2.homedir(), ".blockrun");
+var SOLANA_WALLET_FILE = path2.join(WALLET_DIR2, ".solana-session");
+function createSolanaWallet() {
+  const { Keypair } = (init_index_esm(), __toCommonJS(index_esm_exports));
+  const bs58 = __require("bs58");
+  const keypair = Keypair.generate();
+  return {
+    address: keypair.publicKey.toBase58(),
+    privateKey: bs58.default?.encode(keypair.secretKey) ?? bs58.encode(keypair.secretKey)
+  };
+}
+async function solanaKeyToBytes(privateKey) {
+  try {
+    const bs58 = await import("bs58");
+    const bytes = (bs58.default ?? bs58).decode(privateKey);
+    if (bytes.length !== 64) {
+      throw new Error(`Invalid Solana key length: expected 64 bytes, got ${bytes.length}`);
+    }
+    return bytes;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Invalid Solana private key: ${msg}`);
+  }
+}
+async function solanaPublicKey(privateKey) {
+  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const bytes = await solanaKeyToBytes(privateKey);
+  return Keypair.fromSecretKey(bytes).publicKey.toBase58();
+}
+function saveSolanaWallet(privateKey) {
+  if (!fs2.existsSync(WALLET_DIR2)) fs2.mkdirSync(WALLET_DIR2, { recursive: true });
+  fs2.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
+  return SOLANA_WALLET_FILE;
+}
+function loadSolanaWallet() {
+  if (fs2.existsSync(SOLANA_WALLET_FILE)) {
+    const key = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
+    if (key) return key;
+  }
+  return null;
+}
+async function getOrCreateSolanaWallet() {
+  const envKey = typeof process !== "undefined" && process.env ? process.env.SOLANA_WALLET_KEY : void 0;
+  if (envKey) {
+    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 { address, privateKey } = createSolanaWallet();
+  saveSolanaWallet(privateKey);
+  return { address, privateKey, isNew: true };
+}
+
+// src/solana-client.ts
+var SOLANA_API_URL = "https://sol.blockrun.ai/api";
+var DEFAULT_MAX_TOKENS2 = 1024;
+var DEFAULT_TIMEOUT3 = 6e4;
+var SDK_VERSION2 = "0.3.0";
+var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
+var SolanaLLMClient = class {
+  static SOLANA_API_URL = SOLANA_API_URL;
+  privateKey;
+  apiUrl;
+  rpcUrl;
+  timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
+  addressCache = null;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.SOLANA_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set SOLANA_WALLET_KEY environment variable."
+      );
+    }
+    this.privateKey = privateKey;
+    const apiUrl = options.apiUrl || SOLANA_API_URL;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
+    this.timeout = options.timeout || DEFAULT_TIMEOUT3;
+  }
+  /** Get Solana wallet address (public key in base58). */
+  async getWalletAddress() {
+    if (!this.addressCache) {
+      this.addressCache = await solanaPublicKey(this.privateKey);
+    }
+    return this.addressCache;
+  }
+  /** Simple 1-line chat. */
+  async chat(model, prompt, options) {
+    const messages = [];
+    if (options?.system) messages.push({ role: "system", content: options.system });
+    messages.push({ role: "user", content: prompt });
+    const result = await this.chatCompletion(model, messages, {
+      maxTokens: options?.maxTokens,
+      temperature: options?.temperature,
+      topP: options?.topP,
+      search: options?.search,
+      searchParameters: options?.searchParameters
+    });
+    return result.choices[0].message.content || "";
+  }
+  /** Full chat completion (OpenAI-compatible). */
+  async chatCompletion(model, messages, options) {
+    const body = {
+      model,
+      messages,
+      max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS2
+    };
+    if (options?.temperature !== void 0) body.temperature = options.temperature;
+    if (options?.topP !== void 0) body.top_p = options.topP;
+    if (options?.searchParameters !== void 0) body.search_parameters = options.searchParameters;
+    else if (options?.search === true) body.search_parameters = { mode: "on" };
+    if (options?.tools !== void 0) body.tools = options.tools;
+    if (options?.toolChoice !== void 0) body.tool_choice = options.toolChoice;
+    return this.requestWithPayment("/v1/chat/completions", body);
+  }
+  /** List available models. */
+  async listModels() {
+    const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/models`, { method: "GET" });
+    if (!response.ok) {
+      throw new APIError(`Failed to list models: ${response.status}`, response.status);
+    }
+    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;
+  }
+  /** Get session spending. */
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+  /** True if using sol.blockrun.ai. */
+  isSolana() {
+    return this.apiUrl.includes("sol.blockrun.ai");
+  }
+  async requestWithPayment(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.handlePaymentAndRetry(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 handlePaymentAndRetry(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 || `${this.apiUrl}/v1/chat/completions`,
+          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 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 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);
+    }
+  }
+};
+function solanaClient(options = {}) {
+  return new SolanaLLMClient({ ...options, apiUrl: SOLANA_API_URL });
+}
+
 // src/openai-compat.ts
 var StreamingResponse = class {
   reader;
@@ -1124,20 +2070,32 @@ export {
   LLMClient,
   OpenAI,
   PaymentError,
+  SOLANA_NETWORK,
+  SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH,
+  SolanaLLMClient,
   USDC_BASE,
   USDC_BASE_CONTRACT,
+  USDC_SOLANA,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
+  createSolanaPaymentPayload,
+  createSolanaWallet,
   createWallet,
   client_default as default,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
   getEip681Uri,
+  getOrCreateSolanaWallet,
   getOrCreateWallet,
   getPaymentLinks,
   getWalletAddress,
+  loadSolanaWallet,
   loadWallet,
+  saveSolanaWallet,
   saveWallet,
+  solanaClient,
+  solanaKeyToBytes,
+  solanaPublicKey,
   testnetClient
 };