@blockrun/llm 1.6.1 → 1.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @blockrun/llm (TypeScript SDK)
 
-> **@blockrun/llm** is a TypeScript/Node.js SDK for accessing 40+ large language models (GPT-5, Claude, Gemini, Grok, DeepSeek, Kimi, and more) with automatic pay-per-request USDC micropayments via the x402 protocol. No API keys required — your wallet signature is your authentication. Supports Base and Solana chains.
+> **@blockrun/llm** is a TypeScript/Node.js SDK for accessing 41+ large language models (GPT-5, Claude, Gemini, Grok, DeepSeek, Kimi, and more) with automatic pay-per-request USDC micropayments via the x402 protocol. No API keys required — your wallet signature is your authentication. Supports **streaming**, smart routing, Base and Solana chains.
 
 [![npm](https://img.shields.io/npm/v/@blockrun/llm.svg)](https://www.npmjs.com/package/@blockrun/llm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
@@ -264,6 +264,28 @@ All models below have been tested end-to-end via the TypeScript SDK (Feb 2026):
 | `google/nano-banana` | $0.05/image |
 | `google/nano-banana-pro` | $0.10-0.15/image |
 | `black-forest/flux-1.1-pro` | $0.04/image |
+| `xai/grok-imagine-image` | $0.02/image |
+| `xai/grok-imagine-image-pro` | $0.07/image |
+| `zai/cogview-4` | $0.015/image |
+
+### Video Generation
+| Model | Price |
+|-------|-------|
+| `xai/grok-imagine-video` | $0.05/sec (8s default → $0.42/clip) |
+
+```ts
+import { VideoClient } from '@blockrun/llm';
+
+const client = new VideoClient();
+const result = await client.generate('a red apple slowly spinning on a wooden table');
+console.log(result.data[0].url);             // permanent MP4 URL
+console.log(result.data[0].duration_seconds); // 8
+
+// Image-to-video
+const r2 = await client.generate('the subject turns and smiles', {
+  imageUrl: 'https://example.com/portrait.jpg',
+});
+```
 
 ### Testnet Models (Base Sepolia)
 | Model | Price |
@@ -462,6 +484,74 @@ const result = await client.chatCompletion('openai/gpt-4o', messages);
 console.log(result.choices[0].message.content);
 ```
 
+### Streaming
+
+Stream responses token-by-token with automatic x402 payment. Uses a **pre-auth cache** to skip the 402 round-trip on repeat calls to the same model (~200ms saved per request after the first).
+
+#### OpenAI-compatible (recommended)
+
+```typescript
+import { OpenAI } from '@blockrun/llm';
+
+const client = new OpenAI({ walletKey: process.env.BASE_CHAIN_WALLET_KEY });
+
+const stream = await client.chat.completions.create({
+  model: 'openai/gpt-5.4',
+  messages: [{ role: 'user', content: 'Write a short story about AI agents' }],
+  stream: true,
+});
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content || '');
+}
+```
+
+#### Native client
+
+```typescript
+import { LLMClient, type ChatMessage } from '@blockrun/llm';
+
+const client = new LLMClient();
+
+const messages: ChatMessage[] = [
+  { role: 'user', content: 'Explain quantum computing in simple terms' },
+];
+
+// Returns a raw fetch Response with SSE body
+const response = await client.chatCompletionStream('google/gemini-2.5-flash', messages);
+
+const reader = response.body!.getReader();
+const decoder = new TextDecoder();
+
+while (true) {
+  const { done, value } = await reader.read();
+  if (done) break;
+
+  const chunk = decoder.decode(value, { stream: true });
+  for (const line of chunk.split('\n')) {
+    if (!line.startsWith('data: ') || line === 'data: [DONE]') continue;
+    const data = JSON.parse(line.slice(6));
+    process.stdout.write(data.choices?.[0]?.delta?.content || '');
+  }
+}
+```
+
+#### Payment + streaming flow
+
+```
+First call (cache miss):
+  1. Send request → 402 response (BlockRun returns price)
+  2. Sign USDC payment locally (key never leaves machine)
+  3. Retry with PAYMENT-SIGNATURE header + stream: true
+  4. Cache payment requirements for this model (1h TTL)
+  5. Stream tokens as they arrive
+
+Subsequent calls (cache hit):
+  1. Pre-sign payment from cache — skip 402 round-trip
+  2. Send request with PAYMENT-SIGNATURE upfront
+  3. Stream tokens immediately (~200ms faster)
+```
+
 ### List Available Models
 
 ```typescript
