@blockrun/llm 3.15.1 → 3.17.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 -->76<!-- /br:models.chatVisible --> models — every request goes to the cheapest model that can handle it,
+The smart-routing SDK for <!-- br:models.chatVisible -->79<!-- /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 -->76<!-- /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 -->79<!-- /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 -->76<!-- /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 -->79<!-- /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,
@@ -4312,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;
@@ -4355,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" },
@@ -4391,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,
@@ -4417,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,
@@ -4620,7 +4660,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.15.1";
+var SDK_VERSION = "3.16.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -5080,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
       }
     );
@@ -5165,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
       }
     );
@@ -5376,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
       }
     );
@@ -5523,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
       }
     );
@@ -6316,6 +6360,7 @@ var ImageClient = class {
         resourceDescription: details.resource?.description || "BlockRun Image Generation",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -8670,6 +8715,15 @@ var BlockrunClient = class {
    * deadline exceeded). Settlement happens only when upstream returns 200 +
    * completed — upstream failure or caller giving up = no charge.
    *
+   * **EVM only, and enforced upstream.** Replaying one signature works because
+   * an EIP-3009 authorization stays valid for as long as it was signed for. A
+   * Solana payment is a transaction pinned to a recent blockhash and expires in
+   * ~150 blocks (~60s), so replaying one could not cover a long render. No
+   * guard is needed here: `signFrom402` already refuses a `solana:` network
+   * outright, so this loop is unreachable on Solana. Use `SolanaLLMClient`,
+   * whose poll loop signs afresh each time; the gateway binds a job to the
+   * payer address rather than to the signature, and still settles exactly once.
+   *
    * If the gateway returns 200 directly on submit (no async surface), this
    * short-circuits and returns the body. Most long-running endpoints (image,
    * video, music, voice) return 202 with a poll_url.
@@ -8923,7 +8977,8 @@ var BlockrunClient = class {
           details.maxTimeoutSeconds || 0,
           opts.maxTimeoutSeconds || 300
         ),
-        extra: details.extra
+        extra: details.extra,
+        asset: details.asset
       }
     );
   }
@@ -9903,6 +9958,18 @@ var SolanaLLMClient = class {
     }
   }
   /** Edit an image using img2img (Solana payment). */
+  /**
+   * Generate an image on Solana.
+   *
+   * Slow models answer 202 `{ id, poll_url }`; `requestWithPaymentRaw` follows
+   * that to completion, re-signing per poll, and settles once at the end. Fast
+   * models answer 200 inline and settle there.
+   */
+  async image(prompt, options = {}) {
+    const body = { prompt, ...options };
+    const data = await this.requestWithPaymentRaw("/v1/images/generations", body);
+    return data;
+  }
   async imageEdit(prompt, image, options) {
     const body = {
       model: options?.model || "openai/gpt-image-2",
@@ -10150,6 +10217,81 @@ var SolanaLLMClient = class {
    * @returns the header value to replay with, and what it will settle for.
    * @throws PaymentError when the 402 carries no usable Solana requirements.
    */
+  /**
+   * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+   *
+   * The Base SDK signs one EIP-3009 authorization and replays it on every poll.
+   * That cannot work here: a Solana payment is a transaction pinned to a recent
+   * blockhash, valid for ~150 blocks (~60s), and a long render outlives it. So
+   * every poll takes a **fresh** 402 and signs again. The gateway binds the job
+   * to the payer address rather than to the signature, which is what makes that
+   * legal — and it settles exactly once, on the poll that returns `completed`,
+   * so signing per poll costs signatures, never money.
+   */
+  async followSolanaJob(submitBody, budgetMs, intervalMs = 2e3) {
+    const id = submitBody.id;
+    const pollPath = submitBody.poll_url;
+    if (!id || !pollPath) return submitBody;
+    const pollUrl = pollPath.startsWith("http") ? pollPath : `${this.apiUrl}${pollPath.startsWith("/") ? "" : "/"}${pollPath}`;
+    const deadline = Date.now() + budgetMs;
+    let lastStatus = submitBody.status || "queued";
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, intervalMs));
+      const challenge = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: { "User-Agent": USER_AGENT }
+      });
+      if (challenge.status === 200) {
+        const done = await challenge.json();
+        return done;
+      }
+      if (challenge.status !== 402) {
+        let errorBody;
+        try {
+          errorBody = await challenge.json();
+        } catch {
+          errorBody = { error: "Poll failed" };
+        }
+        throw new APIError(`Poll failed: ${challenge.status}`, challenge.status, sanitizeErrorResponse(errorBody));
+      }
+      const { paymentPayload, costUsd } = await this.signPaymentFrom402(
+        pollUrl,
+        challenge,
+        true,
+        // always a fresh blockhash; the last one is stale by now
+        pollUrl
+      );
+      const paid = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: { "User-Agent": USER_AGENT, "PAYMENT-SIGNATURE": paymentPayload }
+      });
+      let data = {};
+      try {
+        data = await paid.json();
+      } catch {
+      }
+      lastStatus = data.status || lastStatus;
+      if (lastStatus === "failed") {
+        throw new APIError(
+          `Upstream job failed: ${data.error || "unknown"}`,
+          paid.status,
+          sanitizeErrorResponse(data)
+        );
+      }
+      if (paid.status === 200 && lastStatus === "completed") {
+        this.recordSettlement(costUsd);
+        return data;
+      }
+      if (paid.status !== 200 && paid.status !== 202 && paid.status !== 504) {
+        throw new APIError(`Poll failed: ${paid.status}`, paid.status, sanitizeErrorResponse(data));
+      }
+    }
+    throw new APIError(
+      `Job did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken.`,
+      504,
+      { id, last_status: lastStatus }
+    );
+  }
   async signPaymentFrom402(url, response, forceFreshBlockhash, resourceFallback = url) {
     let paymentHeader = response.headers.get("payment-required");
     if (!paymentHeader) {
@@ -10260,6 +10402,10 @@ var SolanaLLMClient = class {
       body: JSON.stringify(body)
     });
     await this.assertPaid(retryResponse);
+    if (retryResponse.status === 202) {
+      const submitted = await retryResponse.json();
+      return this.followSolanaJob(submitted, this.timeout);
+    }
     this.recordSettlement(costUsd);
     return retryResponse.json();
   }
