@lemmaoracle/x402 0.1.1

package/dist/proof-generator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * X402 Payment Proof Generator
+ *
+ * Generates ZK proofs for x402 payment transactions so that
+ * Lemma's disclosure.condition API can verify payments without
+ * exposing transaction details.
+ */
+import { type LemmaClient } from "@lemmaoracle/sdk";
+import type { ProofResult, Config, Transaction, Proof } from "./types.js";
+/**
+ * Generates x402 payment proofs using Lemma's prover infrastructure.
+ *
+ * Usage:
+ *   const generator = new X402ProofGenerator(config, lemmaClient);
+ *   const result = await generator.generateProof(txHash);
+ */
+declare const createProofGenerator: (config: Config, lemmaClient: LemmaClient) => Readonly<{
+    generateProof: (txHash: `0x${string}`) => Promise<ProofResult>;
+    toFieldElements: (payment: Transaction, config: Config) => Readonly<{
+        witness: Record<string, string>;
+        publicInputs: string[];
+    }>;
+}>;
+export type { ProofResult, Config, Proof, Transaction, };
+export { createProofGenerator };
+//# sourceMappingURL=proof-generator.d.ts.map

package/dist/proof-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-generator.d.ts","sourceRoot":"","sources":["../src/proof-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,WAAW,EACX,KAAK,EACN,MAAM,YAAY,CAAC;AAmBpB;;;;;;GAMG;AACH,QAAA,MAAM,oBAAoB,GACxB,QAAQ,MAAM,EACd,aAAa,WAAW,KACvB,QAAQ,CAAC;IACV,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,eAAe,EAAE,CACf,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,KACX,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E,CAqEA,CAAC;AA4FF,YAAY,EACV,WAAW,EACX,MAAM,EACN,KAAK,EACL,WAAW,GACZ,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/proof-generator.js

