@lemmaoracle/x402 0.1.1 → 0.1.2

package/src/transaction-watcher.ts

@@ -1,154 +0,0 @@
-/**
- * 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 * as R from "ramda";
-import type { Config, Transaction } from "./types.js";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** 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>;
-}>;
-
-// ---------------------------------------------------------------------------
-// Watcher Implementation
-// ---------------------------------------------------------------------------
-
-const initialState: WatcherState = {
-  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: Config,
-  _publicClient: unknown,
-): Readonly<{
-  start: (_?: undefined) => Promise<void>;
-  stop: (_?: undefined) => void;
-  onPaymentDetected: (callback: PaymentDetectedCallback) => Promise<void>;
-  getState: (_?: undefined) => WatcherState;
-}> => {
-  const stateCell = { current: initialState };
-
-  const start = (_?: undefined): Promise<void> => {
-    // eslint-disable-next-line functional/no-expression-statements, functional/immutable-data
-    stateCell.current = {
-      ...stateCell.current,
-      isRunning: true,
-      lastCheckedBlock: 0n,
-    };
-
-    return Promise.resolve();
-  };
-
-  const stop = (_?: undefined): void => {
-    // eslint-disable-next-line functional/no-expression-statements, functional/immutable-data
-    stateCell.current = R.assoc("isRunning", false, stateCell.current);
-  };
-
-  const onPaymentDetected = (
-    callback: PaymentDetectedCallback,
-  ): Promise<void> => {
-    // 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 = (_?: undefined): WatcherState => 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: ViemTransaction,
-  receipt: TransactionReceipt,
-  config: Config,
-  currentBlockNumber: bigint = 0n,
-): boolean =>
-  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: ViemTransaction,
-  receipt: TransactionReceipt,
-  currentBlockNumber: bigint,
-): Transaction => {
-  const txRecord = tx as unknown as Readonly<Record<string, unknown>>;
-  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" as `0x${string}`),
-    amount: tx.value,
-    timestamp,
-    blockNumber: receipt.blockNumber,
-    confirmations: Number(currentBlockNumber - receipt.blockNumber),
-  })();
-};
-
-export type {
-  PaymentDetectedCallback,
-  WatcherState,
-};
-
-export {
-  createTransactionWatcher,
-  isValidPayment,
-  extractPaymentDetails,
-};

package/src/types.ts

@@ -1,110 +0,0 @@
-/** Configuration for payment facilitator */
-type Config = Readonly<{
-  /** x402 facilitator URL (for HTTPFacilitatorClient compatibility) */
-  facilitatorUrl?: string;
-
-  /** Address to receive payments */
-  payToAddress: `0x${string}`;
-
-  /** Network identifier (e.g., "eip155:84532" for Base Sepolia) */
-  network: string;
-
-  /** Price for accessing verified attributes (e.g., "$0.001") */
-  price: string;
-
-  /** Ethereum RPC URL for transaction monitoring */
-  ethereumRpcUrl: string;
-
-  /** Chain ID for the network */
-  chainId: number;
-
-  /** Lemma API base URL */
-  lemmaApiBase: string;
-
-  /** Lemma API key (if required) */
-  lemmaApiKey?: string;
-
-  /** Circuit ID for the payment proof */
-  circuitId: string;
-
-  /** Minimum amount in USDC smallest unit (6 decimals) */
-  minAmount: bigint;
-
-  /** Number of block confirmations before considering payment valid */
-  requiredConfirmations: number;
-
-  /** Maximum age of payment proof in seconds */
-  maxProofAge: number;
-
-  /** IPFS gateway URL for fetching circuit artifacts */
-  ipfsGateway?: string;
-}>;
-
-/** Parsed transaction details */
-type Transaction = Readonly<{
-  /** Transaction hash */
-  txHash: `0x${string}`;
-
-  /** Sender address */
-  from: `0x${string}`;
-
-  /** Recipient address */
-  to: `0x${string}`;
-
-  /** Amount in smallest token unit */
-  amount: bigint;
-
-  /** Block timestamp */
-  timestamp: number;
-
-  /** Block number */
-  blockNumber: bigint;
-
-  /** Number of confirmations */
-  confirmations: number;
-}>;
-
-/** Generated proof with inputs for Lemma API */
-type Proof = Readonly<{
-  /** ZK proof data (base64 encoded) */
-  proof: string;
-
-  /** Public inputs for the circuit */
-  inputs: ReadonlyArray<string>;
-
-  /** Circuit ID used */
-  circuitId: string;
-
-  /** Timestamp when proof was generated */
-  generatedAt: number;
-}>;
-
-/** Result of proof generation */
-type ProofResult = Readonly<{
-  /** Transaction */
-  payment: Transaction;
-
-  /** Generated proof */
-  proof: Proof;
-}>;
-
-/** Disclosure condition for Lemma API query */
-type DisclosureCondition = Readonly<{
-  circuitId: string;
-}>;
-
-/** Disclosure object to send with query */
-type Disclosure = Readonly<{
-  condition?: DisclosureCondition;
-  proof: string;
-  inputs: ReadonlyArray<string>;
-}>;
-
-export type {
-  Config,
-  Transaction,
-  Proof,
-  ProofResult,
-  Disclosure,
-  DisclosureCondition,
-};

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "workers"],
-  "references": [
-    { "path": "../spec" },
-    { "path": "../sdk" }
-  ]
-}

package/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["./src/index.ts","./src/proof-generator.test.ts","./src/proof-generator.ts","./src/transaction-watcher.test.ts","./src/transaction-watcher.ts","./src/types.ts"],"version":"5.8.3"}

package/vitest.config.ts

@@ -1,18 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    exclude: [
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/build/**',
-      '**/*.test.mjs', // Exclude circuit test files
-      '**/*.spec.mjs',
-      '**/circuits/**/*.mjs', // Exclude all .mjs files in circuits directory
-    ],
-    include: [
-      '**/*.test.ts',
-      '**/*.spec.ts',
-    ],
-  },
-});