@blockrun/llm 1.4.2 → 1.5.0

package/dist/index.d.cts

@@ -64,6 +64,7 @@ interface Model {
     outputPrice: number;
     contextWindow: number;
     maxOutput: number;
+    categories: string[];
     available: boolean;
     type?: "llm" | "image";
 }
@@ -139,10 +140,48 @@ interface SearchParameters {
     toDate?: string;
     maxSearchResults?: number;
 }
+/** Usage info for Live Search sources */
+interface SearchUsage {
+    /** Number of search sources used in the response */
+    numSourcesUsed?: number;
+}
 interface Spending {
     totalUsd: number;
     calls: number;
 }
+/** Pre-request cost estimate for a chat call */
+interface CostEstimate {
+    /** Model ID used for the estimate */
+    model: string;
+    /** Estimated input token count */
+    estimatedInputTokens: number;
+    /** Estimated output token count */
+    estimatedOutputTokens: number;
+    /** Estimated cost in USD */
+    estimatedCostUsd: number;
+}
+/** Per-call spending report with running session totals */
+interface SpendingReport {
+    /** Model ID used */
+    model: string;
+    /** Input tokens consumed */
+    inputTokens: number;
+    /** Output tokens consumed */
+    outputTokens: number;
+    /** Cost of this call in USD */
+    costUsd: number;
+    /** Cumulative session spend in USD */
+    sessionTotalUsd: number;
+    /** Total number of calls in this session */
+    sessionCalls: number;
+}
+/** Chat response bundled with its spending report */
+interface ChatResponseWithCost {
+    /** The chat completion response */
+    response: ChatResponse;
+    /** Spending report for this call */
+    spendingReport: SpendingReport;
+}
 interface ResourceInfo {
     url: string;
     description?: string;
@@ -183,9 +222,9 @@ interface ChatOptions {
     temperature?: number;
     /** Nucleus sampling parameter */
     topP?: number;
-    /** Enable xAI Live Search (shortcut for searchParameters.mode = "on") */
+    /** Enable Live Search (shortcut for searchParameters.mode = "on") */
     search?: boolean;
-    /** Full xAI Live Search configuration (for Grok models) */
+    /** Full Live Search configuration (for search-enabled models) */
     searchParameters?: SearchParameters;
 }
 interface ChatCompletionOptions {
@@ -195,9 +234,9 @@ interface ChatCompletionOptions {
     temperature?: number;
     /** Nucleus sampling parameter */
     topP?: number;
-    /** Enable xAI Live Search (shortcut for searchParameters.mode = "on") */
+    /** Enable Live Search (shortcut for searchParameters.mode = "on") */
     search?: boolean;
-    /** Full xAI Live Search configuration (for Grok models) */
+    /** Full Live Search configuration (for search-enabled models) */
     searchParameters?: SearchParameters;
     /** Tool definitions for function calling */
     tools?: Tool[];
@@ -405,7 +444,7 @@ declare class APIError extends BlockrunError {
  *   // Option 2: Pass private key directly
  *   const client = new LLMClient({ privateKey: '0x...' });
  *
- *   const response = await client.chat('openai/gpt-4o', 'Hello!');
+ *   const response = await client.chat('openai/gpt-5.2', 'Hello!');
  *   console.log(response);
  */
 
@@ -453,13 +492,13 @@ declare class LLMClient {
     /**
      * Simple 1-line chat interface.
      *
-     * @param model - Model ID (e.g., 'openai/gpt-4o', 'anthropic/claude-sonnet-4')
+     * @param model - Model ID (e.g., 'openai/gpt-5.2', 'anthropic/claude-sonnet-4.6')
      * @param prompt - User message
      * @param options - Optional chat parameters
      * @returns Assistant's response text
      *
      * @example
-     * const response = await client.chat('gpt-4o', 'What is the capital of France?');
+     * const response = await client.chat('gpt-5.2', 'What is the capital of France?');
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
@@ -1107,7 +1146,7 @@ declare const WALLET_DIR_PATH: string;
  *   // Or pass key directly
  *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
  *
- *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ *   const response = await client.chat('openai/gpt-5.2', 'gm Solana');
  */
 
 interface SolanaLLMClientOptions {
@@ -1227,6 +1266,11 @@ declare function getCachedByRequest(endpoint: string, body: Record<string, unkno
 declare function setCache(key: string, data: unknown, ttlMs: number): void;
 declare function saveToCache(endpoint: string, body: Record<string, unknown>, response: unknown, costUsd?: number): void;
 declare function clearCache(): number;
+declare function getCostLogSummary(): {
+    totalUsd: number;
+    calls: number;
+    byEndpoint: Record<string, number>;
+};
 
 /**
  * Agent wallet setup utilities.
@@ -1276,7 +1320,7 @@ declare function getCostSummary(): {
  *
  * // Rest of your code stays exactly the same!
  * const response = await client.chat.completions.create({
- *   model: 'gpt-4o',
+ *   model: 'gpt-5.2',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  */
@@ -1383,7 +1427,7 @@ declare class Chat {
  * const client = new OpenAI({ walletKey: '0x...' });
  *
  * const response = await client.chat.completions.create({
- *   model: 'gpt-4o',
+ *   model: 'gpt-5.2',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  *
@@ -1418,4 +1462,59 @@ declare class AnthropicClient {
     getWalletAddress(): string;
 }
 
-export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 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, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+/**
+ * Input validation and security utilities for BlockRun LLM SDK.
+ *
+ * This module provides validation functions to ensure:
+ * - Private keys are properly formatted
+ * - API URLs use HTTPS
+ * - Server responses don't leak sensitive information
+ * - Resource URLs match expected domains
+ */
+
+/**
+ * Known LLM providers (for optional validation).
+ */
+declare const KNOWN_PROVIDERS: Set<string>;
+/**
+ * Validates that a model ID is a non-empty string.
+ *
+ * @param model - The model ID (e.g., "openai/gpt-5.2", "anthropic/claude-sonnet-4.5")
+ * @throws {Error} If the model is invalid
+ *
+ * @example
+ * validateModel("openai/gpt-5.2");
+ */
+declare function validateModel(model: string): void;
+/**
+ * Validates that max_tokens is an integer between 1 and 100,000.
+ *
+ * @param maxTokens - Maximum number of tokens to generate
+ * @throws {Error} If maxTokens is invalid
+ *
+ * @example
+ * validateMaxTokens(1000);
+ */
+declare function validateMaxTokens(maxTokens?: number): void;
+/**
+ * Validates that temperature is a number between 0 and 2.
+ *
+ * @param temperature - Sampling temperature (0-2)
+ * @throws {Error} If temperature is invalid
+ *
+ * @example
+ * validateTemperature(0.7);
+ */
+declare function validateTemperature(temperature?: number): void;
+/**
+ * Validates that top_p is a number between 0 and 1.
+ *
+ * @param topP - Top-p sampling parameter (0-1)
+ * @throws {Error} If topP is invalid
+ *
+ * @example
+ * validateTopP(0.9);
+ */
+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 };

package/dist/index.d.ts

@@ -64,6 +64,7 @@ interface Model {
     outputPrice: number;
     contextWindow: number;
     maxOutput: number;
+    categories: string[];
     available: boolean;
     type?: "llm" | "image";
 }
@@ -139,10 +140,48 @@ interface SearchParameters {
     toDate?: string;
     maxSearchResults?: number;
 }
+/** Usage info for Live Search sources */
+interface SearchUsage {
+    /** Number of search sources used in the response */
+    numSourcesUsed?: number;
+}
 interface Spending {
     totalUsd: number;
     calls: number;
 }
+/** Pre-request cost estimate for a chat call */
+interface CostEstimate {
+    /** Model ID used for the estimate */
+    model: string;
+    /** Estimated input token count */
+    estimatedInputTokens: number;
+    /** Estimated output token count */
+    estimatedOutputTokens: number;
+    /** Estimated cost in USD */
+    estimatedCostUsd: number;
+}
+/** Per-call spending report with running session totals */
+interface SpendingReport {
+    /** Model ID used */
+    model: string;
+    /** Input tokens consumed */
+    inputTokens: number;
+    /** Output tokens consumed */
+    outputTokens: number;
+    /** Cost of this call in USD */
+    costUsd: number;
+    /** Cumulative session spend in USD */
+    sessionTotalUsd: number;
+    /** Total number of calls in this session */
+    sessionCalls: number;
+}
+/** Chat response bundled with its spending report */
+interface ChatResponseWithCost {
+    /** The chat completion response */
+    response: ChatResponse;
+    /** Spending report for this call */
+    spendingReport: SpendingReport;
+}
 interface ResourceInfo {
     url: string;
     description?: string;
@@ -183,9 +222,9 @@ interface ChatOptions {
     temperature?: number;
     /** Nucleus sampling parameter */
     topP?: number;
-    /** Enable xAI Live Search (shortcut for searchParameters.mode = "on") */
+    /** Enable Live Search (shortcut for searchParameters.mode = "on") */
     search?: boolean;
-    /** Full xAI Live Search configuration (for Grok models) */
+    /** Full Live Search configuration (for search-enabled models) */
     searchParameters?: SearchParameters;
 }
 interface ChatCompletionOptions {
@@ -195,9 +234,9 @@ interface ChatCompletionOptions {
     temperature?: number;
     /** Nucleus sampling parameter */
     topP?: number;
-    /** Enable xAI Live Search (shortcut for searchParameters.mode = "on") */
+    /** Enable Live Search (shortcut for searchParameters.mode = "on") */
     search?: boolean;
-    /** Full xAI Live Search configuration (for Grok models) */
+    /** Full Live Search configuration (for search-enabled models) */
     searchParameters?: SearchParameters;
     /** Tool definitions for function calling */
     tools?: Tool[];
@@ -405,7 +444,7 @@ declare class APIError extends BlockrunError {
  *   // Option 2: Pass private key directly
  *   const client = new LLMClient({ privateKey: '0x...' });
  *
- *   const response = await client.chat('openai/gpt-4o', 'Hello!');
+ *   const response = await client.chat('openai/gpt-5.2', 'Hello!');
  *   console.log(response);
  */
 
@@ -453,13 +492,13 @@ declare class LLMClient {
     /**
      * Simple 1-line chat interface.
      *
-     * @param model - Model ID (e.g., 'openai/gpt-4o', 'anthropic/claude-sonnet-4')
+     * @param model - Model ID (e.g., 'openai/gpt-5.2', 'anthropic/claude-sonnet-4.6')
      * @param prompt - User message
      * @param options - Optional chat parameters
      * @returns Assistant's response text
      *
      * @example
-     * const response = await client.chat('gpt-4o', 'What is the capital of France?');
+     * const response = await client.chat('gpt-5.2', 'What is the capital of France?');
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
@@ -1107,7 +1146,7 @@ declare const WALLET_DIR_PATH: string;
  *   // Or pass key directly
  *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
  *
- *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ *   const response = await client.chat('openai/gpt-5.2', 'gm Solana');
  */
 
 interface SolanaLLMClientOptions {
@@ -1227,6 +1266,11 @@ declare function getCachedByRequest(endpoint: string, body: Record<string, unkno
 declare function setCache(key: string, data: unknown, ttlMs: number): void;
 declare function saveToCache(endpoint: string, body: Record<string, unknown>, response: unknown, costUsd?: number): void;
 declare function clearCache(): number;
+declare function getCostLogSummary(): {
+    totalUsd: number;
+    calls: number;
+    byEndpoint: Record<string, number>;
+};
 
 /**
  * Agent wallet setup utilities.
@@ -1276,7 +1320,7 @@ declare function getCostSummary(): {
  *
  * // Rest of your code stays exactly the same!
  * const response = await client.chat.completions.create({
- *   model: 'gpt-4o',
+ *   model: 'gpt-5.2',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  */
@@ -1383,7 +1427,7 @@ declare class Chat {
  * const client = new OpenAI({ walletKey: '0x...' });
  *
  * const response = await client.chat.completions.create({
- *   model: 'gpt-4o',
+ *   model: 'gpt-5.2',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  *
@@ -1418,4 +1462,59 @@ declare class AnthropicClient {
     getWalletAddress(): string;
 }
 
-export { APIError, AnthropicClient, BASE_CHAIN_ID, type BlockRunAnthropicOptions, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 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, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+/**
+ * Input validation and security utilities for BlockRun LLM SDK.
+ *
+ * This module provides validation functions to ensure:
+ * - Private keys are properly formatted
+ * - API URLs use HTTPS
+ * - Server responses don't leak sensitive information
+ * - Resource URLs match expected domains
+ */
+
+/**
+ * Known LLM providers (for optional validation).
+ */
+declare const KNOWN_PROVIDERS: Set<string>;
+/**
+ * Validates that a model ID is a non-empty string.
+ *
+ * @param model - The model ID (e.g., "openai/gpt-5.2", "anthropic/claude-sonnet-4.5")
+ * @throws {Error} If the model is invalid
+ *
+ * @example
+ * validateModel("openai/gpt-5.2");
+ */
+declare function validateModel(model: string): void;
+/**
+ * Validates that max_tokens is an integer between 1 and 100,000.
+ *
+ * @param maxTokens - Maximum number of tokens to generate
+ * @throws {Error} If maxTokens is invalid
+ *
+ * @example
+ * validateMaxTokens(1000);
+ */
+declare function validateMaxTokens(maxTokens?: number): void;
+/**
+ * Validates that temperature is a number between 0 and 2.
+ *
+ * @param temperature - Sampling temperature (0-2)
+ * @throws {Error} If temperature is invalid
+ *
+ * @example
+ * validateTemperature(0.7);
+ */
+declare function validateTemperature(temperature?: number): void;
+/**
+ * Validates that top_p is a number between 0 and 1.
+ *
+ * @param topP - Top-p sampling parameter (0-1)
+ * @throws {Error} If topP is invalid
+ *
+ * @example
+ * validateTopP(0.9);
+ */
+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 };