@alleyboss/micropay-solana-x402-paywall 2.3.0 → 3.0.0

package/dist/agent/index.js

@@ -0,0 +1,347 @@
+import { PublicKey, SystemProgram, LAMPORTS_PER_SOL, Keypair, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } from '@solana/web3.js';
+import { SignJWT, jwtVerify } from 'jose';
+import { v4 } from 'uuid';
+
+// src/agent/agentPayment.ts
+var DEFAULT_COMPUTE_UNITS = 2e5;
+var DEFAULT_MICRO_LAMPORTS = 1e3;
+function createPriorityFeeInstructions(config = {}) {
+  const { enabled = false, microLamports, computeUnits } = config;
+  if (!enabled) {
+    return [];
+  }
+  const instructions = [];
+  const units = computeUnits ?? DEFAULT_COMPUTE_UNITS;
+  instructions.push(ComputeBudgetProgram.setComputeUnitLimit({ units }));
+  const price = microLamports ?? DEFAULT_MICRO_LAMPORTS;
+  instructions.push(ComputeBudgetProgram.setComputeUnitPrice({ microLamports: price }));
+  return instructions;
+}
+async function buildVersionedTransaction(config) {
+  const {
+    connection,
+    payer,
+    instructions,
+    priorityFee,
+    recentBlockhash
+  } = config;
+  const priorityIxs = createPriorityFeeInstructions(priorityFee);
+  const allInstructions = [...priorityIxs, ...instructions];
+  let blockhash;
+  let lastValidBlockHeight;
+  if (recentBlockhash) {
+    blockhash = recentBlockhash;
+    const slot = await connection.getSlot();
+    lastValidBlockHeight = slot + 150;
+  } else {
+    const latestBlockhash = await connection.getLatestBlockhash("confirmed");
+    blockhash = latestBlockhash.blockhash;
+    lastValidBlockHeight = latestBlockhash.lastValidBlockHeight;
+  }
+  const message = new TransactionMessage({
+    payerKey: payer,
+    recentBlockhash: blockhash,
+    instructions: allInstructions
+  }).compileToV0Message([]);
+  const transaction = new VersionedTransaction(message);
+  return {
+    transaction,
+    blockhash,
+    lastValidBlockHeight
+  };
+}
+
+// src/agent/agentPayment.ts
+var WALLET_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+function isValidWalletAddress(address) {
+  if (!address || typeof address !== "string") return false;
+  return WALLET_REGEX.test(address);
+}
+async function executeAgentPayment(params) {
+  const {
+    connection,
+    agentKeypair,
+    recipientAddress,
+    amountLamports,
+    priorityFee,
+    confirmationTimeout = 6e4
+  } = params;
+  if (!isValidWalletAddress(recipientAddress)) {
+    return {
+      success: false,
+      error: "Invalid recipient address format"
+    };
+  }
+  if (amountLamports <= 0n) {
+    return {
+      success: false,
+      error: "Amount must be greater than 0"
+    };
+  }
+  try {
+    const recipientPubkey = new PublicKey(recipientAddress);
+    const transferInstruction = SystemProgram.transfer({
+      fromPubkey: agentKeypair.publicKey,
+      toPubkey: recipientPubkey,
+      lamports: amountLamports
+    });
+    const { transaction, lastValidBlockHeight } = await buildVersionedTransaction({
+      connection,
+      payer: agentKeypair.publicKey,
+      instructions: [transferInstruction],
+      priorityFee
+    });
+    transaction.sign([agentKeypair]);
+    const signature = await connection.sendTransaction(transaction, {
+      maxRetries: 3,
+      skipPreflight: false
+    });
+    const confirmationPromise = connection.confirmTransaction(
+      {
+        signature,
+        lastValidBlockHeight,
+        blockhash: transaction.message.recentBlockhash
+      },
+      "confirmed"
+    );
+    const timeoutPromise = new Promise((_, reject) => {
+      setTimeout(() => reject(new Error("Confirmation timeout")), confirmationTimeout);
+    });
+    const confirmation = await Promise.race([confirmationPromise, timeoutPromise]);
+    if (confirmation.value.err) {
+      return {
+        success: false,
+        signature,
+        error: "Transaction failed on-chain"
+      };
+    }
+    const txDetails = await connection.getTransaction(signature, {
+      commitment: "confirmed",
+      maxSupportedTransactionVersion: 0
+    });
+    return {
+      success: true,
+      signature,
+      confirmedAt: txDetails?.blockTime ?? Math.floor(Date.now() / 1e3),
+      slot: txDetails?.slot ?? confirmation.context.slot,
+      amountLamports,
+      amountSol: Number(amountLamports) / LAMPORTS_PER_SOL
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+    return {
+      success: false,
+      error: errorMessage
+    };
+  }
+}
+async function getAgentBalance(connection, agentKeypair) {
+  const balance = await connection.getBalance(agentKeypair.publicKey);
+  return {
+    balance: BigInt(balance),
+    balanceSol: balance / LAMPORTS_PER_SOL
+  };
+}
+async function hasAgentSufficientBalance(connection, agentKeypair, requiredLamports) {
+  const { balance } = await getAgentBalance(connection, agentKeypair);
+  const totalRequired = requiredLamports + 10000n;
+  return {
+    sufficient: balance >= totalRequired,
+    balance,
+    required: totalRequired
+  };
+}
+function keypairFromBase58(base58Secret) {
+  const bytes = Buffer.from(base58Secret, "base64");
+  if (bytes.length !== 64) {
+    const parts = base58Secret.split(",").map((n) => parseInt(n.trim(), 10));
+    if (parts.length === 64) {
+      return Keypair.fromSecretKey(Uint8Array.from(parts));
+    }
+    throw new Error("Invalid secret key format. Expected base58 string or comma-separated bytes.");
+  }
+  return Keypair.fromSecretKey(bytes);
+}
+function generateAgentKeypair() {
+  const keypair = Keypair.generate();
+  const secretBytes = Array.from(keypair.secretKey);
+  return {
+    keypair,
+    secretBase58: secretBytes.join(","),
+    // Comma-separated for easy storage
+    publicKey: keypair.publicKey.toBase58()
+  };
+}
+var MAX_CREDITS = 1e3;
+var MIN_SECRET_LENGTH = 32;
+function getSecretKey(secret) {
+  if (!secret || typeof secret !== "string") {
+    throw new Error("Session secret is required");
+  }
+  if (secret.length < MIN_SECRET_LENGTH) {
+    throw new Error(`Session secret must be at least ${MIN_SECRET_LENGTH} characters`);
+  }
+  return new TextEncoder().encode(secret);
+}
+function validateWalletAddress(address) {
+  if (!address || typeof address !== "string") return false;
+  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+  return base58Regex.test(address);
+}
+async function createCreditSession(walletAddress, purchaseId, config) {
+  if (!validateWalletAddress(walletAddress)) {
+    throw new Error("Invalid wallet address format");
+  }
+  if (config.initialCredits <= 0 || config.initialCredits > MAX_CREDITS) {
+    throw new Error(`Credits must be between 1 and ${MAX_CREDITS}`);
+  }
+  if (!config.durationHours || config.durationHours <= 0 || config.durationHours > 8760) {
+    throw new Error("Session duration must be between 1 and 8760 hours (1 year)");
+  }
+  const sessionId = v4();
+  const now = Math.floor(Date.now() / 1e3);
+  const expiresAt = now + config.durationHours * 3600;
+  const bundleExpiry = config.bundleExpiryHours ? now + config.bundleExpiryHours * 3600 : expiresAt;
+  const session = {
+    id: sessionId,
+    walletAddress,
+    unlockedArticles: [purchaseId],
+    siteWideUnlock: false,
+    createdAt: now,
+    expiresAt,
+    credits: config.initialCredits,
+    bundleExpiry,
+    bundleType: config.bundleType
+  };
+  const payload = {
+    sub: walletAddress,
+    sid: sessionId,
+    articles: session.unlockedArticles,
+    siteWide: false,
+    credits: config.initialCredits,
+    bundleExpiry,
+    bundleType: config.bundleType,
+    iat: now,
+    exp: expiresAt
+  };
+  const token = await new SignJWT(payload).setProtectedHeader({ alg: "HS256" }).setIssuedAt().setExpirationTime(`${config.durationHours}h`).sign(getSecretKey(config.secret));
+  return { token, session };
+}
+async function validateCreditSession(token, secret) {
+  if (!token || typeof token !== "string") {
+    return { valid: false, reason: "Invalid token format" };
+  }
+  try {
+    const { payload } = await jwtVerify(token, getSecretKey(secret));
+    const creditPayload = payload;
+    if (!creditPayload.sub || !creditPayload.sid || !creditPayload.exp) {
+      return { valid: false, reason: "Malformed session payload" };
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    if (creditPayload.exp < now) {
+      return { valid: false, reason: "Session expired" };
+    }
+    if (creditPayload.bundleExpiry && creditPayload.bundleExpiry < now) {
+      return { valid: false, reason: "Bundle expired" };
+    }
+    if (!validateWalletAddress(creditPayload.sub)) {
+      return { valid: false, reason: "Invalid session data" };
+    }
+    const session = {
+      id: creditPayload.sid,
+      walletAddress: creditPayload.sub,
+      unlockedArticles: Array.isArray(creditPayload.articles) ? creditPayload.articles : [],
+      siteWideUnlock: Boolean(creditPayload.siteWide),
+      createdAt: creditPayload.iat ?? 0,
+      expiresAt: creditPayload.exp,
+      credits: creditPayload.credits ?? 0,
+      bundleExpiry: creditPayload.bundleExpiry,
+      bundleType: creditPayload.bundleType
+    };
+    return { valid: true, session };
+  } catch {
+    return { valid: false, reason: "Invalid session" };
+  }
+}
+async function useCredit(token, secret, creditsToUse = 1) {
+  if (creditsToUse <= 0) {
+    return { success: false, remainingCredits: 0, error: "Invalid credit amount" };
+  }
+  const validation = await validateCreditSession(token, secret);
+  if (!validation.valid || !validation.session) {
+    return {
+      success: false,
+      remainingCredits: 0,
+      error: validation.reason || "Invalid session"
+    };
+  }
+  const session = validation.session;
+  if (session.credits < creditsToUse) {
+    return {
+      success: false,
+      remainingCredits: session.credits,
+      error: "Insufficient credits"
+    };
+  }
+  const newCredits = session.credits - creditsToUse;
+  const payload = {
+    sub: session.walletAddress,
+    sid: session.id,
+    articles: session.unlockedArticles,
+    siteWide: session.siteWideUnlock,
+    credits: newCredits,
+    bundleExpiry: session.bundleExpiry,
+    bundleType: session.bundleType,
+    iat: session.createdAt,
+    exp: session.expiresAt
+  };
+  const newToken = await new SignJWT(payload).setProtectedHeader({ alg: "HS256" }).sign(getSecretKey(secret));
+  return {
+    success: true,
+    remainingCredits: newCredits,
+    newToken
+  };
+}
+async function addCredits(token, secret, creditsToAdd) {
+  if (creditsToAdd <= 0 || creditsToAdd > MAX_CREDITS) {
+    return { success: false, error: "Invalid credit amount" };
+  }
+  const validation = await validateCreditSession(token, secret);
+  if (!validation.valid || !validation.session) {
+    return { success: false, error: validation.reason || "Invalid session" };
+  }
+  const session = validation.session;
+  const newCredits = Math.min(session.credits + creditsToAdd, MAX_CREDITS);
+  const payload = {
+    sub: session.walletAddress,
+    sid: session.id,
+    articles: session.unlockedArticles,
+    siteWide: session.siteWideUnlock,
+    credits: newCredits,
+    bundleExpiry: session.bundleExpiry,
+    bundleType: session.bundleType,
+    iat: session.createdAt,
+    exp: session.expiresAt
+  };
+  const newToken = await new SignJWT(payload).setProtectedHeader({ alg: "HS256" }).sign(getSecretKey(secret));
+  return {
+    success: true,
+    newToken,
+    totalCredits: newCredits
+  };
+}
+async function getRemainingCredits(token, secret) {
+  const validation = await validateCreditSession(token, secret);
+  if (!validation.valid || !validation.session) {
+    return { credits: 0, valid: false };
+  }
+  return {
+    credits: validation.session.credits,
+    valid: true,
+    bundleExpiry: validation.session.bundleExpiry
+  };
+}
+
+export { addCredits, createCreditSession, executeAgentPayment, generateAgentKeypair, getAgentBalance, getRemainingCredits, hasAgentSufficientBalance, keypairFromBase58, useCredit, validateCreditSession };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/solanaHelpers.ts","../../src/agent/agentPayment.ts","../../src/agent/credits.ts"],"names":["PublicKey","uuidv4"],"mappings":"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","file":"index.js","sourcesContent":["// Solana Helper Utilities for Agent Module\n// Self-contained helpers to avoid dependency on deleted/replaced modules\n\nimport {\n    Connection,\n    PublicKey,\n    TransactionMessage,\n    VersionedTransaction,\n    ComputeBudgetProgram,\n    type TransactionInstruction,\n} from '@solana/web3.js';\n\n/** Configuration for priority fees */\nexport interface PriorityFeeConfig {\n    /** Enable priority fees (default: false) */\n    enabled?: boolean;\n    /** Price per compute unit in micro-lamports (default: auto-estimate) */\n    microLamports?: number;\n    /** Maximum compute units for transaction (default: 200_000) */\n    computeUnits?: number;\n}\n\n/** Default priority fee settings */\nconst DEFAULT_COMPUTE_UNITS = 200_000;\nconst DEFAULT_MICRO_LAMPORTS = 1_000; // 0.001 lamports per CU\n\n/**\n * Create compute budget instructions for priority fees\n */\nexport function createPriorityFeeInstructions(\n    config: PriorityFeeConfig = {}\n): TransactionInstruction[] {\n    const { enabled = false, microLamports, computeUnits } = config;\n\n    if (!enabled) {\n        return [];\n    }\n\n    const instructions: TransactionInstruction[] = [];\n\n    // Set compute unit limit\n    const units = computeUnits ?? DEFAULT_COMPUTE_UNITS;\n    instructions.push(ComputeBudgetProgram.setComputeUnitLimit({ units }));\n\n    // Set compute unit price\n    const price = microLamports ?? DEFAULT_MICRO_LAMPORTS;\n    instructions.push(ComputeBudgetProgram.setComputeUnitPrice({ microLamports: price }));\n\n    return instructions;\n}\n\n/** Configuration for building versioned transactions */\nexport interface VersionedTransactionConfig {\n    connection: Connection;\n    payer: PublicKey;\n    instructions: TransactionInstruction[];\n    priorityFee?: PriorityFeeConfig;\n    recentBlockhash?: string;\n}\n\n/** Result of building a versioned transaction */\nexport interface VersionedTransactionResult {\n    transaction: VersionedTransaction;\n    blockhash: string;\n    lastValidBlockHeight: number;\n}\n\n/**\n * Build a versioned transaction (v0) with optional priority fees\n */\nexport async function buildVersionedTransaction(\n    config: VersionedTransactionConfig\n): Promise<VersionedTransactionResult> {\n    const {\n        connection,\n        payer,\n        instructions,\n        priorityFee,\n        recentBlockhash,\n    } = config;\n\n    // Prepend priority fee instructions if configured\n    const priorityIxs = createPriorityFeeInstructions(priorityFee);\n    const allInstructions = [...priorityIxs, ...instructions];\n\n    // Get recent blockhash if not provided\n    let blockhash: string;\n    let lastValidBlockHeight: number;\n\n    if (recentBlockhash) {\n        blockhash = recentBlockhash;\n        // Estimate last valid block height (typically ~150 blocks)\n        const slot = await connection.getSlot();\n        lastValidBlockHeight = slot + 150;\n    } else {\n        const latestBlockhash = await connection.getLatestBlockhash('confirmed');\n        blockhash = latestBlockhash.blockhash;\n        lastValidBlockHeight = latestBlockhash.lastValidBlockHeight;\n    }\n\n    // Build message\n    const message = new TransactionMessage({\n        payerKey: payer,\n        recentBlockhash: blockhash,\n        instructions: allInstructions,\n    }).compileToV0Message([]);\n\n    // Create versioned transaction\n    const transaction = new VersionedTransaction(message);\n\n    return {\n        transaction,\n        blockhash,\n        lastValidBlockHeight,\n    };\n}\n","// Agent Payment Utilities\n// Server-side autonomous payment execution for AI agents\n// SECURITY: Keypair must only be loaded server-side\n\nimport {\n    Connection,\n    Keypair,\n    PublicKey,\n    SystemProgram,\n    LAMPORTS_PER_SOL,\n} from '@solana/web3.js';\nimport { buildVersionedTransaction, type PriorityFeeConfig } from './solanaHelpers';\n\n/** Parameters for executing an agent payment */\nexport interface ExecuteAgentPaymentParams {\n    /** Solana connection */\n    connection: Connection;\n    /** Agent's keypair (server-side only!) */\n    agentKeypair: Keypair;\n    /** Recipient wallet address (base58) */\n    recipientAddress: string;\n    /** Amount to send in lamports */\n    amountLamports: bigint;\n    /** Optional memo for the transaction */\n    memo?: string;\n    /** Optional priority fee configuration */\n    priorityFee?: PriorityFeeConfig;\n    /** Timeout for confirmation in ms (default: 60000) */\n    confirmationTimeout?: number;\n}\n\n/** Result of an agent payment execution */\nexport interface AgentPaymentResult {\n    /** Whether the payment was successful */\n    success: boolean;\n    /** Transaction signature (if successful) */\n    signature?: string;\n    /** Error message (if failed) */\n    error?: string;\n    /** Block time when confirmed (Unix timestamp) */\n    confirmedAt?: number;\n    /** Slot number */\n    slot?: number;\n    /** Amount sent in lamports */\n    amountLamports?: bigint;\n    /** Amount sent in SOL */\n    amountSol?: number;\n}\n\n// Wallet address validation regex\nconst WALLET_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n\n/**\n * Validate wallet address format\n */\nfunction isValidWalletAddress(address: string): boolean {\n    if (!address || typeof address !== 'string') return false;\n    return WALLET_REGEX.test(address);\n}\n\n/**\n * Execute an autonomous SOL payment from the agent's wallet\n * \n * This is the core utility for AI agents to pay for x402-protected resources.\n * The agent keypair must be loaded server-side only (never exposed to client).\n * \n * @example\n * ```typescript\n * import { executeAgentPayment } from '@alleyboss/micropay-solana-x402-paywall/agent';\n * import { Keypair, Connection } from '@solana/web3.js';\n * import bs58 from 'bs58';\n * \n * // Load agent keypair from environment (server-side only!)\n * const agentKeypair = Keypair.fromSecretKey(\n *   bs58.decode(process.env.AGENT_KEYPAIR_SECRET!)\n * );\n * \n * const connection = new Connection('https://api.devnet.solana.com');\n * \n * const result = await executeAgentPayment({\n *   connection,\n *   agentKeypair,\n *   recipientAddress: 'RecipientWallet...',\n *   amountLamports: 20_000_000n, // 0.02 SOL\n *   priorityFee: { enabled: true, microLamports: 5000 },\n * });\n * \n * if (result.success) {\n *   console.log('Payment sent:', result.signature);\n * }\n * ```\n */\nexport async function executeAgentPayment(\n    params: ExecuteAgentPaymentParams\n): Promise<AgentPaymentResult> {\n    const {\n        connection,\n        agentKeypair,\n        recipientAddress,\n        amountLamports,\n        priorityFee,\n        confirmationTimeout = 60000,\n    } = params;\n\n    // Validate recipient address\n    if (!isValidWalletAddress(recipientAddress)) {\n        return {\n            success: false,\n            error: 'Invalid recipient address format',\n        };\n    }\n\n    // Validate amount\n    if (amountLamports <= 0n) {\n        return {\n            success: false,\n            error: 'Amount must be greater than 0',\n        };\n    }\n\n    try {\n        const recipientPubkey = new PublicKey(recipientAddress);\n\n        // Create transfer instruction\n        const transferInstruction = SystemProgram.transfer({\n            fromPubkey: agentKeypair.publicKey,\n            toPubkey: recipientPubkey,\n            lamports: amountLamports,\n        });\n\n        // Build versioned transaction with optional priority fee\n        const { transaction, lastValidBlockHeight } = await buildVersionedTransaction({\n            connection,\n            payer: agentKeypair.publicKey,\n            instructions: [transferInstruction],\n            priorityFee,\n        });\n\n        // Sign transaction\n        transaction.sign([agentKeypair]);\n\n        // Send transaction\n        const signature = await connection.sendTransaction(transaction, {\n            maxRetries: 3,\n            skipPreflight: false,\n        });\n\n        // Wait for confirmation with timeout\n        const confirmationPromise = connection.confirmTransaction(\n            {\n                signature,\n                lastValidBlockHeight,\n                blockhash: transaction.message.recentBlockhash,\n            },\n            'confirmed'\n        );\n\n        const timeoutPromise = new Promise<never>((_, reject) => {\n            setTimeout(() => reject(new Error('Confirmation timeout')), confirmationTimeout);\n        });\n\n        const confirmation = await Promise.race([confirmationPromise, timeoutPromise]);\n\n        if (confirmation.value.err) {\n            return {\n                success: false,\n                signature,\n                error: 'Transaction failed on-chain',\n            };\n        }\n\n        // Get transaction details for confirmed time\n        const txDetails = await connection.getTransaction(signature, {\n            commitment: 'confirmed',\n            maxSupportedTransactionVersion: 0,\n        });\n\n        return {\n            success: true,\n            signature,\n            confirmedAt: txDetails?.blockTime ?? Math.floor(Date.now() / 1000),\n            slot: txDetails?.slot ?? confirmation.context.slot,\n            amountLamports,\n            amountSol: Number(amountLamports) / LAMPORTS_PER_SOL,\n        };\n    } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : 'Unknown error';\n        return {\n            success: false,\n            error: errorMessage,\n        };\n    }\n}\n\n/**\n * Get the agent wallet's SOL balance\n */\nexport async function getAgentBalance(\n    connection: Connection,\n    agentKeypair: Keypair\n): Promise<{ balance: bigint; balanceSol: number }> {\n    const balance = await connection.getBalance(agentKeypair.publicKey);\n    return {\n        balance: BigInt(balance),\n        balanceSol: balance / LAMPORTS_PER_SOL,\n    };\n}\n\n/**\n * Check if agent has sufficient balance for a payment\n */\nexport async function hasAgentSufficientBalance(\n    connection: Connection,\n    agentKeypair: Keypair,\n    requiredLamports: bigint\n): Promise<{ sufficient: boolean; balance: bigint; required: bigint }> {\n    const { balance } = await getAgentBalance(connection, agentKeypair);\n    // Add buffer for transaction fees (~5000 lamports)\n    const totalRequired = requiredLamports + 10000n;\n    return {\n        sufficient: balance >= totalRequired,\n        balance,\n        required: totalRequired,\n    };\n}\n\n/**\n * Create a Keypair from a base58-encoded secret key string\n * \n * @example\n * ```typescript\n * const keypair = keypairFromBase58(process.env.AGENT_KEYPAIR_SECRET!);\n * ```\n */\nexport function keypairFromBase58(base58Secret: string): Keypair {\n    // Dynamic import to avoid bundling bs58 in client code\n    // For server-side use, install bs58 as a dependency\n    const bytes = Buffer.from(base58Secret, 'base64');\n\n    // Try base58 decode if base64 fails\n    if (bytes.length !== 64) {\n        // Fallback: assume it's a comma-separated array of numbers\n        const parts = base58Secret.split(',').map(n => parseInt(n.trim(), 10));\n        if (parts.length === 64) {\n            return Keypair.fromSecretKey(Uint8Array.from(parts));\n        }\n        throw new Error('Invalid secret key format. Expected base58 string or comma-separated bytes.');\n    }\n\n    return Keypair.fromSecretKey(bytes);\n}\n\n/**\n * Create a new random Keypair for agent use\n * Returns both the keypair and its base58-encoded secret for storage\n */\nexport function generateAgentKeypair(): { keypair: Keypair; secretBase58: string; publicKey: string } {\n    const keypair = Keypair.generate();\n    const secretBytes = Array.from(keypair.secretKey);\n    return {\n        keypair,\n        secretBase58: secretBytes.join(','), // Comma-separated for easy storage\n        publicKey: keypair.publicKey.toBase58(),\n    };\n}\n","// Bundle Credits System\n// Optional credit-based session management for agent payments\n\nimport { SignJWT, jwtVerify } from 'jose';\nimport { v4 as uuidv4 } from 'uuid';\nimport type { SessionConfig, SessionData } from '../session/types';\n\n/** Credit claims stored in session JWT */\nexport interface CreditSessionClaims {\n    /** Number of remaining credits */\n    credits: number;\n    /** Unix timestamp when bundle expires (optional) */\n    bundleExpiry?: number;\n    /** Bundle type identifier (e.g., 'starter', 'pro') */\n    bundleType?: string;\n}\n\n/** Extended session data with credit information */\nexport type CreditSessionData = SessionData & CreditSessionClaims;\n\n/** Configuration for credit sessions */\nexport interface CreditSessionConfig extends SessionConfig {\n    /** Initial number of credits */\n    initialCredits: number;\n    /** Bundle expiry in hours (optional, defaults to session duration) */\n    bundleExpiryHours?: number;\n    /** Bundle type identifier */\n    bundleType?: string;\n}\n\n/** JWT payload for credit sessions */\ninterface CreditJWTPayload {\n    sub: string;\n    sid: string;\n    articles: string[];\n    siteWide: boolean;\n    credits: number;\n    bundleExpiry?: number;\n    bundleType?: string;\n    iat: number;\n    exp: number;\n}\n\n// Constants\nconst MAX_CREDITS = 1000;\nconst MIN_SECRET_LENGTH = 32;\n\n/**\n * Get the secret key for JWT signing\n */\nfunction getSecretKey(secret: string): Uint8Array {\n    if (!secret || typeof secret !== 'string') {\n        throw new Error('Session secret is required');\n    }\n    if (secret.length < MIN_SECRET_LENGTH) {\n        throw new Error(`Session secret must be at least ${MIN_SECRET_LENGTH} characters`);\n    }\n    return new TextEncoder().encode(secret);\n}\n\n/**\n * Validate wallet address format\n */\nfunction validateWalletAddress(address: string): boolean {\n    if (!address || typeof address !== 'string') return false;\n    const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n    return base58Regex.test(address);\n}\n\n/**\n * Create a new credit session after bundle purchase\n * \n * @example\n * ```typescript\n * import { createCreditSession } from '@alleyboss/micropay-solana-x402-paywall/agent';\n * \n * const { token, session } = await createCreditSession(\n *   walletAddress,\n *   'bundle-purchase',\n *   {\n *     secret: process.env.SESSION_SECRET!,\n *     durationHours: 24 * 30, // 30 days\n *     initialCredits: 10,\n *     bundleType: 'starter',\n *   }\n * );\n * \n * // Set as cookie\n * response.cookies.set('x402_credits', token, { httpOnly: true });\n * ```\n */\nexport async function createCreditSession(\n    walletAddress: string,\n    purchaseId: string,\n    config: CreditSessionConfig\n): Promise<{ token: string; session: CreditSessionData }> {\n    // Input validation\n    if (!validateWalletAddress(walletAddress)) {\n        throw new Error('Invalid wallet address format');\n    }\n    if (config.initialCredits <= 0 || config.initialCredits > MAX_CREDITS) {\n        throw new Error(`Credits must be between 1 and ${MAX_CREDITS}`);\n    }\n    if (!config.durationHours || config.durationHours <= 0 || config.durationHours > 8760) {\n        throw new Error('Session duration must be between 1 and 8760 hours (1 year)');\n    }\n\n    const sessionId = uuidv4();\n    const now = Math.floor(Date.now() / 1000);\n    const expiresAt = now + (config.durationHours * 3600);\n    const bundleExpiry = config.bundleExpiryHours\n        ? now + (config.bundleExpiryHours * 3600)\n        : expiresAt;\n\n    const session: CreditSessionData = {\n        id: sessionId,\n        walletAddress,\n        unlockedArticles: [purchaseId],\n        siteWideUnlock: false,\n        createdAt: now,\n        expiresAt,\n        credits: config.initialCredits,\n        bundleExpiry,\n        bundleType: config.bundleType,\n    };\n\n    const payload: CreditJWTPayload = {\n        sub: walletAddress,\n        sid: sessionId,\n        articles: session.unlockedArticles,\n        siteWide: false,\n        credits: config.initialCredits,\n        bundleExpiry,\n        bundleType: config.bundleType,\n        iat: now,\n        exp: expiresAt,\n    };\n\n    const token = await new SignJWT(payload as unknown as Record<string, unknown>)\n        .setProtectedHeader({ alg: 'HS256' })\n        .setIssuedAt()\n        .setExpirationTime(`${config.durationHours}h`)\n        .sign(getSecretKey(config.secret));\n\n    return { token, session };\n}\n\n/** Result of validating a credit session */\nexport interface CreditValidation {\n    valid: boolean;\n    session?: CreditSessionData;\n    reason?: string;\n}\n\n/**\n * Validate a credit session token\n */\nexport async function validateCreditSession(\n    token: string,\n    secret: string\n): Promise<CreditValidation> {\n    if (!token || typeof token !== 'string') {\n        return { valid: false, reason: 'Invalid token format' };\n    }\n\n    try {\n        const { payload } = await jwtVerify(token, getSecretKey(secret));\n        const creditPayload = payload as unknown as CreditJWTPayload;\n\n        // Validate required fields\n        if (!creditPayload.sub || !creditPayload.sid || !creditPayload.exp) {\n            return { valid: false, reason: 'Malformed session payload' };\n        }\n\n        // Check expiration\n        const now = Math.floor(Date.now() / 1000);\n        if (creditPayload.exp < now) {\n            return { valid: false, reason: 'Session expired' };\n        }\n\n        // Check bundle expiry if set\n        if (creditPayload.bundleExpiry && creditPayload.bundleExpiry < now) {\n            return { valid: false, reason: 'Bundle expired' };\n        }\n\n        // Validate wallet format\n        if (!validateWalletAddress(creditPayload.sub)) {\n            return { valid: false, reason: 'Invalid session data' };\n        }\n\n        const session: CreditSessionData = {\n            id: creditPayload.sid,\n            walletAddress: creditPayload.sub,\n            unlockedArticles: Array.isArray(creditPayload.articles) ? creditPayload.articles : [],\n            siteWideUnlock: Boolean(creditPayload.siteWide),\n            createdAt: creditPayload.iat ?? 0,\n            expiresAt: creditPayload.exp,\n            credits: creditPayload.credits ?? 0,\n            bundleExpiry: creditPayload.bundleExpiry,\n            bundleType: creditPayload.bundleType,\n        };\n\n        return { valid: true, session };\n    } catch {\n        return { valid: false, reason: 'Invalid session' };\n    }\n}\n\n/** Result of using a credit */\nexport interface UseCreditResult {\n    /** Whether the credit was successfully used */\n    success: boolean;\n    /** Remaining credits after use */\n    remainingCredits: number;\n    /** New token with decremented credits (if successful) */\n    newToken?: string;\n    /** Error message (if failed) */\n    error?: string;\n}\n\n/**\n * Use one credit from the session\n * Returns a new token with decremented credit count\n * \n * @example\n * ```typescript\n * import { useCredit } from '@alleyboss/micropay-solana-x402-paywall/agent';\n * \n * const result = await useCredit(token, process.env.SESSION_SECRET!);\n * \n * if (result.success) {\n *   console.log(`Credit used. ${result.remainingCredits} remaining`);\n *   // Update cookie with new token\n *   response.cookies.set('x402_credits', result.newToken!);\n * } else {\n *   console.log('No credits:', result.error);\n * }\n * ```\n */\nexport async function useCredit(\n    token: string,\n    secret: string,\n    creditsToUse: number = 1\n): Promise<UseCreditResult> {\n    if (creditsToUse <= 0) {\n        return { success: false, remainingCredits: 0, error: 'Invalid credit amount' };\n    }\n\n    const validation = await validateCreditSession(token, secret);\n\n    if (!validation.valid || !validation.session) {\n        return {\n            success: false,\n            remainingCredits: 0,\n            error: validation.reason || 'Invalid session'\n        };\n    }\n\n    const session = validation.session;\n\n    // Check if enough credits\n    if (session.credits < creditsToUse) {\n        return {\n            success: false,\n            remainingCredits: session.credits,\n            error: 'Insufficient credits'\n        };\n    }\n\n    // Decrement credits and create new token\n    const newCredits = session.credits - creditsToUse;\n\n    const payload: CreditJWTPayload = {\n        sub: session.walletAddress,\n        sid: session.id,\n        articles: session.unlockedArticles,\n        siteWide: session.siteWideUnlock,\n        credits: newCredits,\n        bundleExpiry: session.bundleExpiry,\n        bundleType: session.bundleType,\n        iat: session.createdAt,\n        exp: session.expiresAt,\n    };\n\n    const newToken = await new SignJWT(payload as unknown as Record<string, unknown>)\n        .setProtectedHeader({ alg: 'HS256' })\n        .sign(getSecretKey(secret));\n\n    return {\n        success: true,\n        remainingCredits: newCredits,\n        newToken,\n    };\n}\n\n/**\n * Add credits to an existing session\n * Useful for top-ups or rewards\n */\nexport async function addCredits(\n    token: string,\n    secret: string,\n    creditsToAdd: number\n): Promise<{ success: boolean; newToken?: string; totalCredits?: number; error?: string }> {\n    if (creditsToAdd <= 0 || creditsToAdd > MAX_CREDITS) {\n        return { success: false, error: 'Invalid credit amount' };\n    }\n\n    const validation = await validateCreditSession(token, secret);\n\n    if (!validation.valid || !validation.session) {\n        return { success: false, error: validation.reason || 'Invalid session' };\n    }\n\n    const session = validation.session;\n    const newCredits = Math.min(session.credits + creditsToAdd, MAX_CREDITS);\n\n    const payload: CreditJWTPayload = {\n        sub: session.walletAddress,\n        sid: session.id,\n        articles: session.unlockedArticles,\n        siteWide: session.siteWideUnlock,\n        credits: newCredits,\n        bundleExpiry: session.bundleExpiry,\n        bundleType: session.bundleType,\n        iat: session.createdAt,\n        exp: session.expiresAt,\n    };\n\n    const newToken = await new SignJWT(payload as unknown as Record<string, unknown>)\n        .setProtectedHeader({ alg: 'HS256' })\n        .sign(getSecretKey(secret));\n\n    return {\n        success: true,\n        newToken,\n        totalCredits: newCredits,\n    };\n}\n\n/**\n * Get remaining credits from a session token (quick check without full validation)\n */\nexport async function getRemainingCredits(\n    token: string,\n    secret: string\n): Promise<{ credits: number; valid: boolean; bundleExpiry?: number }> {\n    const validation = await validateCreditSession(token, secret);\n\n    if (!validation.valid || !validation.session) {\n        return { credits: 0, valid: false };\n    }\n\n    return {\n        credits: validation.session.credits,\n        valid: true,\n        bundleExpiry: validation.session.bundleExpiry,\n    };\n}\n"]}

package/dist/client/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-// src/types/payment.ts
+// src/client/types.ts
 var TOKEN_MINTS = {
   /** USDC on mainnet */
   USDC_MAINNET: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",

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    /** 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"]}
+{"version":3,"sources":["../../src/client/types.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/** 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\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\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","// 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,13 @@
-import { S as SolanaNetwork, d as PaymentAsset } from '../payment-BGp7eMQl.cjs';
+/** SPL Token asset specification */
+interface SPLTokenAsset {
+    /** Token mint address */
+    mint: string;
+    /** Token decimals (default: 6 for USDC/USDT) */
+    decimals?: number;
+}
+/** Asset types for payments */
+type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;
+type SolanaNetwork = 'devnet' | 'mainnet-beta';
 
 /**
  * Payment flow configuration

package/dist/client/index.d.ts

@@ -1,4 +1,13 @@
-import { S as SolanaNetwork, d as PaymentAsset } from '../payment-BGp7eMQl.js';
+/** SPL Token asset specification */
+interface SPLTokenAsset {
+    /** Token mint address */
+    mint: string;
+    /** Token decimals (default: 6 for USDC/USDT) */
+    decimals?: number;
+}
+/** Asset types for payments */
+type PaymentAsset = 'native' | 'usdc' | 'usdt' | SPLTokenAsset;
+type SolanaNetwork = 'devnet' | 'mainnet-beta';
 
 /**
  * Payment flow configuration

package/dist/client/index.js

@@ -1,4 +1,4 @@
-// src/types/payment.ts
+// src/client/types.ts
 var TOKEN_MINTS = {
   /** USDC on mainnet */
   USDC_MAINNET: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",

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    /** 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"]}
+{"version":3,"sources":["../../src/client/types.ts","../../src/client/payment.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** 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\nexport type SolanaNetwork = 'devnet' | 'mainnet-beta';\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","// 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"]}