@@ -724,10 +814,12 @@ Full TypeScript support with exported types:
 ```typescript
 import {
   LLMClient,
+  OpenAI,
   testnetClient,
   type ChatMessage,
   type ChatResponse,
   type ChatOptions,
+  type ChatCompletionOptions,
   type Model,
   // Smart routing types
   type SmartChatOptions,
@@ -738,6 +830,14 @@ import {
   APIError,
   PaymentError,
 } from '@blockrun/llm';
+
+// chatCompletionStream returns a standard fetch Response with SSE body
+const streamResponse: Response = await client.chatCompletionStream(model, messages, options);
+
+// OpenAI-compat stream returns AsyncIterable
+const stream: AsyncIterable<OpenAIChatCompletionChunk> = await openaiClient.chat.completions.create({
+  model, messages, stream: true
+});
 ```
 
 ## Agent Wallet Setup
@@ -862,6 +962,9 @@ When you make an API call, the SDK automatically handles x402 payment. It signs
 ### What is smart routing / ClawRouter?
 ClawRouter is a built-in smart routing engine that analyzes your request across 14 dimensions and automatically picks the cheapest model capable of handling it. Routing happens locally in under 1ms. It can save up to 78% on LLM costs compared to using premium models for every request.
 
+### Does it support streaming?
+Yes — as of v1.6.1. Use `client.chatCompletionStream()` for native streaming or `stream: true` in the OpenAI-compatible client. Payment is handled automatically: the SDK signs USDC payment before streaming begins, and caches payment requirements per model so subsequent calls skip the 402 round-trip (~200ms faster).
+
 ### How much does it cost?
 Pay only for what you use. Prices start at $0.0002 per request (GPT-5 Nano). There are no minimums, subscriptions, or monthly fees. $5 in USDC gets you thousands of requests.
 

package/dist/index.cjs

