@blockrun/llm 1.12.0 → 1.15.0

package/README.md

@@ -1,6 +1,8 @@
 # @blockrun/llm (TypeScript SDK)
 
 > **@blockrun/llm** is a TypeScript/Node.js SDK for accessing 41+ large language models (GPT-5, Claude, Gemini, Grok, DeepSeek, Kimi, and more) with automatic pay-per-request USDC micropayments via the x402 protocol. No API keys required — your wallet signature is your authentication. Supports **streaming**, smart routing, Base and Solana chains.
+>
+> 🆓 **Includes 9 fully-free NVIDIA-hosted models** — DeepSeek V4 Pro/Flash (1M context), Nemotron Nano Omni (vision), Qwen3, Llama 4, GLM-4.7, Mistral. Zero USDC, no rate-limit gimmicks. Use `routingProfile: 'free'` or call any `nvidia/*` model directly.
 
 [![npm](https://img.shields.io/npm/v/@blockrun/llm.svg)](https://www.npmjs.com/package/@blockrun/llm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
@@ -39,6 +41,41 @@ const response = await client.chat('openai/gpt-4o', 'Hello!');
 
 That's it. The SDK handles x402 payment automatically.
 
+### Try It Free (No USDC Required)
+
+Want to kick the tires before funding a wallet? Route to BlockRun's free NVIDIA tier:
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient();  // Wallet still required for signing, but $0 charged
+
+// Option 1: call a free model directly
+const reply = await client.chat('nvidia/qwen3-next-80b-a3b-thinking', 'Explain x402 in 1 sentence');
+
+// Option 2: let the smart router pick the best free model per request
+const result = await client.smartChat('What is 2+2?', { routingProfile: 'free' });
+console.log(result.model);     // e.g. 'nvidia/deepseek-v4-flash' (cheapest capable for SIMPLE tier)
+console.log(result.response);  // '4'
+```
+
+**Available free models** (input + output both $0, all NVIDIA-hosted, last refreshed 2026-04-28):
+
+| Model ID | Context | Best For |
+|----------|---------|----------|
+| `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/llama-4-maverick` | 131K | Meta Llama 4 Maverick MoE |
+| `nvidia/qwen3-coder-480b` | 131K | Coding-optimised 480B MoE |
+| `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.
+
 ## Quick Start (Solana)
 
 ```typescript
@@ -115,7 +152,7 @@ console.log(complex.model);  // 'xai/grok-4-1-fast-reasoning'
 
 | Profile | Description | Best For |
 |---------|-------------|----------|
-| `free` | nvidia/gpt-oss-120b only (FREE) | Testing, development |
+| `free` | NVIDIA free tier — smart-routes across 9 models (DeepSeek V4 Pro/Flash, Nemotron Nano Omni, Qwen3, GLM-4.7, Llama 4, Mistral) | Zero-cost testing, dev, prod |
 | `eco` | Cheapest models per tier (DeepSeek, xAI) | Cost-sensitive production |
 | `auto` | Best balance of cost/quality (default) | General use |
 | `premium` | Top-tier models (OpenAI, Anthropic) | Quality-critical tasks |
@@ -213,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 |
@@ -245,20 +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-21: retired the Nemotron family, `mistral-large-3-675b`,
-`devstral-2-123b`, and paid `nvidia/kimi-k2.5`. The backend auto-redirects the
-old IDs; the recommended replacements are listed 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/qwen3-next-80b-a3b-thinking` | **FREE** | **FREE** | Reasoning flagship — 116 tok/s, thinking mode |
-| `nvidia/mistral-small-4-119b` | **FREE** | **FREE** | Fastest free chat — 114 tok/s |
-| `nvidia/glm-4.7` | **FREE** | **FREE** | GLM-4.7 with thinking — 237 tok/s |
-| `nvidia/llama-4-maverick` | **FREE** | **FREE** | Llama 4 Maverick MoE |
+| `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/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** | DeepSeek V3.2 hosted |
-| `nvidia/gpt-oss-120b` | **FREE** | **FREE** | OpenAI open-weight 120B — 123 tok/s |
-| `nvidia/gpt-oss-20b` | **FREE** | **FREE** | OpenAI open-weight 20B — 155 tok/s |
+| `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
@@ -544,7 +594,7 @@ const premium = await client.smartChat('Write a legal brief', { routingProfile:
 
 | Profile | Description | Best For |
 |---------|-------------|----------|
-| `free` | NVIDIA free models only | Testing, simple queries |
+| `free` | NVIDIA free tier (9 models, smart-routed) | Zero-cost testing, dev, prod |
 | `eco` | Budget-optimized | Cost-sensitive workloads |
 | `auto` | Intelligent routing (default) | General use |
 | `premium` | Best quality models | Critical tasks |

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) {
@@ -2824,13 +2884,13 @@ var path2 = __toESM(require("path"), 1);
 var os2 = __toESM(require("os"), 1);
 var WALLET_DIR2 = path2.join(os2.homedir(), ".blockrun");
 var SOLANA_WALLET_FILE = path2.join(WALLET_DIR2, ".solana-session");
-function createSolanaWallet() {
-  const { Keypair } = require("@solana/web3.js");
-  const bs58 = require("bs58");
+async function createSolanaWallet() {
+  const { Keypair } = await import("@solana/web3.js");
+  const bs58 = await import("bs58");
   const keypair = Keypair.generate();
   return {
     address: keypair.publicKey.toBase58(),
-    privateKey: bs58.default?.encode(keypair.secretKey) ?? bs58.encode(keypair.secretKey)
+    privateKey: (bs58.default ?? bs58).encode(keypair.secretKey)
   };
 }
 async function solanaKeyToBytes(privateKey) {
@@ -2923,7 +2983,7 @@ async function getOrCreateSolanaWallet() {
       return { privateKey: fileKey, address: address2, isNew: false };
     }
   }
-  const { address, privateKey } = createSolanaWallet();
+  const { address, privateKey } = await createSolanaWallet();
   saveSolanaWallet(privateKey);
   return { address, privateKey, isNew: true };
 }

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>;
@@ -1746,12 +1787,14 @@ interface SolanaWalletInfo {
 }
 /**
  * Create a new Solana wallet.
- * Requires @solana/web3.js (optional dep).
+ * Requires @solana/web3.js (optional dep) — loaded lazily via dynamic
+ * import so callers that never touch Solana don't pay the resolution cost
+ * and ESM consumers don't trip over esbuild's __require shim.
  */
-declare function createSolanaWallet(): {
+declare function createSolanaWallet(): Promise<{
     address: string;
     privateKey: string;
-};
+}>;
 /**
  * Convert a bs58 private key string to Uint8Array (64 bytes).
  * Accepts: bs58-encoded 64-byte key (standard Solana format).

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>;
@@ -1746,12 +1787,14 @@ interface SolanaWalletInfo {
 }
 /**
  * Create a new Solana wallet.
- * Requires @solana/web3.js (optional dep).
+ * Requires @solana/web3.js (optional dep) — loaded lazily via dynamic
+ * import so callers that never touch Solana don't pay the resolution cost
+ * and ESM consumers don't trip over esbuild's __require shim.
  */
-declare function createSolanaWallet(): {
+declare function createSolanaWallet(): Promise<{
     address: string;
     privateKey: string;
-};
+}>;
 /**
  * Convert a bs58 private key string to Uint8Array (64 bytes).
  * Accepts: bs58-encoded 64-byte key (standard Solana format).

package/dist/index.js

@@ -1,10 +1,3 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/client.ts
 import { privateKeyToAccount } from "viem/accounts";
 
@@ -1544,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.
    *
@@ -2176,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) {
@@ -2735,13 +2788,13 @@ 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 } = __require("@solana/web3.js");
-  const bs58 = __require("bs58");
+async function createSolanaWallet() {
+  const { Keypair } = await import("@solana/web3.js");
+  const bs58 = await import("bs58");
   const keypair = Keypair.generate();
   return {
     address: keypair.publicKey.toBase58(),
-    privateKey: bs58.default?.encode(keypair.secretKey) ?? bs58.encode(keypair.secretKey)
+    privateKey: (bs58.default ?? bs58).encode(keypair.secretKey)
   };
 }
 async function solanaKeyToBytes(privateKey) {
@@ -2834,7 +2887,7 @@ async function getOrCreateSolanaWallet() {
       return { privateKey: fileKey, address: address2, isNew: false };
     }
   }
-  const { address, privateKey } = createSolanaWallet();
+  const { address, privateKey } = await createSolanaWallet();
   saveSolanaWallet(privateKey);
   return { address, privateKey, isNew: true };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.12.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",