@blockrun/llm 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -301,7 +301,7 @@ declare class LLMClient {
      * ```ts
      * const result = await client.smartChat('What is 2+2?');
      * console.log(result.response); // '4'
-     * console.log(result.model); // 'google/gemini-2.5-flash'
+     * console.log(result.model); // 'google/gemini-2.5-flash-lite'
      * console.log(result.routing.savings); // 0.78 (78% savings)
      * ```
      *
@@ -502,6 +502,33 @@ declare class ImageClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreateSolanaPaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+    rpcUrl?: string;
+}
+/**
+ * Create a signed Solana x402 v2 payment payload.
+ *
+ * This creates an SPL TransferChecked transaction for USDC payment
+ * that the CDP facilitator can verify and settle.
+ *
+ * Requires @solana/web3.js and @solana/spl-token dependencies.
+ *
+ * @param secretKey - Solana secret key (Uint8Array, 64 bytes)
+ * @param fromAddress - Sender wallet address (base58)
+ * @param recipient - Payment recipient address (base58)
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param feePayer - CDP facilitator fee payer address (base58)
+ * @param options - Additional options
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -602,6 +629,89 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/**
+ * BlockRun Solana LLM Client.
+ *
+ * Usage:
+ *   import { SolanaLLMClient } from '@blockrun/llm';
+ *
+ *   // SOLANA_WALLET_KEY env var (bs58-encoded Solana secret key)
+ *   const client = new SolanaLLMClient();
+ *
+ *   // Or pass key directly
+ *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
+ *
+ *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ */
+
+interface SolanaLLMClientOptions {
+    /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
+    privateKey?: string;
+    /** API endpoint URL (default: https://sol.blockrun.ai/api) */
+    apiUrl?: string;
+    /** Solana RPC URL (default: https://api.mainnet-beta.solana.com) */
+    rpcUrl?: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+declare class SolanaLLMClient {
+    static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
+    private privateKey;
+    private apiUrl;
+    private rpcUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    private addressCache;
+    constructor(options?: SolanaLLMClientOptions);
+    /** Get Solana wallet address (public key in base58). */
+    getWalletAddress(): Promise<string>;
+    /** Simple 1-line chat. */
+    chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /** Full chat completion (OpenAI-compatible). */
+    chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    /** List available models. */
+    listModels(): Promise<Model[]>;
+    /** Get session spending. */
+    getSpending(): Spending;
+    /** True if using sol.blockrun.ai. */
+    isSolana(): boolean;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+}
+/**
+ * Convenience function: create SolanaLLMClient for sol.blockrun.ai.
+ */
+declare function solanaClient(options?: SolanaLLMClientOptions): SolanaLLMClient;
+
+declare const SOLANA_WALLET_FILE: string;
+interface SolanaWalletInfo {
+    privateKey: string;
+    address: string;
+    isNew: boolean;
+}
+/**
+ * Create a new Solana wallet.
+ * Requires @solana/web3.js (optional dep).
+ */
+declare function createSolanaWallet(): {
+    address: string;
+    privateKey: string;
+};
+/**
+ * Convert a bs58 private key string to Uint8Array (64 bytes).
+ * Accepts: bs58-encoded 64-byte key (standard Solana format).
+ */
+declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
+/**
+ * Get Solana public key (address) from bs58 private key.
+ */
+declare function solanaPublicKey(privateKey: string): Promise<string>;
+declare function saveSolanaWallet(privateKey: string): string;
+declare function loadSolanaWallet(): string | null;
+declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -741,4 +851,4 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, 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, type SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadWallet, saveWallet, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, 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 SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };

package/dist/index.d.ts

