@blockrun/llm 1.3.1 → 1.4.0

package/README.md

@@ -5,12 +5,16 @@
 [![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)
 
-**Networks:**
-- **Base Mainnet:** Chain ID 8453 - Production with real USDC
-- **Base Sepolia (Testnet):** Chain ID 84532 - Developer testing with testnet USDC
-- **Solana Mainnet** - Production with real USDC
+## Supported Chains
+
+| Chain | Network | Payment | Status |
+|-------|---------|---------|--------|
+| **Base** | Base Mainnet (Chain ID: 8453) | USDC | Primary |
+| **Base Testnet** | Base Sepolia (Chain ID: 84532) | Testnet USDC | Development |
+| **Solana** | Solana Mainnet | USDC (SPL) | New |
+
+> **XRPL (RLUSD):** Use [@blockrun/llm-xrpl](https://www.npmjs.com/package/@blockrun/llm-xrpl) for XRPL payments
 
-**Payment:** USDC
 **Protocol:** x402 v2 (CDP Facilitator)
 
 ## Installation
@@ -87,6 +91,64 @@ const tweet = await client.chat('xai/grok-3-mini', 'What is trending on X?', { s
 
 **Your private key never leaves your machine** - it's only used for local signing.
 
+## Smart Routing (ClawRouter)
+
+Let the SDK automatically pick the cheapest capable model for each request:
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient();
+
+// Auto-routes to cheapest capable model
+const result = await client.smartChat('What is 2+2?');
+console.log(result.response);     // '4'
+console.log(result.model);        // 'nvidia/kimi-k2.5' (cheap, fast)
+console.log(`Saved ${(result.routing.savings * 100).toFixed(0)}%`); // 'Saved 78%'
+
+// Complex reasoning task -> routes to reasoning model
+const complex = await client.smartChat('Prove the Riemann hypothesis step by step');
+console.log(complex.model);  // 'xai/grok-4-1-fast-reasoning'
+```
+
+### Routing Profiles
+
+| Profile | Description | Best For |
+|---------|-------------|----------|
+| `free` | nvidia/gpt-oss-120b only (FREE) | Testing, development |
+| `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 |
+
+```typescript
+// Use premium models for complex tasks
+const result = await client.smartChat(
+  'Write production-grade async TypeScript code',
+  { routingProfile: 'premium' }
+);
+console.log(result.model);  // 'anthropic/claude-opus-4.5'
+```
+
+### How ClawRouter Works
+
+ClawRouter uses a 14-dimension rule-based classifier to analyze each request:
+
+- **Token count** - Short vs long prompts
+- **Code presence** - Programming keywords
+- **Reasoning markers** - "prove", "step by step", etc.
+- **Technical terms** - Architecture, optimization, etc.
+- **Creative markers** - Story, poem, brainstorm, etc.
+- **Agentic patterns** - Multi-step, tool use indicators
+
+The classifier runs in <1ms, 100% locally, and routes to one of four tiers:
+
+| Tier | Example Tasks | Auto Profile Model |
+|------|---------------|-------------------|
+| SIMPLE | "What is 2+2?", definitions | nvidia/kimi-k2.5 |
+| MEDIUM | Code snippets, explanations | xai/grok-code-fast-1 |
+| COMPLEX | Architecture, long documents | google/gemini-3.1-pro |
+| REASONING | Proofs, multi-step reasoning | xai/grok-4-1-fast-reasoning |
+
 ## Available Models
 
 ### OpenAI GPT-5 Family
@@ -203,6 +265,78 @@ All models below have been tested end-to-end via the TypeScript SDK (Feb 2026):
 
 *Testnet models use flat pricing (no token counting) for simplicity.*
 
+## X/Twitter Data (Powered by AttentionVC)
+
+Access X/Twitter user profiles, followers, and followings via [AttentionVC](https://attentionvc.ai) partner API. No API keys needed — pay-per-request via x402.
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient();
+
+// Look up user profiles ($0.002/user, min $0.02)
+const users = await client.xUserLookup(['elonmusk', 'blockaborr']);
+for (const user of users.users) {
+  console.log(`@${user.userName}: ${user.followers} followers`);
+}
+
+// Get followers ($0.05/page, ~200 accounts)
+let result = await client.xFollowers('blockaborr');
+for (const f of result.followers) {
+  console.log(`  @${f.screen_name}`);
+}
+
+// Paginate through all followers
+while (result.has_next_page) {
+  result = await client.xFollowers('blockaborr', result.next_cursor);
+}
+
+// Get followings ($0.05/page)
+const followings = await client.xFollowings('blockaborr');
+```
+
+Works on both `LLMClient` (Base) and `SolanaLLMClient`.
+
+## Standalone Search
+
+Search web, X/Twitter, and news without using a chat model:
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient();
+
+const result = await client.search('latest AI agent frameworks 2026');
+console.log(result.summary);
+for (const cite of result.citations ?? []) {
+  console.log(`  - ${cite}`);
+}
+
+// Filter by source type and date range
+const filtered = await client.search('BlockRun x402', {
+  sources: ['web', 'x'],
+  fromDate: '2026-01-01',
+  maxResults: 5,
+});
+```
+
+## Image Editing (img2img)
+
+Edit existing images with text prompts:
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient();
+
+const result = await client.imageEdit(
+  'Make the sky purple and add northern lights',
+  'data:image/png;base64,...',  // base64 or URL
+  { model: 'openai/gpt-image-1' }
+);
+console.log(result.data[0].url);
+```
+
 ## Testnet Usage
 
 For development and testing without real USDC, use the testnet:
@@ -636,6 +770,32 @@ console.log(`Calls: ${summary.calls}`);
 console.log(`By model:`, summary.byModel);
 ```
 
+## Anthropic SDK Compatibility
+
+Use the official Anthropic SDK interface with BlockRun's pay-per-request backend:
+
+```typescript
+import { AnthropicClient } from '@blockrun/llm';
+
+const client = new AnthropicClient();  // Auto-detects wallet, auto-pays
+
+const response = await client.messages.create({
+  model: 'claude-sonnet-4-6',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Hello!' }],
+});
+console.log(response.content[0].text);
+
+// Any model works in Anthropic format
+const gptResponse = await client.messages.create({
+  model: 'openai/gpt-5.4',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Hello from GPT!' }],
+});
+```
+
+The `AnthropicClient` wraps the official `@anthropic-ai/sdk` with a custom fetch that handles x402 payment automatically. Your private key never leaves your machine.
+
 ## Links
 
 - [Website](https://blockrun.ai)

package/dist/index.cjs

@@ -11119,7 +11119,7 @@ function exportNodeCompatibleHeaders(headers) {
   return obj;
 }
 function createHeadersLenient(obj) {
-  const headers = new Headers();
+  const headers = new Headers2();
   for (const name of Object.keys(obj)) {
     if (invalidTokenRegex.test(name)) {
       continue;
@@ -11156,7 +11156,7 @@ function isAbortSignal(signal) {
 }
 function getNodeRequestOptions(request) {
   const parsedURL = request[INTERNALS$2].parsedURL;
-  const headers = new Headers(request[INTERNALS$2].headers);
+  const headers = new Headers2(request[INTERNALS$2].headers);
   if (!headers.has("Accept")) {
     headers.set("Accept", "*/*");
   }
@@ -11316,7 +11316,7 @@ function fetch2(url2, opts) {
               return;
             }
             const requestOpts = {
-              headers: new Headers(request.headers),
+              headers: new Headers2(request.headers),
               follow: request.follow,
               counter: request.counter + 1,
               agent: request.agent,
@@ -11434,7 +11434,7 @@ function destroyStream(stream, err) {
     stream.end();
   }
 }
-var import_stream, import_http, import_url, import_whatwg_url, import_https, import_zlib, Readable, BUFFER, TYPE2, Blob2, convert, INTERNALS, PassThrough, invalidTokenRegex, invalidHeaderCharRegex, MAP, Headers, INTERNAL, HeadersIteratorPrototype, INTERNALS$1, STATUS_CODES, Response, INTERNALS$2, URL3, parse_url, format_url, streamDestructionSupported, Request, URL$1, PassThrough$1, isDomainOrSubdomain, isSameProtocol, lib_default;
+var import_stream, import_http, import_url, import_whatwg_url, import_https, import_zlib, Readable, BUFFER, TYPE2, Blob2, convert, INTERNALS, PassThrough, invalidTokenRegex, invalidHeaderCharRegex, MAP, Headers2, INTERNAL, HeadersIteratorPrototype, INTERNALS$1, STATUS_CODES, Response, INTERNALS$2, URL3, parse_url, format_url, streamDestructionSupported, Request, URL$1, PassThrough$1, isDomainOrSubdomain, isSameProtocol, lib_default;
 var init_lib = __esm({
   "node_modules/.pnpm/node-fetch@2.7.0/node_modules/node-fetch/lib/index.mjs"() {
     "use strict";
@@ -11655,7 +11655,7 @@ var init_lib = __esm({
     invalidTokenRegex = /[^\^_`a-zA-Z\-0-9!#$%&'*+.|~]/;
     invalidHeaderCharRegex = /[^\t\x20-\x7e\x80-\xff]/;
     MAP = /* @__PURE__ */ Symbol("map");
-    Headers = class _Headers {
+    Headers2 = class _Headers {
       /**
        * Headers class
        *
@@ -11833,14 +11833,14 @@ var init_lib = __esm({
         return createHeadersIterator(this, "key+value");
       }
     };
-    Headers.prototype.entries = Headers.prototype[Symbol.iterator];
-    Object.defineProperty(Headers.prototype, Symbol.toStringTag, {
+    Headers2.prototype.entries = Headers2.prototype[Symbol.iterator];
+    Object.defineProperty(Headers2.prototype, Symbol.toStringTag, {
       value: "Headers",
       writable: false,
       enumerable: false,
       configurable: true
     });
-    Object.defineProperties(Headers.prototype, {
+    Object.defineProperties(Headers2.prototype, {
       get: { enumerable: true },
       forEach: { enumerable: true },
       set: { enumerable: true },
@@ -11888,7 +11888,7 @@ var init_lib = __esm({
         let opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         Body.call(this, body, opts);
         const status2 = opts.status || 200;
-        const headers = new Headers(opts.headers);
+        const headers = new Headers2(opts.headers);
         if (body != null && !headers.has("Content-Type")) {
           const contentType = extractContentType(body);
           if (contentType) {
@@ -11985,7 +11985,7 @@ var init_lib = __esm({
           timeout: init.timeout || input.timeout || 0,
           size: init.size || input.size || 0
         });
-        const headers = new Headers(init.headers || input.headers || {});
+        const headers = new Headers2(init.headers || input.headers || {});
         if (inputBody != null && !headers.has("Content-Type")) {
           const contentType = extractContentType(inputBody);
           if (contentType) {
@@ -36420,6 +36420,7 @@ var init_esm4 = __esm({
 var index_exports = {};
 __export(index_exports, {
   APIError: () => APIError,
+  AnthropicClient: () => AnthropicClient,
   BASE_CHAIN_ID: () => BASE_CHAIN_ID,
   BlockrunError: () => BlockrunError,
   ImageClient: () => ImageClient,
@@ -39016,9 +39017,119 @@ var OpenAI = class {
     return this.client.getWalletAddress();
   }
 };
+
+// src/anthropic-compat.ts
+var import_accounts5 = require("viem/accounts");
+var AnthropicClient = class {
+  _client = null;
+  _clientPromise = null;
+  _privateKey;
+  _account;
+  _apiUrl;
+  _timeout;
+  constructor(options = {}) {
+    const wallet = getOrCreateWallet();
+    const key = options.privateKey ?? wallet.privateKey;
+    validatePrivateKey(key);
+    this._privateKey = key;
+    this._account = (0, import_accounts5.privateKeyToAccount)(this._privateKey);
+    const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
+    validateApiUrl(apiUrl);
+    this._apiUrl = apiUrl.replace(/\/$/, "");
+    this._timeout = options.timeout ?? 6e4;
+  }
+  async _getClient() {
+    if (this._client) return this._client;
+    if (this._clientPromise) return this._clientPromise;
+    this._clientPromise = (async () => {
+      const { default: Anthropic } = await import("@anthropic-ai/sdk");
+      this._client = new Anthropic({
+        baseURL: this._apiUrl,
+        apiKey: "blockrun",
+        fetch: this._x402Fetch.bind(this)
+      });
+      return this._client;
+    })();
+    return this._clientPromise;
+  }
+  async _x402Fetch(input, init) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+    try {
+      const mergedInit = { ...init, signal: controller.signal };
+      let response = await globalThis.fetch(input, mergedInit);
+      if (response.status === 402) {
+        let paymentHeader = response.headers.get("payment-required");
+        if (!paymentHeader) {
+          try {
+            const respBody = await response.json();
+            if (respBody.x402 || respBody.accepts) {
+              paymentHeader = btoa(JSON.stringify(respBody));
+            }
+          } catch {
+          }
+        }
+        if (!paymentHeader) {
+          throw new Error("402 response but no payment requirements found");
+        }
+        const paymentRequired = parsePaymentRequired(paymentHeader);
+        const details = extractPaymentDetails(paymentRequired);
+        const extensions = paymentRequired.extensions;
+        const paymentPayload = await createPaymentPayload(
+          this._privateKey,
+          this._account.address,
+          details.recipient,
+          details.amount,
+          details.network || "eip155:8453",
+          {
+            resourceUrl: validateResourceUrl(
+              details.resource?.url || `${this._apiUrl}/v1/messages`,
+              this._apiUrl
+            ),
+            resourceDescription: details.resource?.description || "BlockRun AI API call",
+            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            extra: details.extra,
+            extensions
+          }
+        );
+        const newHeaders = new Headers(init?.headers);
+        newHeaders.set("PAYMENT-SIGNATURE", paymentPayload);
+        response = await globalThis.fetch(input, {
+          ...init,
+          headers: newHeaders,
+          signal: controller.signal
+        });
+        if (response.status === 402) {
+          throw new Error(
+            "Payment was rejected. Check your wallet balance."
+          );
+        }
+      }
+      return response;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  get messages() {
+    const handler = {
+      get: (_target, prop) => {
+        return async (...args) => {
+          const client = await this._getClient();
+          const messages = client.messages;
+          return messages[prop](...args);
+        };
+      }
+    };
+    return new Proxy({}, handler);
+  }
+  getWalletAddress() {
+    return this._account.address;
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APIError,
+  AnthropicClient,
   BASE_CHAIN_ID,
   BlockrunError,
   ImageClient,

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import * as _anthropic_ai_sdk from '@anthropic-ai/sdk';
+
 /**
  * Type definitions for BlockRun LLM SDK
  */
@@ -1319,4 +1321,23 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+interface BlockRunAnthropicOptions {
+    privateKey?: `0x${string}` | string;
+    apiUrl?: string;
+    timeout?: number;
+}
+declare class AnthropicClient {
+    private _client;
+    private _clientPromise;
+    private _privateKey;
+    private _account;
+    private _apiUrl;
+    private _timeout;
+    constructor(options?: BlockRunAnthropicOptions);
+    private _getClient;
+    private _x402Fetch;
+    get messages(): _anthropic_ai_sdk.default['messages'];
+    getWalletAddress(): string;
+}
+
+export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as _anthropic_ai_sdk from '@anthropic-ai/sdk';
+
 /**
  * Type definitions for BlockRun LLM SDK
  */
@@ -1319,4 +1321,23 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+interface BlockRunAnthropicOptions {
+    privateKey?: `0x${string}` | string;
+    apiUrl?: string;
+    timeout?: number;
+}
+declare class AnthropicClient {
+    private _client;
+    private _clientPromise;
+    private _privateKey;
+    private _account;
+    private _apiUrl;
+    private _timeout;
+    constructor(options?: BlockRunAnthropicOptions);
+    private _getClient;
+    private _x402Fetch;
+    get messages(): _anthropic_ai_sdk.default['messages'];
+    getWalletAddress(): string;
+}
+
+export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };

package/dist/index.js

@@ -2552,8 +2552,118 @@ var OpenAI = class {
     return this.client.getWalletAddress();
   }
 };
+
+// src/anthropic-compat.ts
+import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
+var AnthropicClient = class {
+  _client = null;
+  _clientPromise = null;
+  _privateKey;
+  _account;
+  _apiUrl;
+  _timeout;
+  constructor(options = {}) {
+    const wallet = getOrCreateWallet();
+    const key = options.privateKey ?? wallet.privateKey;
+    validatePrivateKey(key);
+    this._privateKey = key;
+    this._account = privateKeyToAccount4(this._privateKey);
+    const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
+    validateApiUrl(apiUrl);
+    this._apiUrl = apiUrl.replace(/\/$/, "");
+    this._timeout = options.timeout ?? 6e4;
+  }
+  async _getClient() {
+    if (this._client) return this._client;
+    if (this._clientPromise) return this._clientPromise;
+    this._clientPromise = (async () => {
+      const { default: Anthropic } = await import("@anthropic-ai/sdk");
+      this._client = new Anthropic({
+        baseURL: this._apiUrl,
+        apiKey: "blockrun",
+        fetch: this._x402Fetch.bind(this)
+      });
+      return this._client;
+    })();
+    return this._clientPromise;
+  }
+  async _x402Fetch(input, init) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+    try {
+      const mergedInit = { ...init, signal: controller.signal };
+      let response = await globalThis.fetch(input, mergedInit);
+      if (response.status === 402) {
+        let paymentHeader = response.headers.get("payment-required");
+        if (!paymentHeader) {
+          try {
+            const respBody = await response.json();
+            if (respBody.x402 || respBody.accepts) {
+              paymentHeader = btoa(JSON.stringify(respBody));
+            }
+          } catch {
+          }
+        }
+        if (!paymentHeader) {
+          throw new Error("402 response but no payment requirements found");
+        }
+        const paymentRequired = parsePaymentRequired(paymentHeader);
+        const details = extractPaymentDetails(paymentRequired);
+        const extensions = paymentRequired.extensions;
+        const paymentPayload = await createPaymentPayload(
+          this._privateKey,
+          this._account.address,
+          details.recipient,
+          details.amount,
+          details.network || "eip155:8453",
+          {
+            resourceUrl: validateResourceUrl(
+              details.resource?.url || `${this._apiUrl}/v1/messages`,
+              this._apiUrl
+            ),
+            resourceDescription: details.resource?.description || "BlockRun AI API call",
+            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            extra: details.extra,
+            extensions
+          }
+        );
+        const newHeaders = new Headers(init?.headers);
+        newHeaders.set("PAYMENT-SIGNATURE", paymentPayload);
+        response = await globalThis.fetch(input, {
+          ...init,
+          headers: newHeaders,
+          signal: controller.signal
+        });
+        if (response.status === 402) {
+          throw new Error(
+            "Payment was rejected. Check your wallet balance."
+          );
+        }
+      }
+      return response;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  get messages() {
+    const handler = {
+      get: (_target, prop) => {
+        return async (...args) => {
+          const client = await this._getClient();
+          const messages = client.messages;
+          return messages[prop](...args);
+        };
+      }
+    };
+    return new Proxy({}, handler);
+  }
+  getWalletAddress() {
+    return this._account.address;
+  }
+};
 export {
   APIError,
+  AnthropicClient,
   BASE_CHAIN_ID,
   BlockrunError,
   ImageClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "type": "module",
   "description": "BlockRun LLM Gateway SDK - Pay-per-request AI via x402 on Base and Solana",
   "main": "dist/index.cjs",
@@ -18,8 +18,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external @anthropic-ai/sdk",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --external @anthropic-ai/sdk",
     "test": "vitest",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit"
@@ -53,6 +53,7 @@
     "viem": "^2.21.0"
   },
   "optionalDependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
     "@solana/spl-token": "^0.4.0",
     "@solana/web3.js": "^1.98.0"
   },