@@ -0,0 +1,154 @@
+/**
+ * X402 Payment Proof Generator
+ *
+ * Generates ZK proofs for x402 payment transactions so that
+ * Lemma's disclosure.condition API can verify payments without
+ * exposing transaction details.
+ */
+import { createPublicClient, http } from "viem";
+import { prover } from "@lemmaoracle/sdk";
+import * as R from "ramda";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default IPFS gateway if not specified in config */
+const _DEFAULT_IPFS_GATEWAY = "https://ipfs.io/ipfs/";
+/** Poseidon hash function for field element hashing */
+const toFieldElement = (value) => BigInt(value) < 0n
+    ? String(BigInt(value) % 21888242871839275222246405745257275088548364400416034343698204186575808495617n)
+    : value;
+// ---------------------------------------------------------------------------
+// Proof Generator Class
+// ---------------------------------------------------------------------------
+/**
+ * Generates x402 payment proofs using Lemma's prover infrastructure.
+ *
+ * Usage:
+ *   const generator = new X402ProofGenerator(config, lemmaClient);
+ *   const result = await generator.generateProof(txHash);
+ */
+const createProofGenerator = (config, lemmaClient) => {
+    /** Create public client for transaction inspection */
+    const publicClient = createPublicClient({
+        transport: http(config.ethereumRpcUrl),
+    });
+    return {
+        /**
+         * Generate a payment proof for a given transaction hash.
+         * This fetches the transaction details, computes the witness,
+         * and generates the ZK proof.
+         */
+        generateProof: async (txHash) => {
+            // Step 1: Fetch transaction details from blockchain
+            const payment = await fetchPaymentTransaction(txHash, publicClient);
+            // Step 2: Generate proof
+            const proofResult = await generateZKProof(lemmaClient, payment, config);
+            return R.always({
+                payment,
+                proof: proofResult,
+            })();
+        },
+        /**
+         * Convert payment transaction details to circuit field elements.
+         */
+        toFieldElements: (payment, cfg) => {
+            // Split 256-bit txHash into two 128-bit elements
+            const txHashBigInt = BigInt(payment.txHash);
+            const upper128 = toFieldElement(String(txHashBigInt >> 128n));
+            const lower128 = toFieldElement(String(txHashBigInt & ((1n << 128n) - 1n)));
+            // Split 160-bit recipient address
+            const recipientBigInt = BigInt(payment.to);
+            const recipientLow = toFieldElement(String(recipientBigInt & ((1n << 128n) - 1n)));
+            const recipientHigh = toFieldElement(String(recipientBigInt >> 128n));
+            // Amount and timestamp
+            const amount = toFieldElement(String(payment.amount));
+            const timestamp = toFieldElement(String(payment.timestamp));
+            const minAmount = toFieldElement(String(cfg.minAmount));
+            return R.always({
+                witness: {
+                    txHashPacked_0: lower128,
+                    txHashPacked_1: upper128,
+                    recipientLow,
+                    recipientHigh,
+                    amount,
+                    timestamp,
+                    minAmount,
+                },
+                publicInputs: [
+                    // commitment will be computed during proof generation
+                    toFieldElement(String(cfg.minAmount)), // minAmountPublic
+                    toFieldElement(String(cfg.maxProofAge)), // timestampMax
+                ],
+            })();
+        },
+    };
+};
+// ---------------------------------------------------------------------------
+// Private Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Fetch payment transaction details from the blockchain.
+ */
+const fetchPaymentTransaction = async (txHash, client) => {
+    const txPromise = client.getTransaction({ hash: txHash });
+    const receiptPromise = client.getTransactionReceipt({ hash: txHash });
+    const blockPromise = client.getBlock({ blockTag: "latest" });
+    const [tx, receipt, block] = await Promise.all([
+        txPromise,
+        receiptPromise,
+        blockPromise,
+    ]);
+    return receipt.status !== "success"
+        ? Promise.reject(new Error(`Transaction ${txHash} failed`))
+        : client.getBlock({ blockNumber: receipt.blockNumber }).then((blockData) => R.always({
+            txHash,
+            from: tx.from,
+            to: tx.to ?? "0x",
+            amount: tx.value + receipt.effectiveGasPrice * receipt.gasUsed,
+            timestamp: Number(blockData.timestamp),
+            blockNumber: receipt.blockNumber,
+            confirmations: Number(block.number - receipt.blockNumber),
+        })());
+};
+/**
+ * Generate ZK proof for the payment transaction.
+ */
+const generateZKProof = async (lemmaClient, payment, config) => {
+    // Build witness from payment transaction
+    const builder = createProofGenerator(config, lemmaClient);
+    const { witness, publicInputs } = builder.toFieldElements(payment, config);
+    // Generate proof using Lemma SDK
+    const proofResult = await prover.prove(lemmaClient, {
+        circuitId: config.circuitId,
+        witness,
+    });
+    // Compute the commitment for public inputs
+    const commitment = computeCommitment(witness, publicInputs);
+    return R.always({
+        proof: proofResult.proof,
+        inputs: [commitment, ...publicInputs],
+        circuitId: config.circuitId,
+        generatedAt: Date.now(),
+    })();
+};
+/**
+ * Compute the commitment hash for the circuit public inputs.
+ */
+const computeCommitment = (witness, _publicInputs) => {
+    // The commitment is computed from:
+    // poseidon(txHashPacked[0], txHashPacked[1], recipientLow, amount, timestamp, minAmount)
+    // This should match the public commitment used in the circuit
+    const values = [
+        witness.txHashPacked_0,
+        witness.txHashPacked_1,
+        witness.recipientLow,
+        witness.amount,
+        witness.timestamp,
+        witness.minAmount,
+    ];
+    // In a real implementation, use poseidon from circomlib
+    // For now, we use a simple hash placeholder
+    return values.join(",");
+};
+export { createProofGenerator };
+//# sourceMappingURL=proof-generator.js.map

package/dist/proof-generator.js.map

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

package/dist/proof-generator.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for x402 payment proof generator.
+ *
+ * Test files are exempt from FP rules.
+ */
+export {};
+//# sourceMappingURL=proof-generator.test.d.ts.map

package/dist/proof-generator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-generator.test.d.ts","sourceRoot":"","sources":["../src/proof-generator.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/proof-generator.test.js