@@ -301,7 +301,7 @@ declare class LLMClient {
      * ```ts
      * const result = await client.smartChat('What is 2+2?');
      * console.log(result.response); // '4'
-     * console.log(result.model); // 'google/gemini-2.5-flash'
+     * console.log(result.model); // 'google/gemini-2.5-flash-lite'
      * console.log(result.routing.savings); // 0.78 (78% savings)
      * ```
      *
@@ -502,6 +502,33 @@ declare class ImageClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreateSolanaPaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+    rpcUrl?: string;
+}
+/**
+ * Create a signed Solana x402 v2 payment payload.
+ *
+ * This creates an SPL TransferChecked transaction for USDC payment
+ * that the CDP facilitator can verify and settle.
+ *
+ * Requires @solana/web3.js and @solana/spl-token dependencies.
+ *
+ * @param secretKey - Solana secret key (Uint8Array, 64 bytes)
+ * @param fromAddress - Sender wallet address (base58)
+ * @param recipient - Payment recipient address (base58)
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param feePayer - CDP facilitator fee payer address (base58)
+ * @param options - Additional options
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -602,6 +629,89 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/**
+ * BlockRun Solana LLM Client.
+ *
+ * Usage:
+ *   import { SolanaLLMClient } from '@blockrun/llm';
+ *
+ *   // SOLANA_WALLET_KEY env var (bs58-encoded Solana secret key)
+ *   const client = new SolanaLLMClient();
+ *
+ *   // Or pass key directly
+ *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
+ *
+ *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ */
+
+interface SolanaLLMClientOptions {
+    /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
+    privateKey?: string;
+    /** API endpoint URL (default: https://sol.blockrun.ai/api) */
+    apiUrl?: string;
+    /** Solana RPC URL (default: https://api.mainnet-beta.solana.com) */
+    rpcUrl?: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+declare class SolanaLLMClient {
+    static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
+    private privateKey;
+    private apiUrl;
+    private rpcUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    private addressCache;
+    constructor(options?: SolanaLLMClientOptions);
+    /** Get Solana wallet address (public key in base58). */
+    getWalletAddress(): Promise<string>;
+    /** Simple 1-line chat. */
+    chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /** Full chat completion (OpenAI-compatible). */
+    chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    /** List available models. */
+    listModels(): Promise<Model[]>;
+    /** Get session spending. */
+    getSpending(): Spending;
+    /** True if using sol.blockrun.ai. */
+    isSolana(): boolean;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+}
+/**
+ * Convenience function: create SolanaLLMClient for sol.blockrun.ai.
+ */
+declare function solanaClient(options?: SolanaLLMClientOptions): SolanaLLMClient;
+
+declare const SOLANA_WALLET_FILE: string;
+interface SolanaWalletInfo {
+    privateKey: string;
+    address: string;
+    isNew: boolean;
+}
+/**
+ * Create a new Solana wallet.
+ * Requires @solana/web3.js (optional dep).
+ */
+declare function createSolanaWallet(): {
+    address: string;
+    privateKey: string;
+};
+/**
+ * Convert a bs58 private key string to Uint8Array (64 bytes).
+ * Accepts: bs58-encoded 64-byte key (standard Solana format).
+ */
+declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
+/**
+ * Get Solana public key (address) from bs58 private key.
+ */
+declare function solanaPublicKey(privateKey: string): Promise<string>;
+declare function saveSolanaWallet(privateKey: string): string;
+declare function loadSolanaWallet(): string | null;
+declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -741,4 +851,4 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, 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, type SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadWallet, saveWallet, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, 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 SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };

package/dist/{index.esm-WP2DIBSK.js → index.esm-SXKIFLA7.js}

@@ -73,10 +73,11 @@ import {
   VoteInstruction,
   VoteProgram,
   clusterApiUrl,
+  init_index_esm,
   sendAndConfirmRawTransaction,
   sendAndConfirmTransaction
-} from "./chunk-S7BEMV6T.js";
-import "./chunk-2ESYSVXG.js";
+} from "./chunk-KRDGCX7W.js";
+init_index_esm();
 export {
   Account,
   AddressLookupTableAccount,

package/dist/index.js

@@ -1,4 +1,9 @@
-import "./chunk-2ESYSVXG.js";
+import {
+  __require,
+  __toCommonJS,
+  index_esm_exports,
+  init_index_esm
+} from "./chunk-KRDGCX7W.js";
 
 // src/client.ts
 import { privateKeyToAccount } from "viem/accounts";
@@ -34,6 +39,10 @@ import { route, DEFAULT_ROUTING_CONFIG } from "@blockrun/clawrouter";
 import { signTypedData } from "viem/accounts";
 var BASE_CHAIN_ID = 8453;
 var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+var USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+var DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+var DEFAULT_COMPUTE_UNIT_LIMIT = 8e3;
 var USDC_DOMAIN = {
   name: "USD Coin",
   version: "2",
@@ -106,6 +115,66 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
   };
   return btoa(JSON.stringify(paymentData));
 }
