@voyage_ai/v402-web-ts 0.2.1 → 1.0.0

package/README.md

@@ -868,9 +868,12 @@ const response = await handleEvmPayment(endpoint, {
 ```json
 {
   "react": ">=18.0.0",
-  "@solana/web3.js": "^1.95.0",
-  "@solana/spl-token": "^0.4.0",
-  "antd": "^5.0.0"  // For V402Checkout component
+  "@solana/kit": "^3.0.0",
+  "@solana-program/token": "^0.6.0",
+  "@solana-program/token-2022": "^0.4.0",
+  "@solana-program/compute-budget": "^0.8.0",
+  "@solana-program/system": "^0.8.0",
+  "antd": "^5.0.0" 
 }
 ```
 
@@ -878,13 +881,14 @@ const response = await handleEvmPayment(endpoint, {
 
 ```json
 {
-  "ethers": "^6.0.0"  // Only needed if using EVM networks
+  "ethers": "^6.0.0" 
 }
 ```
 
 **Note**: 
 - If you only use `V402Checkout` component, all dependencies are included
 - For custom integration, install only the wallets you need (Solana or EVM)
+- Solana dependencies use the new `@solana/kit` unified SDK for better performance and smaller bundle size
 
 ## 🤝 Contributing
 

package/dist/index.d.mts

@@ -1,23 +1,21 @@
 import { PaymentRequirements } from 'x402/types';
 export { PaymentRequirements, SPLTokenAmount, SettleResponse, VerifyResponse, x402Response } from 'x402/types';
-import { VersionedTransaction } from '@solana/web3.js';
 import { z } from 'zod';
 
 /**
  * Common types for x402 SDK
  * Framework-agnostic types that work across different wallet implementations
  */
-
 /**
  * Generic wallet adapter interface - works with any wallet provider
- * Compatible with Anza wallet-adapter, Privy, and custom implementations
+ * Compatible with Anza wallet-adapter, Privy, @solana/kit, and custom implementations
  */
 interface WalletAdapter {
     publicKey?: {
         toString(): string;
     };
     address?: string;
-    signTransaction: (tx: VersionedTransaction) => Promise<VersionedTransaction>;
+    signTransaction: <T>(tx: T) => Promise<T>;
 }
 /**
  * EVM wallet adapter interface
@@ -235,6 +233,8 @@ declare function getChainId(network: string): number;
  *
  * Low-level API: Creates X-PAYMENT header for Solana transactions
  * Use this when you want to build the payment header yourself and handle fetch separately
+ *
+ * Uses @solana/web3.js and @solana/spl-token packages
  */
 
 /**
@@ -443,6 +443,7 @@ declare function getWalletDisplayName(networkType: NetworkType): string;
  * @param networkType - Network type (from useWallet)
  * @param merchantId - @see our website to apply
  * @param additionalParams - Optional additional parameters to send with the request (default: {})
+ * @param expectedAddress - Optional expected wallet address for validation
  * @returns Response from the payment
  *
  * @example
@@ -453,16 +454,17 @@ declare function getWalletDisplayName(networkType: NetworkType): string;
  *
  * @example
  * ```tsx
- * // With additional parameters
+ * // With additional parameters and address validation
  * const response = await makePayment(
  *   '/api/endpoint',
  *   networkType,
  *   merchantId,
- *   { userId: '123', customField: 'value' }
+ *   { userId: '123', customField: 'value' },
+ *   walletAddress  // Pass the expected address for validation
  * );
  * ```
  */
-declare function makePayment(networkType: NetworkType, merchantId: string, endpoint?: string, additionalParams?: Record<string, any>): Promise<Response>;
+declare function makePayment(networkType: NetworkType, merchantId: string, endpoint?: string, additionalParams?: Record<string, any>, expectedAddress?: string): Promise<Response>;
 
 /**
  * Network utilities

package/dist/index.d.ts

@@ -1,23 +1,21 @@
 import { PaymentRequirements } from 'x402/types';
 export { PaymentRequirements, SPLTokenAmount, SettleResponse, VerifyResponse, x402Response } from 'x402/types';
-import { VersionedTransaction } from '@solana/web3.js';
 import { z } from 'zod';
 
 /**
  * Common types for x402 SDK
  * Framework-agnostic types that work across different wallet implementations
  */
-
 /**
  * Generic wallet adapter interface - works with any wallet provider
- * Compatible with Anza wallet-adapter, Privy, and custom implementations
+ * Compatible with Anza wallet-adapter, Privy, @solana/kit, and custom implementations
  */
 interface WalletAdapter {
     publicKey?: {
         toString(): string;
     };
     address?: string;
-    signTransaction: (tx: VersionedTransaction) => Promise<VersionedTransaction>;
+    signTransaction: <T>(tx: T) => Promise<T>;
 }
 /**
  * EVM wallet adapter interface
@@ -235,6 +233,8 @@ declare function getChainId(network: string): number;
  *
  * Low-level API: Creates X-PAYMENT header for Solana transactions
  * Use this when you want to build the payment header yourself and handle fetch separately
+ *
+ * Uses @solana/web3.js and @solana/spl-token packages
  */
 
 /**
@@ -443,6 +443,7 @@ declare function getWalletDisplayName(networkType: NetworkType): string;
  * @param networkType - Network type (from useWallet)
  * @param merchantId - @see our website to apply
  * @param additionalParams - Optional additional parameters to send with the request (default: {})
+ * @param expectedAddress - Optional expected wallet address for validation
  * @returns Response from the payment
  *
  * @example
@@ -453,16 +454,17 @@ declare function getWalletDisplayName(networkType: NetworkType): string;
  *
  * @example
  * ```tsx
- * // With additional parameters
+ * // With additional parameters and address validation
  * const response = await makePayment(
  *   '/api/endpoint',
  *   networkType,
  *   merchantId,
- *   { userId: '123', customField: 'value' }
+ *   { userId: '123', customField: 'value' },
+ *   walletAddress  // Pass the expected address for validation
  * );
  * ```
  */
-declare function makePayment(networkType: NetworkType, merchantId: string, endpoint?: string, additionalParams?: Record<string, any>): Promise<Response>;
+declare function makePayment(networkType: NetworkType, merchantId: string, endpoint?: string, additionalParams?: Record<string, any>, expectedAddress?: string): Promise<Response>;
 
 /**
  * Network utilities