@blockrun/llm 1.4.0 → 1.4.2

package/dist/index.cjs

@@ -36436,10 +36436,12 @@ __export(index_exports, {
   WALLET_DIR_PATH: () => WALLET_DIR_PATH,
   WALLET_FILE_PATH: () => WALLET_FILE_PATH,
   clearCache: () => clearCache,
+  createPaymentPayload: () => createPaymentPayload,
   createSolanaPaymentPayload: () => createSolanaPaymentPayload,
   createSolanaWallet: () => createSolanaWallet,
   createWallet: () => createWallet,
   default: () => client_default,
+  extractPaymentDetails: () => extractPaymentDetails,
   formatFundingMessageCompact: () => formatFundingMessageCompact,
   formatNeedsFundingMessage: () => formatNeedsFundingMessage,
   formatWalletCreatedMessage: () => formatWalletCreatedMessage,
@@ -36454,6 +36456,7 @@ __export(index_exports, {
   loadSolanaWallet: () => loadSolanaWallet,
   loadWallet: () => loadWallet,
   logCost: () => logCost,
+  parsePaymentRequired: () => parsePaymentRequired,
   saveSolanaWallet: () => saveSolanaWallet,
   saveToCache: () => saveToCache,
   saveWallet: () => saveWallet,
@@ -39145,9 +39148,11 @@ var AnthropicClient = class {
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
   clearCache,
+  createPaymentPayload,
   createSolanaPaymentPayload,
   createSolanaWallet,
   createWallet,
+  extractPaymentDetails,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
@@ -39162,6 +39167,7 @@ var AnthropicClient = class {
   loadSolanaWallet,
   loadWallet,
   logCost,
+  parsePaymentRequired,
   saveSolanaWallet,
   saveToCache,
   saveWallet,

package/dist/index.d.cts

@@ -143,6 +143,29 @@ interface Spending {
     totalUsd: number;
     calls: number;
 }
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PaymentRequirement {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount?: string;
+    maxAmountRequired?: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    extra?: {
+        name?: string;
+        version?: string;
+    };
+}
+interface PaymentRequired {
+    x402Version: number;
+    accepts: PaymentRequirement[];
+    resource?: ResourceInfo;
+}
 interface LLMClientOptions {
     /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY env var is set. */
     privateKey?: `0x${string}` | string;
@@ -874,6 +897,28 @@ declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreatePaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: {
+        name?: string;
+        version?: string;
+    };
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Create a signed x402 v2 payment payload.
+ *
+ * @param privateKey - Hex-encoded private key
+ * @param fromAddress - Sender wallet address
+ * @param recipient - Payment recipient address
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param network - Network identifier (default: eip155:8453)
+ * @param options - Additional options for resource info
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createPaymentPayload(privateKey: `0x${string}`, fromAddress: string, recipient: string, amount: string, network?: string, options?: CreatePaymentOptions): Promise<string>;
 interface CreateSolanaPaymentOptions {
     resourceUrl?: string;
     resourceDescription?: string;
@@ -899,6 +944,39 @@ interface CreateSolanaPaymentOptions {
  * @returns Base64-encoded signed payment payload
  */
 declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
+/**
+ * Parse the X-Payment-Required header from a 402 response.
+ *
+ * @param headerValue - Base64-encoded payment required header
+ * @returns Parsed payment required object
+ * @throws {Error} If the header cannot be parsed or has invalid structure
+ */
+declare function parsePaymentRequired(headerValue: string): PaymentRequired;
+/**
+ * Extract payment details from parsed payment required response.
+ * Supports both v1 and v2 formats, with optional network preference.
+ *
+ * @param paymentRequired - Parsed payment required object
+ * @param preferredNetwork - Optional network preference. If specified, will try
+ *   to use matching network option. Defaults to first option (Base).
+ *   Examples:
+ *   - "eip155:8453" for Base
+ *   - "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" for Solana
+ */
+declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferredNetwork?: string): {
+    amount: string;
+    recipient: string;
+    network: string;
+    asset: string;
+    scheme: string;
+    maxTimeoutSeconds: number;
+    extra?: {
+        name?: string;
+        version?: string;
+        feePayer?: string;
+    };
+    resource?: ResourceInfo;
+};
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -1340,4 +1418,4 @@ 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 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, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+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 };

package/dist/index.d.ts

@@ -143,6 +143,29 @@ interface Spending {
     totalUsd: number;
     calls: number;
 }
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PaymentRequirement {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount?: string;
+    maxAmountRequired?: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    extra?: {
+        name?: string;
+        version?: string;
+    };
+}
+interface PaymentRequired {
+    x402Version: number;
+    accepts: PaymentRequirement[];
+    resource?: ResourceInfo;
+}
 interface LLMClientOptions {
     /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY env var is set. */
     privateKey?: `0x${string}` | string;
@@ -874,6 +897,28 @@ declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreatePaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: {
+        name?: string;
+        version?: string;
+    };
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Create a signed x402 v2 payment payload.
+ *
+ * @param privateKey - Hex-encoded private key
+ * @param fromAddress - Sender wallet address
+ * @param recipient - Payment recipient address
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param network - Network identifier (default: eip155:8453)
+ * @param options - Additional options for resource info
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createPaymentPayload(privateKey: `0x${string}`, fromAddress: string, recipient: string, amount: string, network?: string, options?: CreatePaymentOptions): Promise<string>;
 interface CreateSolanaPaymentOptions {
     resourceUrl?: string;
     resourceDescription?: string;
@@ -899,6 +944,39 @@ interface CreateSolanaPaymentOptions {
  * @returns Base64-encoded signed payment payload
  */
 declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
+/**
+ * Parse the X-Payment-Required header from a 402 response.
+ *
+ * @param headerValue - Base64-encoded payment required header
+ * @returns Parsed payment required object
+ * @throws {Error} If the header cannot be parsed or has invalid structure
+ */
+declare function parsePaymentRequired(headerValue: string): PaymentRequired;
+/**
+ * Extract payment details from parsed payment required response.
+ * Supports both v1 and v2 formats, with optional network preference.
+ *
+ * @param paymentRequired - Parsed payment required object
+ * @param preferredNetwork - Optional network preference. If specified, will try
+ *   to use matching network option. Defaults to first option (Base).
+ *   Examples:
+ *   - "eip155:8453" for Base
+ *   - "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" for Solana
+ */
+declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferredNetwork?: string): {
+    amount: string;
+    recipient: string;
+    network: string;
+    asset: string;
+    scheme: string;
+    maxTimeoutSeconds: number;
+    extra?: {
+        name?: string;
+        version?: string;
+        feePayer?: string;
+    };
+    resource?: ResourceInfo;
+};
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -1340,4 +1418,4 @@ 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 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, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };
+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 };

package/dist/index.js

@@ -2679,10 +2679,12 @@ export {
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
   clearCache,
+  createPaymentPayload,
   createSolanaPaymentPayload,
   createSolanaWallet,
   createWallet,
   client_default as default,
+  extractPaymentDetails,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
@@ -2697,6 +2699,7 @@ export {
   loadSolanaWallet,
   loadWallet,
   logCost,
+  parsePaymentRequired,
   saveSolanaWallet,
   saveToCache,
   saveWallet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "description": "BlockRun LLM Gateway SDK - Pay-per-request AI via x402 on Base and Solana",
   "main": "dist/index.cjs",