@@ -0,0 +1,121 @@
+/**
+ * Tests for x402 payment proof generator.
+ *
+ * Test files are exempt from FP rules.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { createProofGenerator } from "./proof-generator.js";
+// Mock viem
+vi.mock("viem", async () => {
+    const actual = await vi.importActual("viem");
+    return {
+        ...actual,
+        createPublicClient: vi.fn(() => ({
+            getTransaction: vi.fn().mockResolvedValue({
+                hash: "0xabc123",
+                from: "0xsender",
+                to: "0x2222222222222222222222222222222222222222",
+                value: 1000n,
+            }),
+            getTransactionReceipt: vi.fn().mockResolvedValue({
+                status: "success",
+                blockNumber: 1000n,
+                gasUsed: 21000n,
+                effectiveGasPrice: 1000000000n,
+                confirmations: 6,
+            }),
+            getBlock: vi.fn().mockResolvedValue({
+                number: 1006n,
+                timestamp: 1712000000n,
+            }),
+        })),
+    };
+});
+// Mock Lemma SDK
+vi.mock("@lemmaoracle/sdk", async () => {
+    const actual = await vi.importActual("@lemmaoracle/sdk");
+    return {
+        ...actual,
+        prover: {
+            prove: vi.fn().mockResolvedValue({
+                proof: "mock-proof-base64",
+                publicInputs: ["input1", "input2"],
+            }),
+        },
+        createClient: vi.fn().mockReturnValue({
+            apiBase: "https://workers.lemma.workers.dev",
+        }),
+    };
+});
+const mockConfig = {
+    payToAddress: "0x2222222222222222222222222222222222222222",
+    network: "eip155:84532",
+    price: "$0.001",
+    ethereumRpcUrl: "https://sepolia.base.org",
+    chainId: 84532,
+    lemmaApiBase: "https://workers.lemma.workers.dev",
+    circuitId: "x402-payment-v1",
+    minAmount: 1000n,
+    requiredConfirmations: 6,
+    maxProofAge: 3600,
+    ipfsGateway: "https://ipfs.io/ipfs/",
+};
+const mockLemmaClient = {
+    apiBase: "https://workers.lemma.workers.dev",
+};
+describe("X402 Proof Generator", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("should create a proof generator", () => {
+        const generator = createProofGenerator(mockConfig, mockLemmaClient);
+        expect(generator).toBeDefined();
+        expect(typeof generator.generateProof).toBe("function");
+        expect(typeof generator.toFieldElements).toBe("function");
+    });
+    it("should convert payment details to field elements", async () => {
+        const generator = createProofGenerator(mockConfig, mockLemmaClient);
+        const mockPayment = {
+            txHash: "0xabc123",
+            from: "0x1111111111111111111111111111111111111111",
+            to: "0x2222222222222222222222222222222222222222",
+            amount: 1000n,
+            timestamp: 1712000000,
+            blockNumber: 1000n,
+            confirmations: 6,
+        };
+        const result = await generator.toFieldElements(mockPayment, mockConfig);
+        expect(result).toBeDefined();
+        expect(result.witness).toBeDefined();
+        expect(result.publicInputs).toBeDefined();
+        expect(result.witness.amount).toBeDefined();
+        expect(result.witness.minAmount).toBeDefined();
+    });
+    it("should handle empty txHash gracefully", async () => {
+        const generator = createProofGenerator(mockConfig, mockLemmaClient);
+        expect(generator.generateProof).toBeDefined();
+    });
+});
+describe("Field Element Conversion", () => {
+    it("should convert addresses to field elements", async () => {
+        const generator = createProofGenerator(mockConfig, mockLemmaClient);
+        const mockPayment = {
+            txHash: "0xabc123",
+            from: "0x1111111111111111111111111111111111111111",
+            to: "0x2222222222222222222222222222222222222222",
+            amount: 1000n,
+            timestamp: 1712000000,
+            blockNumber: 1000n,
+            confirmations: 6,
+        };
+        const { witness } = await generator.toFieldElements(mockPayment, mockConfig);
+        // Verify field elements are present and not null
+        expect(witness.txHashPacked_0).toBeDefined();
+        expect(witness.txHashPacked_1).toBeDefined();
+        expect(witness.recipientLow).toBeDefined();
+        expect(witness.amount).toBeDefined();
+        expect(witness.timestamp).toBeDefined();
+        expect(witness.minAmount).toBeDefined();
+    });
+});
+//# sourceMappingURL=proof-generator.test.js.map

package/dist/proof-generator.test.js.map

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

package/dist/transaction-watcher.d.ts

@@ -0,0 +1,42 @@
+/**
+ * X402 Transaction Watcher
+ *
+ * Monitors the blockchain for x402 payment transactions to the configured
+ * recipient address and triggers proof generation when payments are detected.
+ */
+import type { Transaction as ViemTransaction, TransactionReceipt } from "viem";
+import type { Config, Transaction } from "./types.js";
+/** Callback invoked when a valid payment is detected */
+type PaymentDetectedCallback = (payment: Transaction) => Promise<void>;
+/** State of the transaction watcher */
+type WatcherState = Readonly<{
+    isRunning: boolean;
+    lastCheckedBlock: bigint;
+    detectedPayments: ReadonlyArray<PaymentDetectedCallback>;
+}>;
+/**
+ * Creates a transaction watcher that monitors for payments to the configured address.
+ *
+ * Uses an immutable state cell (single-element tuple) as a controlled mutable reference.
+ */
+declare const createTransactionWatcher: (_config: Config, _publicClient: unknown) => Readonly<{
+    start: (_?: undefined) => Promise<void>;
+    stop: (_?: undefined) => void;
+    onPaymentDetected: (callback: PaymentDetectedCallback) => Promise<void>;
+    getState: (_?: undefined) => WatcherState;
+}>;
+/**
+ * Validate that a transaction is a valid x402 payment:
+ * - Transaction was successful
+ * - Sent to the correct recipient
+ * - Amount meets the minimum requirement
+ * - Has sufficient confirmations
+ */
+declare const isValidPayment: (tx: ViemTransaction, receipt: TransactionReceipt, config: Config, currentBlockNumber?: bigint) => boolean;
+/**
+ * Extract payment details from transaction and receipt.
+ */
+declare const extractPaymentDetails: (tx: ViemTransaction, receipt: TransactionReceipt, currentBlockNumber: bigint) => Transaction;
+export type { PaymentDetectedCallback, WatcherState, };
+export { createTransactionWatcher, isValidPayment, extractPaymentDetails, };
+//# sourceMappingURL=transaction-watcher.d.ts.map

