@blockrun/llm 1.13.0 → 1.15.0

package/README.md

@@ -63,15 +63,16 @@ console.log(result.response);  // '4'
 
 | Model ID | Context | Best For |
 |----------|---------|----------|
-| `nvidia/deepseek-v4-pro` | 1M | Flagship reasoning — MMLU-Pro 87.5, GPQA 90.1, SWE-bench 80.6, LiveCodeBench 93.5 |
-| `nvidia/deepseek-v4-flash` | 1M | ~5× faster than V4 Pro — chat, summarization, light reasoning (weaker factual recall) |
+| `nvidia/deepseek-v4-flash` | 1M | DeepSeek V4 Flash — 284B / 13B active MoE, ~5× faster than V4 Pro. Best free chat / summarization / light reasoning |
 | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning` | 256K | Only vision-capable free model — text + images + video (≤2 min) + audio (≤1 hr) |
 | `nvidia/qwen3-next-80b-a3b-thinking` | 131K | 116 tok/s reasoning with thinking mode |
 | `nvidia/mistral-small-4-119b` | 131K | 114 tok/s — fastest free chat |
-| `nvidia/glm-4.7` | 131K | 237 tok/s — GLM-4.7 with thinking mode |
 | `nvidia/llama-4-maverick` | 131K | Meta Llama 4 Maverick MoE |
 | `nvidia/qwen3-coder-480b` | 131K | Coding-optimised 480B MoE |
-| `nvidia/deepseek-v3.2` | 131K | Legacy V3.2 — auto-upgrades to V4 Pro via fallback |
+| `nvidia/gpt-oss-120b` | 128K | OpenAI open-weight 120B — 123 tok/s. Hidden from `/v1/models` for privacy but direct calls still work |
+| `nvidia/gpt-oss-20b` | 128K | OpenAI open-weight 20B — 155 tok/s. Hidden from `/v1/models` but direct calls still work |
+
+> Need V4-Pro-class reasoning? Use the paid `deepseek/deepseek-v4-pro` ($0.50/$1.00 with the 75% promo through 2026-05-31) — `nvidia/deepseek-v4-pro` is currently hidden because NVIDIA's NIM deployment is hung; backend MODEL_REDIRECTS forwards calls to V4 Flash.
 
 > Note: `nvidia/gpt-oss-120b` and `nvidia/gpt-oss-20b` were retired 2026-04-28 — NVIDIA's free build.nvidia.com tier reserves the right to use prompts/outputs for service improvement, which conflicts with our data-privacy policy.
 
@@ -249,10 +250,17 @@ Released 2026-04-23 — first fully retrained base since GPT-4.5. 1M context, 12
 | `google/gemini-2.5-flash-lite` | $0.10/M | $0.40/M |
 
 ### DeepSeek
-| Model | Input Price | Output Price |
-|-------|-------------|--------------|
-| `deepseek/deepseek-chat` | $0.28/M | $0.42/M |
-| `deepseek/deepseek-reasoner` | $0.28/M | $0.42/M |
+
+V4 family launched 2026-04-24. DeepSeek upstream now serves the legacy
+`deepseek-chat` / `deepseek-reasoner` aliases as V4 Flash non-thinking /
+thinking modes. V4 Pro is the new flagship paid SKU — 1.6T MoE / 49B active,
+1M context, MMLU-Pro 87.5, GPQA 90.1, SWE-bench 80.6, LiveCodeBench 93.5.
+
+| Model | Input Price | Output Price | Context | Notes |
+|-------|-------------|--------------|---------|-------|
+| `deepseek/deepseek-v4-pro` | $0.50/M | $1.00/M | 1M | V4 flagship — strongest open-weight reasoner. **75% off until 2026-05-31** (list $2.00/$4.00) |
+| `deepseek/deepseek-chat` | $0.20/M | $0.40/M | 1M | V4 Flash non-thinking (paid endpoint with 5MB request bodies; same upstream as `nvidia/deepseek-v4-flash`) |
+| `deepseek/deepseek-reasoner` | $0.20/M | $0.40/M | 1M | V4 Flash thinking (same upstream as `deepseek-chat`, thinking enabled by default) |
 
 ### xAI Grok
 | Model | Input Price | Output Price | Context | Notes |
@@ -281,23 +289,26 @@ Released 2026-04-23 — first fully retrained base since GPT-4.5. 1M context, 12
 
 ### NVIDIA (Free) + Moonshot
 
-Free tier refreshed 2026-04-28: added DeepSeek V4 Pro/Flash and Nemotron Nano
-Omni (vision); retired `nvidia/gpt-oss-120b` / `nvidia/gpt-oss-20b` over data
-privacy (NVIDIA's free build.nvidia.com tier reserves the right to use prompts
-for service improvement, which conflicts with our policy). Backend
-auto-redirects retired IDs to the replacements below.
+Free tier refreshed 2026-04-28: added `nvidia/deepseek-v4-flash` (1M context)
+and Nemotron Nano Omni (vision). `nvidia/gpt-oss-120b` and
+`nvidia/gpt-oss-20b` were briefly delisted over privacy concerns then
+**re-enabled 2026-04-30** with `available: true` + `hidden: true` — they
+no longer appear in `/v1/models` (so SmartChat won't auto-pick them) but
+direct calls by full ID still return HTTP 200. `nvidia/deepseek-v4-pro`,
+`nvidia/deepseek-v3.2`, and `nvidia/glm-4.7` are hidden because NVIDIA's
+NIM deployment is hung — backend MODEL_REDIRECTS forwards calls to V4
+Flash / qwen3-coder.
 
 | Model | Input Price | Output Price | Notes |
 |-------|-------------|--------------|-------|
-| `nvidia/deepseek-v4-pro` | **FREE** | **FREE** | 1.6T MoE / 49B active, 1M context — flagship reasoning (MMLU-Pro 87.5, GPQA 90.1) |
-| `nvidia/deepseek-v4-flash` | **FREE** | **FREE** | 284B / 13B active MoE, 1M context — ~5× faster than V4 Pro |
+| `nvidia/deepseek-v4-flash` | **FREE** | **FREE** | 284B / 13B active MoE, 1M context — best free chat / summarization / light reasoning |
 | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning` | **FREE** | **FREE** | 31B / 3.2B active MoE, 256K — only vision-capable free model |
 | `nvidia/qwen3-next-80b-a3b-thinking` | **FREE** | **FREE** | 116 tok/s — reasoning flagship with thinking mode |
 | `nvidia/mistral-small-4-119b` | **FREE** | **FREE** | 114 tok/s — fastest free chat |
