uvd-x402-sdk 2.0.1

package/dist/providers/solana/index.d.mts

@@ -0,0 +1,115 @@
+import { b as WalletAdapter, C as ChainConfig, P as PaymentInfo } from '../../index-D6Sr4ARD.mjs';
+
+/**
+ * uvd-x402-sdk - SVM Provider (Solana Virtual Machine)
+ *
+ * Provides wallet connection and payment creation for SVM-based chains via Phantom.
+ * Supports: Solana, Fogo
+ * Uses partially-signed transactions where the facilitator is the fee payer.
+ *
+ * @example Solana
+ * ```ts
+ * import { SVMProvider } from 'uvd-x402-sdk/solana';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const svm = new SVMProvider();
+ *
+ * // Connect
+ * const address = await svm.connect();
+ *
+ * // Create Solana payment
+ * const chainConfig = getChainByName('solana')!;
+ * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);
+ * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ *
+ * @example Fogo
+ * ```ts
+ * import { SVMProvider } from 'uvd-x402-sdk/solana';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const svm = new SVMProvider();
+ *
+ * // Connect (same wallet works for all SVM chains)
+ * const address = await svm.connect();
+ *
+ * // Create Fogo payment
+ * const chainConfig = getChainByName('fogo')!;
+ * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);
+ * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * SVMProvider - Wallet adapter for SVM chains (Solana, Fogo) via Phantom
+ *
+ * @alias SolanaProvider for backward compatibility
+ */
+declare class SVMProvider implements WalletAdapter {
+    readonly id = "phantom";
+    readonly name = "Phantom";
+    readonly networkType: "svm";
+    private provider;
+    private publicKey;
+    private connections;
+    private address;
+    /**
+     * Check if Phantom wallet is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Phantom wallet
+     */
+    connect(): Promise<string>;
+    /**
+     * Disconnect from Phantom
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create SVM payment (partially-signed transaction)
+     *
+     * Works for both Solana and Fogo chains.
+     *
+     * Transaction structure required by facilitator:
+     * 1. SetComputeUnitLimit
+     * 2. SetComputeUnitPrice
+     * 3. (Optional) CreateAssociatedTokenAccount if recipient ATA doesn't exist
+     * 4. TransferChecked (USDC transfer)
+     *
+     * Fee payer: Facilitator (not user)
+     * User pays: ZERO SOL/FOGO
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode SVM payment as X-PAYMENT header
+     *
+     * @param paymentPayload - The payment payload JSON string
+     * @param chainConfig - Optional chain config (defaults to 'solana' if not provided)
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig): string;
+    private getPhantomProvider;
+    /**
+     * Get or create a connection for a specific chain
+     */
+    private getConnection;
+    /**
+     * @deprecated Use getConnection instead
+     */
+    private initConnection;
+}
+/**
+ * @deprecated Use SVMProvider instead
+ */
+declare class SolanaProvider extends SVMProvider {
+    constructor();
+}
+
+export { SVMProvider, SolanaProvider, SVMProvider as default };

package/dist/providers/solana/index.d.ts

@@ -0,0 +1,115 @@
+import { b as WalletAdapter, C as ChainConfig, P as PaymentInfo } from '../../index-D6Sr4ARD.js';
+
+/**
+ * uvd-x402-sdk - SVM Provider (Solana Virtual Machine)
+ *
+ * Provides wallet connection and payment creation for SVM-based chains via Phantom.
+ * Supports: Solana, Fogo
+ * Uses partially-signed transactions where the facilitator is the fee payer.
+ *
+ * @example Solana
+ * ```ts
+ * import { SVMProvider } from 'uvd-x402-sdk/solana';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const svm = new SVMProvider();
+ *
+ * // Connect
+ * const address = await svm.connect();
+ *
+ * // Create Solana payment
+ * const chainConfig = getChainByName('solana')!;
+ * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);
+ * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ *
+ * @example Fogo
+ * ```ts
+ * import { SVMProvider } from 'uvd-x402-sdk/solana';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const svm = new SVMProvider();
+ *
+ * // Connect (same wallet works for all SVM chains)
+ * const address = await svm.connect();
+ *
+ * // Create Fogo payment
+ * const chainConfig = getChainByName('fogo')!;
+ * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);
+ * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * SVMProvider - Wallet adapter for SVM chains (Solana, Fogo) via Phantom
+ *
+ * @alias SolanaProvider for backward compatibility
+ */
+declare class SVMProvider implements WalletAdapter {
+    readonly id = "phantom";
+    readonly name = "Phantom";
+    readonly networkType: "svm";
+    private provider;
+    private publicKey;
+    private connections;
+    private address;
+    /**
+     * Check if Phantom wallet is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Phantom wallet
+     */
+    connect(): Promise<string>;
+    /**
+     * Disconnect from Phantom
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create SVM payment (partially-signed transaction)
+     *
+     * Works for both Solana and Fogo chains.
+     *
+     * Transaction structure required by facilitator:
+     * 1. SetComputeUnitLimit
+     * 2. SetComputeUnitPrice
+     * 3. (Optional) CreateAssociatedTokenAccount if recipient ATA doesn't exist
+     * 4. TransferChecked (USDC transfer)
+     *
+     * Fee payer: Facilitator (not user)
+     * User pays: ZERO SOL/FOGO
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode SVM payment as X-PAYMENT header
+     *
+     * @param paymentPayload - The payment payload JSON string
+     * @param chainConfig - Optional chain config (defaults to 'solana' if not provided)
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig): string;
+    private getPhantomProvider;
+    /**
+     * Get or create a connection for a specific chain
+     */
+    private getConnection;
+    /**
+     * @deprecated Use getConnection instead
+     */
+    private initConnection;
+}
+/**
+ * @deprecated Use SVMProvider instead
+ */
+declare class SolanaProvider extends SVMProvider {
+    constructor();
+}
+
+export { SVMProvider, SolanaProvider, SVMProvider as default };