@retrodeck/x402 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import type { LocalStore } from '@rdk/core';
+export declare const AUTONOMOUS_THRESHOLD_USDC = 0.05;
+export declare const BATCH_INTERVAL_MS: number;
+export declare const BATCH_TRIGGER_USDC = 1;
+export interface TipConfig {
+    privateKey: string;
+    centralApiUrl: string;
+    centralApiKey: string;
+    defaultChain: string;
+}
+export declare class X402Client {
+    private config;
+    private store;
+    private settling;
+    constructor(config: TipConfig, store: LocalStore);
+    /** Queue a tip after a successful network retrieval */
+    payForRetrieval(opts: {
+        chunkId: string;
+        providerNodeId: string;
+        amountUsdc: number;
+        chain?: string;
+    }): Promise<{
+        queued: boolean;
+        txHash?: string;
+    }>;
+    /** Batch-settle all pending tips. Called hourly or when threshold crossed. */
+    settleBatch(): Promise<{
+        settled: number;
+        failed: number;
+        totalUsdc: number;
+    }>;
+    /** Start hourly background settlement loop */
+    startSettlementLoop(): ReturnType<typeof setInterval>;
+    private sendUsdc;
+    private getProviderWallet;
+    private recordOnCentral;
+    private loadEthers;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,WAAW,CAAC;AAE3D,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,IAAO,CAAC;AAmBvC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU;IAKhD,uDAAuD;IACjD,eAAe,CAAC,IAAI,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBjD,8EAA8E;IACxE,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAkDpF,8CAA8C;IAC9C,mBAAmB,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC;YAUvC,QAAQ;YAgCR,iBAAiB;YAcjB,eAAe;YAiBf,UAAU;CAWzB"}

package/dist/client.js

@@ -0,0 +1,162 @@
+// packages/rdk-x402/src/client.ts
+// On-chain USDC micropayment tips for RDK knowledge retrieval.
+// ethers.js is an optional dep — imported lazily on first tip settlement only.
+// Tier 4: only loaded when user runs `rdk tips:enable`.
+export const AUTONOMOUS_THRESHOLD_USDC = 0.05;
+export const BATCH_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
+export const BATCH_TRIGGER_USDC = 1.00;
+const USDC_CONTRACTS = {
+    base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    ethereum: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    polygon: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174',
+};
+const ERC20_ABI = [
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function balanceOf(address owner) view returns (uint256)',
+];
+const RPC_URLS = {
+    base: 'https://mainnet.base.org',
+    ethereum: 'https://cloudflare-eth.com',
+    polygon: 'https://polygon-rpc.com',
+};
+export class X402Client {
+    config;
+    store;
+    settling = false;
+    constructor(config, store) {
+        this.config = config;
+        this.store = store;
+    }
+    /** Queue a tip after a successful network retrieval */
+    async payForRetrieval(opts) {
+        const chain = opts.chain ?? this.config.defaultChain;
+        this.store.enqueueTip({
+            chunkId: opts.chunkId,
+            providerNodeId: opts.providerNodeId,
+            amountUsdc: opts.amountUsdc,
+            chain,
+        });
+        // Trigger immediate batch if we've crossed the $1.00 threshold
+        const pendingTotal = this.store.getPendingTipTotal();
+        if (pendingTotal >= BATCH_TRIGGER_USDC) {
+            setImmediate(() => this.settleBatch().catch(console.error));
+        }
+        return { queued: true };
+    }
+    /** Batch-settle all pending tips. Called hourly or when threshold crossed. */
+    async settleBatch() {
+        if (this.settling)
+            return { settled: 0, failed: 0, totalUsdc: 0 };
+        this.settling = true;
+        let settled = 0;
+        let failed = 0;
+        let totalUsdc = 0;
+        try {
+            const pending = this.store.getPendingTips();
+            if (pending.length === 0)
+                return { settled: 0, failed: 0, totalUsdc: 0 };
+            // Group by providerNodeId + chain to minimize on-chain transactions
+            const groups = new Map();
+            for (const tip of pending) {
+                const key = `${tip.providerNodeId}:${tip.chain}`;
+                const group = groups.get(key) ?? [];
+                group.push(tip);
+                groups.set(key, group);
+            }
+            for (const [, tips] of groups) {
+                const batchAmount = tips.reduce((s, t) => s + t.amountUsdc, 0);
+                if (batchAmount < 0.001)
+                    continue; // skip micro-batches below gas cost
+                const chain = tips[0].chain;
+                const providerNodeId = tips[0].providerNodeId;
+                try {
+                    const txHash = await this.sendUsdc(providerNodeId, batchAmount, chain);
+                    if (txHash) {
+                        for (const tip of tips) {
+                            this.store.settleTip(tip.id, txHash);
+                            await this.recordOnCentral(tip.chunkId, txHash, tip.amountUsdc, chain);
+                        }
+                        settled += tips.length;
+                        totalUsdc += batchAmount;
+                    }
+                }
+                catch {
+                    for (const tip of tips)
+                        this.store.failTip(tip.id);
+                    failed += tips.length;
+                }
+            }
+        }
+        finally {
+            this.settling = false;
+        }
+        return { settled, failed, totalUsdc };
+    }
+    /** Start hourly background settlement loop */
+    startSettlementLoop() {
+        return setInterval(() => {
+            if (this.store.getPendingTipTotal() > 0) {
+                this.settleBatch().catch(console.error);
+            }
+        }, BATCH_INTERVAL_MS);
+    }
+    // ── Private: on-chain settlement ──────────────────────────────────────────
+    async sendUsdc(providerNodeId, amountUsdc, chain) {
+        const toAddress = await this.getProviderWallet(providerNodeId);
+        if (!toAddress)
+            return null;
+        const usdcAddress = USDC_CONTRACTS[chain];
+        if (!usdcAddress)
+            throw new Error(`Chain not supported: ${chain}`);
+        if (!this.config.privateKey) {
+            throw new Error('No wallet private key. Set RDK_WALLET_PRIVATE_KEY env var.');
+        }
+        // Lazy-load ethers — only runs if tips are actually being settled
+        const ethers = await this.loadEthers();
+        const rpcUrl = process.env[`${chain.toUpperCase()}_RPC_URL`] ?? RPC_URLS[chain];
+        if (!rpcUrl)
+            throw new Error(`No RPC URL for chain: ${chain}`);
+        const provider = new ethers.JsonRpcProvider(rpcUrl);
+        const wallet = new ethers.Wallet(this.config.privateKey, provider);
+        const usdc = new ethers.Contract(usdcAddress, ERC20_ABI, wallet);
+        // USDC: 6 decimals
+        const amount = BigInt(Math.round(amountUsdc * 1_000_000));
+        const tx = await usdc['transfer'](toAddress, amount);
+        const receipt = await tx.wait();
+        return receipt?.hash ?? null;
+    }
+    async getProviderWallet(providerNodeId) {
+        try {
+            const res = await fetch(`${this.config.centralApiUrl}/api/v1/nodes/${providerNodeId}/wallet`, { headers: { Authorization: `Bearer ${this.config.centralApiKey}` } });
+            if (!res.ok)
+                return null;
+            const data = await res.json();
+            return data.walletAddress ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async recordOnCentral(chunkId, txHash, amountUsdc, chain) {
+        await fetch(`${this.config.centralApiUrl}/api/v1/tips/record`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.config.centralApiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ queryId: '', chunkId, txHash, amountUsdc, chain }),
+        });
+    }
+    // Lazy ethers loader — returns the ethers namespace, not { ethers: ... }
+    async loadEthers() {
+        try {
+            return await import('ethers');
+        }
+        catch {
+            throw new Error('ethers not installed.\n' +
+                'Run: rdk tips:enable  (installs automatically)\n' +
+                'Or:  npm install ethers');
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { X402Client, AUTONOMOUS_THRESHOLD_USDC, BATCH_INTERVAL_MS, BATCH_TRIGGER_USDC } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,191 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AUTONOMOUS_THRESHOLD_USDC: () => AUTONOMOUS_THRESHOLD_USDC,
+  BATCH_INTERVAL_MS: () => BATCH_INTERVAL_MS,
+  BATCH_TRIGGER_USDC: () => BATCH_TRIGGER_USDC,
+  X402Client: () => X402Client
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var AUTONOMOUS_THRESHOLD_USDC = 0.05;
+var BATCH_INTERVAL_MS = 60 * 60 * 1e3;
+var BATCH_TRIGGER_USDC = 1;
+var USDC_CONTRACTS = {
+  base: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  ethereum: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+  polygon: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
+};
+var ERC20_ABI = [
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address owner) view returns (uint256)"
+];
+var RPC_URLS = {
+  base: "https://mainnet.base.org",
+  ethereum: "https://cloudflare-eth.com",
+  polygon: "https://polygon-rpc.com"
+};
+var X402Client = class {
+  config;
+  store;
+  settling = false;
+  constructor(config, store) {
+    this.config = config;
+    this.store = store;
+  }
+  /** Queue a tip after a successful network retrieval */
+  async payForRetrieval(opts) {
+    const chain = opts.chain ?? this.config.defaultChain;
+    this.store.enqueueTip({
+      chunkId: opts.chunkId,
+      providerNodeId: opts.providerNodeId,
+      amountUsdc: opts.amountUsdc,
+      chain
+    });
+    const pendingTotal = this.store.getPendingTipTotal();
+    if (pendingTotal >= BATCH_TRIGGER_USDC) {
+      setImmediate(() => this.settleBatch().catch(console.error));
+    }
+    return { queued: true };
+  }
+  /** Batch-settle all pending tips. Called hourly or when threshold crossed. */
+  async settleBatch() {
+    if (this.settling) return { settled: 0, failed: 0, totalUsdc: 0 };
+    this.settling = true;
+    let settled = 0;
+    let failed = 0;
+    let totalUsdc = 0;
+    try {
+      const pending = this.store.getPendingTips();
+      if (pending.length === 0) return { settled: 0, failed: 0, totalUsdc: 0 };
+      const groups = /* @__PURE__ */ new Map();
+      for (const tip of pending) {
+        const key = `${tip.providerNodeId}:${tip.chain}`;
+        const group = groups.get(key) ?? [];
+        group.push(tip);
+        groups.set(key, group);
+      }
+      for (const [, tips] of groups) {
+        const batchAmount = tips.reduce((s, t) => s + t.amountUsdc, 0);
+        if (batchAmount < 1e-3) continue;
+        const chain = tips[0].chain;
+        const providerNodeId = tips[0].providerNodeId;
+        try {
+          const txHash = await this.sendUsdc(providerNodeId, batchAmount, chain);
+          if (txHash) {
+            for (const tip of tips) {
+              this.store.settleTip(tip.id, txHash);
+              await this.recordOnCentral(tip.chunkId, txHash, tip.amountUsdc, chain);
+            }
+            settled += tips.length;
+            totalUsdc += batchAmount;
+          }
+        } catch {
+          for (const tip of tips) this.store.failTip(tip.id);
+          failed += tips.length;
+        }
+      }
+    } finally {
+      this.settling = false;
+    }
+    return { settled, failed, totalUsdc };
+  }
+  /** Start hourly background settlement loop */
+  startSettlementLoop() {
+    return setInterval(() => {
+      if (this.store.getPendingTipTotal() > 0) {
+        this.settleBatch().catch(console.error);
+      }
+    }, BATCH_INTERVAL_MS);
+  }
+  // ── Private: on-chain settlement ──────────────────────────────────────────
+  async sendUsdc(providerNodeId, amountUsdc, chain) {
+    const toAddress = await this.getProviderWallet(providerNodeId);
+    if (!toAddress) return null;
+    const usdcAddress = USDC_CONTRACTS[chain];
+    if (!usdcAddress) throw new Error(`Chain not supported: ${chain}`);
+    if (!this.config.privateKey) {
+      throw new Error("No wallet private key. Set RDK_WALLET_PRIVATE_KEY env var.");
+    }
+    const ethers = await this.loadEthers();
+    const rpcUrl = process.env[`${chain.toUpperCase()}_RPC_URL`] ?? RPC_URLS[chain];
+    if (!rpcUrl) throw new Error(`No RPC URL for chain: ${chain}`);
+    const provider = new ethers.JsonRpcProvider(rpcUrl);
+    const wallet = new ethers.Wallet(this.config.privateKey, provider);
+    const usdc = new ethers.Contract(usdcAddress, ERC20_ABI, wallet);
+    const amount = BigInt(Math.round(amountUsdc * 1e6));
+    const tx = await usdc["transfer"](toAddress, amount);
+    const receipt = await tx.wait();
+    return receipt?.hash ?? null;
+  }
+  async getProviderWallet(providerNodeId) {
+    try {
+      const res = await fetch(
+        `${this.config.centralApiUrl}/api/v1/nodes/${providerNodeId}/wallet`,
+        { headers: { Authorization: `Bearer ${this.config.centralApiKey}` } }
+      );
+      if (!res.ok) return null;
+      const data = await res.json();
+      return data.walletAddress ?? null;
+    } catch {
+      return null;
+    }
+  }
+  async recordOnCentral(chunkId, txHash, amountUsdc, chain) {
+    await fetch(`${this.config.centralApiUrl}/api/v1/tips/record`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.config.centralApiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ queryId: "", chunkId, txHash, amountUsdc, chain })
+    });
+  }
+  // Lazy ethers loader — returns the ethers namespace, not { ethers: ... }
+  async loadEthers() {
+    try {
+      return await import("ethers");
+    } catch {
+      throw new Error(
+        "ethers not installed.\nRun: rdk tips:enable  (installs automatically)\nOr:  npm install ethers"
+      );
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AUTONOMOUS_THRESHOLD_USDC,
+  BATCH_INTERVAL_MS,
+  BATCH_TRIGGER_USDC,
+  X402Client
+});

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@retrodeck/x402",
+  "version": "1.0.0",
+  "description": "RDK x402 micropayment tip protocol — on-chain USDC tips for knowledge retrieval",
+  "main": "./dist/index.js",
+  "optionalDependencies": {
+    "ethers": "^6.14.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "esbuild": "^0.28.0",
+    "typescript": "^5.8.3",
+    "@rdk/core": "1.0.0"
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=cjs --target=node20 --outfile=dist/index.js --external:ethers --external:better-sqlite3 --external:@xenova/transformers",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist"
+  }
+}