-| `nvidia/glm-4.7` | **FREE** | **FREE** | 237 tok/s — GLM-4.7 with thinking mode |
 | `nvidia/llama-4-maverick` | **FREE** | **FREE** | Meta Llama 4 Maverick MoE |
 | `nvidia/qwen3-coder-480b` | **FREE** | **FREE** | Coding-optimised 480B MoE |
-| `nvidia/deepseek-v3.2` | **FREE** | **FREE** | Legacy V3.2 — auto-upgrades to V4 Pro via fallback |
+| `nvidia/gpt-oss-120b` | **FREE** | **FREE** | Hidden from `/v1/models` for privacy but direct calls still work — 123 tok/s |
+| `nvidia/gpt-oss-20b` | **FREE** | **FREE** | Hidden from `/v1/models` but direct calls still work — 155 tok/s |
 | `moonshot/kimi-k2.5` | $0.60/M | $3.00/M | Direct from Moonshot — replaces `nvidia/kimi-k2.5` |
 
 ### E2E Verified Models

package/dist/index.cjs

@@ -1633,17 +1633,70 @@ var LLMClient = class _LLMClient {
   /**
    * Structured query for Predexon prediction market data (POST endpoints).
    *
-   * For complex queries that require a JSON body. $0.005 per request.
+   * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
+   * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
    *
-   * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+   * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
    * @param query - JSON body for the structured query
    *
    * @example
-   * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+   * const batch = await client.pmQuery("polymarket/wallet/identities", {
+   *   addresses: ["0xabc...", "0xdef..."],
+   * });
    */
   async pmQuery(path5, query) {
     return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
   }
+  // ── PM convenience helpers (Predexon v2) ─────────────────────────────────
+  // Thin wrappers over pm() / pmQuery() for the most common v2 endpoints.
+  /** List canonical cross-venue markets (Predexon v2). Tier 1 ($0.001/call).
+   * Filter with venue, status, category, league, event_id, pagination_key. */
+  async pmMarkets(params) {
+    return this.pm("markets", params);
+  }
+  /** List venue-native executable listings flattened across canonical markets
+   * (Predexon v2). Tier 1 ($0.001/call). */
+  async pmListings(params) {
+    return this.pm("markets/listings", params);
+  }
+  /** Resolve a canonical Predexon outcome ID to its market context and venue
+   * listings. Tier 1 ($0.001/call). */
+  async pmOutcome(predexonId) {
+    return this.pm(`outcomes/${predexonId}`);
+  }
+  /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketMarketsKeyset(params) {
+    return this.pm("polymarket/markets/keyset", params);
+  }
+  /** Polymarket events with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketEventsKeyset(params) {
+    return this.pm("polymarket/events/keyset", params);
+  }
+  /** List available sports categories. Tier 1 ($0.001/call). */
+  async pmSportsCategories() {
+    return this.pm("sports/categories");
+  }
+  /** List sports markets grouped by game. Filter with league, sport_type,
+   * status, venue. Tier 1 ($0.001/call). */
+  async pmSportsMarkets(params) {
+    return this.pm("sports/markets", params);
+  }
+  /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
+   * etc.). Tier 2 ($0.005/call). */
+  async pmWalletIdentity(wallet) {
+    return this.pm(`polymarket/wallet/identity/${wallet}`);
+  }
+  /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+  async pmWalletIdentities(addresses) {
+    return this.pmQuery("polymarket/wallet/identities", { addresses });
+  }
+  /** Discover wallets connected to a seed address via on-chain transfers and
+   * identity proofs. Tier 2 ($0.005/call). */
+  async pmWalletCluster(address) {
+    return this.pm(`polymarket/wallet/${address}/cluster`);
+  }
   /**
    * Get current session spending.
    *
@@ -2265,12 +2318,19 @@ var SearchClient = class {
 var import_accounts6 = require("viem/accounts");
 var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT5 = 6e4;
-var XClient = class {
+var XClient = class _XClient {
   account;
   privateKey;
   apiUrl;
   timeout;
+  static deprecationWarned = false;
   constructor(options = {}) {
+    if (!_XClient.deprecationWarned) {
+      console.warn(
+        "[@blockrun/llm] XClient: BlockRun's /v1/x/* (AttentionVC) integration was removed 2026-04-30. All calls will return HTTP 404 until a replacement X data upstream is reintroduced."
+      );
+      _XClient.deprecationWarned = true;
+    }
     const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
     const privateKey = options.privateKey || envKey;
     if (!privateKey) {

package/dist/index.d.cts

@@ -1066,15 +1066,46 @@ declare class LLMClient {
     /**
      * Structured query for Predexon prediction market data (POST endpoints).
      *
-     * For complex queries that require a JSON body. $0.005 per request.
+     * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
+     * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
      *
-     * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+     * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
      * @param query - JSON body for the structured query
      *
      * @example
-     * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+     * const batch = await client.pmQuery("polymarket/wallet/identities", {
+     *   addresses: ["0xabc...", "0xdef..."],
+     * });
      */
     pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** List canonical cross-venue markets (Predexon v2). Tier 1 ($0.001/call).