@@ -37,6 +37,7 @@ __export(index_exports, {
   ImageClient: () => ImageClient,
   KNOWN_PROVIDERS: () => KNOWN_PROVIDERS,
   LLMClient: () => LLMClient,
+  MusicClient: () => MusicClient,
   OpenAI: () => OpenAI,
   PaymentError: () => PaymentError,
   SOLANA_NETWORK: () => SOLANA_NETWORK,
@@ -1898,8 +1899,163 @@ var ImageClient = class {
   }
 };
 
-// src/wallet.ts
+// src/music.ts
 var import_accounts4 = require("viem/accounts");
+var DEFAULT_API_URL3 = "https://blockrun.ai/api";
+var DEFAULT_MODEL2 = "minimax/music-2.5+";
+var DEFAULT_TIMEOUT3 = 21e4;
+var MusicClient = 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_accounts4.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL3;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT3;
+  }
+  /**
+   * Generate a music track from a text prompt.
+   *
+   * Takes 1-3 minutes. Returns a CDN URL valid for ~24h.
+   *
+   * @param prompt - Music style, mood, or description
+   * @param options - Optional generation parameters
+   * @returns MusicResponse with track URL and metadata
+   *
+   * @example
+   * const result = await client.generate('chill lo-fi beats with piano');
+   * console.log(result.data[0].url); // Download this URL — expires in 24h
+   *
+   * @example With lyrics
+   * const result = await client.generate('upbeat pop song', {
+   *   instrumental: false,
+   *   lyrics: 'Hello world, this is my song...'
+   * });
+   */
+  async generate(prompt, options) {
+    const instrumental = options?.instrumental ?? true;
+    const lyrics = options?.lyrics?.trim();
+    if (instrumental && lyrics) {
+      throw new Error("Cannot specify lyrics when instrumental is true");
+    }
+    const body = {
+      model: options?.model || DEFAULT_MODEL2,
+      prompt,
+      instrumental
+    };
+    if (lyrics) body.lyrics = lyrics;
+    return this.requestWithPayment("/v1/audio/generations", body);
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    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);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          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);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}/v1/audio/generations`,
+        resourceDescription: details.resource?.description || "BlockRun Music Generation",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    const data = await retryResponse.json();
+    this.sessionCalls++;
+    this.sessionTotalUsd += 0.1575;
+    const txHash = retryResponse.headers.get("x-payment-receipt") || retryResponse.headers.get("X-Payment-Receipt");
+    if (txHash) data.txHash = txHash;
+    return data;
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
+// src/wallet.ts
+var import_accounts5 = require("viem/accounts");
 var fs = __toESM(require("fs"), 1);
 var path = __toESM(require("path"), 1);
 var os = __toESM(require("os"), 1);
@@ -1908,8 +2064,8 @@ var BASE_CHAIN_ID2 = "8453";
 var WALLET_DIR = path.join(os.homedir(), ".blockrun");
 var WALLET_FILE = path.join(WALLET_DIR, ".session");
 function createWallet() {
-  const privateKey = (0, import_accounts4.generatePrivateKey)();
-  const account = (0, import_accounts4.privateKeyToAccount)(privateKey);
+  const privateKey = (0, import_accounts5.generatePrivateKey)();
+  const account = (0, import_accounts5.privateKeyToAccount)(privateKey);
   return {
     address: account.address,
     privateKey
@@ -1965,12 +2121,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_accounts4.privateKeyToAccount)(envKey);
+    const account = (0, import_accounts5.privateKeyToAccount)(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = (0, import_accounts4.privateKeyToAccount)(fileKey);
+    const account = (0, import_accounts5.privateKeyToAccount)(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -1980,11 +2136,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_accounts4.privateKeyToAccount)(envKey).address;
+    return (0, import_accounts5.privateKeyToAccount)(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return (0, import_accounts4.privateKeyToAccount)(fileKey).address;
+    return (0, import_accounts5.privateKeyToAccount)(fileKey).address;
   }
   return null;
 }
@@ -2164,7 +2320,7 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT3 = 6e4;
+var DEFAULT_TIMEOUT4 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
 var SolanaLLMClient = class {
@@ -2189,7 +2345,7 @@ var SolanaLLMClient = class {
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-    this.timeout = options.timeout || DEFAULT_TIMEOUT3;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT4;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -3134,7 +3290,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-var import_accounts5 = require("viem/accounts");
+var import_accounts6 = require("viem/accounts");
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -3147,7 +3303,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = (0, import_accounts5.privateKeyToAccount)(this._privateKey);
+    this._account = (0, import_accounts6.privateKeyToAccount)(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -3250,6 +3406,7 @@ var AnthropicClient = class {
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
+  MusicClient,
   OpenAI,
   PaymentError,
   SOLANA_NETWORK,

package/dist/index.d.cts

@@ -70,6 +70,10 @@ interface Model {
 }
 interface ImageData {
     url: string;
+    /** Original upstream URL (e.g. imgen.x.ai). Omitted for data URIs. */
+    source_url?: string;
+    /** True when the gateway mirrored the image to its GCS bucket. Omitted for data URIs. */
+    backed_up?: boolean;
     revised_prompt?: string;
     b64_json?: string;
 }
@@ -286,6 +290,91 @@ interface ImageEditOptions {
     /** Number of images to generate (default: 1) */
     n?: number;
 }
+interface AudioTrack {
+    url: string;
+    duration_seconds?: number;
+    lyrics?: string;
+}
+interface MusicResponse {
+    created: number;
+    model: string;
+    data: AudioTrack[];
+    txHash?: string;
+}
+interface AudioModel {
+    id: string;
+    name: string;
+    provider: string;
+    description: string;
+    pricePerTrack: number;
+    maxDurationSeconds: number;
+    supportsLyrics: boolean;
+    supportsInstrumental: boolean;
+    available: boolean;
+    type: "audio";
+}
+interface MusicClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 210000 — music gen takes 1-3 min) */
+    timeout?: number;
+}
+interface MusicGenerateOptions {
+    /** Model ID (default: "minimax/music-2.5+") */
+    model?: "minimax/music-2.5+" | "minimax/music-2.5";
+    /** Generate without vocals (default: true) */
+    instrumental?: boolean;
+    /** Custom lyrics — cannot be used with instrumental: true */
+    lyrics?: string;
+}
+interface VideoClip {
+    /** Permanent blockrun-hosted URL (falls back to upstream if backup fails) */
+    url: string;
+    /** Original upstream URL (e.g. vidgen.x.ai) */
+    source_url?: string;
+    /** Duration of the generated video */
+    duration_seconds?: number;
+    /** Upstream provider's request id (xAI) */
+    request_id?: string;
+    /** True when the gateway mirrored the video to its GCS bucket */
+    backed_up?: boolean;
+}
+interface VideoResponse {
+    created: number;
+    model: string;
+    data: VideoClip[];
+    txHash?: string;
+}
+interface VideoModel {
+    id: string;
+    name: string;
+    provider: string;
+    description: string;
+    pricePerSecond: number;
+    defaultDurationSeconds: number;
+    maxDurationSeconds: number;
+    supportsImageInput: boolean;
+    available: boolean;
+    type: "video";
+}
+interface VideoClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 300000 — video gen + polling up to 3 min) */
+    timeout?: number;
+}
+interface VideoGenerateOptions {
+    /** Model ID (default: "xai/grok-imagine-video") */
+    model?: "xai/grok-imagine-video" | string;
+    /** Optional seed image URL for image-to-video */
+    imageUrl?: string;
+    /** Duration to bill for (defaults to model's default duration) */
+    durationSeconds?: number;
+}
 interface SearchOptions {
     /** Source types to search (e.g. ["web", "x", "news"]) */
     sources?: string[];
@@ -967,8 +1056,8 @@ declare function testnetClient(options?: Omit<LLMClientOptions, 'apiUrl'>): LLMC
 /**
  * BlockRun Image Generation Client.
  *
- * Generate images using Nano Banana (Google Gemini), DALL-E 3, or GPT Image
- * with automatic x402 micropayments on Base chain.
+ * Generate images using Nano Banana (Google Gemini), DALL-E 3, GPT Image,
+ * or CogView-4 (Zhipu AI) with automatic x402 micropayments on Base chain.
  */
 declare class ImageClient {
     private account;
@@ -1034,6 +1123,67 @@ declare class ImageClient {
     getSpending(): Spending;
 }
 
+/**
+ * BlockRun Music Client - Generate music tracks via x402 micropayments.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Usage:
+ *   import { MusicClient } from '@blockrun/llm';
+ *
+ *   const client = new MusicClient({ privateKey: '0x...' });
+ *   const result = await client.generate('upbeat synthwave with neon pads');
+ *   console.log(result.data[0].url); // CDN URL — download within 24h
+ */
+
+/**
+ * BlockRun Music Generation Client.
+ *
+ * Generate full-length ~3 minute music tracks using MiniMax Music 2.5+
+ * with automatic x402 micropayments on Base chain.
+ *
+ * Pricing: $0.1575/track
+ * Note: Generated URLs expire in ~24h — download immediately if needed.
+ */
+declare class MusicClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: MusicClientOptions);
+    /**
+     * Generate a music track from a text prompt.
+     *
+     * Takes 1-3 minutes. Returns a CDN URL valid for ~24h.
+     *
+     * @param prompt - Music style, mood, or description
+     * @param options - Optional generation parameters
+     * @returns MusicResponse with track URL and metadata
+     *
+     * @example
+     * const result = await client.generate('chill lo-fi beats with piano');
+     * console.log(result.data[0].url); // Download this URL — expires in 24h
+     *
+     * @example With lyrics
+     * const result = await client.generate('upbeat pop song', {
+     *   instrumental: false,
+     *   lyrics: 'Hello world, this is my song...'
+     * });
+     */
+    generate(prompt: string, options?: MusicGenerateOptions): Promise<MusicResponse>;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * x402 Payment Protocol v2 Implementation for BlockRun.
  *
@@ -1664,4 +1814,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type SpendingReport, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type SpendingReport, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.d.ts

@@ -70,6 +70,10 @@ interface Model {
 }
 interface ImageData {
     url: string;
+    /** Original upstream URL (e.g. imgen.x.ai). Omitted for data URIs. */
+    source_url?: string;
+    /** True when the gateway mirrored the image to its GCS bucket. Omitted for data URIs. */
+    backed_up?: boolean;
     revised_prompt?: string;
     b64_json?: string;
 }
@@ -286,6 +290,91 @@ interface ImageEditOptions {
     /** Number of images to generate (default: 1) */
     n?: number;
 }
+interface AudioTrack {
+    url: string;
+    duration_seconds?: number;
+    lyrics?: string;
+}
+interface MusicResponse {
+    created: number;
+    model: string;
+    data: AudioTrack[];
+    txHash?: string;
+}
+interface AudioModel {
+    id: string;
+    name: string;
+    provider: string;
+    description: string;
+    pricePerTrack: number;
+    maxDurationSeconds: number;
+    supportsLyrics: boolean;
+    supportsInstrumental: boolean;
+    available: boolean;
+    type: "audio";
+}
+interface MusicClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 210000 — music gen takes 1-3 min) */
+    timeout?: number;
+}
+interface MusicGenerateOptions {
+    /** Model ID (default: "minimax/music-2.5+") */
+    model?: "minimax/music-2.5+" | "minimax/music-2.5";
+    /** Generate without vocals (default: true) */
+    instrumental?: boolean;
+    /** Custom lyrics — cannot be used with instrumental: true */
+    lyrics?: string;
+}
+interface VideoClip {
+    /** Permanent blockrun-hosted URL (falls back to upstream if backup fails) */
+    url: string;
+    /** Original upstream URL (e.g. vidgen.x.ai) */
+    source_url?: string;
+    /** Duration of the generated video */
+    duration_seconds?: number;
+    /** Upstream provider's request id (xAI) */
+    request_id?: string;
+    /** True when the gateway mirrored the video to its GCS bucket */
+    backed_up?: boolean;
+}
+interface VideoResponse {
+    created: number;
+    model: string;
+    data: VideoClip[];
+    txHash?: string;
+}
+interface VideoModel {
+    id: string;
+    name: string;
+    provider: string;
+    description: string;
+    pricePerSecond: number;
+    defaultDurationSeconds: number;
+    maxDurationSeconds: number;
+    supportsImageInput: boolean;
+    available: boolean;
+    type: "video";
+}
+interface VideoClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 300000 — video gen + polling up to 3 min) */
+    timeout?: number;
+}
+interface VideoGenerateOptions {
+    /** Model ID (default: "xai/grok-imagine-video") */
+    model?: "xai/grok-imagine-video" | string;
+    /** Optional seed image URL for image-to-video */
+    imageUrl?: string;
+    /** Duration to bill for (defaults to model's default duration) */
+    durationSeconds?: number;
+}
 interface SearchOptions {
     /** Source types to search (e.g. ["web", "x", "news"]) */
     sources?: string[];
@@ -967,8 +1056,8 @@ declare function testnetClient(options?: Omit<LLMClientOptions, 'apiUrl'>): LLMC
 /**
  * BlockRun Image Generation Client.
  *
- * Generate images using Nano Banana (Google Gemini), DALL-E 3, or GPT Image
- * with automatic x402 micropayments on Base chain.
+ * Generate images using Nano Banana (Google Gemini), DALL-E 3, GPT Image,
+ * or CogView-4 (Zhipu AI) with automatic x402 micropayments on Base chain.
  */
 declare class ImageClient {
     private account;
@@ -1034,6 +1123,67 @@ declare class ImageClient {
     getSpending(): Spending;
 }
 
+/**
+ * BlockRun Music Client - Generate music tracks via x402 micropayments.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Usage:
+ *   import { MusicClient } from '@blockrun/llm';
+ *
+ *   const client = new MusicClient({ privateKey: '0x...' });
+ *   const result = await client.generate('upbeat synthwave with neon pads');
+ *   console.log(result.data[0].url); // CDN URL — download within 24h
+ */
+
+/**
+ * BlockRun Music Generation Client.
+ *
+ * Generate full-length ~3 minute music tracks using MiniMax Music 2.5+
+ * with automatic x402 micropayments on Base chain.
+ *
+ * Pricing: $0.1575/track
+ * Note: Generated URLs expire in ~24h — download immediately if needed.
+ */
+declare class MusicClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: MusicClientOptions);
+    /**
+     * Generate a music track from a text prompt.
+     *
+     * Takes 1-3 minutes. Returns a CDN URL valid for ~24h.
+     *
+     * @param prompt - Music style, mood, or description
+     * @param options - Optional generation parameters
+     * @returns MusicResponse with track URL and metadata
+     *
+     * @example
+     * const result = await client.generate('chill lo-fi beats with piano');
+     * console.log(result.data[0].url); // Download this URL — expires in 24h
+     *
+     * @example With lyrics
+     * const result = await client.generate('upbeat pop song', {
+     *   instrumental: false,
+     *   lyrics: 'Hello world, this is my song...'
+     * });
+     */
+    generate(prompt: string, options?: MusicGenerateOptions): Promise<MusicResponse>;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * x402 Payment Protocol v2 Implementation for BlockRun.
  *
@@ -1664,4 +1814,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type SpendingReport, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type SpendingReport, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.js

@@ -1813,8 +1813,163 @@ var ImageClient = class {
   }
 };
 
+// src/music.ts
+import { privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+var DEFAULT_API_URL3 = "https://blockrun.ai/api";
+var DEFAULT_MODEL2 = "minimax/music-2.5+";
+var DEFAULT_TIMEOUT3 = 21e4;
+var MusicClient = 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 = privateKeyToAccount3(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL3;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT3;
+  }
+  /**
+   * Generate a music track from a text prompt.
+   *
+   * Takes 1-3 minutes. Returns a CDN URL valid for ~24h.
+   *
+   * @param prompt - Music style, mood, or description
+   * @param options - Optional generation parameters
+   * @returns MusicResponse with track URL and metadata
+   *
+   * @example
+   * const result = await client.generate('chill lo-fi beats with piano');
+   * console.log(result.data[0].url); // Download this URL — expires in 24h
+   *
+   * @example With lyrics
+   * const result = await client.generate('upbeat pop song', {
+   *   instrumental: false,
+   *   lyrics: 'Hello world, this is my song...'
+   * });
+   */
+  async generate(prompt, options) {
+    const instrumental = options?.instrumental ?? true;
+    const lyrics = options?.lyrics?.trim();
+    if (instrumental && lyrics) {
+      throw new Error("Cannot specify lyrics when instrumental is true");
+    }
+    const body = {
+      model: options?.model || DEFAULT_MODEL2,
+      prompt,
+      instrumental
+    };
+    if (lyrics) body.lyrics = lyrics;
+    return this.requestWithPayment("/v1/audio/generations", body);
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    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);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          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);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}/v1/audio/generations`,
+        resourceDescription: details.resource?.description || "BlockRun Music Generation",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    const data = await retryResponse.json();
+    this.sessionCalls++;
+    this.sessionTotalUsd += 0.1575;
+    const txHash = retryResponse.headers.get("x-payment-receipt") || retryResponse.headers.get("X-Payment-Receipt");
+    if (txHash) data.txHash = txHash;
+    return data;
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
 // src/wallet.ts
