privacycash-x402 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rohan Singla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# p402 ( Private x402 SDK )
+
+A privacy-preserving payment SDK for Solana implementing the HTTP 402 Payment Required protocol using [Privacy Cash](https://privacycash.org).
+
+## What is This?
+
+This SDK enables **private API monetization** on Solana. Users pay for API access through a privacy pool - the server receives payment but cannot link it to the user's identity.
+
+```
+User deposits SOL → Privacy Pool → Anonymous payment → API Access
+```
+
+## Quick Start
+
+```bash
+# Install
+npm install
+
+# Terminal 1: Start server
+npm run example:server
+
+# Terminal 2: Run client
+npm run example:client
+```
+
+## How It Works
+
+```
+Client                              Server
+  │                                   │
+  ├─── GET /api/premium ─────────────►│
+  │◄── 402 + Payment Quote ───────────┤
+  │                                   │
+  │ [Deposit to Privacy Pool]         │
+  │ [Generate ZK Payment Proof]       │
+  │                                   │
+  ├─── GET /api + Payment Headers ───►│
+  │                         [Verify]  │
+  │                   [Check Balance] │
+  │              [Prevent Double-Spend]│
+  │◄────── 200 + Premium Content ─────┤
+```
+
+## Usage
+
+### Server
+
+```typescript
+import express from 'express';
+import { X402PaymentServer } from 'privacycash-x402';
+
+const server = new X402PaymentServer({
+  merchantWallet: 'YOUR_WALLET_ADDRESS',
+  rpcUrl: 'https://api.mainnet-beta.solana.com',
+  apiPrice: 10_000_000, // 0.01 SOL
+});
+
+const app = express();
+app.get('/premium', server.middleware(), (req, res) => {
+  res.json({ data: 'Premium content!' });
+});
+```
+
+### Client
+
+```typescript
+import { Keypair } from '@solana/web3.js';
+import { X402PaymentClient } from 'privacycash-x402';
+
+const client = new X402PaymentClient({
+  rpcUrl: 'https://api.mainnet-beta.solana.com',
+  keypair: Keypair.fromSecretKey(yourKeypair),
+  mockMode: false, // Set true for testing without real SOL
+});
+
+await client.initialize();
+const result = await client.payForAccess('https://api.example.com/premium');
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MERCHANT_WALLET` | Wallet to receive payments | - |
+| `API_PRICE` | Price in lamports | `10000000` |
+| `RPC_URL` | Solana RPC endpoint | devnet |
+| `WALLET_KEYPAIR` | Client keypair (JSON array) | - |
+| `MOCK_MODE` | Enable mock mode | `true` |
+
+## Project Structure
+
+```
+src/
+├── index.ts           # Main exports
+├── server/index.ts    # X402PaymentServer
+├── client/index.ts    # X402PaymentClient
+├── types/index.ts     # TypeScript types
+├── errors/index.ts    # Error classes
+└── utils/             # Encryption, constants
+```
+
+## Privacy Guarantees
+
+- **Unlinkable**: Deposits and payments cannot be connected on-chain
+- **Anonymous**: Server cannot identify who made the deposit
+- **Zero-Knowledge**: Payment validity proven without revealing identity
+- **Double-Spend Protected**: Each commitment can only be used once
+
+## Primary Use Cases
+
+| User Type | Example | Why p402? |
+|-----------|---------|-----------|
+| **Backend Services** | AI API paying for data APIs | Privacy between service providers |
+| **CLI Tools** | Payment tools for developers | Programmatic private payments |
+| **Bots/Automation** | Trading bots, monitoring services | Automated payments without linking activity |
+| **B2B Integrations** | Company A's service paying Company B's API | Hide business relationships on-chain |
+| **Privacy-first Businesses** | VPN providers, privacy tools | Users who specifically want unlinkable payments |
+
+**Note:** This SDK requires full keypair access and is designed for server-side/CLI usage.
+
+## Limitations
+
+- **Mainnet Only**: Privacy Cash is deployed only on Solana mainnet
+- **Mock Mode**: Use `mockMode: true` for development/demos without real SOL
+- **Balance Proof**: Current implementation uses client-reported balance proofs (see Upcoming Updates)
+
+### Security Note
+
+Production deployments should await ZK proof integration.
+
+### Roadmap
+
+- [ ] ZK balance proof generation via Privacy Cash SDK
+- [ ] Server-side proof verification against on-chain state
+- [ ] Mainnet launch with full cryptographic guarantees
+
+## License
+
+MIT

package/dist/examples/client-example.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Privacy Cash x402 Client Example
+ *
+ * Make sure the server is running first: npm run example:server
+ *
+ * Environment variables:
+ * - WALLET_KEYPAIR: JSON array of keypair bytes (required)
+ * - RPC_URL: Solana RPC URL (default: devnet)
+ * - SERVER_URL: x402 server URL (default: http://localhost:3001)
+ * - MOCK_MODE: Set to "false" to use real Privacy Cash (requires mainnet)
+ */
+import 'dotenv/config';
+//# sourceMappingURL=client-example.d.ts.map

package/dist/examples/client-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-example.d.ts","sourceRoot":"","sources":["../../examples/client-example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,eAAe,CAAC"}

package/dist/examples/client-example.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Privacy Cash x402 Client Example
+ *
+ * Make sure the server is running first: npm run example:server
+ *
+ * Environment variables:
+ * - WALLET_KEYPAIR: JSON array of keypair bytes (required)
+ * - RPC_URL: Solana RPC URL (default: devnet)
+ * - SERVER_URL: x402 server URL (default: http://localhost:3001)
+ * - MOCK_MODE: Set to "false" to use real Privacy Cash (requires mainnet)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const web3_js_1 = require("@solana/web3.js");
+const src_1 = require("../src");
+// Load config from environment
+const RPC_URL = process.env.RPC_URL || 'https://api.devnet.solana.com';
+const SERVER_URL = process.env.SERVER_URL || 'http://localhost:3001';
+const MOCK_MODE = process.env.MOCK_MODE !== 'false'; // Default to mock mode
+/**
+ * Load keypair from environment
+ */
+function loadKeypair() {
+    if (!process.env.WALLET_KEYPAIR) {
+        console.error('Error: WALLET_KEYPAIR environment variable is required');
+        console.error('Then add to .env: WALLET_KEYPAIR=[...contents of wallet.json...]');
+        process.exit(1);
+    }
+    try {
+        const keypairBytes = new Uint8Array(JSON.parse(process.env.WALLET_KEYPAIR));
+        return web3_js_1.Keypair.fromSecretKey(keypairBytes);
+    }
+    catch (e) {
+        console.error('Error: Failed to parse WALLET_KEYPAIR');
+        console.error('Make sure it is a valid JSON array of 64 bytes');
+        process.exit(1);
+    }
+}
+/**
+ * Main demo function
+ */
+async function main() {
+    console.log('\nPrivacy Cash x402 Client Demo\n');
+    console.log('==============================\n');
+    // Load keypair
+    const keypair = loadKeypair();
+    console.log(`Wallet: ${keypair.publicKey.toBase58()}`);
+    // Check wallet balance (skip in mock mode)
+    if (!MOCK_MODE) {
+        const connection = new web3_js_1.Connection(RPC_URL, 'confirmed');
+        const balance = await connection.getBalance(keypair.publicKey);
+        console.log(`Wallet SOL balance: ${balance / web3_js_1.LAMPORTS_PER_SOL} SOL`);
+        if (balance < 0.02 * web3_js_1.LAMPORTS_PER_SOL) {
+            console.log('\nWarning: Low SOL balance.');
+            console.log(`Address: ${keypair.publicKey.toBase58()}\n`);
+        }
+    }
+    // Create x402 client
+    const client = new src_1.X402PaymentClient({
+        rpcUrl: RPC_URL,
+        keypair,
+        mockMode: MOCK_MODE,
+    });
+    if (MOCK_MODE) {
+        console.log('\n[MOCK MODE] Simulating p402 - no real transactions');
+        console.log('Set MOCK_MODE=false in .env to use real Privacy Cash (mainnet only)\n');
+    }
+    // Initialize client
+    console.log('\nInitializing client...');
+    await client.initialize();
+    // Try to access premium endpoint
+    console.log(`\nAccessing premium endpoint at ${SERVER_URL}/premium...`);
+    try {
+        const result = await client.payForAccess(`${SERVER_URL}/premium`);
+        if (result.success) {
+            console.log('\nPremium Content Unlocked!');
+            console.log('========================');
+            console.log(result.data);
+            if (result.paymentDetails) {
+                console.log('\nPayment Details:');
+                console.log(`  Note Hash: ${result.paymentDetails.noteHash?.substring(0, 20)}...`);
+                console.log(`  Verified: ${result.paymentDetails.verified}`);
+            }
+            console.log('\nPrivacy Achieved:');
+            console.log('  Your deposit is mixed with others in the pool');
+            console.log('  Server receives payment but cannot link it to your wallet');
+            console.log('  On-chain observers see anonymous deposit/withdrawal');
+            console.log('  Zero-knowledge proofs verify payment validity');
+        }
+    }
+    catch (error) {
+        console.error('\nPayment failed:', error);
+        if (error instanceof Error) {
+            if (error.message.includes('insufficient funds')) {
+                console.log('\nTip: You need SOL in your wallet to deposit into the privacy pool');
+                console.log(`Get devnet SOL: https://faucet.solana.com/`);
+                console.log(`Your address: ${keypair.publicKey.toBase58()}`);
+            }
+        }
+    }
+}
+// Run the demo
+main().catch((err) => {
+    console.error('Demo failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=client-example.js.map

package/dist/examples/client-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-example.js","sourceRoot":"","sources":["../../examples/client-example.ts"],"names":[],"mappings":"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"}

package/dist/examples/server-example.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Privacy Cash x402 Server Example
+ *
+ * Start this server, then run client-example.ts in another terminal
+ *
+ * Environment variables:
+ * - MERCHANT_WALLET: Your Solana wallet address for receiving payments
+ * - MERCHANT_KEYPAIR: JSON array of keypair bytes (for withdrawals)
+ * - API_PRICE: Price in lamports (default: 10000000 = 0.01 SOL)
+ * - RPC_URL: Solana RPC URL (default: devnet)
+ */
+import 'dotenv/config';
+//# sourceMappingURL=server-example.d.ts.map

package/dist/examples/server-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-example.d.ts","sourceRoot":"","sources":["../../examples/server-example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,eAAe,CAAC"}

package/dist/examples/server-example.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Privacy Cash x402 Server Example
+ *
+ * Start this server, then run client-example.ts in another terminal
+ *
+ * Environment variables:
+ * - MERCHANT_WALLET: Your Solana wallet address for receiving payments
+ * - MERCHANT_KEYPAIR: JSON array of keypair bytes (for withdrawals)
+ * - API_PRICE: Price in lamports (default: 10000000 = 0.01 SOL)
+ * - RPC_URL: Solana RPC URL (default: devnet)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const express_1 = __importDefault(require("express"));
+const server_1 = require("../src/server");
+// Load config from environment
+const MERCHANT_WALLET = process.env.MERCHANT_WALLET || '';
+const API_PRICE = parseInt(process.env.API_PRICE || '10000000'); // 0.01 SOL
+const RPC_URL = process.env.RPC_URL || 'https://api.devnet.solana.com';
+// Parse merchant keypair if provided
+let merchantKeypair;
+if (process.env.MERCHANT_KEYPAIR) {
+    try {
+        merchantKeypair = new Uint8Array(JSON.parse(process.env.MERCHANT_KEYPAIR));
+    }
+    catch (e) {
+        console.warn('Failed to parse MERCHANT_KEYPAIR, withdrawals will be simulated');
+    }
+}
+// Create server
+const paymentServer = new server_1.X402PaymentServer({
+    merchantWallet: MERCHANT_WALLET,
+    rpcUrl: RPC_URL,
+    apiPrice: API_PRICE,
+    merchantKeypair,
+});
+// Create Express app
+const app = (0, express_1.default)();
+app.use(express_1.default.json());
+// Health check endpoint
+app.get('/health', (req, res) => {
+    const stats = paymentServer.getStats();
+    res.json({
+        status: 'healthy',
+        service: 'Privacy Cash x402 Server',
+        network: RPC_URL.includes('devnet') ? 'devnet' : 'mainnet-beta',
+        stats,
+    });
+});
+// Premium endpoint - protected by x402 payment
+app.get('/premium', paymentServer.middleware(), (req, res) => {
+    res.json({
+        success: true,
+        data: 'Premium content unlocked! This data is protected by Privacy Cash.',
+        message: 'Your payment was verified privately. No one can link this to your deposit.',
+        privacyGuarantees: [
+            'Your wallet address is hidden from this transaction',
+            'Payment amount is mixed with others in the pool',
+            'Zero-knowledge proofs verify validity without revealing identity',
+            'On-chain observers cannot link deposit to withdrawal',
+        ],
+    });
+});
+// Admin stats endpoint
+app.get('/admin/stats', (req, res) => {
+    const stats = paymentServer.getStats();
+    res.json({
+        totalPaymentsReceived: stats.usedCommitments,
+        pendingWithdrawals: stats.pendingPayments,
+        totalPendingRevenue: stats.totalPendingAmount,
+        uptime: process.uptime(),
+    });
+});
+// Start server
+const PORT = parseInt(process.env.PORT || '3001');
+app.listen(PORT, () => {
+    console.log('\nPrivacy Cash x402 Server Running');
+    console.log('=====================================');
+    console.log(`URL: http://localhost:${PORT}`);
+    console.log(`Network: ${RPC_URL.includes('devnet') ? 'devnet' : 'mainnet-beta'}`);
+    console.log(`Merchant: ${MERCHANT_WALLET}`);
+    console.log(`API Price: ${API_PRICE / 1e9} SOL`);
+    console.log('\nPrivacy Features:');
+    console.log('   Zero-knowledge payment verification');
+    console.log('   Unlinkable deposits and withdrawals');
+    console.log('   Anonymous sender privacy');
+    console.log('   Double-spend protection');
+    console.log('\nEndpoints:');
+    console.log('   GET  /premium       - Protected content (requires payment)');
+    console.log('   GET  /health        - Health check');
+    console.log('   GET  /admin/stats   - Server statistics');
+    console.log('\nReady to accept private payments!\n');
+});
+// Cleanup on exit
+process.on('SIGINT', () => {
+    console.log('\nShutting down...');
+    paymentServer.stop();
+    process.exit(0);
+});
+//# sourceMappingURL=server-example.js.map

package/dist/examples/server-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-example.js","sourceRoot":"","sources":["../../examples/server-example.ts"],"names":[],"mappings":"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"}

package/dist/src/client/index.d.ts

@@ -0,0 +1,89 @@
+import { PrivacyCash } from 'privacycash';
+import { X402ClientConfig, PaymentQuote, PrivateBalance, PaymentResult } from '../types';
+import { EncryptionService } from '../utils/encryption';
+/**
+ * X402 Payment Client for Privacy Cash
+ * Handles private payments for API access using Privacy Cash protocol
+ *
+ * Supports mock mode for demos without real transactions
+ */
+export declare class X402PaymentClient {
+    private config;
+    private connection;
+    private keypair;
+    private client;
+    private encryptionService;
+    private initialized;
+    private network;
+    private mockMode;
+    private mockBalance;
+    constructor(config: X402ClientConfig);
+    /**
+     * Initialize the client - must be called before other operations
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get current private balance
+     */
+    getPrivateBalance(): Promise<PrivateBalance>;
+    /**
+     * Deposit SOL into Privacy Cash pool
+     */
+    deposit(lamports: number): Promise<{
+        tx: string;
+    }>;
+    /**
+     * Generate payment headers for a quote
+     * Returns headers to include in request to protected endpoint
+     */
+    generatePayment(quote: PaymentQuote): Promise<{
+        'X-Payment': string;
+        'X-Privacy-Commitment': string;
+        'X-Wallet-Address': string;
+    }>;
+    /**
+     * Full payment flow: request quote, ensure balance, pay, return response
+     */
+    payForAccess(url: string): Promise<PaymentResult>;
+    /**
+     * Generate balance proof for server verification
+     */
+    private generateBalanceProof;
+    /**
+     * Generate unique commitment for this payment
+     */
+    private generateCommitment;
+    /**
+     * Hash the commitment for x402 header
+     */
+    private hashNote;
+    /**
+     * Ensure client is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Generate mock transaction ID
+     */
+    private generateMockTxId;
+    /**
+     * Sleep helper
+     */
+    private sleep;
+    /**
+     * Check if running in mock mode
+     */
+    isMockMode(): boolean;
+    /**
+     * Get the underlying Privacy Cash client (for advanced usage)
+     */
+    getPrivacyCashClient(): PrivacyCash | null;
+    /**
+     * Get the encryption service (for advanced usage)
+     */
+    getEncryptionService(): EncryptionService | null;
+    /**
+     * Get the public key
+     */
+    getPublicKey(): import("@solana/web3.js").PublicKey;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EACL,gBAAgB,EAChB,YAAY,EAEZ,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,EAAE,gBAAgB;IAQpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IAiBlD;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBxD;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;QACpB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IA6CF;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwDvD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,oBAAoB,IAAI,WAAW,GAAG,IAAI;IAI1C;;OAEG;IACH,oBAAoB,IAAI,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACH,YAAY;CAGb"}