privacycash-x402 1.0.0

package/dist/src/client/index.js

@@ -0,0 +1,259 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402PaymentClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const privacycash_1 = require("privacycash");
+const hasher_rs_1 = require("@lightprotocol/hasher.rs");
+const crypto_1 = __importDefault(require("crypto"));
+const encryption_1 = require("../utils/encryption");
+const errors_1 = require("../errors");
+/**
+ * X402 Payment Client for Privacy Cash
+ * Handles private payments for API access using Privacy Cash protocol
+ *
+ * Supports mock mode for demos without real transactions
+ */
+class X402PaymentClient {
+    constructor(config) {
+        this.client = null;
+        this.encryptionService = null;
+        this.initialized = false;
+        this.mockBalance = 0; // Mock balance in lamports
+        this.config = config;
+        this.connection = new web3_js_1.Connection(config.rpcUrl, 'confirmed');
+        this.keypair = config.keypair;
+        this.network = config.rpcUrl.includes('devnet') ? 'devnet' : 'mainnet-beta';
+        this.mockMode = config.mockMode ?? false;
+    }
+    /**
+     * Initialize the client - must be called before other operations
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        if (this.mockMode) {
+            console.log('Initializing Privacy Cash SDK (MOCK MODE)...');
+            console.log('  Transactions will be simulated, no real SOL required');
+            // Initialize encryption service from keypair
+            this.encryptionService = new encryption_1.EncryptionService();
+            this.encryptionService.deriveEncryptionKeyFromWallet(this.keypair);
+            this.initialized = true;
+            console.log('Privacy Cash SDK initialized (MOCK MODE)');
+            return;
+        }
+        console.log('Initializing Privacy Cash SDK...');
+        // Initialize WASM
+        await hasher_rs_1.WasmFactory.getInstance();
+        // Initialize encryption service from keypair
+        this.encryptionService = new encryption_1.EncryptionService();
+        this.encryptionService.deriveEncryptionKeyFromWallet(this.keypair);
+        // Initialize Privacy Cash client with keypair
+        this.client = new privacycash_1.PrivacyCash({
+            RPC_url: this.connection.rpcEndpoint,
+            owner: this.keypair,
+        });
+        this.initialized = true;
+        console.log('Privacy Cash SDK initialized');
+    }
+    /**
+     * Get current private balance
+     */
+    async getPrivateBalance() {
+        this.ensureInitialized();
+        if (this.mockMode) {
+            return {
+                lamports: this.mockBalance,
+                sol: this.mockBalance / web3_js_1.LAMPORTS_PER_SOL,
+            };
+        }
+        const balance = await this.client.getPrivateBalance();
+        return {
+            lamports: balance.lamports,
+            sol: balance.lamports / web3_js_1.LAMPORTS_PER_SOL,
+        };
+    }
+    /**
+     * Deposit SOL into Privacy Cash pool
+     */
+    async deposit(lamports) {
+        this.ensureInitialized();
+        console.log(`Depositing ${lamports / web3_js_1.LAMPORTS_PER_SOL} SOL into Privacy Cash pool...`);
+        if (this.mockMode) {
+            // Simulate deposit delay
+            await this.sleep(1500);
+            this.mockBalance += lamports;
+            const mockTx = this.generateMockTxId();
+            console.log('Deposit successful! (MOCK)');
+            console.log(`Transaction: ${mockTx}`);
+            return { tx: mockTx };
+        }
+        const result = await this.client.deposit({ lamports });
+        console.log('Deposit successful!');
+        console.log(`Transaction: ${result.tx}`);
+        return { tx: result.tx };
+    }
+    /**
+     * Generate payment headers for a quote
+     * Returns headers to include in request to protected endpoint
+     */
+    async generatePayment(quote) {
+        this.ensureInitialized();
+        // Get current balance
+        const balance = await this.getPrivateBalance();
+        // Check if we have enough balance
+        if (balance.lamports < quote.payment.amount) {
+            throw new errors_1.InsufficientBalanceError(quote.payment.amount, balance.lamports);
+        }
+        // Generate unique commitment
+        const commitment = this.generateCommitment();
+        const noteHash = this.hashNote(commitment);
+        // Generate balance proof
+        const balanceProof = this.generateBalanceProof(balance.lamports);
+        // Create x402 payload
+        const payload = {
+            x402Version: 1,
+            scheme: 'privacycash',
+            network: `solana-${this.network}`,
+            payload: {
+                noteHash,
+                commitment,
+                timestamp: Date.now(),
+                balanceProof,
+            },
+        };
+        const xPaymentHeader = Buffer.from(JSON.stringify(payload)).toString('base64');
+        // Deduct from mock balance if in mock mode
+        if (this.mockMode) {
+            this.mockBalance -= quote.payment.amount;
+        }
+        return {
+            'X-Payment': xPaymentHeader,
+            'X-Privacy-Commitment': commitment,
+            'X-Wallet-Address': this.keypair.publicKey.toBase58(),
+        };
+    }
+    /**
+     * Full payment flow: request quote, ensure balance, pay, return response
+     */
+    async payForAccess(url) {
+        this.ensureInitialized();
+        console.log(`\nRequesting payment quote from ${url}...`);
+        // Step 1: Request quote (expect 402)
+        const quoteRes = await fetch(url);
+        if (quoteRes.status !== 402) {
+            // Already have access or error
+            if (quoteRes.ok) {
+                const data = await quoteRes.json();
+                return { success: true, data };
+            }
+            throw new Error(`Unexpected status: ${quoteRes.status}`);
+        }
+        const quote = (await quoteRes.json());
+        console.log('Payment Quote:', {
+            recipient: quote.payment.recipientWallet,
+            amount: `${quote.payment.amount / web3_js_1.LAMPORTS_PER_SOL} SOL`,
+        });
+        // Step 2: Check balance and deposit if needed
+        let balance = await this.getPrivateBalance();
+        console.log(`Current private balance: ${balance.sol} SOL`);
+        if (balance.lamports < quote.payment.amount) {
+            console.log('Insufficient balance, depositing...');
+            await this.deposit(quote.payment.amount);
+            balance = await this.getPrivateBalance();
+            console.log(`New private balance: ${balance.sol} SOL`);
+        }
+        // Step 3: Generate payment headers
+        const headers = await this.generatePayment(quote);
+        // Step 4: Make paid request
+        console.log('Sending payment...');
+        const paidRes = await fetch(url, { headers });
+        if (!paidRes.ok) {
+            const errorData = await paidRes.json();
+            throw new Error(`Payment failed: ${JSON.stringify(errorData)}`);
+        }
+        const response = (await paidRes.json());
+        console.log('Payment verified! Access granted.');
+        return {
+            success: true,
+            data: response.data,
+            paymentDetails: response.paymentDetails,
+        };
+    }
+    /**
+     * Generate balance proof for server verification
+     */
+    generateBalanceProof(balance) {
+        const proof = {
+            balance,
+            timestamp: Date.now(),
+            wallet: this.keypair.publicKey.toBase58(),
+        };
+        return Buffer.from(JSON.stringify(proof)).toString('base64');
+    }
+    /**
+     * Generate unique commitment for this payment
+     */
+    generateCommitment() {
+        const data = `${this.keypair.publicKey.toBase58()}-${Date.now()}-${Math.random()}`;
+        return crypto_1.default.createHash('sha256').update(data).digest('hex');
+    }
+    /**
+     * Hash the commitment for x402 header
+     */
+    hashNote(note) {
+        return crypto_1.default.createHash('sha256').update(note).digest('hex');
+    }
+    /**
+     * Ensure client is initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('Client not initialized. Call initialize() first.');
+        }
+        if (!this.mockMode && !this.client) {
+            throw new Error('Client not initialized. Call initialize() first.');
+        }
+    }
+    /**
+     * Generate mock transaction ID
+     */
+    generateMockTxId() {
+        return crypto_1.default.randomBytes(32).toString('base64').replace(/[^a-zA-Z0-9]/g, '').substring(0, 44);
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Check if running in mock mode
+     */
+    isMockMode() {
+        return this.mockMode;
+    }
+    /**
+     * Get the underlying Privacy Cash client (for advanced usage)
+     */
+    getPrivacyCashClient() {
+        return this.client;
+    }
+    /**
+     * Get the encryption service (for advanced usage)
+     */
+    getEncryptionService() {
+        return this.encryptionService;
+    }
+    /**
+     * Get the public key
+     */
+    getPublicKey() {
+        return this.keypair.publicKey;
+    }
+}
+exports.X402PaymentClient = X402PaymentClient;
+//# sourceMappingURL=index.js.map

package/dist/src/client/index.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,10 @@
+type Config = {
+    withdraw_fee_rate: number;
+    withdraw_rent_fee: number;
+    deposit_fee_rate: number;
+    usdc_withdraw_rent_fee: number;
+    rent_fees: any;
+};
+export declare function getConfig<K extends keyof Config>(key: K): Promise<Config[K]>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAEA,KAAK,MAAM,GAAG;IACV,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,SAAS,EAAE,GAAG,CAAA;CACjB,CAAA;AAID,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CASlF"}

package/dist/src/config.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+const constants_1 = require("./utils/constants");
+let config;
+async function getConfig(key) {
+    if (!config) {
+        const res = await fetch(constants_1.RELAYER_API_URL + '/config');
+        config = (await res.json());
+    }
+    if (typeof config[key] == 'undefined') {
+        throw new Error(`can not get ${key} from ${constants_1.RELAYER_API_URL}/config`);
+    }
+    return config[key];
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;AAYA,8BASC;AArBD,iDAAoD;AAUpD,IAAI,MAA0B,CAAA;AAEvB,KAAK,UAAU,SAAS,CAAyB,GAAM;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,2BAAe,GAAG,SAAS,CAAC,CAAA;QACpD,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAW,CAAA;IACzC,CAAC;IACD,IAAI,OAAO,MAAO,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,SAAS,2BAAe,SAAS,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,MAAO,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * Base error class for x402 payment errors
+ */
+export declare class X402Error extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+    toJSON(): {
+        error: string;
+        code: string;
+        statusCode: number;
+    };
+}
+/**
+ * Thrown when user has insufficient private balance for payment
+ */
+export declare class InsufficientBalanceError extends X402Error {
+    readonly required: number;
+    readonly available: number;
+    constructor(required: number, available?: number);
+    toJSON(): {
+        required: number;
+        available: number;
+        hint: string;
+        error: string;
+        code: string;
+        statusCode: number;
+    };
+}
+/**
+ * Thrown when a commitment has already been used (double-spend attempt)
+ */
+export declare class DoubleSpendError extends X402Error {
+    readonly commitment: string;
+    constructor(commitment: string);
+    toJSON(): {
+        commitment: string;
+        hint: string;
+        error: string;
+        code: string;
+        statusCode: number;
+    };
+}
+/**
+ * Thrown when payment verification fails
+ */
+export declare class InvalidPaymentError extends X402Error {
+    readonly reason: string;
+    constructor(reason: string);
+    toJSON(): {
+        reason: string;
+        error: string;
+        code: string;
+        statusCode: number;
+    };
+}
+/**
+ * Thrown when balance proof is expired or invalid
+ */
+export declare class ExpiredBalanceProofError extends X402Error {
+    readonly proofTimestamp: number;
+    readonly currentTimestamp: number;
+    constructor(proofTimestamp: number);
+    toJSON(): {
+        proofTimestamp: number;
+        currentTimestamp: number;
+        hint: string;
+        error: string;
+        code: string;
+        statusCode: number;
+    };
+}
+/**
+ * Thrown when network/scheme mismatch occurs
+ */
+export declare class NetworkMismatchError extends X402Error {
+    readonly expected: string;
+    readonly received: string;
+    constructor(expected: string, received: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY;IAOnE,MAAM;;;;;CAOP;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAWnD,MAAM;;;;;;;;CAQP;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;IAU9B,MAAM;;;;;;;CAOP;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,MAAM;IAM1B,MAAM;;;;;;CAMP;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,gBAAgB,EAAE,MAAM,CAAC;gBAE7B,cAAc,EAAE,MAAM;IAWlC,MAAM;;;;;;;;CAQP;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU/C"}

package/dist/src/errors/index.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkMismatchError = exports.ExpiredBalanceProofError = exports.InvalidPaymentError = exports.DoubleSpendError = exports.InsufficientBalanceError = exports.X402Error = void 0;
+/**
+ * Base error class for x402 payment errors
+ */
+class X402Error extends Error {
+    constructor(message, code, statusCode = 400) {
+        super(message);
+        this.name = 'X402Error';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+    toJSON() {
+        return {
+            error: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+        };
+    }
+}
+exports.X402Error = X402Error;
+/**
+ * Thrown when user has insufficient private balance for payment
+ */
+class InsufficientBalanceError extends X402Error {
+    constructor(required, available = 0) {
+        super(`Insufficient private balance. Required: ${required} lamports, Available: ${available} lamports`, 'INSUFFICIENT_BALANCE', 402);
+        this.name = 'InsufficientBalanceError';
+        this.required = required;
+        this.available = available;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            required: this.required,
+            available: this.available,
+            hint: 'Please deposit more SOL into Privacy Cash pool',
+        };
+    }
+}
+exports.InsufficientBalanceError = InsufficientBalanceError;
+/**
+ * Thrown when a commitment has already been used (double-spend attempt)
+ */
+class DoubleSpendError extends X402Error {
+    constructor(commitment) {
+        super('Commitment already used. This payment has already been redeemed.', 'DOUBLE_SPEND', 402);
+        this.name = 'DoubleSpendError';
+        this.commitment = commitment;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            commitment: this.commitment.substring(0, 20) + '...',
+            hint: 'Generate a new payment commitment',
+        };
+    }
+}
+exports.DoubleSpendError = DoubleSpendError;
+/**
+ * Thrown when payment verification fails
+ */
+class InvalidPaymentError extends X402Error {
+    constructor(reason) {
+        super(`Invalid payment: ${reason}`, 'INVALID_PAYMENT', 400);
+        this.name = 'InvalidPaymentError';
+        this.reason = reason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            reason: this.reason,
+        };
+    }
+}
+exports.InvalidPaymentError = InvalidPaymentError;
+/**
+ * Thrown when balance proof is expired or invalid
+ */
+class ExpiredBalanceProofError extends X402Error {
+    constructor(proofTimestamp) {
+        super('Balance proof has expired. Please generate a new payment.', 'EXPIRED_BALANCE_PROOF', 402);
+        this.name = 'ExpiredBalanceProofError';
+        this.proofTimestamp = proofTimestamp;
+        this.currentTimestamp = Date.now();
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            proofTimestamp: this.proofTimestamp,
+            currentTimestamp: this.currentTimestamp,
+            hint: 'Balance proofs are valid for 5 minutes',
+        };
+    }
+}
+exports.ExpiredBalanceProofError = ExpiredBalanceProofError;
+/**
+ * Thrown when network/scheme mismatch occurs
+ */
+class NetworkMismatchError extends X402Error {
+    constructor(expected, received) {
+        super(`Network mismatch. Expected: ${expected}, Received: ${received}`, 'NETWORK_MISMATCH', 400);
+        this.name = 'NetworkMismatchError';
+        this.expected = expected;
+        this.received = received;
+    }
+}
+exports.NetworkMismatchError = NetworkMismatchError;
+//# sourceMappingURL=index.js.map