package/dist/transaction-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-watcher.d.ts","sourceRoot":"","sources":["../src/transaction-watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,IAAI,eAAe,EAC9B,kBAAkB,EACnB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMtD,wDAAwD;AACxD,KAAK,uBAAuB,GAAG,CAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,uCAAuC;AACvC,KAAK,YAAY,GAAG,QAAQ,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAC1D,CAAC,CAAC;AAYH;;;;GAIG;AACH,QAAA,MAAM,wBAAwB,GAC5B,SAAS,MAAM,EACf,eAAe,OAAO,KACrB,QAAQ,CAAC;IACV,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9B,iBAAiB,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,KAAK,YAAY,CAAC;CAC3C,CAsCA,CAAC;AAMF;;;;;;GAMG;AACH,QAAA,MAAM,cAAc,GAClB,IAAI,eAAe,EACnB,SAAS,kBAAkB,EAC3B,QAAQ,MAAM,EACd,qBAAoB,MAAW,KAC9B,OAUG,CAAC;AAEP;;GAEG;AACH,QAAA,MAAM,qBAAqB,GACzB,IAAI,eAAe,EACnB,SAAS,kBAAkB,EAC3B,oBAAoB,MAAM,KACzB,WAcF,CAAC;AAEF,YAAY,EACV,uBAAuB,EACvB,YAAY,GACb,CAAC;AAEF,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,CAAC"}

package/dist/transaction-watcher.js

