@alleyboss/micropay-solana-x402-paywall 2.1.0 → 2.1.2

package/dist/client/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/payment.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Payment-related TypeScript types for x402 protocol\n\n/** x402 network identifiers for Solana */\nexport type X402Network = 'solana-devnet' | 'solana-mainnet';\n\n/** Solana network types */\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\n\n/** SPL Token asset specification */\nexport interface SPLTokenAsset {\n    /** Token mint address */\n    mint: string;\n    /** Token decimals (default: 6 for USDC/USDT) */\n    decimals?: number;\n}\n\n/** Asset types for payments */\nexport type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;\n\n/** Known SPL token mint addresses */\nexport const TOKEN_MINTS = {\n    /** USDC on mainnet */\n    USDC_MAINNET: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n    /** USDC on devnet */\n    USDC_DEVNET: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',\n    /** USDT on mainnet */\n    USDT_MAINNET: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n} as const;\n\n/** Payment requirement for x402 protocol */\nexport interface PaymentRequirement {\n    /** Payment scheme - currently only 'exact' is supported */\n    scheme: 'exact';\n    /** Network identifier for x402 */\n    network: X402Network;\n    /** Amount in smallest unit as string (lamports for SOL, base units for tokens) */\n    maxAmountRequired: string;\n    /** URL of the protected resource */\n    resource: string;\n    /** Human-readable description */\n    description: string;\n    /** MIME type of the resource */\n    mimeType?: string;\n    /** Recipient wallet address */\n    payTo: string;\n    /** Maximum time in seconds to complete payment */\n    maxTimeoutSeconds: number;\n    /** Asset type - 'native' for SOL, 'usdc', 'usdt', or custom mint */\n    asset: PaymentAsset;\n    /** Additional metadata */\n    extra?: {\n        name?: string;\n        articleId?: string;\n        [key: string]: unknown;\n    };\n}\n\n/** Payment payload sent by client after transaction */\nexport interface PaymentPayload {\n    /** x402 protocol version */\n    x402Version: number;\n    /** Payment scheme */\n    scheme: 'exact';\n    /** Network identifier */\n    network: X402Network;\n    /** Transaction details */\n    payload: {\n        /** Transaction signature (base58) */\n        signature: string;\n        /** Base64 encoded transaction (optional) */\n        transaction?: string;\n    };\n}\n\n/** Request to verify a payment */\nexport interface VerificationRequest {\n    paymentPayload: PaymentPayload;\n    paymentRequirements: PaymentRequirement;\n}\n\n/** Response from payment verification */\nexport interface VerificationResponse {\n    /** Whether the payment is valid */\n    valid: boolean;\n    /** Reason for invalid payment */\n    invalidReason?: string;\n    /** Whether the transaction is settled on-chain */\n    settled?: boolean;\n    /** Transaction details */\n    transaction?: {\n        signature: string;\n        blockTime?: number;\n        slot?: number;\n    };\n}\n\n/** Payment status for tracking */\nexport interface PaymentStatus {\n    status: 'pending' | 'confirmed' | 'failed' | 'expired';\n    signature?: string;\n    confirmations?: number;\n    error?: string;\n}\n\n/** x402 HTTP header constants */\nexport const X402_HEADERS = {\n    PAYMENT_REQUIRED: 'x-payment-required',\n    PAYMENT: 'x-payment',\n    PAYMENT_RESPONSE: 'x-payment-response',\n} as const;\n\n/** Configuration for article pricing */\nexport interface ArticlePaymentConfig {\n    articleId: string;\n    priceInLamports: bigint;\n    title: string;\n    description?: string;\n}\n","// Client-Side Payment Flow Helper\n// Headless payment flow for frontend integration (no Node.js dependencies)\n\nimport { TOKEN_MINTS, type PaymentAsset, type SolanaNetwork } from '../types';\n\n/**\n * Payment flow configuration\n */\nexport interface PaymentFlowConfig {\n    /** Solana network */\n    network: SolanaNetwork;\n    /** Recipient wallet address */\n    recipientWallet: string;\n    /** Amount in smallest unit (lamports or token base units) */\n    amount: bigint;\n    /** Asset to pay with */\n    asset?: PaymentAsset;\n    /** Optional memo for the transaction */\n    memo?: string;\n}\n\n/**\n * Solana Pay URL parameters\n */\nexport interface SolanaPayUrlParams {\n    /** Recipient address */\n    recipient: string;\n    /** Amount in token's natural units (e.g., SOL, not lamports) */\n    amount?: number;\n    /** SPL token mint address */\n    splToken?: string;\n    /** Transaction reference */\n    reference?: string;\n    /** Label for the recipient */\n    label?: string;\n    /** Memo/message */\n    message?: string;\n}\n\n/**\n * Build a Solana Pay URL for QR codes and deep linking\n * Compatible with Phantom, Solflare, and other Solana Pay wallets\n * \n * @example\n * ```typescript\n * const url = buildSolanaPayUrl({\n *   recipient: 'CreatorWalletAddress',\n *   amount: 0.01,\n *   label: 'Article Unlock',\n *   message: 'Premium Content Access',\n * });\n * // Returns: solana:CreatorWalletAddress?amount=0.01&label=Article%20Unlock&message=Premium%20Content%20Access\n * ```\n */\nexport function buildSolanaPayUrl(params: SolanaPayUrlParams): string {\n    const { recipient, amount, splToken, reference, label, message } = params;\n\n    const url = new URL(`solana:${recipient}`);\n\n    if (amount !== undefined) {\n        url.searchParams.set('amount', amount.toString());\n    }\n\n    if (splToken) {\n        url.searchParams.set('spl-token', splToken);\n    }\n\n    if (reference) {\n        url.searchParams.set('reference', reference);\n    }\n\n    if (label) {\n        url.searchParams.set('label', label);\n    }\n\n    if (message) {\n        url.searchParams.set('message', message);\n    }\n\n    return url.toString();\n}\n\n/**\n * Create a payment flow helper for frontend use\n * Provides utilities for building transactions and generating QR codes\n * \n * @example\n * ```typescript\n * const flow = createPaymentFlow({\n *   network: 'devnet',\n *   recipientWallet: 'CreatorAddress',\n *   amount: 10000000n, // 0.01 SOL\n * });\n * \n * // Generate QR code URL\n * const qrUrl = flow.getSolanaPayUrl({ label: 'Unlock Article' });\n * \n * // Get transaction amount in natural units\n * const amountInSol = flow.getDisplayAmount();\n * ```\n */\nexport function createPaymentFlow(config: PaymentFlowConfig) {\n    const { network, recipientWallet, amount, asset = 'native', memo } = config;\n\n    // Determine decimals and mint\n    let decimals = 9; // SOL default\n    let mintAddress: string | undefined;\n\n    if (asset === 'usdc') {\n        decimals = 6;\n        mintAddress = network === 'mainnet-beta' ? TOKEN_MINTS.USDC_MAINNET : TOKEN_MINTS.USDC_DEVNET;\n    } else if (asset === 'usdt') {\n        decimals = 6;\n        mintAddress = TOKEN_MINTS.USDT_MAINNET;\n    } else if (typeof asset === 'object' && 'mint' in asset) {\n        decimals = asset.decimals ?? 6;\n        mintAddress = asset.mint;\n    }\n\n    // Convert to natural units (from lamports/base units)\n    const naturalAmount = Number(amount) / Math.pow(10, decimals);\n\n    return {\n        /** Get the payment configuration */\n        getConfig: () => ({ ...config }),\n\n        /** Get amount in natural display units (e.g., 0.01 SOL) */\n        getDisplayAmount: () => naturalAmount,\n\n        /** Get amount formatted with symbol */\n        getFormattedAmount: () => {\n            const symbol = asset === 'native' ? 'SOL'\n                : asset === 'usdc' ? 'USDC'\n                    : asset === 'usdt' ? 'USDT'\n                        : 'tokens';\n            return `${naturalAmount.toFixed(decimals > 6 ? 4 : 2)} ${symbol}`;\n        },\n\n        /** Generate Solana Pay URL for QR codes */\n        getSolanaPayUrl: (options: { label?: string; reference?: string } = {}) => {\n            return buildSolanaPayUrl({\n                recipient: recipientWallet,\n                amount: naturalAmount,\n                splToken: mintAddress,\n                label: options.label,\n                reference: options.reference,\n                message: memo,\n            });\n        },\n\n        /** Get the token mint address (undefined for native SOL) */\n        getMintAddress: () => mintAddress,\n\n        /** Check if this is a native SOL payment */\n        isNativePayment: () => asset === 'native',\n\n        /** Get network information */\n        getNetworkInfo: () => ({\n            network,\n            isMainnet: network === 'mainnet-beta',\n            explorerUrl: network === 'mainnet-beta'\n                ? 'https://explorer.solana.com'\n                : 'https://explorer.solana.com?cluster=devnet',\n        }),\n\n        /** Build explorer URL for a transaction */\n        getExplorerUrl: (signature: string) => {\n            const baseUrl = 'https://explorer.solana.com/tx';\n            const cluster = network === 'mainnet-beta' ? '' : '?cluster=devnet';\n            return `${baseUrl}/${signature}${cluster}`;\n        },\n    };\n}\n\n/**\n * Create a unique reference for payment tracking\n * Uses crypto.randomUUID when available\n */\nexport function createPaymentReference(): string {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n        return crypto.randomUUID();\n    }\n    // Fallback for environments without crypto.randomUUID\n    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n"]}
+{"version":3,"sources":["../../src/types/payment.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Payment-related TypeScript types for x402 protocol\n\n/** x402 network identifiers for Solana */\nexport type X402Network = 'solana-devnet' | 'solana-mainnet';\n\n/** Solana network types */\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\n\n/** SPL Token asset specification */\nexport interface SPLTokenAsset {\n    /** Token mint address */\n    mint: string;\n    /** Token decimals (default: 6 for USDC/USDT) */\n    decimals?: number;\n}\n\n/** Asset types for payments */\nexport type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;\n\n/** Known SPL token mint addresses */\nexport const TOKEN_MINTS = {\n    /** USDC on mainnet */\n    USDC_MAINNET: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n    /** USDC on devnet */\n    USDC_DEVNET: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',\n    /** USDT on mainnet */\n    USDT_MAINNET: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n} as const;\n\n/** Payment requirement for x402 protocol */\nexport interface PaymentRequirement {\n    /** Payment scheme - currently only 'exact' is supported */\n    scheme: 'exact';\n    /** Network identifier for x402 */\n    network: X402Network;\n    /** Amount in smallest unit as string (lamports for SOL, base units for tokens) */\n    maxAmountRequired: string;\n    /** URL of the protected resource */\n    resource: string;\n    /** Human-readable description */\n    description: string;\n    /** MIME type of the resource */\n    mimeType?: string;\n    /** Recipient wallet address */\n    payTo: string;\n    /** Maximum time in seconds to complete payment */\n    maxTimeoutSeconds: number;\n    /** Asset type - 'native' for SOL, 'usdc', 'usdt', or custom mint */\n    asset: PaymentAsset;\n    /** Additional metadata */\n    extra?: {\n        name?: string;\n        articleId?: string;\n        [key: string]: unknown;\n    };\n}\n\n/** Payment payload sent by client after transaction */\nexport interface PaymentPayload {\n    /** x402 protocol version */\n    x402Version: number;\n    /** Payment scheme */\n    scheme: 'exact';\n    /** Network identifier */\n    network: X402Network;\n    /** Transaction details */\n    payload: {\n        /** Transaction signature (base58) */\n        signature: string;\n        /** Base64 encoded transaction (optional) */\n        transaction?: string;\n    };\n}\n\n/** Request to verify a payment */\nexport interface VerificationRequest {\n    paymentPayload: PaymentPayload;\n    paymentRequirements: PaymentRequirement;\n}\n\n/** Response from payment verification */\nexport interface VerificationResponse {\n    /** Whether the payment is valid */\n    valid: boolean;\n    /** Reason for invalid payment */\n    invalidReason?: string;\n    /** Whether the transaction is settled on-chain */\n    settled?: boolean;\n    /** Sender wallet address (payer) */\n    from?: string;\n    /** Transaction details */\n    transaction?: {\n        signature: string;\n        blockTime?: number;\n        slot?: number;\n    };\n}\n\n/** Payment status for tracking */\nexport interface PaymentStatus {\n    status: 'pending' | 'confirmed' | 'failed' | 'expired';\n    signature?: string;\n    confirmations?: number;\n    error?: string;\n}\n\n/** x402 HTTP header constants */\nexport const X402_HEADERS = {\n    PAYMENT_REQUIRED: 'x-payment-required',\n    PAYMENT: 'x-payment',\n    PAYMENT_RESPONSE: 'x-payment-response',\n} as const;\n\n/** Configuration for article pricing */\nexport interface ArticlePaymentConfig {\n    articleId: string;\n    priceInLamports: bigint;\n    title: string;\n    description?: string;\n}\n","// Client-Side Payment Flow Helper\n// Headless payment flow for frontend integration (no Node.js dependencies)\n\nimport { TOKEN_MINTS, type PaymentAsset, type SolanaNetwork } from '../types';\n\n/**\n * Payment flow configuration\n */\nexport interface PaymentFlowConfig {\n    /** Solana network */\n    network: SolanaNetwork;\n    /** Recipient wallet address */\n    recipientWallet: string;\n    /** Amount in smallest unit (lamports or token base units) */\n    amount: bigint;\n    /** Asset to pay with */\n    asset?: PaymentAsset;\n    /** Optional memo for the transaction */\n    memo?: string;\n}\n\n/**\n * Solana Pay URL parameters\n */\nexport interface SolanaPayUrlParams {\n    /** Recipient address */\n    recipient: string;\n    /** Amount in token's natural units (e.g., SOL, not lamports) */\n    amount?: number;\n    /** SPL token mint address */\n    splToken?: string;\n    /** Transaction reference */\n    reference?: string;\n    /** Label for the recipient */\n    label?: string;\n    /** Memo/message */\n    message?: string;\n}\n\n/**\n * Build a Solana Pay URL for QR codes and deep linking\n * Compatible with Phantom, Solflare, and other Solana Pay wallets\n * \n * @example\n * ```typescript\n * const url = buildSolanaPayUrl({\n *   recipient: 'CreatorWalletAddress',\n *   amount: 0.01,\n *   label: 'Article Unlock',\n *   message: 'Premium Content Access',\n * });\n * // Returns: solana:CreatorWalletAddress?amount=0.01&label=Article%20Unlock&message=Premium%20Content%20Access\n * ```\n */\nexport function buildSolanaPayUrl(params: SolanaPayUrlParams): string {\n    const { recipient, amount, splToken, reference, label, message } = params;\n\n    const url = new URL(`solana:${recipient}`);\n\n    if (amount !== undefined) {\n        url.searchParams.set('amount', amount.toString());\n    }\n\n    if (splToken) {\n        url.searchParams.set('spl-token', splToken);\n    }\n\n    if (reference) {\n        url.searchParams.set('reference', reference);\n    }\n\n    if (label) {\n        url.searchParams.set('label', label);\n    }\n\n    if (message) {\n        url.searchParams.set('message', message);\n    }\n\n    return url.toString();\n}\n\n/**\n * Create a payment flow helper for frontend use\n * Provides utilities for building transactions and generating QR codes\n * \n * @example\n * ```typescript\n * const flow = createPaymentFlow({\n *   network: 'devnet',\n *   recipientWallet: 'CreatorAddress',\n *   amount: 10000000n, // 0.01 SOL\n * });\n * \n * // Generate QR code URL\n * const qrUrl = flow.getSolanaPayUrl({ label: 'Unlock Article' });\n * \n * // Get transaction amount in natural units\n * const amountInSol = flow.getDisplayAmount();\n * ```\n */\nexport function createPaymentFlow(config: PaymentFlowConfig) {\n    const { network, recipientWallet, amount, asset = 'native', memo } = config;\n\n    // Determine decimals and mint\n    let decimals = 9; // SOL default\n    let mintAddress: string | undefined;\n\n    if (asset === 'usdc') {\n        decimals = 6;\n        mintAddress = network === 'mainnet-beta' ? TOKEN_MINTS.USDC_MAINNET : TOKEN_MINTS.USDC_DEVNET;\n    } else if (asset === 'usdt') {\n        decimals = 6;\n        mintAddress = TOKEN_MINTS.USDT_MAINNET;\n    } else if (typeof asset === 'object' && 'mint' in asset) {\n        decimals = asset.decimals ?? 6;\n        mintAddress = asset.mint;\n    }\n\n    // Convert to natural units (from lamports/base units)\n    const naturalAmount = Number(amount) / Math.pow(10, decimals);\n\n    return {\n        /** Get the payment configuration */\n        getConfig: () => ({ ...config }),\n\n        /** Get amount in natural display units (e.g., 0.01 SOL) */\n        getDisplayAmount: () => naturalAmount,\n\n        /** Get amount formatted with symbol */\n        getFormattedAmount: () => {\n            const symbol = asset === 'native' ? 'SOL'\n                : asset === 'usdc' ? 'USDC'\n                    : asset === 'usdt' ? 'USDT'\n                        : 'tokens';\n            return `${naturalAmount.toFixed(decimals > 6 ? 4 : 2)} ${symbol}`;\n        },\n\n        /** Generate Solana Pay URL for QR codes */\n        getSolanaPayUrl: (options: { label?: string; reference?: string } = {}) => {\n            return buildSolanaPayUrl({\n                recipient: recipientWallet,\n                amount: naturalAmount,\n                splToken: mintAddress,\n                label: options.label,\n                reference: options.reference,\n                message: memo,\n            });\n        },\n\n        /** Get the token mint address (undefined for native SOL) */\n        getMintAddress: () => mintAddress,\n\n        /** Check if this is a native SOL payment */\n        isNativePayment: () => asset === 'native',\n\n        /** Get network information */\n        getNetworkInfo: () => ({\n            network,\n            isMainnet: network === 'mainnet-beta',\n            explorerUrl: network === 'mainnet-beta'\n                ? 'https://explorer.solana.com'\n                : 'https://explorer.solana.com?cluster=devnet',\n        }),\n\n        /** Build explorer URL for a transaction */\n        getExplorerUrl: (signature: string) => {\n            const baseUrl = 'https://explorer.solana.com/tx';\n            const cluster = network === 'mainnet-beta' ? '' : '?cluster=devnet';\n            return `${baseUrl}/${signature}${cluster}`;\n        },\n    };\n}\n\n/**\n * Create a unique reference for payment tracking\n * Uses crypto.randomUUID when available\n */\nexport function createPaymentReference(): string {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n        return crypto.randomUUID();\n    }\n    // Fallback for environments without crypto.randomUUID\n    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n"]}

package/dist/client/index.d.cts

@@ -1,4 +1,4 @@
-import { S as SolanaNetwork, d as PaymentAsset } from '../payment-CTxdtqmc.cjs';
+import { S as SolanaNetwork, d as PaymentAsset } from '../payment-BGp7eMQl.cjs';
 
 /**
  * Payment flow configuration

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SolanaNetwork, d as PaymentAsset } from '../payment-CTxdtqmc.js';
+import { S as SolanaNetwork, d as PaymentAsset } from '../payment-BGp7eMQl.js';
 
 /**
  * Payment flow configuration

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/payment.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Payment-related TypeScript types for x402 protocol\n\n/** x402 network identifiers for Solana */\nexport type X402Network = 'solana-devnet' | 'solana-mainnet';\n\n/** Solana network types */\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\n\n/** SPL Token asset specification */\nexport interface SPLTokenAsset {\n    /** Token mint address */\n    mint: string;\n    /** Token decimals (default: 6 for USDC/USDT) */\n    decimals?: number;\n}\n\n/** Asset types for payments */\nexport type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;\n\n/** Known SPL token mint addresses */\nexport const TOKEN_MINTS = {\n    /** USDC on mainnet */\n    USDC_MAINNET: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n    /** USDC on devnet */\n    USDC_DEVNET: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',\n    /** USDT on mainnet */\n    USDT_MAINNET: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n} as const;\n\n/** Payment requirement for x402 protocol */\nexport interface PaymentRequirement {\n    /** Payment scheme - currently only 'exact' is supported */\n    scheme: 'exact';\n    /** Network identifier for x402 */\n    network: X402Network;\n    /** Amount in smallest unit as string (lamports for SOL, base units for tokens) */\n    maxAmountRequired: string;\n    /** URL of the protected resource */\n    resource: string;\n    /** Human-readable description */\n    description: string;\n    /** MIME type of the resource */\n    mimeType?: string;\n    /** Recipient wallet address */\n    payTo: string;\n    /** Maximum time in seconds to complete payment */\n    maxTimeoutSeconds: number;\n    /** Asset type - 'native' for SOL, 'usdc', 'usdt', or custom mint */\n    asset: PaymentAsset;\n    /** Additional metadata */\n    extra?: {\n        name?: string;\n        articleId?: string;\n        [key: string]: unknown;\n    };\n}\n\n/** Payment payload sent by client after transaction */\nexport interface PaymentPayload {\n    /** x402 protocol version */\n    x402Version: number;\n    /** Payment scheme */\n    scheme: 'exact';\n    /** Network identifier */\n    network: X402Network;\n    /** Transaction details */\n    payload: {\n        /** Transaction signature (base58) */\n        signature: string;\n        /** Base64 encoded transaction (optional) */\n        transaction?: string;\n    };\n}\n\n/** Request to verify a payment */\nexport interface VerificationRequest {\n    paymentPayload: PaymentPayload;\n    paymentRequirements: PaymentRequirement;\n}\n\n/** Response from payment verification */\nexport interface VerificationResponse {\n    /** Whether the payment is valid */\n    valid: boolean;\n    /** Reason for invalid payment */\n    invalidReason?: string;\n    /** Whether the transaction is settled on-chain */\n    settled?: boolean;\n    /** Transaction details */\n    transaction?: {\n        signature: string;\n        blockTime?: number;\n        slot?: number;\n    };\n}\n\n/** Payment status for tracking */\nexport interface PaymentStatus {\n    status: 'pending' | 'confirmed' | 'failed' | 'expired';\n    signature?: string;\n    confirmations?: number;\n    error?: string;\n}\n\n/** x402 HTTP header constants */\nexport const X402_HEADERS = {\n    PAYMENT_REQUIRED: 'x-payment-required',\n    PAYMENT: 'x-payment',\n    PAYMENT_RESPONSE: 'x-payment-response',\n} as const;\n\n/** Configuration for article pricing */\nexport interface ArticlePaymentConfig {\n    articleId: string;\n    priceInLamports: bigint;\n    title: string;\n    description?: string;\n}\n","// Client-Side Payment Flow Helper\n// Headless payment flow for frontend integration (no Node.js dependencies)\n\nimport { TOKEN_MINTS, type PaymentAsset, type SolanaNetwork } from '../types';\n\n/**\n * Payment flow configuration\n */\nexport interface PaymentFlowConfig {\n    /** Solana network */\n    network: SolanaNetwork;\n    /** Recipient wallet address */\n    recipientWallet: string;\n    /** Amount in smallest unit (lamports or token base units) */\n    amount: bigint;\n    /** Asset to pay with */\n    asset?: PaymentAsset;\n    /** Optional memo for the transaction */\n    memo?: string;\n}\n\n/**\n * Solana Pay URL parameters\n */\nexport interface SolanaPayUrlParams {\n    /** Recipient address */\n    recipient: string;\n    /** Amount in token's natural units (e.g., SOL, not lamports) */\n    amount?: number;\n    /** SPL token mint address */\n    splToken?: string;\n    /** Transaction reference */\n    reference?: string;\n    /** Label for the recipient */\n    label?: string;\n    /** Memo/message */\n    message?: string;\n}\n\n/**\n * Build a Solana Pay URL for QR codes and deep linking\n * Compatible with Phantom, Solflare, and other Solana Pay wallets\n * \n * @example\n * ```typescript\n * const url = buildSolanaPayUrl({\n *   recipient: 'CreatorWalletAddress',\n *   amount: 0.01,\n *   label: 'Article Unlock',\n *   message: 'Premium Content Access',\n * });\n * // Returns: solana:CreatorWalletAddress?amount=0.01&label=Article%20Unlock&message=Premium%20Content%20Access\n * ```\n */\nexport function buildSolanaPayUrl(params: SolanaPayUrlParams): string {\n    const { recipient, amount, splToken, reference, label, message } = params;\n\n    const url = new URL(`solana:${recipient}`);\n\n    if (amount !== undefined) {\n        url.searchParams.set('amount', amount.toString());\n    }\n\n    if (splToken) {\n        url.searchParams.set('spl-token', splToken);\n    }\n\n    if (reference) {\n        url.searchParams.set('reference', reference);\n    }\n\n    if (label) {\n        url.searchParams.set('label', label);\n    }\n\n    if (message) {\n        url.searchParams.set('message', message);\n    }\n\n    return url.toString();\n}\n\n/**\n * Create a payment flow helper for frontend use\n * Provides utilities for building transactions and generating QR codes\n * \n * @example\n * ```typescript\n * const flow = createPaymentFlow({\n *   network: 'devnet',\n *   recipientWallet: 'CreatorAddress',\n *   amount: 10000000n, // 0.01 SOL\n * });\n * \n * // Generate QR code URL\n * const qrUrl = flow.getSolanaPayUrl({ label: 'Unlock Article' });\n * \n * // Get transaction amount in natural units\n * const amountInSol = flow.getDisplayAmount();\n * ```\n */\nexport function createPaymentFlow(config: PaymentFlowConfig) {\n    const { network, recipientWallet, amount, asset = 'native', memo } = config;\n\n    // Determine decimals and mint\n    let decimals = 9; // SOL default\n    let mintAddress: string | undefined;\n\n    if (asset === 'usdc') {\n        decimals = 6;\n        mintAddress = network === 'mainnet-beta' ? TOKEN_MINTS.USDC_MAINNET : TOKEN_MINTS.USDC_DEVNET;\n    } else if (asset === 'usdt') {\n        decimals = 6;\n        mintAddress = TOKEN_MINTS.USDT_MAINNET;\n    } else if (typeof asset === 'object' && 'mint' in asset) {\n        decimals = asset.decimals ?? 6;\n        mintAddress = asset.mint;\n    }\n\n    // Convert to natural units (from lamports/base units)\n    const naturalAmount = Number(amount) / Math.pow(10, decimals);\n\n    return {\n        /** Get the payment configuration */\n        getConfig: () => ({ ...config }),\n\n        /** Get amount in natural display units (e.g., 0.01 SOL) */\n        getDisplayAmount: () => naturalAmount,\n\n        /** Get amount formatted with symbol */\n        getFormattedAmount: () => {\n            const symbol = asset === 'native' ? 'SOL'\n                : asset === 'usdc' ? 'USDC'\n                    : asset === 'usdt' ? 'USDT'\n                        : 'tokens';\n            return `${naturalAmount.toFixed(decimals > 6 ? 4 : 2)} ${symbol}`;\n        },\n\n        /** Generate Solana Pay URL for QR codes */\n        getSolanaPayUrl: (options: { label?: string; reference?: string } = {}) => {\n            return buildSolanaPayUrl({\n                recipient: recipientWallet,\n                amount: naturalAmount,\n                splToken: mintAddress,\n                label: options.label,\n                reference: options.reference,\n                message: memo,\n            });\n        },\n\n        /** Get the token mint address (undefined for native SOL) */\n        getMintAddress: () => mintAddress,\n\n        /** Check if this is a native SOL payment */\n        isNativePayment: () => asset === 'native',\n\n        /** Get network information */\n        getNetworkInfo: () => ({\n            network,\n            isMainnet: network === 'mainnet-beta',\n            explorerUrl: network === 'mainnet-beta'\n                ? 'https://explorer.solana.com'\n                : 'https://explorer.solana.com?cluster=devnet',\n        }),\n\n        /** Build explorer URL for a transaction */\n        getExplorerUrl: (signature: string) => {\n            const baseUrl = 'https://explorer.solana.com/tx';\n            const cluster = network === 'mainnet-beta' ? '' : '?cluster=devnet';\n            return `${baseUrl}/${signature}${cluster}`;\n        },\n    };\n}\n\n/**\n * Create a unique reference for payment tracking\n * Uses crypto.randomUUID when available\n */\nexport function createPaymentReference(): string {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n        return crypto.randomUUID();\n    }\n    // Fallback for environments without crypto.randomUUID\n    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n"]}
+{"version":3,"sources":["../../src/types/payment.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Payment-related TypeScript types for x402 protocol\n\n/** x402 network identifiers for Solana */\nexport type X402Network = 'solana-devnet' | 'solana-mainnet';\n\n/** Solana network types */\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\n\n/** SPL Token asset specification */\nexport interface SPLTokenAsset {\n    /** Token mint address */\n    mint: string;\n    /** Token decimals (default: 6 for USDC/USDT) */\n    decimals?: number;\n}\n\n/** Asset types for payments */\nexport type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;\n\n/** Known SPL token mint addresses */\nexport const TOKEN_MINTS = {\n    /** USDC on mainnet */\n    USDC_MAINNET: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n    /** USDC on devnet */\n    USDC_DEVNET: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',\n    /** USDT on mainnet */\n    USDT_MAINNET: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n} as const;\n\n/** Payment requirement for x402 protocol */\nexport interface PaymentRequirement {\n    /** Payment scheme - currently only 'exact' is supported */\n    scheme: 'exact';\n    /** Network identifier for x402 */\n    network: X402Network;\n    /** Amount in smallest unit as string (lamports for SOL, base units for tokens) */\n    maxAmountRequired: string;\n    /** URL of the protected resource */\n    resource: string;\n    /** Human-readable description */\n    description: string;\n    /** MIME type of the resource */\n    mimeType?: string;\n    /** Recipient wallet address */\n    payTo: string;\n    /** Maximum time in seconds to complete payment */\n    maxTimeoutSeconds: number;\n    /** Asset type - 'native' for SOL, 'usdc', 'usdt', or custom mint */\n    asset: PaymentAsset;\n    /** Additional metadata */\n    extra?: {\n        name?: string;\n        articleId?: string;\n        [key: string]: unknown;\n    };\n}\n\n/** Payment payload sent by client after transaction */\nexport interface PaymentPayload {\n    /** x402 protocol version */\n    x402Version: number;\n    /** Payment scheme */\n    scheme: 'exact';\n    /** Network identifier */\n    network: X402Network;\n    /** Transaction details */\n    payload: {\n        /** Transaction signature (base58) */\n        signature: string;\n        /** Base64 encoded transaction (optional) */\n        transaction?: string;\n    };\n}\n\n/** Request to verify a payment */\nexport interface VerificationRequest {\n    paymentPayload: PaymentPayload;\n    paymentRequirements: PaymentRequirement;\n}\n\n/** Response from payment verification */\nexport interface VerificationResponse {\n    /** Whether the payment is valid */\n    valid: boolean;\n    /** Reason for invalid payment */\n    invalidReason?: string;\n    /** Whether the transaction is settled on-chain */\n    settled?: boolean;\n    /** Sender wallet address (payer) */\n    from?: string;\n    /** Transaction details */\n    transaction?: {\n        signature: string;\n        blockTime?: number;\n        slot?: number;\n    };\n}\n\n/** Payment status for tracking */\nexport interface PaymentStatus {\n    status: 'pending' | 'confirmed' | 'failed' | 'expired';\n    signature?: string;\n    confirmations?: number;\n    error?: string;\n}\n\n/** x402 HTTP header constants */\nexport const X402_HEADERS = {\n    PAYMENT_REQUIRED: 'x-payment-required',\n    PAYMENT: 'x-payment',\n    PAYMENT_RESPONSE: 'x-payment-response',\n} as const;\n\n/** Configuration for article pricing */\nexport interface ArticlePaymentConfig {\n    articleId: string;\n    priceInLamports: bigint;\n    title: string;\n    description?: string;\n}\n","// Client-Side Payment Flow Helper\n// Headless payment flow for frontend integration (no Node.js dependencies)\n\nimport { TOKEN_MINTS, type PaymentAsset, type SolanaNetwork } from '../types';\n\n/**\n * Payment flow configuration\n */\nexport interface PaymentFlowConfig {\n    /** Solana network */\n    network: SolanaNetwork;\n    /** Recipient wallet address */\n    recipientWallet: string;\n    /** Amount in smallest unit (lamports or token base units) */\n    amount: bigint;\n    /** Asset to pay with */\n    asset?: PaymentAsset;\n    /** Optional memo for the transaction */\n    memo?: string;\n}\n\n/**\n * Solana Pay URL parameters\n */\nexport interface SolanaPayUrlParams {\n    /** Recipient address */\n    recipient: string;\n    /** Amount in token's natural units (e.g., SOL, not lamports) */\n    amount?: number;\n    /** SPL token mint address */\n    splToken?: string;\n    /** Transaction reference */\n    reference?: string;\n    /** Label for the recipient */\n    label?: string;\n    /** Memo/message */\n    message?: string;\n}\n\n/**\n * Build a Solana Pay URL for QR codes and deep linking\n * Compatible with Phantom, Solflare, and other Solana Pay wallets\n * \n * @example\n * ```typescript\n * const url = buildSolanaPayUrl({\n *   recipient: 'CreatorWalletAddress',\n *   amount: 0.01,\n *   label: 'Article Unlock',\n *   message: 'Premium Content Access',\n * });\n * // Returns: solana:CreatorWalletAddress?amount=0.01&label=Article%20Unlock&message=Premium%20Content%20Access\n * ```\n */\nexport function buildSolanaPayUrl(params: SolanaPayUrlParams): string {\n    const { recipient, amount, splToken, reference, label, message } = params;\n\n    const url = new URL(`solana:${recipient}`);\n\n    if (amount !== undefined) {\n        url.searchParams.set('amount', amount.toString());\n    }\n\n    if (splToken) {\n        url.searchParams.set('spl-token', splToken);\n    }\n\n    if (reference) {\n        url.searchParams.set('reference', reference);\n    }\n\n    if (label) {\n        url.searchParams.set('label', label);\n    }\n\n    if (message) {\n        url.searchParams.set('message', message);\n    }\n\n    return url.toString();\n}\n\n/**\n * Create a payment flow helper for frontend use\n * Provides utilities for building transactions and generating QR codes\n * \n * @example\n * ```typescript\n * const flow = createPaymentFlow({\n *   network: 'devnet',\n *   recipientWallet: 'CreatorAddress',\n *   amount: 10000000n, // 0.01 SOL\n * });\n * \n * // Generate QR code URL\n * const qrUrl = flow.getSolanaPayUrl({ label: 'Unlock Article' });\n * \n * // Get transaction amount in natural units\n * const amountInSol = flow.getDisplayAmount();\n * ```\n */\nexport function createPaymentFlow(config: PaymentFlowConfig) {\n    const { network, recipientWallet, amount, asset = 'native', memo } = config;\n\n    // Determine decimals and mint\n    let decimals = 9; // SOL default\n    let mintAddress: string | undefined;\n\n    if (asset === 'usdc') {\n        decimals = 6;\n        mintAddress = network === 'mainnet-beta' ? TOKEN_MINTS.USDC_MAINNET : TOKEN_MINTS.USDC_DEVNET;\n    } else if (asset === 'usdt') {\n        decimals = 6;\n        mintAddress = TOKEN_MINTS.USDT_MAINNET;\n    } else if (typeof asset === 'object' && 'mint' in asset) {\n        decimals = asset.decimals ?? 6;\n        mintAddress = asset.mint;\n    }\n\n    // Convert to natural units (from lamports/base units)\n    const naturalAmount = Number(amount) / Math.pow(10, decimals);\n\n    return {\n        /** Get the payment configuration */\n        getConfig: () => ({ ...config }),\n\n        /** Get amount in natural display units (e.g., 0.01 SOL) */\n        getDisplayAmount: () => naturalAmount,\n\n        /** Get amount formatted with symbol */\n        getFormattedAmount: () => {\n            const symbol = asset === 'native' ? 'SOL'\n                : asset === 'usdc' ? 'USDC'\n                    : asset === 'usdt' ? 'USDT'\n                        : 'tokens';\n            return `${naturalAmount.toFixed(decimals > 6 ? 4 : 2)} ${symbol}`;\n        },\n\n        /** Generate Solana Pay URL for QR codes */\n        getSolanaPayUrl: (options: { label?: string; reference?: string } = {}) => {\n            return buildSolanaPayUrl({\n                recipient: recipientWallet,\n                amount: naturalAmount,\n                splToken: mintAddress,\n                label: options.label,\n                reference: options.reference,\n                message: memo,\n            });\n        },\n\n        /** Get the token mint address (undefined for native SOL) */\n        getMintAddress: () => mintAddress,\n\n        /** Check if this is a native SOL payment */\n        isNativePayment: () => asset === 'native',\n\n        /** Get network information */\n        getNetworkInfo: () => ({\n            network,\n            isMainnet: network === 'mainnet-beta',\n            explorerUrl: network === 'mainnet-beta'\n                ? 'https://explorer.solana.com'\n                : 'https://explorer.solana.com?cluster=devnet',\n        }),\n\n        /** Build explorer URL for a transaction */\n        getExplorerUrl: (signature: string) => {\n            const baseUrl = 'https://explorer.solana.com/tx';\n            const cluster = network === 'mainnet-beta' ? '' : '?cluster=devnet';\n            return `${baseUrl}/${signature}${cluster}`;\n        },\n    };\n}\n\n/**\n * Create a unique reference for payment tracking\n * Uses crypto.randomUUID when available\n */\nexport function createPaymentReference(): string {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n        return crypto.randomUUID();\n    }\n    // Fallback for environments without crypto.randomUUID\n    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n"]}

package/dist/{client-Blkcv17a.d.cts → client-D-dteoJw.d.cts}

@@ -1,5 +1,5 @@
 import { Connection } from '@solana/web3.js';
-import { S as SolanaNetwork } from './payment-CTxdtqmc.cjs';
+import { S as SolanaNetwork } from './payment-BGp7eMQl.cjs';
 
 /** Configuration for Solana client */
 interface SolanaClientConfig {

package/dist/{client-xhJSoeOH.d.ts → client-DfCIRrNG.d.ts}

@@ -1,5 +1,5 @@
 import { Connection } from '@solana/web3.js';
-import { S as SolanaNetwork } from './payment-CTxdtqmc.js';
+import { S as SolanaNetwork } from './payment-BGp7eMQl.js';
 
 /** Configuration for Solana client */
 interface SolanaClientConfig {

package/dist/index.cjs

@@ -803,6 +803,7 @@ async function verifyX402Payment(payload, requirement, clientConfig) {
   return {
     valid: true,
     settled: verification.confirmed,
+    from: verification.from,
     transaction: {
       signature: verification.signature,
       blockTime: verification.blockTime,