@@ -10854,6 +11000,7 @@ var AnthropicClient = class {
             resourceDescription: details.resource?.description || "BlockRun AI API call",
             maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
             extra: details.extra,
+            asset: details.asset,
             extensions
           }
         );
@@ -10896,10 +11043,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,
@@ -10923,6 +11072,7 @@ var AnthropicClient = class {
   SolanaLLMClient,
   SpeechClient,
   SurfClient,
+  USDC_ARC,
   USDC_BASE,
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
@@ -10935,6 +11085,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 {
@@ -2262,6 +2264,15 @@ declare class BlockrunClient {
      * deadline exceeded). Settlement happens only when upstream returns 200 +
      * completed — upstream failure or caller giving up = no charge.
      *
+     * **EVM only, and enforced upstream.** Replaying one signature works because
+     * an EIP-3009 authorization stays valid for as long as it was signed for. A
+     * Solana payment is a transaction pinned to a recent blockhash and expires in
+     * ~150 blocks (~60s), so replaying one could not cover a long render. No
+     * guard is needed here: `signFrom402` already refuses a `solana:` network
+     * outright, so this loop is unreachable on Solana. Use `SolanaLLMClient`,
+     * whose poll loop signs afresh each time; the gateway binds a job to the
+     * payer address rather than to the signature, and still settles exactly once.
+     *
      * If the gateway returns 200 directly on submit (no async surface), this
      * short-circuits and returns the body. Most long-running endpoints (image,
      * video, music, voice) return 202 with a poll_url.
@@ -2312,16 +2323,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 +2377,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
  */
@@ -2731,6 +2777,18 @@ declare class SolanaLLMClient {
      */
     getBalance(): Promise<number>;
     /** Edit an image using img2img (Solana payment). */
+    /**
+     * Generate an image on Solana.
+     *
+     * Slow models answer 202 `{ id, poll_url }`; `requestWithPaymentRaw` follows
+     * that to completion, re-signing per poll, and settles once at the end. Fast
+     * models answer 200 inline and settle there.
+     */
+    image(prompt: string, options?: {
+        model?: string;
+        size?: string;
+        n?: number;
+    } & Record<string, unknown>): Promise<ImageResponse>;
     imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /** Standalone search (Solana payment). */
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
@@ -2860,6 +2918,18 @@ declare class SolanaLLMClient {
      * @returns the header value to replay with, and what it will settle for.
      * @throws PaymentError when the 402 carries no usable Solana requirements.
      */
+    /**
+     * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+     *
+     * The Base SDK signs one EIP-3009 authorization and replays it on every poll.
+     * That cannot work here: a Solana payment is a transaction pinned to a recent
+     * blockhash, valid for ~150 blocks (~60s), and a long render outlives it. So
+     * every poll takes a **fresh** 402 and signs again. The gateway binds the job
+     * to the payer address rather than to the signature, which is what makes that
+     * legal — and it settles exactly once, on the poll that returns `completed`,
+     * so signing per poll costs signatures, never money.
+     */
+    private followSolanaJob;
     private signPaymentFrom402;
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
@@ -3014,7 +3084,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 +3313,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 {
@@ -2262,6 +2264,15 @@ declare class BlockrunClient {
      * deadline exceeded). Settlement happens only when upstream returns 200 +
      * completed — upstream failure or caller giving up = no charge.
      *
+     * **EVM only, and enforced upstream.** Replaying one signature works because
+     * an EIP-3009 authorization stays valid for as long as it was signed for. A
+     * Solana payment is a transaction pinned to a recent blockhash and expires in
+     * ~150 blocks (~60s), so replaying one could not cover a long render. No
+     * guard is needed here: `signFrom402` already refuses a `solana:` network
+     * outright, so this loop is unreachable on Solana. Use `SolanaLLMClient`,
+     * whose poll loop signs afresh each time; the gateway binds a job to the
+     * payer address rather than to the signature, and still settles exactly once.
+     *
      * If the gateway returns 200 directly on submit (no async surface), this
      * short-circuits and returns the body. Most long-running endpoints (image,
      * video, music, voice) return 202 with a poll_url.
@@ -2312,16 +2323,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 +2377,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
  */
@@ -2731,6 +2777,18 @@ declare class SolanaLLMClient {
      */
     getBalance(): Promise<number>;
     /** Edit an image using img2img (Solana payment). */
+    /**
+     * Generate an image on Solana.
+     *
+     * Slow models answer 202 `{ id, poll_url }`; `requestWithPaymentRaw` follows
+     * that to completion, re-signing per poll, and settles once at the end. Fast
+     * models answer 200 inline and settle there.
+     */
+    image(prompt: string, options?: {
+        model?: string;
+        size?: string;
+        n?: number;
+    } & Record<string, unknown>): Promise<ImageResponse>;
     imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /** Standalone search (Solana payment). */
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
@@ -2860,6 +2918,18 @@ declare class SolanaLLMClient {
      * @returns the header value to replay with, and what it will settle for.
      * @throws PaymentError when the 402 carries no usable Solana requirements.
      */
+    /**
+     * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+     *
+     * The Base SDK signs one EIP-3009 authorization and replays it on every poll.
+     * That cannot work here: a Solana payment is a transaction pinned to a recent
+     * blockhash, valid for ~150 blocks (~60s), and a long render outlives it. So
+     * every poll takes a **fresh** 402 and signs again. The gateway binds the job
+     * to the payer address rather than to the signature, which is what makes that
+     * legal — and it settles exactly once, on the poll that returns `completed`,
+     * so signing per poll costs signatures, never money.
+     */
+    private followSolanaJob;
     private signPaymentFrom402;
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
@@ -3014,7 +3084,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 +3313,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

@@ -4195,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;
@@ -4238,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" },
@@ -4274,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,
@@ -4300,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,
@@ -4503,7 +4539,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.15.1";
+var SDK_VERSION = "3.16.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -4963,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
       }
     );
@@ -5048,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
       }
     );
@@ -5259,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
       }
     );
@@ -5406,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
       }
     );
