@blockrun/llm 2.4.0 → 2.7.0

package/dist/index.cjs

@@ -33,13 +33,16 @@ __export(index_exports, {
   APIError: () => APIError,
   AnthropicClient: () => AnthropicClient,
   BASE_CHAIN_ID: () => BASE_CHAIN_ID,
+  BlockrunClient: () => BlockrunClient,
   BlockrunError: () => BlockrunError,
   ImageClient: () => ImageClient,
   KNOWN_PROVIDERS: () => KNOWN_PROVIDERS,
   LLMClient: () => LLMClient,
   MusicClient: () => MusicClient,
   OpenAI: () => OpenAI,
+  PHONE_PRICES: () => PHONE_PRICES,
   PaymentError: () => PaymentError,
+  PhoneClient: () => PhoneClient,
   PriceClient: () => PriceClient,
   SOLANA_NETWORK: () => SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH: () => SOLANA_WALLET_FILE,
@@ -210,8 +213,8 @@ async function createSolanaPaymentPayload(secretKey, fromAddress, recipient, amo
   const { Connection, PublicKey, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } = await import("@solana/web3.js");
   const { getAssociatedTokenAddress, createTransferCheckedInstruction, getMint } = await import("@solana/spl-token");
   const { Keypair } = await import("@solana/web3.js");
-  const rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-  const connection = new Connection(rpcUrl);
+  const rpcUrl = options.rpcUrl || "https://sol.blockrun.ai/api/v1/solana/rpc";
+  const connection = options.rpcHeaders ? new Connection(rpcUrl, { httpHeaders: options.rpcHeaders }) : new Connection(rpcUrl);
   const keypair = Keypair.fromSecretKey(secretKey);
   const feePayerPubkey = new PublicKey(feePayer);
   const ownerPubkey = keypair.publicKey;
@@ -2408,11 +2411,22 @@ var VideoClient = class {
    * @param options - Optional generation parameters
    */
   async generate(prompt, options) {
+    if (options?.imageUrl && options?.realFaceAssetId) {
+      throw new Error(
+        "imageUrl and realFaceAssetId are mutually exclusive; pass at most one."
+      );
+    }
+    if (options?.realFaceAssetId && !/^ta_[A-Za-z0-9]+$/.test(options.realFaceAssetId)) {
+      throw new Error(
+        "realFaceAssetId must be a Token360 asset id matching 'ta_[A-Za-z0-9]+' (e.g. 'ta_abc123xyz')"
+      );
+    }
     const body = {
       model: options?.model || DEFAULT_MODEL3,
       prompt
     };
     if (options?.imageUrl) body.image_url = options.imageUrl;
+    if (options?.realFaceAssetId) body.real_face_asset_id = options.realFaceAssetId;
     if (options?.durationSeconds !== void 0) body.duration_seconds = options.durationSeconds;
     if (options?.aspectRatio) body.aspect_ratio = options.aspectRatio;
     if (options?.resolution) body.resolution = options.resolution;
@@ -2766,15 +2780,37 @@ var VoiceClient = class {
   }
 };
 
-// src/search.ts
+// src/phone.ts
 var import_accounts7 = require("viem/accounts");
 var DEFAULT_API_URL6 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT6 = 6e4;
-var SearchClient = class {
+var PHONE_PRICES = Object.freeze({
+  lookup: 0.01,
+  "lookup/fraud": 0.05,
+  "numbers/buy": 5,
+  "numbers/renew": 5,
+  "numbers/list": 1e-3,
+  "numbers/release": 0
+});
+function requireE164(value) {
+  if (!value || typeof value !== "string") {
+    throw new Error("phoneNumber is required (E.164 format, e.g. '+14155552671')");
+  }
+  const v = value.trim();
+  if (!/^\+\d{7,15}$/.test(v)) {
+    throw new Error(
+      `phoneNumber must be E.164 (e.g. '+14155552671'), got ${JSON.stringify(value)}`
+    );
+  }
+  return v;
+}
+var PhoneClient = class {
   account;
   privateKey;
   apiUrl;
   timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
   constructor(options = {}) {
     const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
     const privateKey = options.privateKey || envKey;
@@ -2791,6 +2827,203 @@ var SearchClient = class {
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT6;
   }
+  /** EVM wallet address used for payments. */
+  getWalletAddress() {
+    return this.account.address;
+  }
+  /** Session-cumulative USD spend + call count across this client instance. */
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+  // ─── Lookup ────────────────────────────────────────────────────────────
+  /**
+   * Carrier + line-type lookup. ~$0.01.
+   *
+   * @param phoneNumber E.164 number (e.g. "+14155552671").
+   */
+  async lookup(phoneNumber) {
+    const num = requireE164(phoneNumber);
+    return this.request("lookup", { phoneNumber: num });
+  }
+  /**
+   * Lookup + fraud signals (SIM swap, call forwarding). ~$0.05.
+   *
+   * @param phoneNumber E.164 number.
+   */
+  async lookupFraud(phoneNumber) {
+    const num = requireE164(phoneNumber);
+    return this.request("lookup/fraud", { phoneNumber: num });
+  }
+  // ─── Provisioning ──────────────────────────────────────────────────────
+  /**
+   * Provision a dedicated phone number for 30 days. $5.00.
+   *
+   * Payment is settled only after Twilio confirms the purchase, so failed
+   * buys never charge your wallet.
+   *
+   * @param options.country  ISO country code, "US" or "CA" (default "US").
+   * @param options.areaCode Optional 3-digit area-code hint. Availability is
+   *   not guaranteed — the backend falls back to any number in the country if
+   *   the area code can't be matched.
+   */
+  async buyNumber(options = {}) {
+    const country = options.country ?? "US";
+    if (country !== "US" && country !== "CA") {
+      throw new Error("country must be 'US' or 'CA'");
+    }
+    const body = { country };
+    if (options.areaCode !== void 0) {
+      const ac = options.areaCode;
+      if (typeof ac !== "string" || !/^\d{3}$/.test(ac)) {
+        throw new Error("areaCode must be a 3-digit string, e.g. '415'");
+      }
+      body.areaCode = ac;
+    }
+    const data = await this.request("numbers/buy", body);
+    return data;
+  }
+  /**
+   * Extend an existing provisioned number by 30 days. $5.00.
+   *
+   * @throws {APIError} 403 when the wallet doesn't own the number or it has expired.
+   */
+  async renewNumber(phoneNumber) {
+    const num = requireE164(phoneNumber);
+    const data = await this.request("numbers/renew", {
+      phoneNumber: num
+    });
+    return data;
+  }
+  /** List the wallet's active phone numbers. ~$0.001. */
+  async listNumbers() {
+    const data = await this.request("numbers/list", {});
+    return data;
+  }
+  /**
+   * Release a provisioned number back to the Twilio pool. Free, but still
+   * flows through x402 so the backend can verify ownership.
+   */
+  async releaseNumber(phoneNumber) {
+    const num = requireE164(phoneNumber);
+    const data = await this.request("numbers/release", {
+      phoneNumber: num
+    });
+    return data;
+  }
+  // ─── Internals ─────────────────────────────────────────────────────────
+  async request(path5, body) {
+    const url = `${this.apiUrl}/v1/phone/${path5}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, body, response);
+    }
+    return this.unwrap(response, false);
+  }
+  async handlePaymentAndRetry(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const rb = await response.json();
+        if (rb.x402 || rb.accepts) paymentHeader = btoa(JSON.stringify(rb));
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || url,
+        resourceDescription: details.resource?.description || "BlockRun Phone",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retry = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retry.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    const data = await this.unwrap(retry, true);
+    const costUsd = Number.parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    const txHash = retry.headers.get("x-payment-receipt") || retry.headers.get("X-Payment-Receipt");
+    if (txHash && data && typeof data === "object" && !("txHash" in data)) {
+      data.txHash = txHash;
+    }
+    return data;
+  }
+  async unwrap(response, afterPayment) {
+    if (response.ok) {
+      return response.json();
+    }
+    let errorBody;
+    try {
+      errorBody = await response.json();
+    } catch {
+      errorBody = { error: "Request failed" };
+    }
+    const prefix = afterPayment ? "API error after payment" : "API error";
+    throw new APIError(
+      `${prefix}: ${response.status}`,
+      response.status,
+      sanitizeErrorResponse(errorBody)
+    );
+  }
+  async fetchWithTimeout(url, init) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...init, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+};
+
+// src/search.ts
+var import_accounts8 = require("viem/accounts");
+var DEFAULT_API_URL7 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT7 = 6e4;
+var SearchClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
+  }
   async search(query, options) {
     if (!query || query.length > 1e3) {
       throw new Error("query must be 1-1000 characters");
@@ -2903,9 +3136,9 @@ var SearchClient = class {
 };
 
 // src/x-client.ts
-var import_accounts8 = require("viem/accounts");
-var DEFAULT_API_URL7 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT7 = 6e4;
+var import_accounts9 = require("viem/accounts");
+var DEFAULT_API_URL8 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT8 = 6e4;
 var XClient = class _XClient {
   account;
   privateKey;
@@ -2928,11 +3161,11 @@ var XClient = class _XClient {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    this.account = (0, import_accounts9.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
   }
   // ───────── User endpoints ─────────
   userLookup(usernames) {
@@ -3110,9 +3343,9 @@ var XClient = class _XClient {
 };
 
 // src/price.ts
-var import_accounts9 = require("viem/accounts");
-var DEFAULT_API_URL8 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT8 = 3e4;
+var import_accounts10 = require("viem/accounts");
+var DEFAULT_API_URL9 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT9 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -3130,12 +3363,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = (0, import_accounts9.privateKeyToAccount)(privateKey);
+      this.account = (0, import_accounts10.privateKeyToAccount)(privateKey);
     }
-    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
+    const apiUrl = options.apiUrl || DEFAULT_API_URL9;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
   }
   async price(category, symbol, options) {
     if (!symbol) throw new Error("symbol is required");
@@ -3314,9 +3547,9 @@ function buildUrl(base, query) {
 }
 
 // src/surf.ts
-var import_accounts10 = require("viem/accounts");
-var DEFAULT_API_URL9 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT9 = 6e4;
+var import_accounts11 = require("viem/accounts");
+var DEFAULT_API_URL10 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT10 = 6e4;
 var SURF_PREFIX = "/v1/surf";
 var SurfClient = class {
   account;
@@ -3333,11 +3566,11 @@ var SurfClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts10.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL9;
+    this.account = (0, import_accounts11.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
   }
   /**
    * GET a Surf endpoint. `path` is everything after `/v1/surf` (a leading
@@ -3468,8 +3701,386 @@ var SurfClient = class {
   }
 };
 
+// src/blockrun.ts
+var import_accounts12 = require("viem/accounts");
+var DEFAULT_API_URL11 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT11 = 6e4;
+var DEFAULT_POLL_INTERVAL_MS = 5e3;
+var DEFAULT_POLL_BUDGET_MS = 3e5;
+var MAX_SIGNED_AUTH_SECONDS = 600;
+var BlockrunClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = (0, import_accounts12.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
+  }
+  /**
+   * GET a BlockRun endpoint. `path` is everything after `/api` (a leading
+   * `/api` is tolerated and stripped). Query params are URL-encoded; arrays
+   * become repeated keys (`?a=1&a=2`); undefined/null are dropped.
+   */
+  async get(path5, params) {
+    const url = this.buildUrl(path5, params);
+    return this.requestWithPayment(url, "GET");
+  }
+  /**
+   * POST a BlockRun endpoint with a JSON body.
+   */
+  async post(path5, body) {
+    const url = this.buildUrl(path5);
+    return this.requestWithPayment(url, "POST", body);
+  }
+  /**
+   * Submit a long-running job and poll until it completes.
+   *
+   * Pattern: submit → 402 → sign → 202 `{ id, poll_url, status }` → loop GET
+   * the poll_url with the SAME `PAYMENT-SIGNATURE` until status=completed (or
+   * deadline exceeded). Settlement happens only when upstream returns 200 +
+   * completed — upstream failure or caller giving up = no charge.
+   *
+   * 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.
+   */
+  async poll(path5, body, options) {
+    const submitUrl = this.buildUrl(path5);
+    const budgetMs = options?.budgetMs ?? DEFAULT_POLL_BUDGET_MS;
+    const intervalMs = options?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const resp402 = await this.fetchWithTimeout(submitUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body ?? {})
+    });
+    if (resp402.status === 200) {
+      return resp402.json();
+    }
+    if (resp402.status !== 402) {
+      await this.throwApiError(resp402, `poll submit failed (${submitUrl})`);
+    }
+    const paymentPayload = await this.signFrom402(resp402, submitUrl, {
+      description: "BlockRun async job",
+      maxTimeoutSeconds: MAX_SIGNED_AUTH_SECONDS
+    });
+    const submitResp = await this.fetchWithTimeout(submitUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body ?? {})
+    });
+    if (submitResp.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (submitResp.status !== 200 && submitResp.status !== 202) {
+      await this.throwApiError(submitResp, `poll submit failed (${submitUrl})`);
+    }
+    if (submitResp.status === 200) {
+      this.recordSpending();
+      return submitResp.json();
+    }
+    const submitData = await submitResp.json();
+    if (!submitData.id || !submitData.poll_url) {
+      throw new APIError(
+        "Async submit response missing id/poll_url",
+        submitResp.status,
+        { response: submitData }
+      );
+    }
+    const pollUrl = this.absolute(submitData.poll_url);
+    const deadline = Date.now() + budgetMs;
+    let lastStatus = submitData.status || "queued";
+    while (Date.now() < deadline) {
+      await sleep(intervalMs);
+      const pollResp = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: { "PAYMENT-SIGNATURE": paymentPayload }
+      });
+      let pollData = {};
+      try {
+        pollData = await pollResp.json();
+      } catch {
+      }
+      lastStatus = pollData.status || lastStatus;
+      if (pollResp.status === 202 && (lastStatus === "queued" || lastStatus === "in_progress")) {
+        continue;
+      }
+      if (lastStatus === "failed") {
+        throw new APIError(
+          `Upstream job failed: ${pollData.error || "unknown"}`,
+          pollResp.status,
+          sanitizeErrorResponse(pollData)
+        );
+      }
+      if (pollResp.status === 200 && lastStatus === "completed") {
+        this.recordSpending();
+        return pollData;
+      }
+      if (pollResp.status !== 200 && pollResp.status !== 202 && pollResp.status !== 504) {
+        await this.throwApiError(pollResp, `poll failed (${pollUrl})`);
+      }
+    }
+    throw new APIError(
+      `Job did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken.`,
+      504,
+      { id: submitData.id, last_status: lastStatus }
+    );
+  }
+  /**
+   * Stream a Server-Sent Events endpoint.
+   *
+   * Yields each `data: …` line parsed as JSON. Stops when the upstream emits
+   * `data: [DONE]` or closes the connection. Caller is responsible for typing
+   * the chunk shape; pass a generic for typed yields.
+   *
+   * Example — streaming chat:
+   *   for await (const chunk of br.stream<ChatChunk>("/v1/chat/completions", {
+   *     model: "anthropic/claude-sonnet-4-6",
+   *     messages: [{ role: "user", content: "Hi" }],
+   *     stream: true,
+   *   })) {
+   *     process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "");
+   *   }
+   */
+  async *stream(path5, body) {
+    const url = this.buildUrl(path5);
+    const requestBody = JSON.stringify(body ?? {});
+    const resp402 = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: requestBody
+    });
+    let streamResp;
+    if (resp402.status === 200) {
+      streamResp = resp402;
+    } else if (resp402.status === 402) {
+      const paymentPayload = await this.signFrom402(resp402, url, {
+        description: "BlockRun stream"
+      });
+      streamResp = await this.fetchWithTimeout(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "PAYMENT-SIGNATURE": paymentPayload
+        },
+        body: requestBody
+      });
+      if (streamResp.status === 402) {
+        throw new PaymentError(
+          "Payment was rejected. Check your wallet balance."
+        );
+      }
+      if (!streamResp.ok) {
+        await this.throwApiError(streamResp, `stream failed after payment (${url})`);
+      }
+      this.recordSpending();
+    } else {
+      await this.throwApiError(resp402, `stream failed (${url})`);
+      return;
+    }
+    if (!streamResp.body) {
+      throw new APIError("Stream response has no body", streamResp.status, {});
+    }
+    const reader = streamResp.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (!trimmed || !trimmed.startsWith("data: ")) continue;
+          const data = trimmed.slice(6);
+          if (data === "[DONE]") return;
+          try {
+            yield JSON.parse(data);
+          } catch {
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  // --------------------------------------------------------------------
+  // Internal: shared infrastructure
+  // --------------------------------------------------------------------
+  buildUrl(path5, params) {
+    let normalized = path5.startsWith("/") ? path5 : `/${path5}`;
+    if (normalized.startsWith("/api/")) {
+      normalized = normalized.slice(4);
+    }
+    const base = `${this.apiUrl}${normalized}`;
+    if (!params) return base;
+    const qs = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value === void 0 || value === null) continue;
+      if (Array.isArray(value)) {
+        for (const v of value) {
+          if (v === void 0 || v === null) continue;
+          qs.append(key, String(v));
+        }
+      } else {
+        qs.append(key, String(value));
+      }
+    }
+    const query = qs.toString();
+    return query ? `${base}?${query}` : base;
+  }
+  absolute(url) {
+    if (url.startsWith("http://") || url.startsWith("https://")) return url;
+    const base = this.apiUrl.endsWith("/api") ? this.apiUrl.slice(0, -"/api".length) : this.apiUrl;
+    return `${base}${url}`;
+  }
+  async requestWithPayment(url, method, body) {
+    const init = { method };
+    if (method === "POST") {
+      init.headers = { "Content-Type": "application/json" };
+      init.body = JSON.stringify(body ?? {});
+    }
+    const response = await this.fetchWithTimeout(url, init);
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, method, body, response);
+    }
+    if (!response.ok) {
+      await this.throwApiError(response, `${method} ${url} failed`);
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, method, body, response) {
+    const paymentPayload = await this.signFrom402(response, url, {
+      description: "BlockRun"
+    });
+    const retryInit = {
+      method,
+      headers: { "PAYMENT-SIGNATURE": paymentPayload }
+    };
+    if (method === "POST") {
+      retryInit.headers = {
+        ...retryInit.headers,
+        "Content-Type": "application/json"
+      };
+      retryInit.body = JSON.stringify(body ?? {});
+    }
+    const retry = await this.fetchWithTimeout(url, retryInit);
+    if (retry.status === 402) {
+      throw new PaymentError(
+        "Payment was rejected. Check your wallet balance."
+      );
+    }
+    if (!retry.ok) {
+      await this.throwApiError(retry, `${method} ${url} failed after payment`);
+    }
+    this.recordSpending();
+    return retry.json();
+  }
+  /**
+   * Read a 402 response's payment requirements (header or body), then sign and
+   * return the base64 PAYMENT-SIGNATURE payload. Also records the cost-to-be
+   * onto the response context (settled on `recordSpending`).
+   */
+  async signFrom402(response, url, opts) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402Version !== void 0 || respBody.accepts !== void 0) {
+          paymentHeader = btoa(JSON.stringify(respBody));
+        }
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    this.pendingCostUsd = parseFloat(details.amount) / 1e6;
+    return createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || url,
+        resourceDescription: details.resource?.description || opts.description,
+        maxTimeoutSeconds: Math.max(
+          details.maxTimeoutSeconds || 0,
+          opts.maxTimeoutSeconds || 300
+        ),
+        extra: details.extra
+      }
+    );
+  }
+  /** Accumulates the most-recent pending cost; settled by recordSpending. */
+  pendingCostUsd = 0;
+  recordSpending() {
+    if (this.pendingCostUsd > 0) {
+      this.sessionCalls += 1;
+      this.sessionTotalUsd += this.pendingCostUsd;
+      this.pendingCostUsd = 0;
+    }
+  }
+  async throwApiError(resp, prefix) {
+    let errorBody;
+    try {
+      errorBody = await resp.json();
+    } catch {
+      errorBody = { error: "Request failed" };
+    }
+    throw new APIError(
+      `${prefix}: HTTP ${resp.status}`,
+      resp.status,
+      sanitizeErrorResponse(errorBody)
+    );
+  }
+  async fetchWithTimeout(url, init) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...init, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  // --------------------------------------------------------------------
+  // Public surface: wallet + spending
+  // --------------------------------------------------------------------
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
 // src/wallet.ts
-var import_accounts11 = require("viem/accounts");
+var import_accounts13 = require("viem/accounts");
 var fs2 = __toESM(require("fs"), 1);
 var path2 = __toESM(require("path"), 1);
 var os2 = __toESM(require("os"), 1);
@@ -3478,8 +4089,8 @@ var BASE_CHAIN_ID2 = "8453";
 var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
 var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
-  const privateKey = (0, import_accounts11.generatePrivateKey)();
-  const account = (0, import_accounts11.privateKeyToAccount)(privateKey);
+  const privateKey = (0, import_accounts13.generatePrivateKey)();
+  const account = (0, import_accounts13.privateKeyToAccount)(privateKey);
   return {
     address: account.address,
     privateKey
@@ -3535,12 +4146,12 @@ function loadWallet() {
 function getOrCreateWallet() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    const account = (0, import_accounts11.privateKeyToAccount)(envKey);
+    const account = (0, import_accounts13.privateKeyToAccount)(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = (0, import_accounts11.privateKeyToAccount)(fileKey);
+    const account = (0, import_accounts13.privateKeyToAccount)(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -3550,11 +4161,11 @@ function getOrCreateWallet() {
 function getWalletAddress() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    return (0, import_accounts11.privateKeyToAccount)(envKey).address;
+    return (0, import_accounts13.privateKeyToAccount)(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return (0, import_accounts11.privateKeyToAccount)(fileKey).address;
+    return (0, import_accounts13.privateKeyToAccount)(fileKey).address;
   }
   return null;
 }
@@ -3734,14 +4345,37 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT10 = 6e4;
+var DEFAULT_TIMEOUT12 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
+var DEFAULT_SOLANA_RPC_URL = "https://sol.blockrun.ai/api/v1/solana/rpc";
+function resolveRpcConfig(rpcUrl, rpcHeaders) {
+  const env = typeof process !== "undefined" && process.env ? process.env : {};
+  const url = rpcUrl || env.SOLANA_RPC_URL || DEFAULT_SOLANA_RPC_URL;
+  let headers;
+  if (rpcHeaders) {
+    headers = { ...rpcHeaders };
+  } else if (env.SOLANA_RPC_HEADERS) {
+    try {
+      const parsed = JSON.parse(env.SOLANA_RPC_HEADERS);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        headers = Object.fromEntries(
+          Object.entries(parsed).map(([k, v]) => [String(k), String(v)])
+        );
+      }
+    } catch {
+    }
+  } else if (env.SOLANA_RPC_API_KEY) {
+    headers = { "x-api-key": env.SOLANA_RPC_API_KEY };
+  }
+  return headers ? { url, headers } : { url };
+}
 var SolanaLLMClient = class {
   static SOLANA_API_URL = SOLANA_API_URL;
   privateKey;
   apiUrl;
   rpcUrl;
+  rpcHeaders;
   timeout;
   sessionTotalUsd = 0;
   sessionCalls = 0;
@@ -3758,8 +4392,10 @@ var SolanaLLMClient = class {
     const apiUrl = options.apiUrl || SOLANA_API_URL;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
+    const rpc = resolveRpcConfig(options.rpcUrl, options.rpcHeaders);
+    this.rpcUrl = rpc.url;
+    this.rpcHeaders = rpc.headers;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT12;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -3817,7 +4453,7 @@ var SolanaLLMClient = class {
     try {
       const response = await fetch(this.rpcUrl, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers: { "Content-Type": "application/json", ...this.rpcHeaders ?? {} },
         body: JSON.stringify({
           jsonrpc: "2.0",
           id: 1,
@@ -4068,7 +4704,8 @@ var SolanaLLMClient = class {
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
         extensions,
-        rpcUrl: this.rpcUrl
+        rpcUrl: this.rpcUrl,
+        rpcHeaders: this.rpcHeaders
       }
     );
     const retryResponse = await this.fetchWithTimeout(url, {
@@ -4159,7 +4796,8 @@ var SolanaLLMClient = class {
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
         extensions,
-        rpcUrl: this.rpcUrl
+        rpcUrl: this.rpcUrl,
+        rpcHeaders: this.rpcHeaders
       }
     );
     const retryResponse = await this.fetchWithTimeout(url, {
@@ -4250,7 +4888,8 @@ var SolanaLLMClient = class {
         maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
         extra: details.extra,
         extensions,
-        rpcUrl: this.rpcUrl
+        rpcUrl: this.rpcUrl,
+        rpcHeaders: this.rpcHeaders
       }
     );
     const query = params ? "?" + new URLSearchParams(params).toString() : "";
@@ -4666,7 +5305,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-var import_accounts12 = require("viem/accounts");
+var import_accounts14 = require("viem/accounts");
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -4679,7 +5318,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = (0, import_accounts12.privateKeyToAccount)(this._privateKey);
+    this._account = (0, import_accounts14.privateKeyToAccount)(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -4778,13 +5417,16 @@ var AnthropicClient = class {
   APIError,
   AnthropicClient,
   BASE_CHAIN_ID,
+  BlockrunClient,
   BlockrunError,
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
   MusicClient,
   OpenAI,
+  PHONE_PRICES,
   PaymentError,
+  PhoneClient,
   PriceClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE_PATH,