@blockrun/llm 3.9.0 → 3.10.0

package/README.md

@@ -1,6 +1,6 @@
 # @blockrun/llm (TypeScript SDK)
 
-> **@blockrun/llm** is a TypeScript/Node.js SDK for accessing <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> 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.
+> **@blockrun/llm** is a TypeScript/Node.js SDK for accessing <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> 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 7 fully-free NVIDIA-hosted models** (5 visible in `/v1/models`, 2 hidden but directly callable) — DeepSeek V4 Flash (1M context), Nemotron Nano Omni (vision), Qwen3 Coder, Llama 4, Mistral, plus the gpt-oss pair. Zero USDC, no rate-limit gimmicks. Use `routingProfile: 'free'` or call any `nvidia/*` model directly.
 
@@ -21,7 +21,7 @@
 ## Installation
 
 ```bash
-# Base and Solana support (optional Solana deps auto-installed)
+# Base / EVM payments — nothing else needed
 npm install @blockrun/llm
 # or
 pnpm add @blockrun/llm
@@ -29,6 +29,21 @@ pnpm add @blockrun/llm
 yarn add @blockrun/llm
 ```
 
+**Solana payments** need two more packages. They are optional peer dependencies,
+so npm will not install them for you:
+
+```bash
+npm install @blockrun/llm @solana/web3.js @solana/spl-token
+```
+
+Why they are not automatic: `@solana/spl-token` pulls in `bigint-buffer`, whose
+native `toBigIntLE()` has an unpatched buffer overflow
+([GHSA-3gc7-fjrx-p6mg](https://github.com/advisories/GHSA-3gc7-fjrx-p6mg)) with no
+fixed release anywhere. As an optional *dependency* it landed in the lockfile of
+every consumer, including projects that only ever pay on Base. As an optional
+*peer* it reaches only the projects that ask for Solana. Calling a Solana path
+without them throws an error naming the exact install command.
+
 ## Quick Start (Base - Default)
 
 ```typescript
@@ -263,7 +278,7 @@ const reply = await client.chat('nvidia/deepseek-v4-flash', 'hello', {
 
 | Profile | Description | Best For |
 |---------|-------------|----------|
-| `free` | NVIDIA free tier — smart-routes across <!-- br:models.free -->8<!-- /br:models.free --> models (DeepSeek V4 Flash, Nemotron Nano Omni, Qwen3, Llama 4, Mistral, plus 2 hidden gpt-oss) | Zero-cost testing, dev, prod |
+| `free` | NVIDIA free tier — smart-routes across <!-- br:models.free -->6<!-- /br:models.free --> models (DeepSeek V4 Flash, Nemotron Nano Omni, Qwen3, Llama 4, Mistral, plus 2 hidden gpt-oss) | 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 |
@@ -883,7 +898,7 @@ const premium = await client.smartChat('Write a legal brief', { routingProfile:
 
 | Profile | Description | Best For |
 |---------|-------------|----------|
-| `free` | NVIDIA free tier (<!-- br:models.free -->8<!-- /br:models.free --> models, smart-routed) | Zero-cost testing, dev, prod |
+| `free` | NVIDIA free tier (<!-- br:models.free -->6<!-- /br:models.free --> 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

@@ -48,6 +48,7 @@ __export(index_exports, {
   PortraitClient: () => PortraitClient,
   PriceClient: () => PriceClient,
   RPC_PRICE_USD: () => RPC_PRICE_USD,
+  RetiredEndpointError: () => RetiredEndpointError,
   RpcClient: () => RpcClient,
   SOLANA_NETWORK: () => SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH: () => SOLANA_WALLET_FILE,
@@ -121,6 +122,12 @@ var BlockrunError = class extends Error {
     this.name = "BlockrunError";
   }
 };
+var RetiredEndpointError = class extends BlockrunError {
+  constructor(message) {
+    super(message);
+    this.name = "RetiredEndpointError";
+  }
+};
 var PaymentError = class extends BlockrunError {
   constructor(message) {
     super(message);
@@ -140,6 +147,35 @@ var APIError = class extends BlockrunError {
 
 // src/x402.ts
 var import_accounts = require("viem/accounts");
+
+// src/solana-deps.ts
+var INSTALL_HINT = "npm install @solana/web3.js @solana/spl-token   (or pnpm add / yarn add)";
+function missing(pkg, what, cause) {
+  return new Error(
+    `@blockrun/llm: ${what} requires the optional peer dependency "${pkg}", which is not installed.
+
+  ${INSTALL_HINT}
+
+Solana packages are optional peers so that consumers who only use Base/EVM payments do not inherit them. If you only make Base payments, you should not be reaching this code path \u2014 check which chain you passed.
+Original error: ${cause instanceof Error ? cause.message : String(cause)}`
+  );
+}
+async function loadSolanaWeb3(what) {
+  try {
+    return await import("@solana/web3.js");
+  } catch (err) {
+    throw missing("@solana/web3.js", what, err);
+  }
+}
+async function loadSplToken(what) {
+  try {
+    return await import("@solana/spl-token");
+  } catch (err) {
+    throw missing("@solana/spl-token", what, err);
+  }
+}
+
+// src/x402.ts
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
@@ -268,9 +304,17 @@ 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("@solana/web3.js");
-  const { getAssociatedTokenAddress, createTransferCheckedInstruction } = await import("@solana/spl-token");
-  const { Keypair } = await import("@solana/web3.js");
+  const {
+    Connection,
+    PublicKey,
+    TransactionMessage,
+    VersionedTransaction,
+    ComputeBudgetProgram,
+    Keypair
+  } = await loadSolanaWeb3("createSolanaPaymentPayload()");
+  const { getAssociatedTokenAddress, createTransferCheckedInstruction } = await loadSplToken(
+    "createSolanaPaymentPayload()"
+  );
   const rpcUrl = options.rpcUrl || "https://sol.blockrun.ai/api/v1/solana/rpc";
   const connection = options.rpcHeaders ? new Connection(rpcUrl, { httpHeaders: options.rpcHeaders }) : new Connection(rpcUrl);
   const keypair = Keypair.fromSecretKey(secretKey);
@@ -564,7 +608,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.9.0";
+var SDK_VERSION = "3.10.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -1783,20 +1827,38 @@ var LLMClient = class _LLMClient {
   }
   // ── 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);
+  /** RETIRED — `/v1/pm/markets` no longer exists.
+   *
+   * Predexon sunset market matching on 2026-07-20 and the whole canonical layer
+   * went with it, so this path returns 410 upstream. Use
+   * `pm("markets/search", { q })` for cross-venue lookups.
+   *
+   * Kept as a throwing stub rather than deleted so upgrading does not break
+   * property access; it throws before any network I/O.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmMarkets(_params) {
+    throw new RetiredEndpointError(
+      '/v1/pm/markets was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
-  /** 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);
+  /** RETIRED — `/v1/pm/markets/listings` no longer exists (410, sunset
+   * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmListings(_params) {
+    throw new RetiredEndpointError(
+      '/v1/pm/markets/listings was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
-  /** 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}`);
+  /** RETIRED — `/v1/pm/outcomes/{predexonId}` no longer exists (410, sunset
+   * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmOutcome(_predexonId) {
+    throw new RetiredEndpointError(
+      '/v1/pm/outcomes/{predexon_id} was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
   /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
    * Tier 1 ($0.001/call). */
@@ -1808,12 +1870,18 @@ var LLMClient = class _LLMClient {
   async pmPolymarketEventsKeyset(params) {
     return this.pm("polymarket/events/keyset", params);
   }
-  /** List available sports categories. Tier 1 ($0.001/call). */
+  /** List available sports categories. Tier 1 ($0.001/call).
+   *
+   * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04.
+   * The route still resolves, so this works again the moment Predexon restores
+   * it, but do not build on it yet. */
   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). */
+   * status, venue. Tier 1 ($0.001/call).
+   *
+   * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04. */
   async pmSportsMarkets(params) {
     return this.pm("sports/markets", params);
   }
@@ -4894,7 +4962,7 @@ var os3 = __toESM(require("os"), 1);
 var WALLET_DIR2 = path3.join(os3.homedir(), ".blockrun");
 var SOLANA_WALLET_FILE = path3.join(WALLET_DIR2, ".solana-session");
 async function createSolanaWallet() {
-  const { Keypair } = await import("@solana/web3.js");
+  const { Keypair } = await loadSolanaWeb3("Solana wallet operations");
   const bs58 = await import("bs58");
   const keypair = Keypair.generate();
   return {
@@ -4951,7 +5019,7 @@ async function solanaKeyToBytes(privateKey) {
   }
 }
 async function solanaPublicKey(privateKey) {
-  const { Keypair } = await import("@solana/web3.js");
+  const { Keypair } = await loadSolanaWeb3("Solana wallet operations");
   const bytes = await solanaKeyToBytes(privateKey);
   return Keypair.fromSecretKey(bytes).publicKey.toBase58();
 }
@@ -6245,6 +6313,7 @@ var AnthropicClient = class {
   PortraitClient,
   PriceClient,
   RPC_PRICE_USD,
+  RetiredEndpointError,
   RpcClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH,

package/dist/index.d.cts

@@ -947,6 +947,16 @@ interface PollOptions {
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown by a helper whose upstream endpoint no longer exists.
+ *
+ * Kept as a throwing method rather than deleted so upgrading does not break
+ * imports or property access — the failure is explicit and immediate instead of
+ * a round trip that returns 410/404.
+ */
+declare class RetiredEndpointError extends BlockrunError {
+    constructor(message: string);
+}
 declare class PaymentError extends BlockrunError {
     constructor(message: string);
 }
@@ -1284,25 +1294,43 @@ declare class LLMClient {
      * });
      */
     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>>;
+    /** RETIRED — `/v1/pm/markets` no longer exists.
+     *
+     * Predexon sunset market matching on 2026-07-20 and the whole canonical layer
+     * went with it, so this path returns 410 upstream. Use
+     * `pm("markets/search", { q })` for cross-venue lookups.
+     *
+     * Kept as a throwing stub rather than deleted so upgrading does not break
+     * property access; it throws before any network I/O.
+     *
+     * @throws {RetiredEndpointError} always. */
+    pmMarkets(_params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** RETIRED — `/v1/pm/markets/listings` no longer exists (410, sunset
+     * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+     *
+     * @throws {RetiredEndpointError} always. */
+    pmListings(_params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** RETIRED — `/v1/pm/outcomes/{predexonId}` no longer exists (410, sunset
+     * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+     *
+     * @throws {RetiredEndpointError} always. */
+    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). */
+    /** List available sports categories. Tier 1 ($0.001/call).
+     *
+     * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04.
+     * The route still resolves, so this works again the moment Predexon restores
+     * it, but do not build on it yet. */
     pmSportsCategories(): Promise<Record<string, unknown>>;
     /** List sports markets grouped by game. Filter with league, sport_type,
-     * status, venue. Tier 1 ($0.001/call). */
+     * status, venue. Tier 1 ($0.001/call).
+     *
+     * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04. */
     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). */
@@ -3210,4 +3238,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, type RoutingDecision, type RoutingProfile, type RoutingTier, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTier, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.d.ts

@@ -947,6 +947,16 @@ interface PollOptions {
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown by a helper whose upstream endpoint no longer exists.
+ *
+ * Kept as a throwing method rather than deleted so upgrading does not break
+ * imports or property access — the failure is explicit and immediate instead of
+ * a round trip that returns 410/404.
+ */
+declare class RetiredEndpointError extends BlockrunError {
+    constructor(message: string);
+}
 declare class PaymentError extends BlockrunError {
     constructor(message: string);
 }
@@ -1284,25 +1294,43 @@ declare class LLMClient {
      * });
      */
     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>>;
+    /** RETIRED — `/v1/pm/markets` no longer exists.
+     *
+     * Predexon sunset market matching on 2026-07-20 and the whole canonical layer
+     * went with it, so this path returns 410 upstream. Use
+     * `pm("markets/search", { q })` for cross-venue lookups.
+     *
+     * Kept as a throwing stub rather than deleted so upgrading does not break
+     * property access; it throws before any network I/O.
+     *
+     * @throws {RetiredEndpointError} always. */
+    pmMarkets(_params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** RETIRED — `/v1/pm/markets/listings` no longer exists (410, sunset
+     * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+     *
+     * @throws {RetiredEndpointError} always. */
+    pmListings(_params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** RETIRED — `/v1/pm/outcomes/{predexonId}` no longer exists (410, sunset
+     * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+     *
+     * @throws {RetiredEndpointError} always. */
+    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). */
+    /** List available sports categories. Tier 1 ($0.001/call).
+     *
+     * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04.
+     * The route still resolves, so this works again the moment Predexon restores
+     * it, but do not build on it yet. */
     pmSportsCategories(): Promise<Record<string, unknown>>;
     /** List sports markets grouped by game. Filter with league, sport_type,
-     * status, venue. Tier 1 ($0.001/call). */
+     * status, venue. Tier 1 ($0.001/call).
+     *
+     * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04. */
     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). */
@@ -3210,4 +3238,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, type RoutingDecision, type RoutingProfile, type RoutingTier, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTier, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.js

@@ -8,6 +8,12 @@ var BlockrunError = class extends Error {
     this.name = "BlockrunError";
   }
 };
+var RetiredEndpointError = class extends BlockrunError {
+  constructor(message) {
+    super(message);
+    this.name = "RetiredEndpointError";
+  }
+};
 var PaymentError = class extends BlockrunError {
   constructor(message) {
     super(message);
@@ -27,6 +33,35 @@ var APIError = class extends BlockrunError {
 
 // src/x402.ts
 import { signTypedData } from "viem/accounts";
+
+// src/solana-deps.ts
+var INSTALL_HINT = "npm install @solana/web3.js @solana/spl-token   (or pnpm add / yarn add)";
+function missing(pkg, what, cause) {
+  return new Error(
+    `@blockrun/llm: ${what} requires the optional peer dependency "${pkg}", which is not installed.
+
+  ${INSTALL_HINT}
+
+Solana packages are optional peers so that consumers who only use Base/EVM payments do not inherit them. If you only make Base payments, you should not be reaching this code path \u2014 check which chain you passed.
+Original error: ${cause instanceof Error ? cause.message : String(cause)}`
+  );
+}
+async function loadSolanaWeb3(what) {
+  try {
+    return await import("@solana/web3.js");
+  } catch (err) {
+    throw missing("@solana/web3.js", what, err);
+  }
+}
+async function loadSplToken(what) {
+  try {
+    return await import("@solana/spl-token");
+  } catch (err) {
+    throw missing("@solana/spl-token", what, err);
+  }
+}
+
+// src/x402.ts
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
@@ -155,9 +190,17 @@ 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("@solana/web3.js");
-  const { getAssociatedTokenAddress, createTransferCheckedInstruction } = await import("@solana/spl-token");
-  const { Keypair } = await import("@solana/web3.js");
+  const {
+    Connection,
+    PublicKey,
+    TransactionMessage,
+    VersionedTransaction,
+    ComputeBudgetProgram,
+    Keypair
+  } = await loadSolanaWeb3("createSolanaPaymentPayload()");
+  const { getAssociatedTokenAddress, createTransferCheckedInstruction } = await loadSplToken(
+    "createSolanaPaymentPayload()"
+  );
   const rpcUrl = options.rpcUrl || "https://sol.blockrun.ai/api/v1/solana/rpc";
   const connection = options.rpcHeaders ? new Connection(rpcUrl, { httpHeaders: options.rpcHeaders }) : new Connection(rpcUrl);
   const keypair = Keypair.fromSecretKey(secretKey);
@@ -451,7 +494,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.9.0";
+var SDK_VERSION = "3.10.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -1670,20 +1713,38 @@ var LLMClient = class _LLMClient {
   }
   // ── 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);
+  /** RETIRED — `/v1/pm/markets` no longer exists.
+   *
+   * Predexon sunset market matching on 2026-07-20 and the whole canonical layer
+   * went with it, so this path returns 410 upstream. Use
+   * `pm("markets/search", { q })` for cross-venue lookups.
+   *
+   * Kept as a throwing stub rather than deleted so upgrading does not break
+   * property access; it throws before any network I/O.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmMarkets(_params) {
+    throw new RetiredEndpointError(
+      '/v1/pm/markets was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
-  /** 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);
+  /** RETIRED — `/v1/pm/markets/listings` no longer exists (410, sunset
+   * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmListings(_params) {
+    throw new RetiredEndpointError(
+      '/v1/pm/markets/listings was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
-  /** 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}`);
+  /** RETIRED — `/v1/pm/outcomes/{predexonId}` no longer exists (410, sunset
+   * 2026-07-20 with market matching). Use `pm("markets/search", { q })`.
+   *
+   * @throws {RetiredEndpointError} always. */
+  async pmOutcome(_predexonId) {
+    throw new RetiredEndpointError(
+      '/v1/pm/outcomes/{predexon_id} was sunset by Predexon on 2026-07-20 (upstream 410). Use pm("markets/search", { q }) for cross-venue lookups.'
+    );
   }
   /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
    * Tier 1 ($0.001/call). */
@@ -1695,12 +1756,18 @@ var LLMClient = class _LLMClient {
   async pmPolymarketEventsKeyset(params) {
     return this.pm("polymarket/events/keyset", params);
   }
-  /** List available sports categories. Tier 1 ($0.001/call). */
+  /** List available sports categories. Tier 1 ($0.001/call).
+   *
+   * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04.
+   * The route still resolves, so this works again the moment Predexon restores
+   * it, but do not build on it yet. */
   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). */
+   * status, venue. Tier 1 ($0.001/call).
+   *
+   * NOTE: upstream returns 500 for every `sports/*` path as of 2026-08-04. */
   async pmSportsMarkets(params) {
     return this.pm("sports/markets", params);
   }
@@ -4781,7 +4848,7 @@ import * as os3 from "os";
 var WALLET_DIR2 = path3.join(os3.homedir(), ".blockrun");
 var SOLANA_WALLET_FILE = path3.join(WALLET_DIR2, ".solana-session");
 async function createSolanaWallet() {
-  const { Keypair } = await import("@solana/web3.js");
+  const { Keypair } = await loadSolanaWeb3("Solana wallet operations");
   const bs58 = await import("bs58");
   const keypair = Keypair.generate();
   return {
@@ -4838,7 +4905,7 @@ async function solanaKeyToBytes(privateKey) {
   }
 }
 async function solanaPublicKey(privateKey) {
-  const { Keypair } = await import("@solana/web3.js");
+  const { Keypair } = await loadSolanaWeb3("Solana wallet operations");
   const bytes = await solanaKeyToBytes(privateKey);
   return Keypair.fromSecretKey(bytes).publicKey.toBase58();
 }
@@ -6131,6 +6198,7 @@ export {
   PortraitClient,
   PriceClient,
   RPC_PRICE_USD,
+  RetiredEndpointError,
   RpcClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.9.0",
+  "version": "3.10.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",
@@ -52,9 +52,7 @@
     "viem": "^2.49.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@solana/spl-token": "^0.4.14",
-    "@solana/web3.js": "^1.98.4"
+    "@anthropic-ai/sdk": "^0.39.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
@@ -77,11 +75,19 @@
   },
   "packageManager": "pnpm@9.15.4",
   "peerDependencies": {
-    "@blockrun/clawrouter": "^0.12.222"
+    "@blockrun/clawrouter": "^0.12.222",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4"
   },
   "peerDependenciesMeta": {
     "@blockrun/clawrouter": {
       "optional": true
+    },
+    "@solana/spl-token": {
+      "optional": true
+    },
+    "@solana/web3.js": {
+      "optional": true
     }
   }
 }