@blockrun/llm 3.20.0 → 3.20.1

package/README.md

@@ -318,13 +318,19 @@ a retry disposition, which `retryDisposition(err)` returns:
 
 - `'unpaid'`: nothing chargeable was sent — the unpaid first request and its
   402 challenge, or signing the payment. A 429, 5xx, timeout or network error
-  here moves on to the next model.
+  here moves on to the next model. On Solana, a `503
+  PAYMENT_VERIFICATION_UNAVAILABLE` in answer to the payment is `'unpaid'`
+  too: the gateway sends it only when verification could not run, so nothing
+  was settled or broadcast (the batch path already treats it as a refusal).
+  This holds on every exact-paid Solana endpoint, not only chat.
 - `'paid-or-in-doubt'`: the signed payment (exact or batch) was sent and may
   have been charged — a timeout, abort or network error after sending it, any
   error status in answer to it, or a 2xx whose body could not be read. The
   error propagates; no other model is bought for the call. With an API key
-  the request itself is billed, so only the account API's explicit 4xx
-  answer (such as a 429) is `'unpaid'`; a 5xx or a timeout is not.
+  the request itself is billed, so only the account API's explicit answers
+  are `'unpaid'`: a 4xx (such as a 429), or a 5xx carrying its JSON error
+  envelope (api.blockrun.ai debits only an accepted 2xx). An HTML or empty
+  5xx from a proxy, or a timeout, is not.
 
 An error without a disposition counts as `'paid-or-in-doubt'`. Use the same
 check in your own retry wrapper:

package/dist/index.cjs

@@ -332,7 +332,13 @@ function resolveApiKeyAuth(options) {
   return new ApiKeyAuth(key.trim(), base);
 }
 function accountErrorDisposition(err) {
-  return err instanceof APIError && err.statusCode >= 400 && err.statusCode < 500 ? "unpaid" : "paid-or-in-doubt";
+  if (!(err instanceof APIError)) return "paid-or-in-doubt";
+  if (err.statusCode >= 400 && err.statusCode < 500) return "unpaid";
+  if (err.statusCode >= 500 && hasGatewayErrorEnvelope(err.response)) return "unpaid";
+  return "paid-or-in-doubt";
+}
+function hasGatewayErrorEnvelope(response) {
+  return !!response && typeof response === "object" && typeof response.message === "string" && response.message.length > 0;
 }
 function requireWallet(value) {
   if (value === void 0) throw new Error("This operation requires a wallet; the client uses API key account billing.");
@@ -4684,7 +4690,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.20.0";
+var SDK_VERSION = "3.20.1";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -11532,7 +11538,7 @@ var SolanaBatchPayer = class {
             cause: await afterPaymentError(response)
           };
         }
-        return { kind: "not_charged", reason: "payment_required", status: status2, depositSafe: false };
+        return { kind: "not_charged", reason: "payment_required", status: status2, errorReason: receipt?.errorReason, depositSafe: provesNothingBroadcast(receipt) };
       }
       const refusal = await batchRefusal(response);
       if (refusal) {
@@ -12911,9 +12917,10 @@ var SolanaLLMClient = class {
       } catch {
         errorBody = { error: "Request failed" };
       }
+      const unverified = response.status === 503 && errorBody?.code === "PAYMENT_VERIFICATION_UNAVAILABLE";
       throw withDisposition(
         new APIError(`API error after payment: ${response.status}`, response.status, sanitizeErrorResponse(errorBody)),
-        "paid-or-in-doubt"
+        unverified ? "unpaid" : "paid-or-in-doubt"
       );
     }
   }
@@ -13385,8 +13392,12 @@ var AnthropicClient = class {
         baseURL: this._apiUrl,
         apiKey: "blockrun",
         fetch: this._x402Fetch.bind(this),
-        // Account POSTs may already be billed when an upstream error arrives.
-        ...this.apiAuth ? { maxRetries: 0 } : {}
+        // Never let the Anthropic SDK retry. It retries 408/409/429/5xx and
+        // connection errors by calling this fetch again, which in wallet mode
+        // runs the whole x402 flow and signs a NEW payment each time (three
+        // payments for one call at the default maxRetries of 2); in account
+        // mode the POST itself may already be billed.
+        maxRetries: 0
       });
       return this._client;
     })();

package/dist/index.js

@@ -206,7 +206,13 @@ function resolveApiKeyAuth(options) {
   return new ApiKeyAuth(key.trim(), base);
 }
 function accountErrorDisposition(err) {
-  return err instanceof APIError && err.statusCode >= 400 && err.statusCode < 500 ? "unpaid" : "paid-or-in-doubt";
+  if (!(err instanceof APIError)) return "paid-or-in-doubt";
+  if (err.statusCode >= 400 && err.statusCode < 500) return "unpaid";
+  if (err.statusCode >= 500 && hasGatewayErrorEnvelope(err.response)) return "unpaid";
+  return "paid-or-in-doubt";
+}
+function hasGatewayErrorEnvelope(response) {
+  return !!response && typeof response === "object" && typeof response.message === "string" && response.message.length > 0;
 }
 function requireWallet(value) {
   if (value === void 0) throw new Error("This operation requires a wallet; the client uses API key account billing.");
@@ -4558,7 +4564,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.20.0";
+var SDK_VERSION = "3.20.1";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -11406,7 +11412,7 @@ var SolanaBatchPayer = class {
             cause: await afterPaymentError(response)
           };
         }
-        return { kind: "not_charged", reason: "payment_required", status: status2, depositSafe: false };
+        return { kind: "not_charged", reason: "payment_required", status: status2, errorReason: receipt?.errorReason, depositSafe: provesNothingBroadcast(receipt) };
       }
       const refusal = await batchRefusal(response);
       if (refusal) {
@@ -12785,9 +12791,10 @@ var SolanaLLMClient = class {
       } catch {
         errorBody = { error: "Request failed" };
       }
+      const unverified = response.status === 503 && errorBody?.code === "PAYMENT_VERIFICATION_UNAVAILABLE";
       throw withDisposition(
         new APIError(`API error after payment: ${response.status}`, response.status, sanitizeErrorResponse(errorBody)),
-        "paid-or-in-doubt"
+        unverified ? "unpaid" : "paid-or-in-doubt"
       );
     }
   }
@@ -13259,8 +13266,12 @@ var AnthropicClient = class {
         baseURL: this._apiUrl,
         apiKey: "blockrun",
         fetch: this._x402Fetch.bind(this),
-        // Account POSTs may already be billed when an upstream error arrives.
-        ...this.apiAuth ? { maxRetries: 0 } : {}
+        // Never let the Anthropic SDK retry. It retries 408/409/429/5xx and
+        // connection errors by calling this fetch again, which in wallet mode
+        // runs the whole x402 flow and signs a NEW payment each time (three
+        // payments for one call at the default maxRetries of 2); in account
+        // mode the POST itself may already be billed.
+        maxRetries: 0
       });
       return this._client;
     })();

package/package.json

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