-import { privateKeyToAccount as privateKeyToAccount3, generatePrivateKey } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount4, generatePrivateKey } from "viem/accounts";
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
@@ -1824,7 +1979,7 @@ var WALLET_DIR = path.join(os.homedir(), ".blockrun");
 var WALLET_FILE = path.join(WALLET_DIR, ".session");
 function createWallet() {
   const privateKey = generatePrivateKey();
-  const account = privateKeyToAccount3(privateKey);
+  const account = privateKeyToAccount4(privateKey);
   return {
     address: account.address,
     privateKey
@@ -1880,12 +2035,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 = privateKeyToAccount3(envKey);
+    const account = privateKeyToAccount4(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = privateKeyToAccount3(fileKey);
+    const account = privateKeyToAccount4(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -1895,11 +2050,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 privateKeyToAccount3(envKey).address;
+    return privateKeyToAccount4(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return privateKeyToAccount3(fileKey).address;
+    return privateKeyToAccount4(fileKey).address;
   }
   return null;
 }
@@ -2079,7 +2234,7 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT3 = 6e4;
+var DEFAULT_TIMEOUT4 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
 var SolanaLLMClient = class {
@@ -2104,7 +2259,7 @@ var SolanaLLMClient = class {
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-    this.timeout = options.timeout || DEFAULT_TIMEOUT3;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT4;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -3049,7 +3204,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -3062,7 +3217,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = privateKeyToAccount4(this._privateKey);
+    this._account = privateKeyToAccount5(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -3164,6 +3319,7 @@ export {
   ImageClient,
   KNOWN_PROVIDERS,
   LLMClient,
+  MusicClient,
   OpenAI,
   PaymentError,
   SOLANA_NETWORK,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "type": "module",
-  "description": "BlockRun LLM Gateway SDK - Pay-per-request AI via x402 on Base and Solana",
+  "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music) via x402 on Base and Solana",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",