@blockrun/llm 2.5.0 → 2.7.0

package/dist/index.js

@@ -112,8 +112,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;
@@ -2310,11 +2310,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;
@@ -2668,15 +2679,37 @@ var VoiceClient = class {
   }
 };
 
-// src/search.ts
+// src/phone.ts
 import { privateKeyToAccount as privateKeyToAccount6 } from "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;
@@ -2693,6 +2726,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
+import { privateKeyToAccount as privateKeyToAccount7 } from "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 = privateKeyToAccount7(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");
@@ -2805,9 +3035,9 @@ var SearchClient = class {
 };
 
 // src/x-client.ts
-import { privateKeyToAccount as privateKeyToAccount7 } from "viem/accounts";
-var DEFAULT_API_URL7 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT7 = 6e4;
+import { privateKeyToAccount as privateKeyToAccount8 } from "viem/accounts";
+var DEFAULT_API_URL8 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT8 = 6e4;
 var XClient = class _XClient {
   account;
   privateKey;
@@ -2830,11 +3060,11 @@ var XClient = class _XClient {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = privateKeyToAccount7(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    this.account = privateKeyToAccount8(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) {
@@ -3012,9 +3242,9 @@ var XClient = class _XClient {
 };
 
 // src/price.ts
-import { privateKeyToAccount as privateKeyToAccount8 } from "viem/accounts";
-var DEFAULT_API_URL8 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT8 = 3e4;
+import { privateKeyToAccount as privateKeyToAccount9 } from "viem/accounts";
+var DEFAULT_API_URL9 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT9 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -3032,12 +3262,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = privateKeyToAccount8(privateKey);
+      this.account = privateKeyToAccount9(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");
@@ -3216,9 +3446,9 @@ function buildUrl(base, query) {
 }
 
 // src/surf.ts
-import { privateKeyToAccount as privateKeyToAccount9 } from "viem/accounts";
-var DEFAULT_API_URL9 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT9 = 6e4;
+import { privateKeyToAccount as privateKeyToAccount10 } from "viem/accounts";
+var DEFAULT_API_URL10 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT10 = 6e4;
 var SURF_PREFIX = "/v1/surf";
 var SurfClient = class {
   account;
@@ -3235,11 +3465,11 @@ var SurfClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = privateKeyToAccount9(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL9;
+    this.account = privateKeyToAccount10(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
@@ -3371,9 +3601,9 @@ var SurfClient = class {
 };
 
 // src/blockrun.ts
-import { privateKeyToAccount as privateKeyToAccount10 } from "viem/accounts";
-var DEFAULT_API_URL10 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT10 = 6e4;
+import { privateKeyToAccount as privateKeyToAccount11 } from "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;
@@ -3394,11 +3624,11 @@ var BlockrunClient = class {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = privateKeyToAccount10(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL10;
+    this.account = privateKeyToAccount11(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL11;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT10;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT11;
   }
   /**
    * GET a BlockRun endpoint. `path` is everything after `/api` (a leading
@@ -3749,7 +3979,7 @@ function sleep(ms) {
 }
 
 // src/wallet.ts
-import { privateKeyToAccount as privateKeyToAccount11, generatePrivateKey } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount12, generatePrivateKey } from "viem/accounts";
 import * as fs2 from "fs";
 import * as path2 from "path";
 import * as os2 from "os";
@@ -3759,7 +3989,7 @@ var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
 var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
   const privateKey = generatePrivateKey();
-  const account = privateKeyToAccount11(privateKey);
+  const account = privateKeyToAccount12(privateKey);
   return {
     address: account.address,
     privateKey
@@ -3815,12 +4045,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 = privateKeyToAccount11(envKey);
+    const account = privateKeyToAccount12(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = privateKeyToAccount11(fileKey);
+    const account = privateKeyToAccount12(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -3830,11 +4060,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 privateKeyToAccount11(envKey).address;
+    return privateKeyToAccount12(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return privateKeyToAccount11(fileKey).address;
+    return privateKeyToAccount12(fileKey).address;
   }
   return null;
 }
@@ -4014,14 +4244,37 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT11 = 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;
@@ -4038,8 +4291,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_TIMEOUT11;
+    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() {
@@ -4097,7 +4352,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,
@@ -4348,7 +4603,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, {
@@ -4439,7 +4695,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, {
@@ -4530,7 +4787,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() : "";
@@ -4946,7 +5204,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-import { privateKeyToAccount as privateKeyToAccount12 } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount13 } from "viem/accounts";
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -4959,7 +5217,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = privateKeyToAccount12(this._privateKey);
+    this._account = privateKeyToAccount13(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -5064,7 +5322,9 @@ export {
   LLMClient,
   MusicClient,
   OpenAI,
+  PHONE_PRICES,
   PaymentError,
+  PhoneClient,
   PriceClient,
   SOLANA_NETWORK,
   SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",