@@ -6199,6 +6239,7 @@ var ImageClient = class {
         resourceDescription: details.resource?.description || "BlockRun Image Generation",
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
+        asset: details.asset,
         extensions
       }
     );
@@ -8553,6 +8594,15 @@ var BlockrunClient = class {
    * deadline exceeded). Settlement happens only when upstream returns 200 +
    * completed — upstream failure or caller giving up = no charge.
    *
+   * **EVM only, and enforced upstream.** Replaying one signature works because
+   * an EIP-3009 authorization stays valid for as long as it was signed for. A
+   * Solana payment is a transaction pinned to a recent blockhash and expires in
+   * ~150 blocks (~60s), so replaying one could not cover a long render. No
+   * guard is needed here: `signFrom402` already refuses a `solana:` network
+   * outright, so this loop is unreachable on Solana. Use `SolanaLLMClient`,
+   * whose poll loop signs afresh each time; the gateway binds a job to the
+   * payer address rather than to the signature, and still settles exactly once.
+   *
    * If the gateway returns 200 directly on submit (no async surface), this
    * short-circuits and returns the body. Most long-running endpoints (image,
    * video, music, voice) return 202 with a poll_url.
@@ -8806,7 +8856,8 @@ var BlockrunClient = class {
           details.maxTimeoutSeconds || 0,
           opts.maxTimeoutSeconds || 300
         ),
-        extra: details.extra
+        extra: details.extra,
+        asset: details.asset
       }
     );
   }
@@ -9786,6 +9837,18 @@ var SolanaLLMClient = class {
     }
   }
   /** Edit an image using img2img (Solana payment). */
