@blockrun/llm 3.15.0 → 3.16.0

package/README.md

@@ -4,7 +4,7 @@
 
 ### Cut your LLM bill by <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->%. One line of TypeScript.
 
-The smart-routing SDK for <!-- br:models.chatVisible -->74<!-- /br:models.chatVisible --> models — every request goes to the cheapest model that can handle it,
+The smart-routing SDK for <!-- br:models.chatVisible -->78<!-- /br:models.chatVisible --> models — every request goes to the cheapest model that can handle it,
 paid with an API key or per-request USDC on Solana or Base. No vendor lock-in.
 
 [![npm](https://img.shields.io/npm/v/@blockrun/llm.svg?style=flat-square)](https://www.npmjs.com/package/@blockrun/llm)
@@ -44,7 +44,7 @@ console.log(r.response);         // the proof
 ## Why This SDK
 
 - 🧠 **Smart routing that pays for itself** — the bundled [Router Core V3](https://github.com/BlockRunAI/router-core) engine (shared with [ClawRouter](https://github.com/BlockRunAI/ClawRouter)) classifies every request locally in <1ms across <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions --> dimensions and routes to the cheapest capable model. The main event.
-- 🆓 **<!-- br:models.free -->7<!-- /br:models.free --> genuinely free models** — $0 in and out, incl. two 1M-context Nemotrons, a multimodal one, and free coding models from Cohere and Poolside. No rate-limit gimmicks.
+- 🆓 **<!-- br:models.free -->6<!-- /br:models.free --> genuinely free models** — $0 in and out, incl. two 1M-context Nemotrons, a multimodal one, and free coding models from Cohere and Poolside. No rate-limit gimmicks.
 - 🔐 **Two ways to connect** — a **BlockRun API key** billed against account credit ([sign up at user.blockrun.ai](https://user.blockrun.ai), [create a key](https://user.blockrun.ai/dashboard/keys), [add credit](https://user.blockrun.ai/dashboard/credits)), or a wallet signature with x402 micropayments and no account at all. Same code either way.
 - 💸 **Pay per request in USDC** — x402 micropayments on Solana or Base. $5 covers thousands of requests; agents can pay their own way.
 - 🛡️ **Automatic failover** — transient errors (timeouts, 429, 5xx) walk the router's ranked fallback chain instead of failing your request.
@@ -56,8 +56,8 @@ console.log(r.response);         // the proof
 |                    | OpenAI SDK     | OpenRouter        | LiteLLM          | **@blockrun/llm**                                                       |
 | ------------------ | -------------- | ----------------- | ---------------- | ----------------------------------------------------------------------- |
 | **Cost routing**   | ✗ one vendor   | Manual selection  | Manual selection | **Automatic — <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% cheaper** |
-| **Models**         | GPT only       | 200+              | 100+ (BYO keys)  | **<!-- br:models.chatVisible -->74<!-- /br:models.chatVisible -->, one credential** |
-| **Free tier**      | ✗              | Rate-limited      | ✗                | **<!-- br:models.free -->7<!-- /br:models.free --> models, no signup**  |
+| **Models**         | GPT only       | 200+              | 100+ (BYO keys)  | **<!-- br:models.chatVisible -->78<!-- /br:models.chatVisible -->, one credential** |
+| **Free tier**      | ✗              | Rate-limited      | ✗                | **<!-- br:models.free -->6<!-- /br:models.free --> models, no signup**  |
 | **Auth**           | API key        | Account + API key | Your API keys    | **API key *or* wallet signature**                                       |
 | **Payment**        | Card + invoice | Credit card       | BYO keys         | **Account credit or USDC per-request**                                  |
 | **Agent-ready**    | ✗              | ✗                 | ✗                | **✓ — one key, or agents fund their own wallet**                        |
@@ -313,7 +313,7 @@ const reply = await client.chat('nvidia/nemotron-3.5-lightning', 'hello', {
 
 | Profile | Strategy | Savings vs Opus 5 | Best For |
 |---------|----------|-------------------|----------|
-| `eco` | Cheapest capable model — ranks the <!-- br:models.free -->7<!-- /br:models.free -->-model free tier first | **<!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->%** | Cost-sensitive production, zero-cost testing |
+| `eco` | Cheapest capable model — ranks the <!-- br:models.free -->6<!-- /br:models.free -->-model free tier first | **<!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->%** | Cost-sensitive production, zero-cost testing |
 | `auto` | Best balance of cost/quality (default) | **<!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->%** | General use |
 | `premium` | Top-tier models (OpenAI, Anthropic) | 0% | Quality-critical tasks |
 
@@ -444,6 +444,31 @@ const tweet = await client.chat('xai/grok-4.5', 'What is trending on X?', { sear
 **Supported endpoint:** `https://sol.blockrun.ai/api`
 **Payment:** Solana USDC (SPL, mainnet)
 
+## Arc Support
+
+The same `LLMClient` pays on [Circle's Arc](https://www.arc.network) via [arc.blockrun.ai](https://arc.blockrun.ai) — point `apiUrl` at it and hold USDC on Arc in the same EVM wallet:
+
+```typescript
+import { LLMClient } from '@blockrun/llm';
+
+const client = new LLMClient({
+  privateKey: process.env.BLOCKRUN_WALLET_KEY,
+  apiUrl: 'https://arc.blockrun.ai/api',
+});
+
+const response = await client.chat('openai/gpt-4o', 'gm Arc');
+```
+
+The 402 from that host names `eip155:5042`, and the SDK signs the EIP-3009 authorization against Arc's USDC (`0x3600…0000`, EIP-712 domain `USDC` v2) — never Base's. Circle's facilitator verifies and settles it on Arc; you pay no gas. Which networks the SDK can sign for is the exported `EVM_NETWORKS` table (Base, Arc, Base Sepolia); a 402 naming any other network, or a non-USDC asset, is refused before anything is signed.
+
+**Setup:**
+1. Same wallet key as Base: `export BLOCKRUN_WALLET_KEY="0x..."`
+2. Fund it with USDC on Arc (Arc's native token, shown as the ERC-20 at `0x3600…0000`)
+3. `apiUrl: 'https://arc.blockrun.ai/api'` — payments are automatic via x402
+
+**Supported endpoint:** `https://arc.blockrun.ai/api`
+**Payment:** USDC on Arc (chain 5042), settled by Circle
+
 ## How Payment Works
 
 In wallet mode, no API key is required. You hold USDC in your own wallet, and **every request pays for itself** with an on-chain micropayment. Two phases:
@@ -1158,7 +1183,7 @@ const free = await client.chat('nvidia/nemotron-3.5-lightning', 'Hello!');
 
 | Profile | Description | Best For |
 |---------|-------------|----------|
-| `eco` | Budget-optimized — ranks the <!-- br:models.free -->7<!-- /br:models.free -->-model free tier first | Cost-sensitive workloads, zero-cost testing |
+| `eco` | Budget-optimized — ranks the <!-- br:models.free -->6<!-- /br:models.free -->-model free tier first | Cost-sensitive workloads, zero-cost testing |
 | `auto` | Intelligent routing (default) | General use |
 | `premium` | Best quality models | Critical tasks |
 
@@ -1749,7 +1774,7 @@ The `AnthropicClient` wraps the official `@anthropic-ai/sdk` with a custom fetch
 ## Frequently Asked Questions
 
 ### What is @blockrun/llm?
-@blockrun/llm is a TypeScript SDK that cuts LLM costs by up to <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% with built-in smart routing: every request is routed to the cheapest of <!-- br:models.chatVisible -->74<!-- /br:models.chatVisible --> models (OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, and more) that can handle it, then paid per-request in USDC via the x402 protocol — with API key account billing or x402 wallet payments on Solana or Base.
+@blockrun/llm is a TypeScript SDK that cuts LLM costs by up to <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% with built-in smart routing: every request is routed to the cheapest of <!-- br:models.chatVisible -->78<!-- /br:models.chatVisible --> models (OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, and more) that can handle it, then paid per-request in USDC via the x402 protocol — with API key account billing or x402 wallet payments on Solana or Base.
 
 ### How does payment work?
 When you make an API call, the SDK automatically handles x402 payment. It signs a USDC transaction locally using your wallet private key (which never leaves your machine), and includes the payment proof in the request header. Settlement is non-custodial and instant on Base or Solana.

package/dist/index.cjs

@@ -32,10 +32,12 @@ var index_exports = {};
 __export(index_exports, {
   APIError: () => APIError,
   API_KEY_URL: () => API_KEY_URL,
+  ARC_CHAIN_ID: () => ARC_CHAIN_ID,
   AnthropicClient: () => AnthropicClient,
   BASE_CHAIN_ID: () => BASE_CHAIN_ID,
   BlockrunClient: () => BlockrunClient,
   BlockrunError: () => BlockrunError,
+  EVM_NETWORKS: () => EVM_NETWORKS,
   ImageClient: () => ImageClient,
   KNOWN_PROVIDERS: () => KNOWN_PROVIDERS,
   LLMClient: () => LLMClient,
@@ -59,6 +61,7 @@ __export(index_exports, {
   SolanaLLMClient: () => SolanaLLMClient,
   SpeechClient: () => SpeechClient,
   SurfClient: () => SurfClient,
+  USDC_ARC: () => USDC_ARC,
   USDC_BASE: () => USDC_BASE,
   USDC_BASE_CONTRACT: () => USDC_BASE_CONTRACT,
   USDC_SOLANA: () => USDC_SOLANA,
@@ -72,6 +75,7 @@ __export(index_exports, {
   createSolanaWallet: () => createSolanaWallet,
   createWallet: () => createWallet,
   default: () => client_default,
+  evmNetwork: () => evmNetwork,
   extractPaymentDetails: () => extractPaymentDetails,
   formatFundingMessageCompact: () => formatFundingMessageCompact,
   formatNeedsFundingMessage: () => formatNeedsFundingMessage,
@@ -243,9 +247,12 @@ function sanitizeErrorResponse(errorBody) {
     return { message: "API request failed" };
   }
   const body = errorBody;
+  const detail = typeof body.message === "string" && body.message !== body.error ? body.message : void 0;
   return {
     message: typeof body.error === "string" ? body.error : "API request failed",
-    code: typeof body.code === "string" ? body.code : void 0
+    code: typeof body.code === "string" ? body.code : void 0,
+    ...detail ? { detail } : {},
+    ...typeof body.hint === "string" ? { hint: body.hint } : {}
   };
 }
 function validateResourceUrl(url, baseUrl) {
@@ -4309,6 +4316,42 @@ async function loadSplToken(what) {
 // src/x402.ts
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var ARC_CHAIN_ID = 5042;
+var USDC_ARC = "0x3600000000000000000000000000000000000000";
+var EVM_NETWORKS = {
+  "eip155:8453": {
+    name: "Base",
+    chainId: BASE_CHAIN_ID,
+    usdc: USDC_BASE,
+    domain: { name: "USD Coin", version: "2", chainId: BASE_CHAIN_ID, verifyingContract: USDC_BASE }
+  },
+  "eip155:5042": {
+    name: "Arc",
+    chainId: ARC_CHAIN_ID,
+    usdc: USDC_ARC,
+    domain: { name: "USDC", version: "2", chainId: ARC_CHAIN_ID, verifyingContract: USDC_ARC }
+  },
+  "eip155:84532": {
+    name: "Base Sepolia",
+    chainId: 84532,
+    usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    domain: {
+      name: "USDC",
+      version: "2",
+      chainId: 84532,
+      verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+    }
+  }
+};
+function evmNetwork(network) {
+  const net = EVM_NETWORKS[network];
+  if (!net) {
+    throw new Error(
+      `Unsupported x402 network "${network}": this SDK signs USDC payments on ${Object.keys(EVM_NETWORKS).join(", ")}`
+    );
+  }
+  return net;
+}
 var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 var USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 var SOLANA_USDC_DECIMALS = 6;
@@ -4352,12 +4395,6 @@ async function getBlockhashEntry(connection, rpcUrl, forceRefresh) {
   trimOldest(blockhashCache, MAX_TRACKED_ENDPOINTS);
   return entry;
 }
-var USDC_DOMAIN = {
-  name: "USD Coin",
-  version: "2",
-  chainId: BASE_CHAIN_ID,
-  verifyingContract: USDC_BASE
-};
 var TRANSFER_TYPES = {
   TransferWithAuthorization: [
     { name: "from", type: "address" },
@@ -4388,7 +4425,13 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
   const validAfter = now - 600;
   const validBefore = now + (options.maxTimeoutSeconds || 300);
   const nonce = createNonce();
-  const domain = USDC_DOMAIN;
+  const net = evmNetwork(network);
+  if (options.asset && options.asset.toLowerCase() !== net.usdc.toLowerCase()) {
+    throw new Error(
+      `x402 asset mismatch: the 402 asks for ${options.asset} on ${network}, but this SDK only pays USDC there (${net.usdc})`
+    );
+  }
+  const domain = net.domain;
   const signature = await (0, import_accounts.signTypedData)({
     privateKey,
     domain,
@@ -4414,10 +4457,10 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
       scheme: "exact",
       network,
       amount,
-      asset: USDC_BASE,
+      asset: net.usdc,
       payTo: recipient,
       maxTimeoutSeconds: options.maxTimeoutSeconds || 300,
-      extra: { name: "USD Coin", version: "2" }
+      extra: { name: net.domain.name, version: net.domain.version }
     },
     payload: {
       signature,
@@ -4617,7 +4660,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.15.0";
+var SDK_VERSION = "3.16.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -5077,6 +5120,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5162,6 +5206,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5373,6 +5418,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5520,6 +5566,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -6313,6 +6360,7 @@ var ImageClient = class {
         resourceDescription: details.resource?.description || "BlockRun Image Generation",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -8920,7 +8968,8 @@ var BlockrunClient = class {
           details.maxTimeoutSeconds || 0,
           opts.maxTimeoutSeconds || 300
         ),
-        extra: details.extra
+        extra: details.extra,
+        asset: details.asset
       }
     );
   }
@@ -10851,6 +10900,7 @@ var AnthropicClient = class {
             resourceDescription: details.resource?.description || "BlockRun AI API call",
             maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
             extra: details.extra,
+            asset: details.asset,
             extensions
           }
         );
@@ -10893,10 +10943,12 @@ var AnthropicClient = class {
 0 && (module.exports = {
   APIError,
   API_KEY_URL,
+  ARC_CHAIN_ID,
   AnthropicClient,
   BASE_CHAIN_ID,
   BlockrunClient,
   BlockrunError,
+  EVM_NETWORKS,
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
@@ -10920,6 +10972,7 @@ var AnthropicClient = class {
   SolanaLLMClient,
   SpeechClient,
   SurfClient,
+  USDC_ARC,
   USDC_BASE,
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
@@ -10932,6 +10985,7 @@ var AnthropicClient = class {
   createSolanaPaymentPayload,
   createSolanaWallet,
   createWallet,
+  evmNetwork,
   extractPaymentDetails,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,

package/dist/index.d.cts

@@ -1164,7 +1164,9 @@ declare class APIError extends BlockrunError {
  * BlockRun LLM Gateway Client.
  *
  * Provides access to multiple LLM providers (OpenAI, Anthropic, Google, etc.)
- * with automatic x402 micropayments on Base chain (Mainnet, Chain ID 8453).
+ * with automatic x402 micropayments in USDC on Base (chain 8453) or, with
+ * `apiUrl` pointed at arc.blockrun.ai, on Circle's Arc (chain 5042) — the
+ * 402's `network` selects the chain (see EVM_NETWORKS in x402.ts).
  * API base: https://blockrun.ai/api
  */
 declare class LLMClient {
@@ -2312,16 +2314,51 @@ declare class BlockrunClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const ARC_CHAIN_ID = 5042;
+declare const USDC_ARC: "0x3600000000000000000000000000000000000000";
+/**
+ * The EVM networks a BlockRun gateway settles on, keyed by the CAIP-2
+ * `network` a 402 carries, each with the SDK's OWN values for that network's
+ * USDC and its EIP-712 domain.
+ *
+ * Until 3.16.0 there was one domain — Base's — signed whatever the 402 said,
+ * so against arc.blockrun.ai (eip155:5042) or testnet.blockrun.ai every
+ * payment was a signature over the wrong domain: the facilitator recovered a
+ * different signer and answered 401 after the SDK had reported a payment.
+ *
+ * The 402 SELECTS a network from this table; it never supplies the domain.
+ * That keeps the rule the single constant enforced — a hostile 402's `extra`
+ * cannot steer a signature onto another contract — while letting the same
+ * SDK pay on every host. Arc's USDC is the chain's native token exposed as an
+ * ERC-20 at 0x3600…0000, and its domain name is "USDC", not Base's "USD Coin".
+ */
+interface EvmNetwork {
+    name: string;
+    chainId: number;
+    usdc: `0x${string}`;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+}
+declare const EVM_NETWORKS: Readonly<Record<string, EvmNetwork>>;
+/** The network table entry for a 402's `network`, or a refusal that names what IS supported. */
+declare function evmNetwork(network: string): EvmNetwork;
 declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 interface CreatePaymentOptions {
     resourceUrl?: string;
     resourceDescription?: string;
     maxTimeoutSeconds?: number;
+    /** The 402's `extra`. Echoed nowhere: the domain comes from EVM_NETWORKS. */
     extra?: {
         name?: string;
         version?: string;
     };
+    /** The 402's `asset`. Checked against the network's USDC; a mismatch is refused. */
+    asset?: string;
     extensions?: Record<string, unknown>;
 }
 /**
@@ -2331,7 +2368,7 @@ interface CreatePaymentOptions {
  * @param fromAddress - Sender wallet address
  * @param recipient - Payment recipient address
  * @param amount - Amount in micro USDC (6 decimals)
- * @param network - Network identifier (default: eip155:8453)
+ * @param network - CAIP-2 network from the 402 (default: eip155:8453); must be in EVM_NETWORKS
  * @param options - Additional options for resource info
  * @returns Base64-encoded signed payment payload
  */
@@ -3014,7 +3051,7 @@ interface CostEntry {
     model?: string;
     /** Payer wallet address (EVM 0x... or Solana base58). */
     wallet?: string;
-    /** Network identifier — "eip155:8453" for Base mainnet, "solana-mainnet", etc. */
+    /** Network identifier — "eip155:8453" for Base, "eip155:5042" for Arc, "solana-mainnet", etc. */
     network?: string;
     /** Caller kind for analytics — "LLMClient", "ImageClient", "AgentClient", ... */
     client_kind?: string;
@@ -3243,4 +3280,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, API_KEY_URL, AnthropicClient, type ApiKeyOptions, 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, PORTAL_URL, 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 RoutingTaskType, type RoutingTier, type RoutingTierConfig, 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 SmartChatCompletionOptions, type SmartChatCompletionResponse, 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, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, 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, EVM_NETWORKS, type EvmNetwork, 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, PORTAL_URL, 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 RoutingTaskType, type RoutingTier, type RoutingTierConfig, 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 SmartChatCompletionOptions, type SmartChatCompletionResponse, 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_ARC, 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, evmNetwork, 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, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.d.ts

@@ -1164,7 +1164,9 @@ declare class APIError extends BlockrunError {
  * BlockRun LLM Gateway Client.
  *
  * Provides access to multiple LLM providers (OpenAI, Anthropic, Google, etc.)
- * with automatic x402 micropayments on Base chain (Mainnet, Chain ID 8453).
+ * with automatic x402 micropayments in USDC on Base (chain 8453) or, with
+ * `apiUrl` pointed at arc.blockrun.ai, on Circle's Arc (chain 5042) — the
+ * 402's `network` selects the chain (see EVM_NETWORKS in x402.ts).
  * API base: https://blockrun.ai/api
  */
 declare class LLMClient {
@@ -2312,16 +2314,51 @@ declare class BlockrunClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const ARC_CHAIN_ID = 5042;
+declare const USDC_ARC: "0x3600000000000000000000000000000000000000";
+/**
+ * The EVM networks a BlockRun gateway settles on, keyed by the CAIP-2
+ * `network` a 402 carries, each with the SDK's OWN values for that network's
+ * USDC and its EIP-712 domain.
+ *
+ * Until 3.16.0 there was one domain — Base's — signed whatever the 402 said,
+ * so against arc.blockrun.ai (eip155:5042) or testnet.blockrun.ai every
+ * payment was a signature over the wrong domain: the facilitator recovered a
+ * different signer and answered 401 after the SDK had reported a payment.
+ *
+ * The 402 SELECTS a network from this table; it never supplies the domain.
+ * That keeps the rule the single constant enforced — a hostile 402's `extra`
+ * cannot steer a signature onto another contract — while letting the same
+ * SDK pay on every host. Arc's USDC is the chain's native token exposed as an
+ * ERC-20 at 0x3600…0000, and its domain name is "USDC", not Base's "USD Coin".
+ */
+interface EvmNetwork {
+    name: string;
+    chainId: number;
+    usdc: `0x${string}`;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+}
+declare const EVM_NETWORKS: Readonly<Record<string, EvmNetwork>>;
+/** The network table entry for a 402's `network`, or a refusal that names what IS supported. */
+declare function evmNetwork(network: string): EvmNetwork;
 declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 interface CreatePaymentOptions {
     resourceUrl?: string;
     resourceDescription?: string;
     maxTimeoutSeconds?: number;
+    /** The 402's `extra`. Echoed nowhere: the domain comes from EVM_NETWORKS. */
     extra?: {
         name?: string;
         version?: string;
     };
+    /** The 402's `asset`. Checked against the network's USDC; a mismatch is refused. */
+    asset?: string;
     extensions?: Record<string, unknown>;
 }
 /**
@@ -2331,7 +2368,7 @@ interface CreatePaymentOptions {
  * @param fromAddress - Sender wallet address
  * @param recipient - Payment recipient address
  * @param amount - Amount in micro USDC (6 decimals)
- * @param network - Network identifier (default: eip155:8453)
+ * @param network - CAIP-2 network from the 402 (default: eip155:8453); must be in EVM_NETWORKS
  * @param options - Additional options for resource info
  * @returns Base64-encoded signed payment payload
  */
@@ -3014,7 +3051,7 @@ interface CostEntry {
     model?: string;
     /** Payer wallet address (EVM 0x... or Solana base58). */
     wallet?: string;
-    /** Network identifier — "eip155:8453" for Base mainnet, "solana-mainnet", etc. */
+    /** Network identifier — "eip155:8453" for Base, "eip155:5042" for Arc, "solana-mainnet", etc. */
     network?: string;
     /** Caller kind for analytics — "LLMClient", "ImageClient", "AgentClient", ... */
     client_kind?: string;
@@ -3243,4 +3280,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, API_KEY_URL, AnthropicClient, type ApiKeyOptions, 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, PORTAL_URL, 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 RoutingTaskType, type RoutingTier, type RoutingTierConfig, 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 SmartChatCompletionOptions, type SmartChatCompletionResponse, 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, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, 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, EVM_NETWORKS, type EvmNetwork, 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, PORTAL_URL, 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 RoutingTaskType, type RoutingTier, type RoutingTierConfig, 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 SmartChatCompletionOptions, type SmartChatCompletionResponse, 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_ARC, 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, evmNetwork, 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, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.js

@@ -126,9 +126,12 @@ function sanitizeErrorResponse(errorBody) {
     return { message: "API request failed" };
   }
   const body = errorBody;
+  const detail = typeof body.message === "string" && body.message !== body.error ? body.message : void 0;
   return {
     message: typeof body.error === "string" ? body.error : "API request failed",
-    code: typeof body.code === "string" ? body.code : void 0
+    code: typeof body.code === "string" ? body.code : void 0,
+    ...detail ? { detail } : {},
+    ...typeof body.hint === "string" ? { hint: body.hint } : {}
   };
 }
 function validateResourceUrl(url, baseUrl) {
@@ -4192,6 +4195,42 @@ async function loadSplToken(what) {
 // src/x402.ts
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var ARC_CHAIN_ID = 5042;
+var USDC_ARC = "0x3600000000000000000000000000000000000000";
+var EVM_NETWORKS = {
+  "eip155:8453": {
+    name: "Base",
+    chainId: BASE_CHAIN_ID,
+    usdc: USDC_BASE,
+    domain: { name: "USD Coin", version: "2", chainId: BASE_CHAIN_ID, verifyingContract: USDC_BASE }
+  },
+  "eip155:5042": {
+    name: "Arc",
+    chainId: ARC_CHAIN_ID,
+    usdc: USDC_ARC,
+    domain: { name: "USDC", version: "2", chainId: ARC_CHAIN_ID, verifyingContract: USDC_ARC }
+  },
+  "eip155:84532": {
+    name: "Base Sepolia",
+    chainId: 84532,
+    usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    domain: {
+      name: "USDC",
+      version: "2",
+      chainId: 84532,
+      verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+    }
+  }
+};
+function evmNetwork(network) {
+  const net = EVM_NETWORKS[network];
+  if (!net) {
+    throw new Error(
+      `Unsupported x402 network "${network}": this SDK signs USDC payments on ${Object.keys(EVM_NETWORKS).join(", ")}`
+    );
+  }
+  return net;
+}
 var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 var USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 var SOLANA_USDC_DECIMALS = 6;
@@ -4235,12 +4274,6 @@ async function getBlockhashEntry(connection, rpcUrl, forceRefresh) {
   trimOldest(blockhashCache, MAX_TRACKED_ENDPOINTS);
   return entry;
 }
-var USDC_DOMAIN = {
-  name: "USD Coin",
-  version: "2",
-  chainId: BASE_CHAIN_ID,
-  verifyingContract: USDC_BASE
-};
 var TRANSFER_TYPES = {
   TransferWithAuthorization: [
     { name: "from", type: "address" },
@@ -4271,7 +4304,13 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
   const validAfter = now - 600;
   const validBefore = now + (options.maxTimeoutSeconds || 300);
   const nonce = createNonce();
-  const domain = USDC_DOMAIN;
+  const net = evmNetwork(network);
+  if (options.asset && options.asset.toLowerCase() !== net.usdc.toLowerCase()) {
+    throw new Error(
+      `x402 asset mismatch: the 402 asks for ${options.asset} on ${network}, but this SDK only pays USDC there (${net.usdc})`
+    );
+  }
+  const domain = net.domain;
   const signature = await signTypedData({
     privateKey,
     domain,
@@ -4297,10 +4336,10 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
       scheme: "exact",
       network,
       amount,
-      asset: USDC_BASE,
+      asset: net.usdc,
       payTo: recipient,
       maxTimeoutSeconds: options.maxTimeoutSeconds || 300,
-      extra: { name: "USD Coin", version: "2" }
+      extra: { name: net.domain.name, version: net.domain.version }
     },
     payload: {
       signature,
@@ -4500,7 +4539,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.15.0";
+var SDK_VERSION = "3.16.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -4960,6 +4999,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5045,6 +5085,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5256,6 +5297,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -5403,6 +5445,7 @@ var LLMClient = class _LLMClient {
         resourceDescription: details.resource?.description || "BlockRun AI API call",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -6196,6 +6239,7 @@ var ImageClient = class {
         resourceDescription: details.resource?.description || "BlockRun Image Generation",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -8803,7 +8847,8 @@ var BlockrunClient = class {
           details.maxTimeoutSeconds || 0,
           opts.maxTimeoutSeconds || 300
         ),
-        extra: details.extra
+        extra: details.extra,
+        asset: details.asset
       }
     );
   }
@@ -10734,6 +10779,7 @@ var AnthropicClient = class {
             resourceDescription: details.resource?.description || "BlockRun AI API call",
             maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
             extra: details.extra,
+            asset: details.asset,
             extensions
           }
         );
@@ -10775,10 +10821,12 @@ var AnthropicClient = class {
 export {
   APIError,
   API_KEY_URL,
+  ARC_CHAIN_ID,
   AnthropicClient,
   BASE_CHAIN_ID,
   BlockrunClient,
   BlockrunError,
+  EVM_NETWORKS,
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
@@ -10802,6 +10850,7 @@ export {
   SolanaLLMClient,
   SpeechClient,
   SurfClient,
+  USDC_ARC,
   USDC_BASE,
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
@@ -10815,6 +10864,7 @@ export {
   createSolanaWallet,
   createWallet,
   client_default as default,
+  evmNetwork,
   extractPaymentDetails,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.15.0",
+  "version": "3.16.0",
   "type": "module",
   "description": "TypeScript SDK for BlockRun - every frontier model behind one OpenAI-compatible client. Pay with a BlockRun API key or per-call in USDC. Smart routing picks the cheapest capable model. No rate limits.",
   "main": "dist/index.cjs",