@@ -0,0 +1,88 @@
+/**
+ * X402 Transaction Watcher
+ *
+ * Monitors the blockchain for x402 payment transactions to the configured
+ * recipient address and triggers proof generation when payments are detected.
+ */
+import * as R from "ramda";
+// ---------------------------------------------------------------------------
+// Watcher Implementation
+// ---------------------------------------------------------------------------
+const initialState = {
+    isRunning: false,
+    lastCheckedBlock: 0n,
+    detectedPayments: [],
+};
+/**
+ * Creates a transaction watcher that monitors for payments to the configured address.
+ *
+ * Uses an immutable state cell (single-element tuple) as a controlled mutable reference.
+ */
+const createTransactionWatcher = (_config, _publicClient) => {
+    const stateCell = { current: initialState };
+    const start = (_) => {
+        // eslint-disable-next-line functional/no-expression-statements, functional/immutable-data
+        stateCell.current = {
+            ...stateCell.current,
+            isRunning: true,
+            lastCheckedBlock: 0n,
+        };
+        return Promise.resolve();
+    };
+    const stop = (_) => {
+        // eslint-disable-next-line functional/no-expression-statements, functional/immutable-data
+        stateCell.current = R.assoc("isRunning", false, stateCell.current);
+    };
+    const onPaymentDetected = (callback) => {
+        // eslint-disable-next-line functional/no-expression-statements, functional/immutable-data
+        stateCell.current = {
+            ...stateCell.current,
+            detectedPayments: R.append(callback, stateCell.current.detectedPayments),
+        };
+        return Promise.resolve();
+    };
+    const getState = (_) => stateCell.current;
+    return {
+        start,
+        stop,
+        onPaymentDetected,
+        getState,
+    };
+};
+// ---------------------------------------------------------------------------
+// Utility Functions
+// ---------------------------------------------------------------------------
+/**
+ * Validate that a transaction is a valid x402 payment:
+ * - Transaction was successful
+ * - Sent to the correct recipient
+ * - Amount meets the minimum requirement
+ * - Has sufficient confirmations
+ */
+const isValidPayment = (tx, receipt, config, currentBlockNumber = 0n) => R.allPass([
+    R.always(tx.to === config.payToAddress),
+    R.always(tx.value >= config.minAmount),
+    R.always(receipt.status === "success"),
+    R.always(currentBlockNumber > 0n
+        ? Number(currentBlockNumber - receipt.blockNumber) >= config.requiredConfirmations
+        : true),
+])();
+/**
+ * Extract payment details from transaction and receipt.
+ */
+const extractPaymentDetails = (tx, receipt, currentBlockNumber) => {
+    const txRecord = tx;
+    const rawTimestamp = txRecord["blockTimestamp"];
+    const timestamp = typeof rawTimestamp === "bigint" ? Number(rawTimestamp) : 0;
+    return R.always({
+        txHash: tx.hash,
+        from: tx.from,
+        to: tx.to ?? "0x",
+        amount: tx.value,
+        timestamp,
+        blockNumber: receipt.blockNumber,
+        confirmations: Number(currentBlockNumber - receipt.blockNumber),
+    })();
+};
+export { createTransactionWatcher, isValidPayment, extractPaymentDetails, };
+//# sourceMappingURL=transaction-watcher.js.map

package/dist/transaction-watcher.js.map

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

package/dist/transaction-watcher.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for x402 transaction watcher.
+ *
+ * Test files are exempt from FP rules.
+ */
+export {};
+//# sourceMappingURL=transaction-watcher.test.d.ts.map

package/dist/transaction-watcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-watcher.test.d.ts","sourceRoot":"","sources":["../src/transaction-watcher.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/transaction-watcher.test.js