+  /**
+   * Generate an image on Solana.
+   *
+   * Slow models answer 202 `{ id, poll_url }`; `requestWithPaymentRaw` follows
+   * that to completion, re-signing per poll, and settles once at the end. Fast
+   * models answer 200 inline and settle there.
+   */
+  async image(prompt, options = {}) {
+    const body = { prompt, ...options };
+    const data = await this.requestWithPaymentRaw("/v1/images/generations", body);
+    return data;
+  }
   async imageEdit(prompt, image, options) {
     const body = {
       model: options?.model || "openai/gpt-image-2",
@@ -10033,6 +10096,81 @@ var SolanaLLMClient = class {
    * @returns the header value to replay with, and what it will settle for.
    * @throws PaymentError when the 402 carries no usable Solana requirements.
    */
+  /**
+   * Follow a 202 `{ id, poll_url }` to completion, on Solana.
+   *
+   * The Base SDK signs one EIP-3009 authorization and replays it on every poll.
+   * That cannot work here: a Solana payment is a transaction pinned to a recent
+   * blockhash, valid for ~150 blocks (~60s), and a long render outlives it. So
+   * every poll takes a **fresh** 402 and signs again. The gateway binds the job
+   * to the payer address rather than to the signature, which is what makes that
+   * legal — and it settles exactly once, on the poll that returns `completed`,
+   * so signing per poll costs signatures, never money.
+   */
+  async followSolanaJob(submitBody, budgetMs, intervalMs = 2e3) {
+    const id = submitBody.id;
+    const pollPath = submitBody.poll_url;
+    if (!id || !pollPath) return submitBody;
+    const pollUrl = pollPath.startsWith("http") ? pollPath : `${this.apiUrl}${pollPath.startsWith("/") ? "" : "/"}${pollPath}`;
+    const deadline = Date.now() + budgetMs;
+    let lastStatus = submitBody.status || "queued";
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, intervalMs));
+      const challenge = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: { "User-Agent": USER_AGENT }
+      });
+      if (challenge.status === 200) {
+        const done = await challenge.json();
+        return done;
+      }
+      if (challenge.status !== 402) {
+        let errorBody;
+        try {
+          errorBody = await challenge.json();
+        } catch {
+          errorBody = { error: "Poll failed" };
+        }
+        throw new APIError(`Poll failed: ${challenge.status}`, challenge.status, sanitizeErrorResponse(errorBody));
+      }
+      const { paymentPayload, costUsd } = await this.signPaymentFrom402(
+        pollUrl,
+        challenge,
+        true,
+        // always a fresh blockhash; the last one is stale by now
+        pollUrl
+      );
+      const paid = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: { "User-Agent": USER_AGENT, "PAYMENT-SIGNATURE": paymentPayload }
+      });
+      let data = {};
+      try {
+        data = await paid.json();
+      } catch {
+      }
+      lastStatus = data.status || lastStatus;
+      if (lastStatus === "failed") {
+        throw new APIError(
+          `Upstream job failed: ${data.error || "unknown"}`,
+          paid.status,
+          sanitizeErrorResponse(data)
+        );
+      }
+      if (paid.status === 200 && lastStatus === "completed") {
+        this.recordSettlement(costUsd);
+        return data;
+      }
+      if (paid.status !== 200 && paid.status !== 202 && paid.status !== 504) {
+        throw new APIError(`Poll failed: ${paid.status}`, paid.status, sanitizeErrorResponse(data));
+      }
+    }
+    throw new APIError(
+      `Job did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken.`,
+      504,
+      { id, last_status: lastStatus }
+    );
+  }
   async signPaymentFrom402(url, response, forceFreshBlockhash, resourceFallback = url) {
     let paymentHeader = response.headers.get("payment-required");
     if (!paymentHeader) {
@@ -10143,6 +10281,10 @@ var SolanaLLMClient = class {
       body: JSON.stringify(body)
     });
     await this.assertPaid(retryResponse);
+    if (retryResponse.status === 202) {
+      const submitted = await retryResponse.json();
+      return this.followSolanaJob(submitted, this.timeout);
+    }
     this.recordSettlement(costUsd);
     return retryResponse.json();
   }
@@ -10737,6 +10879,7 @@ var AnthropicClient = class {
             resourceDescription: details.resource?.description || "BlockRun AI API call",
             maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
             extra: details.extra,
+            asset: details.asset,
             extensions
           }
         );
@@ -10778,10 +10921,12 @@ var AnthropicClient = class {
 export {
   APIError,
   API_KEY_URL,
+  ARC_CHAIN_ID,
   AnthropicClient,
   BASE_CHAIN_ID,
   BlockrunClient,
   BlockrunError,
+  EVM_NETWORKS,
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
@@ -10805,6 +10950,7 @@ export {
   SolanaLLMClient,
   SpeechClient,
   SurfClient,
+  USDC_ARC,
   USDC_BASE,
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
@@ -10818,6 +10964,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.1",
+  "version": "3.17.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",