package/dist/src/errors/index.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export { X402PaymentServer, createX402Middleware } from './server';
+export { X402PaymentClient } from './client';
+export * from './types';
+export * from './errors';
+export { EncryptionService } from './utils/encryption';
+export { logger, setLogger } from './utils/logger';
+export { PROGRAM_ID, RELAYER_API_URL, SIGN_MESSAGE, tokens, BALANCE_PROOF_VALIDITY_MS, } from './utils/constants';
+export { Utxo } from './models/utxo';
+export { Keypair } from './models/keypair';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,UAAU,EACV,eAAe,EACf,YAAY,EACZ,MAAM,EACN,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,47 @@
+"use strict";
+// Main SDK exports
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Keypair = exports.Utxo = exports.BALANCE_PROOF_VALIDITY_MS = exports.tokens = exports.SIGN_MESSAGE = exports.RELAYER_API_URL = exports.PROGRAM_ID = exports.setLogger = exports.logger = exports.EncryptionService = exports.X402PaymentClient = exports.createX402Middleware = exports.X402PaymentServer = void 0;
+// Server
+var server_1 = require("./server");
+Object.defineProperty(exports, "X402PaymentServer", { enumerable: true, get: function () { return server_1.X402PaymentServer; } });
+Object.defineProperty(exports, "createX402Middleware", { enumerable: true, get: function () { return server_1.createX402Middleware; } });
+// Client
+var client_1 = require("./client");
+Object.defineProperty(exports, "X402PaymentClient", { enumerable: true, get: function () { return client_1.X402PaymentClient; } });
+// Types
+__exportStar(require("./types"), exports);
+// Errors
+__exportStar(require("./errors"), exports);
+// Utils
+var encryption_1 = require("./utils/encryption");
+Object.defineProperty(exports, "EncryptionService", { enumerable: true, get: function () { return encryption_1.EncryptionService; } });
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return logger_1.setLogger; } });
+var constants_1 = require("./utils/constants");
+Object.defineProperty(exports, "PROGRAM_ID", { enumerable: true, get: function () { return constants_1.PROGRAM_ID; } });
+Object.defineProperty(exports, "RELAYER_API_URL", { enumerable: true, get: function () { return constants_1.RELAYER_API_URL; } });
+Object.defineProperty(exports, "SIGN_MESSAGE", { enumerable: true, get: function () { return constants_1.SIGN_MESSAGE; } });
+Object.defineProperty(exports, "tokens", { enumerable: true, get: function () { return constants_1.tokens; } });
+Object.defineProperty(exports, "BALANCE_PROOF_VALIDITY_MS", { enumerable: true, get: function () { return constants_1.BALANCE_PROOF_VALIDITY_MS; } });
+// Models (for advanced usage)
+var utxo_1 = require("./models/utxo");
+Object.defineProperty(exports, "Utxo", { enumerable: true, get: function () { return utxo_1.Utxo; } });
+var keypair_1 = require("./models/keypair");
+Object.defineProperty(exports, "Keypair", { enumerable: true, get: function () { return keypair_1.Keypair; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,mBAAmB;;;;;;;;;;;;;;;;;AAEnB,SAAS;AACT,mCAAmE;AAA1D,2GAAA,iBAAiB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAEhD,SAAS;AACT,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAE1B,QAAQ;AACR,0CAAwB;AAExB,SAAS;AACT,2CAAyB;AAEzB,QAAQ;AACR,iDAAuD;AAA9C,+GAAA,iBAAiB,OAAA;AAC1B,yCAAmD;AAA1C,gGAAA,MAAM,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC1B,+CAM2B;AALzB,uGAAA,UAAU,OAAA;AACV,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,mGAAA,MAAM,OAAA;AACN,sHAAA,yBAAyB,OAAA;AAG3B,8BAA8B;AAC9B,sCAAqC;AAA5B,4FAAA,IAAI,OAAA;AACb,4CAA2C;AAAlC,kGAAA,OAAO,OAAA"}

package/dist/src/models/keypair.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Keypair module for ZK Cash
+ *
+ * Provides cryptographic keypair functionality for the ZK Cash system
+ * Based on: https://github.com/tornadocash/tornado-nova
+ */
+import BN from 'bn.js';
+import * as hasher from '@lightprotocol/hasher.rs';
+/**
+ * Simplified version of Keypair
+ */
+export declare class Keypair {
+    privkey: BN;
+    pubkey: BN;
+    private lightWasm;
+    constructor(privkeyHex: string, lightWasm: hasher.LightWasm);
+    /**
+    * Sign a message using keypair private key
+    *
+    * @param {string|number|BigNumber} commitment a hex string with commitment
+    * @param {string|number|BigNumber} merklePath a hex string with merkle path
+    * @returns {BigNumber} a hex string with signature
+    */
+    sign(commitment: string, merklePath: string): string;
+    static generateNew(lightWasm: hasher.LightWasm): Promise<Keypair>;
+}
+//# sourceMappingURL=keypair.d.ts.map

package/dist/src/models/keypair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../../../src/models/keypair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AAOnD;;GAEG;AACH,qBAAa,OAAO;IACT,OAAO,EAAE,EAAE,CAAC;IACZ,MAAM,EAAE,EAAE,CAAC;IAClB,OAAO,CAAC,SAAS,CAAmB;gBAExB,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS;IAQ3D;;;;;;MAME;IACF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;WAIvC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ1E"}

package/dist/src/models/keypair.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Keypair module for ZK Cash
+ *
+ * Provides cryptographic keypair functionality for the ZK Cash system
+ * Based on: https://github.com/tornadocash/tornado-nova
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Keypair = void 0;
+const bn_js_1 = __importDefault(require("bn.js"));
+const ethers_1 = require("ethers");
+// Field size constant
+const FIELD_SIZE = new bn_js_1.default('21888242871839275222246405745257275088548364400416034343698204186575808495617');
+/**
+ * Simplified version of Keypair
+ */
+class Keypair {
+    constructor(privkeyHex, lightWasm) {
+        const rawDecimal = BigInt(privkeyHex);
+        this.privkey = new bn_js_1.default((rawDecimal % BigInt(FIELD_SIZE.toString())).toString());
+        this.lightWasm = lightWasm;
+        // TODO: lazily compute pubkey
+        this.pubkey = new bn_js_1.default(this.lightWasm.poseidonHashString([this.privkey.toString()]));
+    }
+    /**
+    * Sign a message using keypair private key
+    *
+    * @param {string|number|BigNumber} commitment a hex string with commitment
+    * @param {string|number|BigNumber} merklePath a hex string with merkle path
+    * @returns {BigNumber} a hex string with signature
+    */
+    sign(commitment, merklePath) {
+        return this.lightWasm.poseidonHashString([this.privkey.toString(), commitment, merklePath]);
+    }
+    static async generateNew(lightWasm) {
+        // Tornado Cash Nova uses ethers.js to generate a random private key
+        // We can't generate Solana keypairs because it won't fit in the field size
+        // It's OK to use ethereum secret keys, because the secret key is only used for the proof generation.
+        // Namely, it's used to guarantee the uniqueness of the nullifier.
+        const wallet = ethers_1.ethers.Wallet.createRandom();
+        return new Keypair(wallet.privateKey, lightWasm);
+    }
+}
+exports.Keypair = Keypair;
+//# sourceMappingURL=keypair.js.map

package/dist/src/models/keypair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.js","sourceRoot":"","sources":["../../../src/models/keypair.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,kDAAuB;AACvB,mCAAgC;AAGhC,sBAAsB;AACtB,MAAM,UAAU,GAAG,IAAI,eAAE,CACrB,+EAA+E,CAClF,CAAC;AAEF;;GAEG;AACH,MAAa,OAAO;IAKhB,YAAY,UAAkB,EAAE,SAA2B;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,eAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,8BAA8B;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAE,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;MAME;IACF,IAAI,CAAC,UAAkB,EAAE,UAAkB;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAA2B;QAChD,oEAAoE;QACpE,2EAA2E;QAC3E,qGAAqG;QACrG,kEAAkE;QAClE,MAAM,MAAM,GAAG,eAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;CACJ;AAhCD,0BAgCC"}