+async function createSolanaPaymentPayload(secretKey, fromAddress, recipient, amount, feePayer, options = {}) {
+  const { Connection, PublicKey, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } = await import("./index.esm-SXKIFLA7.js");
+  const { getAssociatedTokenAddress, createTransferCheckedInstruction, getMint } = await import("./esm-PTFDM6PE.js");
+  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
+  const connection = new Connection(rpcUrl);
+  const keypair = Keypair.fromSecretKey(secretKey);
+  const feePayerPubkey = new PublicKey(feePayer);
+  const ownerPubkey = keypair.publicKey;
+  const tokenMint = new PublicKey(USDC_SOLANA);
+  const payToPubkey = new PublicKey(recipient);
+  const mintInfo = await getMint(connection, tokenMint);
+  const sourceATA = await getAssociatedTokenAddress(tokenMint, ownerPubkey, false);
+  const destinationATA = await getAssociatedTokenAddress(tokenMint, payToPubkey, false);
+  const { blockhash } = await connection.getLatestBlockhash();
+  const setComputeUnitPriceIx = ComputeBudgetProgram.setComputeUnitPrice({
+    microLamports: DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS
+  });
+  const setComputeUnitLimitIx = ComputeBudgetProgram.setComputeUnitLimit({
+    units: DEFAULT_COMPUTE_UNIT_LIMIT
+  });
+  const transferIx = createTransferCheckedInstruction(
+    sourceATA,
+    tokenMint,
+    destinationATA,
+    ownerPubkey,
+    BigInt(amount),
+    mintInfo.decimals
+  );
+  const messageV0 = new TransactionMessage({
+    payerKey: feePayerPubkey,
+    recentBlockhash: blockhash,
+    instructions: [setComputeUnitLimitIx, setComputeUnitPriceIx, transferIx]
+  }).compileToV0Message();
+  const transaction = new VersionedTransaction(messageV0);
+  transaction.sign([keypair]);
+  const serializedTx = Buffer.from(transaction.serialize()).toString("base64");
+  const paymentData = {
+    x402Version: 2,
+    resource: {
+      url: options.resourceUrl || "https://blockrun.ai/api/v1/chat/completions",
+      description: options.resourceDescription || "BlockRun AI API call",
+      mimeType: "application/json"
+    },
+    accepted: {
+      scheme: "exact",
+      network: SOLANA_NETWORK,
+      amount,
+      asset: USDC_SOLANA,
+      payTo: recipient,
+      maxTimeoutSeconds: options.maxTimeoutSeconds || 300,
+      extra: options.extra || { feePayer }
+    },
+    payload: {
+      transaction: serializedTx
+    },
+    extensions: options.extensions || {}
+  };
+  return btoa(JSON.stringify(paymentData));
+}
 function parsePaymentRequired(headerValue) {
   try {
     const decoded = atob(headerValue);
@@ -304,7 +373,7 @@ var LLMClient = class {
    * ```ts
    * const result = await client.smartChat('What is 2+2?');
    * console.log(result.response); // '4'
-   * console.log(result.model); // 'google/gemini-2.5-flash'
+   * console.log(result.model); // 'google/gemini-2.5-flash-lite'
    * console.log(result.routing.savings); // 0.78 (78% savings)
    * ```
    *
@@ -947,6 +1016,255 @@ Check my balance: ${links.basescan}`;
 var WALLET_FILE_PATH = WALLET_FILE;
 var WALLET_DIR_PATH = WALLET_DIR;
 
+// src/solana-wallet.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+var WALLET_DIR2 = path2.join(os2.homedir(), ".blockrun");
+var SOLANA_WALLET_FILE = path2.join(WALLET_DIR2, ".solana-session");
+function createSolanaWallet() {
+  const { Keypair } = (init_index_esm(), __toCommonJS(index_esm_exports));
+  const bs58 = __require("bs58");
+  const keypair = Keypair.generate();
+  return {
+    address: keypair.publicKey.toBase58(),
+    privateKey: bs58.default?.encode(keypair.secretKey) ?? bs58.encode(keypair.secretKey)
+  };
+}
+async function solanaKeyToBytes(privateKey) {
+  try {
+    const bs58 = await import("bs58");
+    const bytes = (bs58.default ?? bs58).decode(privateKey);
+    if (bytes.length !== 64) {
+      throw new Error(`Invalid Solana key length: expected 64 bytes, got ${bytes.length}`);
+    }
+    return bytes;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Invalid Solana private key: ${msg}`);
+  }
+}
+async function solanaPublicKey(privateKey) {
+  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const bytes = await solanaKeyToBytes(privateKey);
+  return Keypair.fromSecretKey(bytes).publicKey.toBase58();
+}
+function saveSolanaWallet(privateKey) {
+  if (!fs2.existsSync(WALLET_DIR2)) fs2.mkdirSync(WALLET_DIR2, { recursive: true });
+  fs2.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
+  return SOLANA_WALLET_FILE;
+}
+function loadSolanaWallet() {
+  if (fs2.existsSync(SOLANA_WALLET_FILE)) {
+    const key = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
+    if (key) return key;
+  }
+  return null;
+}
+async function getOrCreateSolanaWallet() {
+  const envKey = typeof process !== "undefined" && process.env ? process.env.SOLANA_WALLET_KEY : void 0;
+  if (envKey) {
+    const address2 = await solanaPublicKey(envKey);
+    return { privateKey: envKey, address: address2, isNew: false };
+  }
+  const fileKey = loadSolanaWallet();
+  if (fileKey) {
+    const address2 = await solanaPublicKey(fileKey);
+    return { privateKey: fileKey, address: address2, isNew: false };
+  }
+  const { address, privateKey } = createSolanaWallet();
+  saveSolanaWallet(privateKey);
+  return { address, privateKey, isNew: true };
+}
+
+// src/solana-client.ts
+var SOLANA_API_URL = "https://sol.blockrun.ai/api";
+var DEFAULT_MAX_TOKENS2 = 1024;
+var DEFAULT_TIMEOUT3 = 6e4;
+var SDK_VERSION2 = "0.3.0";
+var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
+var SolanaLLMClient = class {
+  static SOLANA_API_URL = SOLANA_API_URL;
+  privateKey;
+  apiUrl;
+  rpcUrl;
+  timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
+  addressCache = null;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.SOLANA_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set SOLANA_WALLET_KEY environment variable."
+      );
+    }
+    this.privateKey = privateKey;
+    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_TIMEOUT3;
+  }
+  /** Get Solana wallet address (public key in base58). */
+  async getWalletAddress() {
+    if (!this.addressCache) {
+      this.addressCache = await solanaPublicKey(this.privateKey);
+    }
+    return this.addressCache;
+  }
+  /** Simple 1-line chat. */
+  async chat(model, prompt, options) {
+    const messages = [];
+    if (options?.system) messages.push({ role: "system", content: options.system });
+    messages.push({ role: "user", content: prompt });
+    const result = await this.chatCompletion(model, messages, {
+      maxTokens: options?.maxTokens,
+      temperature: options?.temperature,
+      topP: options?.topP,
+      search: options?.search,
+      searchParameters: options?.searchParameters
+    });
+    return result.choices[0].message.content || "";
+  }
+  /** Full chat completion (OpenAI-compatible). */
+  async chatCompletion(model, messages, options) {
+    const body = {
+      model,
+      messages,
+      max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS2
+    };
+    if (options?.temperature !== void 0) body.temperature = options.temperature;
+    if (options?.topP !== void 0) body.top_p = options.topP;
+    if (options?.searchParameters !== void 0) body.search_parameters = options.searchParameters;
+    else if (options?.search === true) body.search_parameters = { mode: "on" };
+    if (options?.tools !== void 0) body.tools = options.tools;
+    if (options?.toolChoice !== void 0) body.tool_choice = options.toolChoice;
+    return this.requestWithPayment("/v1/chat/completions", body);
+  }
+  /** List available models. */
+  async listModels() {
+    const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/models`, { method: "GET" });
+    if (!response.ok) {
+      throw new APIError(`Failed to list models: ${response.status}`, response.status);
+    }
+    const data = await response.json();
+    return data.data || [];
+  }
+  /** Get session spending. */
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+  /** True if using sol.blockrun.ai. */
+  isSolana() {
+    return this.apiUrl.includes("sol.blockrun.ai");
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT2 },
+      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.accepts || respBody.x402Version) {
+          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, SOLANA_NETWORK);
+    if (!details.network?.startsWith("solana:")) {
+      throw new PaymentError(
+        `Expected Solana payment network, got: ${details.network}. Use LLMClient for Base payments.`
+      );
+    }
+    const feePayer = details.extra?.feePayer;
+    if (!feePayer) throw new PaymentError("Missing feePayer in 402 extra field");
+    const fromAddress = await this.getWalletAddress();
+    const secretKey = await solanaKeyToBytes(this.privateKey);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createSolanaPaymentPayload(
+      secretKey,
+      fromAddress,
+      details.recipient,
+      details.amount,
+      feePayer,
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || `${this.apiUrl}/v1/chat/completions`,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun Solana AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions,
+        rpcUrl: this.rpcUrl
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT2,
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your Solana USDC 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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
+  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);
+    }
+  }
+};
+function solanaClient(options = {}) {
+  return new SolanaLLMClient({ ...options, apiUrl: SOLANA_API_URL });
+}
+
 // src/openai-compat.ts
 var StreamingResponse = class {
   reader;
@@ -1124,20 +1442,32 @@ export {
   LLMClient,
   OpenAI,
   PaymentError,
+  SOLANA_NETWORK,
+  SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH,
+  SolanaLLMClient,
   USDC_BASE,
   USDC_BASE_CONTRACT,
+  USDC_SOLANA,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
+  createSolanaPaymentPayload,
+  createSolanaWallet,
   createWallet,
   client_default as default,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
   getEip681Uri,
+  getOrCreateSolanaWallet,
   getOrCreateWallet,
   getPaymentLinks,
   getWalletAddress,
+  loadSolanaWallet,
   loadWallet,
+  saveSolanaWallet,
   saveWallet,
+  solanaClient,
+  solanaKeyToBytes,
+  solanaPublicKey,
   testnetClient
 };