+     * Filter with venue, status, category, league, event_id, pagination_key. */
+    pmMarkets(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** List venue-native executable listings flattened across canonical markets
+     * (Predexon v2). Tier 1 ($0.001/call). */
+    pmListings(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Resolve a canonical Predexon outcome ID to its market context and venue
+     * listings. Tier 1 ($0.001/call). */
+    pmOutcome(predexonId: string): Promise<Record<string, unknown>>;
+    /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
+     * Tier 1 ($0.001/call). */
+    pmPolymarketMarketsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Polymarket events with cursor-based keyset pagination (use pagination_key).
+     * Tier 1 ($0.001/call). */
+    pmPolymarketEventsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** List available sports categories. Tier 1 ($0.001/call). */
+    pmSportsCategories(): Promise<Record<string, unknown>>;
+    /** List sports markets grouped by game. Filter with league, sport_type,
+     * status, venue. Tier 1 ($0.001/call). */
+    pmSportsMarkets(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
+     * etc.). Tier 2 ($0.005/call). */
+    pmWalletIdentity(wallet: string): Promise<Record<string, unknown>>;
+    /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+    pmWalletIdentities(addresses: string[]): Promise<Record<string, unknown>>;
+    /** Discover wallets connected to a seed address via on-chain transfers and
+     * identity proofs. Tier 2 ($0.005/call). */
+    pmWalletCluster(address: string): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -1343,11 +1374,21 @@ interface XSearchOptions {
     queryType?: "Latest" | "Top" | "Default";
     cursor?: string;
 }
+/**
+ * BlockRun X/Twitter client.
+ *
+ * @deprecated BlockRun's `/v1/x/*` (AttentionVC-partnered) integration was
+ * removed from the backend on 2026-04-30 (commit 80dcf52). All `XClient`
+ * calls will return HTTP 404 until a replacement upstream is wired up.
+ * The class is kept in the SDK so existing imports do not break;
+ * instantiation logs a one-time `console.warn`.
+ */
 declare class XClient {
     private account;
     private privateKey;
     private apiUrl;
     private timeout;
+    private static deprecationWarned;
     constructor(options?: XClientOptions);
     userLookup(usernames: string | string[]): Promise<XUserLookupResponse>;
     userInfo(username: string): Promise<XUserInfoResponse>;

package/dist/index.d.ts

@@ -1066,15 +1066,46 @@ declare class LLMClient {
     /**
      * Structured query for Predexon prediction market data (POST endpoints).
      *
-     * For complex queries that require a JSON body. $0.005 per request.
+     * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
+     * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
      *
-     * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+     * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
      * @param query - JSON body for the structured query
      *
      * @example
-     * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+     * const batch = await client.pmQuery("polymarket/wallet/identities", {
+     *   addresses: ["0xabc...", "0xdef..."],
+     * });
      */
     pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** List canonical cross-venue markets (Predexon v2). Tier 1 ($0.001/call).
+     * Filter with venue, status, category, league, event_id, pagination_key. */
+    pmMarkets(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** List venue-native executable listings flattened across canonical markets
+     * (Predexon v2). Tier 1 ($0.001/call). */
+    pmListings(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Resolve a canonical Predexon outcome ID to its market context and venue
+     * listings. Tier 1 ($0.001/call). */
+    pmOutcome(predexonId: string): Promise<Record<string, unknown>>;
+    /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
+     * Tier 1 ($0.001/call). */
+    pmPolymarketMarketsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Polymarket events with cursor-based keyset pagination (use pagination_key).
+     * Tier 1 ($0.001/call). */
+    pmPolymarketEventsKeyset(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** List available sports categories. Tier 1 ($0.001/call). */
+    pmSportsCategories(): Promise<Record<string, unknown>>;
+    /** List sports markets grouped by game. Filter with league, sport_type,
+     * status, venue. Tier 1 ($0.001/call). */
+    pmSportsMarkets(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
+     * etc.). Tier 2 ($0.005/call). */
+    pmWalletIdentity(wallet: string): Promise<Record<string, unknown>>;
+    /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+    pmWalletIdentities(addresses: string[]): Promise<Record<string, unknown>>;
+    /** Discover wallets connected to a seed address via on-chain transfers and
+     * identity proofs. Tier 2 ($0.005/call). */
+    pmWalletCluster(address: string): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -1343,11 +1374,21 @@ interface XSearchOptions {
     queryType?: "Latest" | "Top" | "Default";
     cursor?: string;
 }
+/**
+ * BlockRun X/Twitter client.
+ *
+ * @deprecated BlockRun's `/v1/x/*` (AttentionVC-partnered) integration was
+ * removed from the backend on 2026-04-30 (commit 80dcf52). All `XClient`
+ * calls will return HTTP 404 until a replacement upstream is wired up.
+ * The class is kept in the SDK so existing imports do not break;
+ * instantiation logs a one-time `console.warn`.
+ */
 declare class XClient {
     private account;
     private privateKey;
     private apiUrl;
     private timeout;
+    private static deprecationWarned;
     constructor(options?: XClientOptions);
     userLookup(usernames: string | string[]): Promise<XUserLookupResponse>;
     userInfo(username: string): Promise<XUserInfoResponse>;

package/dist/index.js

@@ -1537,17 +1537,70 @@ var LLMClient = class _LLMClient {
   /**
    * Structured query for Predexon prediction market data (POST endpoints).
    *
-   * For complex queries that require a JSON body. $0.005 per request.
+   * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
+   * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
    *
-   * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+   * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
    * @param query - JSON body for the structured query
    *
    * @example
-   * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+   * const batch = await client.pmQuery("polymarket/wallet/identities", {
+   *   addresses: ["0xabc...", "0xdef..."],
+   * });
    */
   async pmQuery(path5, query) {
     return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
   }
+  // ── PM convenience helpers (Predexon v2) ─────────────────────────────────
+  // Thin wrappers over pm() / pmQuery() for the most common v2 endpoints.
+  /** List canonical cross-venue markets (Predexon v2). Tier 1 ($0.001/call).
+   * Filter with venue, status, category, league, event_id, pagination_key. */
+  async pmMarkets(params) {
+    return this.pm("markets", params);
+  }
+  /** List venue-native executable listings flattened across canonical markets
+   * (Predexon v2). Tier 1 ($0.001/call). */
+  async pmListings(params) {
+    return this.pm("markets/listings", params);
+  }
+  /** Resolve a canonical Predexon outcome ID to its market context and venue
+   * listings. Tier 1 ($0.001/call). */
+  async pmOutcome(predexonId) {
+    return this.pm(`outcomes/${predexonId}`);
+  }
+  /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketMarketsKeyset(params) {
+    return this.pm("polymarket/markets/keyset", params);
+  }
+  /** Polymarket events with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketEventsKeyset(params) {
+    return this.pm("polymarket/events/keyset", params);
+  }
+  /** List available sports categories. Tier 1 ($0.001/call). */
+  async pmSportsCategories() {
+    return this.pm("sports/categories");
+  }
+  /** List sports markets grouped by game. Filter with league, sport_type,
+   * status, venue. Tier 1 ($0.001/call). */
+  async pmSportsMarkets(params) {
+    return this.pm("sports/markets", params);
+  }
+  /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
+   * etc.). Tier 2 ($0.005/call). */
+  async pmWalletIdentity(wallet) {
+    return this.pm(`polymarket/wallet/identity/${wallet}`);
+  }
+  /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+  async pmWalletIdentities(addresses) {
+    return this.pmQuery("polymarket/wallet/identities", { addresses });
+  }
+  /** Discover wallets connected to a seed address via on-chain transfers and
+   * identity proofs. Tier 2 ($0.005/call). */
+  async pmWalletCluster(address) {
+    return this.pm(`polymarket/wallet/${address}/cluster`);
+  }
   /**
    * Get current session spending.
    *
@@ -2169,12 +2222,19 @@ var SearchClient = class {
 import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
 var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT5 = 6e4;
-var XClient = class {
+var XClient = class _XClient {
   account;
   privateKey;
   apiUrl;
   timeout;
+  static deprecationWarned = false;
   constructor(options = {}) {
+    if (!_XClient.deprecationWarned) {
+      console.warn(
+        "[@blockrun/llm] XClient: BlockRun's /v1/x/* (AttentionVC) integration was removed 2026-04-30. All calls will return HTTP 404 until a replacement X data upstream is reintroduced."
+      );
+      _XClient.deprecationWarned = true;
+    }
     const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
     const privateKey = options.privateKey || envKey;
     if (!privateKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music) via x402 on Base and Solana",
   "main": "dist/index.cjs",