@@ -0,0 +1,111 @@
+/**
+ * Tests for x402 transaction watcher.
+ *
+ * Test files are exempt from FP rules.
+ */
+import { describe, it, expect, vi } from "vitest";
+import { createTransactionWatcher, isValidPayment, extractPaymentDetails, } from "./transaction-watcher.js";
+const mockConfig = {
+    payToAddress: "0x2222222222222222222222222222222222222222",
+    network: "eip155:84532",
+    price: "$0.001",
+    ethereumRpcUrl: "https://sepolia.base.org",
+    chainId: 84532,
+    lemmaApiBase: "https://workers.lemma.workers.dev",
+    circuitId: "x402-payment-v1",
+    minAmount: 1000n,
+    requiredConfirmations: 6,
+    maxProofAge: 3600,
+    ipfsGateway: "https://ipfs.io/ipfs/",
+};
+const mockTx = {
+    hash: "0xabc123",
+    from: "0x1111111111111111111111111111111111111111",
+    to: "0x2222222222222222222222222222222222222222",
+    value: 2000n,
+    blockNumber: 1000n,
+    blockTimestamp: 1712000000n,
+    gasUsed: 21000n,
+    effectiveGasPrice: 1000000000n,
+};
+const mockReceipt = {
+    status: "success",
+    blockNumber: 1000n,
+    confirmations: 6,
+    gasUsed: 21000n,
+    effectiveGasPrice: 1000000000n,
+};
+describe("Transaction Watcher", () => {
+    it("should create a watcher", () => {
+        const watcher = createTransactionWatcher(mockConfig, {});
+        expect(watcher).toBeDefined();
+        expect(typeof watcher.start).toBe("function");
+        expect(typeof watcher.stop).toBe("function");
+        expect(typeof watcher.onPaymentDetected).toBe("function");
+        expect(typeof watcher.getState).toBe("function");
+    });
+    it("should register payment detected callbacks", async () => {
+        const watcher = createTransactionWatcher(mockConfig, {});
+        const callback = vi.fn();
+        // Callbacks return Promises
+        const promise = watcher.onPaymentDetected(callback);
+        expect(promise).toBeInstanceOf(Promise);
+        await promise;
+    });
+    it("should return watcher state", () => {
+        const watcher = createTransactionWatcher(mockConfig, {});
+        const state = watcher.getState();
+        expect(state.isRunning).toBe(false);
+        expect(Array.isArray(state.detectedPayments)).toBe(true);
+    });
+});
+describe("isValidPayment", () => {
+    it("should validate a correct payment", () => {
+        const currentBlockNumber = 1010n; // Sufficient confirmations (10 confirmations)
+        const result = isValidPayment(mockTx, mockReceipt, mockConfig, currentBlockNumber);
+        expect(result).toBe(true);
+    });
+    it("should reject payment to wrong recipient", () => {
+        const badTx = { ...mockTx, to: "0x3333333333333333333333333333333333333333" };
+        const currentBlockNumber = 1010n;
+        const result = isValidPayment(badTx, mockReceipt, mockConfig, currentBlockNumber);
+        expect(result).toBe(false);
+    });
+    it("should reject payment below minimum amount", () => {
+        const lowTx = { ...mockTx, value: 500n };
+        const currentBlockNumber = 1010n;
+        const result = isValidPayment(lowTx, mockReceipt, mockConfig, currentBlockNumber);
+        expect(result).toBe(false);
+    });
+    it("should reject failed transaction", () => {
+        const failedReceipt = { ...mockReceipt, status: "reverted" };
+        const currentBlockNumber = 1010n;
+        const result = isValidPayment(mockTx, failedReceipt, mockConfig, currentBlockNumber);
+        expect(result).toBe(false);
+    });
+    it("should reject payment with insufficient confirmations", () => {
+        const currentBlockNumber = 1002n; // Only 2 confirmations (1002 - 1000 = 2)
+        const result = isValidPayment(mockTx, mockReceipt, mockConfig, currentBlockNumber);
+        expect(result).toBe(false);
+    });
+});
+describe("extractPaymentDetails", () => {
+    it("should extract payment details from transaction and receipt", () => {
+        const currentBlockNumber = 1010n;
+        const details = extractPaymentDetails(mockTx, mockReceipt, currentBlockNumber);
+        expect(details.txHash).toBe("0xabc123");
+        expect(details.from).toBe("0x1111111111111111111111111111111111111111");
+        expect(details.to).toBe("0x2222222222222222222222222222222222222222");
+        expect(details.amount).toBe(2000n);
+        expect(details.timestamp).toBe(1712000000); // Retrieved from blockTimestamp
+        expect(details.blockNumber).toBe(1000n);
+        expect(details.confirmations).toBe(10);
+    });
+    it("should handle missing blockTimestamp", () => {
+        const txNoTimestamp = { ...mockTx, blockTimestamp: undefined };
+        const currentBlockNumber = 1010n;
+        const details = extractPaymentDetails(txNoTimestamp, mockReceipt, currentBlockNumber);
+        expect(details.timestamp).toBe(0);
+    });
+});
+//# sourceMappingURL=transaction-watcher.test.js.map

package/dist/transaction-watcher.test.js.map

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