@blockrun/llm 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -37025,6 +37025,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(endpoint2, body) {
+    const url2 = `${this.apiUrl}${endpoint2}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(url2, 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(url2, 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 || url2,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url2, {
+      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.
    */
@@ -37107,6 +37204,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 (e2) {
+        lastError = e2;
+      }
+    }
+    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.
    *
@@ -37200,6 +37576,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.
    */
@@ -37604,6 +38005,142 @@ 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;
+  }
   /** Get session spending. */
   getSpending() {
     return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
@@ -37703,6 +38240,97 @@ var SolanaLLMClient = class {
     this.sessionTotalUsd += costUsd;
     return retryResponse.json();
   }
+  async requestWithPaymentRaw(endpoint2, body) {
+    const url2 = `${this.apiUrl}${endpoint2}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT2 },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(url2, 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(url2, 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 || url2,
+          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(url2, {
+      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(url2, options) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);