@scriptmasterlabs/mcp-x402 2.1.1 → 2.1.2

package/.well-known/x402.json

@@ -1,37 +0,0 @@
-{
-  "protocol": "x402",
-  "version": "1.0",
-  "maintainer": "ScriptMasterLabs",
-  "homepage": "https://scriptmasterlabs.com",
-  "repository": "https://github.com/Timwal78/mcp-x402-xrpl",
-  "npm": "@scriptmasterlabs/mcp-x402",
-  "networks": [
-    {
-      "id": "xrpl-mainnet",
-      "name": "XRP Ledger Mainnet",
-      "rpc": "wss://xrplcluster.com",
-      "currencies": ["XRP", "RLUSD"],
-      "settlementFinality": "3-5 seconds",
-      "averageFee": "0.00001 XRP"
-    },
-    {
-      "id": "xahau-mainnet",
-      "name": "Xahau Mainnet",
-      "rpc": "wss://xahau.network",
-      "currencies": ["XAH"],
-      "settlementFinality": "3-5 seconds",
-      "averageFee": "0.00001 XAH"
-    }
-  ],
-  "capabilities": [
-    "mcp-tool-payment-gate",
-    "x402-middleware",
-    "xrpl-payment-signing",
-    "xahau-payment-signing",
-    "payment-proof-verification"
-  ],
-  "relatedProjects": [
-    "https://github.com/Timwal78/zeroquery-protocol",
-    "https://github.com/Timwal78/ago-orchestrator"
-  ]
-}

package/dist/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402 — Public API barrel
- *
- * Everything a consumer needs is exported from this single file.
- */
-export { createX402Middleware, createPaymentGate } from "./x402-middleware.js";
-export type { X402MiddlewareOptions, PaymentGateOptions, PaymentRequirements, PaymentProof } from "./x402-middleware.js";
-export { XrplFacilitator } from "./xrpl-facilitator.js";
-export type { XrplFacilitatorOptions, XrplNetwork } from "./xrpl-facilitator.js";
-export { wrapMcpServer } from "./mcp-wrapper.js";
-export type { McpTool, McpToolWithPricing, McpServerOptions } from "./mcp-wrapper.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,9 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402 — Public API barrel
- *
- * Everything a consumer needs is exported from this single file.
- */
-export { createX402Middleware, createPaymentGate } from "./x402-middleware.js";
-export { XrplFacilitator } from "./xrpl-facilitator.js";
-export { wrapMcpServer } from "./mcp-wrapper.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mcp-wrapper.d.ts

@@ -1,71 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402
- *
- * mcp-wrapper.ts — Drop-in wrapper that adds x402 XRPL payment gating
- * to any existing MCP (Model Context Protocol) server.
- *
- * Usage:
- *   import { wrapMcpServer } from "@scriptmasterlabs/mcp-x402";
- *   const server = wrapMcpServer(myMcpServer, { ... });
- *
- * The wrapper intercepts tool calls, checks for payment proof,
- * and either issues a 402 challenge or passes through to the real handler.
- */
-import { PaymentGateOptions, X402MiddlewareOptions } from "./x402-middleware.js";
-import { Application } from "express";
-export interface McpTool {
-    name: string;
-    description: string;
-    handler: (params: Record<string, unknown>) => Promise<unknown>;
-}
-export interface McpToolWithPricing extends McpTool {
-    /** If omitted, the tool is free */
-    pricing?: PaymentGateOptions;
-}
-export interface McpServerOptions {
-    /** Port to listen on. Default: 3402 */
-    port?: number;
-    /** x402 middleware options (wallet seed, network, cap) */
-    x402: X402MiddlewareOptions;
-    /** Tools to register */
-    tools: McpToolWithPricing[];
-    /** Server name shown in MCP server manifest */
-    serverName?: string;
-    /** Server version */
-    serverVersion?: string;
-}
-/**
- * Spins up a lightweight MCP-compatible Express server with x402 payment
- * gating on any tools that have a `pricing` field.
- *
- * @example
- * ```ts
- * import { wrapMcpServer } from "@scriptmasterlabs/mcp-x402";
- *
- * const server = wrapMcpServer({
- *   x402: { walletSeed: process.env.XRPL_WALLET_SEED!, network: "xrpl-mainnet" },
- *   tools: [
- *     {
- *       name: "premium-market-data",
- *       description: "Real-time XRP/USD price feed",
- *       pricing: {
- *         destination: "rYourReceivingAddress",
- *         amountDrops: "100000",  // 0.1 XRP per call
- *         currency: "XRP",
- *         description: "0.1 XRP per market data query",
- *       },
- *       handler: async (params) => {
- *         return { price: 0.52, timestamp: Date.now() };
- *       },
- *     },
- *   ],
- * });
- *
- * server.listen();
- * ```
- */
-export declare function wrapMcpServer(opts: McpServerOptions): {
-    app: Application;
-    listen: () => void;
-};
-//# sourceMappingURL=mcp-wrapper.d.ts.map

package/dist/mcp-wrapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-wrapper.d.ts","sourceRoot":"","sources":["../src/mcp-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAA2C,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1H,OAAgB,EAAE,WAAW,EAAU,MAAM,SAAS,CAAC;AAIvD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,mCAAmC;IACnC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,wBAAwB;IACxB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAiE9F"}

package/dist/mcp-wrapper.js

@@ -1,104 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402
- *
- * mcp-wrapper.ts — Drop-in wrapper that adds x402 XRPL payment gating
- * to any existing MCP (Model Context Protocol) server.
- *
- * Usage:
- *   import { wrapMcpServer } from "@scriptmasterlabs/mcp-x402";
- *   const server = wrapMcpServer(myMcpServer, { ... });
- *
- * The wrapper intercepts tool calls, checks for payment proof,
- * and either issues a 402 challenge or passes through to the real handler.
- */
-import { createPaymentGate, createX402Middleware } from "./x402-middleware.js";
-import express, { Router } from "express";
-// ─── wrapMcpServer ────────────────────────────────────────────────────────────
-/**
- * Spins up a lightweight MCP-compatible Express server with x402 payment
- * gating on any tools that have a `pricing` field.
- *
- * @example
- * ```ts
- * import { wrapMcpServer } from "@scriptmasterlabs/mcp-x402";
- *
- * const server = wrapMcpServer({
- *   x402: { walletSeed: process.env.XRPL_WALLET_SEED!, network: "xrpl-mainnet" },
- *   tools: [
- *     {
- *       name: "premium-market-data",
- *       description: "Real-time XRP/USD price feed",
- *       pricing: {
- *         destination: "rYourReceivingAddress",
- *         amountDrops: "100000",  // 0.1 XRP per call
- *         currency: "XRP",
- *         description: "0.1 XRP per market data query",
- *       },
- *       handler: async (params) => {
- *         return { price: 0.52, timestamp: Date.now() };
- *       },
- *     },
- *   ],
- * });
- *
- * server.listen();
- * ```
- */
-export function wrapMcpServer(opts) {
-    const app = express();
-    const port = opts.port ?? 3402;
-    app.use(express.json());
-    // Attach x402 client-side middleware (handles outbound 402 fulfillment)
-    app.use(createX402Middleware(opts.x402));
-    // MCP server manifest (GET /.well-known/mcp)
-    app.get("/.well-known/mcp", (_req, res) => {
-        res.json({
-            name: opts.serverName ?? "mcp-x402-xrpl",
-            version: opts.serverVersion ?? "0.1.0",
-            protocol: "mcp/1.0",
-            payment: {
-                protocol: "x402",
-                network: opts.x402.network ?? "xrpl-mainnet",
-                currency: "XRP",
-                info: "https://github.com/Timwal78/mcp-x402-xrpl",
-            },
-            tools: opts.tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                ...(t.pricing ? { pricing: t.pricing } : {}),
-            })),
-        });
-    });
-    // Register tool routes
-    const toolRouter = Router();
-    for (const tool of opts.tools) {
-        const handlers = [];
-        // Gated tool — add payment gate middleware
-        if (tool.pricing) {
-            handlers.push(createPaymentGate(tool.pricing));
-        }
-        // Tool handler
-        handlers.push(async (req, res) => {
-            try {
-                const result = await tool.handler(req.body);
-                res.json({ result });
-            }
-            catch (err) {
-                res.status(500).json({ error: String(err) });
-            }
-        });
-        toolRouter.post(`/${tool.name}`, ...handlers);
-    }
-    app.use("/tools", toolRouter);
-    return {
-        app,
-        listen: () => {
-            app.listen(port, () => {
-                console.log(`[mcp-x402] MCP server listening on http://localhost:${port}`);
-                console.log(`[mcp-x402] Manifest: http://localhost:${port}/.well-known/mcp`);
-                console.log(`[mcp-x402] Tools: ${opts.tools.map((t) => t.name).join(", ")}`);
-            });
-        },
-    };
-}
-//# sourceMappingURL=mcp-wrapper.js.map

package/dist/mcp-wrapper.js.map

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

package/dist/x402-middleware.d.ts

@@ -1,76 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402
- *
- * x402-middleware.ts — Express/Fastify-compatible middleware that intercepts
- * HTTP 402 Payment Required responses and fulfils them using an XRPL wallet.
- *
- * The middleware sits between the MCP client (AI agent) and any gated
- * MCP tool endpoint. When the upstream server returns 402, it:
- *   1. Parses the X-Payment-Requirements header
- *   2. Signs an XRPL / Xahau payment transaction
- *   3. Resubmits the original request with X-Payment proof header
- *   4. Passes the 200 response through to the agent
- *
- * Chain support:  XRPL mainnet · XRPL testnet · Xahau mainnet · Xahau testnet
- * Settlement:     XRP (native) · RLUSD (IOU) · XAH (native on Xahau)
- */
-import { RequestHandler } from "express";
-import { PaymentRequirements, PaymentProof } from "./xrpl-facilitator.js";
-export interface X402MiddlewareOptions {
-    /** XRPL/Xahau wallet seed (family seed format, e.g. "sEdT...") */
-    walletSeed: string;
-    /** Network to settle on. Defaults to "xrpl-mainnet" */
-    network?: "xrpl-mainnet" | "xrpl-testnet" | "xahau-mainnet" | "xahau-testnet";
-    /** Maximum amount (in drops for XRP, or string for RLUSD/XAH) the middleware
-     *  will auto-pay per request. Requests exceeding this are rejected. */
-    maxPaymentDrops?: string;
-    /** Optional logger. Defaults to console. */
-    logger?: Pick<Console, "log" | "warn" | "error">;
-}
-export type { PaymentRequirements, PaymentProof };
-/**
- * Factory — returns an Express-compatible middleware function.
- *
- * @example
- * ```ts
- * import express from "express";
- * import { createX402Middleware } from "@scriptmasterlabs/mcp-x402";
- *
- * const app = express();
- * app.use(createX402Middleware({
- *   walletSeed: process.env.XRPL_WALLET_SEED!,
- *   network: "xrpl-mainnet",
- *   maxPaymentDrops: "1000000", // 1 XRP cap per tool call
- * }));
- * ```
- */
-export declare function createX402Middleware(opts: X402MiddlewareOptions): RequestHandler;
-/**
- * createPaymentGate — wraps a route handler so that callers without a valid
- * X-Payment-Proof header receive a 402 challenge automatically.
- *
- * @example
- * ```ts
- * app.post(
- *   "/tools/premium-query",
- *   createPaymentGate({ amountDrops: "100000", currency: "XRP" }),
- *   myToolHandler
- * );
- * ```
- */
-export interface PaymentGateOptions {
-    /** Amount in drops (1 XRP = 1,000,000 drops) for XRP payments */
-    amountDrops?: string;
-    /** For RLUSD or XAH: human-readable amount string e.g. "0.10" */
-    amount?: string;
-    /** Currency code. "XRP" | "RLUSD" | "XAH". Defaults to "XRP" */
-    currency?: "XRP" | "RLUSD" | "XAH";
-    /** Your XRPL receiving address */
-    destination: string;
-    /** Optional destination tag */
-    destinationTag?: number;
-    /** Description shown to the paying agent */
-    description?: string;
-}
-export declare function createPaymentGate(opts: PaymentGateOptions): RequestHandler;
-//# sourceMappingURL=x402-middleware.d.ts.map

package/dist/x402-middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"x402-middleware.d.ts","sourceRoot":"","sources":["../src/x402-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAmB,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3F,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;IAC9E;2EACuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAClD;AAED,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAyDhF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;IACnC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAmC1E"}

package/dist/x402-middleware.js

@@ -1,113 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402
- *
- * x402-middleware.ts — Express/Fastify-compatible middleware that intercepts
- * HTTP 402 Payment Required responses and fulfils them using an XRPL wallet.
- *
- * The middleware sits between the MCP client (AI agent) and any gated
- * MCP tool endpoint. When the upstream server returns 402, it:
- *   1. Parses the X-Payment-Requirements header
- *   2. Signs an XRPL / Xahau payment transaction
- *   3. Resubmits the original request with X-Payment proof header
- *   4. Passes the 200 response through to the agent
- *
- * Chain support:  XRPL mainnet · XRPL testnet · Xahau mainnet · Xahau testnet
- * Settlement:     XRP (native) · RLUSD (IOU) · XAH (native on Xahau)
- */
-import { XrplFacilitator } from "./xrpl-facilitator.js";
-/**
- * Factory — returns an Express-compatible middleware function.
- *
- * @example
- * ```ts
- * import express from "express";
- * import { createX402Middleware } from "@scriptmasterlabs/mcp-x402";
- *
- * const app = express();
- * app.use(createX402Middleware({
- *   walletSeed: process.env.XRPL_WALLET_SEED!,
- *   network: "xrpl-mainnet",
- *   maxPaymentDrops: "1000000", // 1 XRP cap per tool call
- * }));
- * ```
- */
-export function createX402Middleware(opts) {
-    const log = opts.logger ?? console;
-    const facilitator = new XrplFacilitator({
-        walletSeed: opts.walletSeed,
-        network: opts.network ?? "xrpl-mainnet",
-    });
-    return async function x402Middleware(req, res, next) {
-        // Intercept only if the upstream already returned 402.
-        // In proxy mode, call next() — the wrapper handles intercept.
-        // In direct mode, the payment gate checks the header before calling next().
-        const paymentRequirementsHeader = req.headers["x-payment-requirements"];
-        if (!paymentRequirementsHeader) {
-            // No payment challenge — pass through
-            next();
-            return;
-        }
-        let requirements;
-        try {
-            requirements = JSON.parse(Buffer.from(paymentRequirementsHeader, "base64").toString("utf8"));
-        }
-        catch {
-            log.error("[mcp-x402] Failed to parse X-Payment-Requirements header");
-            res.status(400).json({ error: "malformed_payment_requirements" });
-            return;
-        }
-        // Safety cap check
-        if (opts.maxPaymentDrops && BigInt(requirements.amountDrops ?? "0") > BigInt(opts.maxPaymentDrops)) {
-            log.warn(`[mcp-x402] Payment request (${requirements.amountDrops} drops) exceeds maxPaymentDrops cap`);
-            res.status(402).json({ error: "payment_exceeds_cap", requirements });
-            return;
-        }
-        try {
-            log.log(`[mcp-x402] Fulfilling x402 payment: ${requirements.amountDrops} drops → ${requirements.destination}`);
-            const proof = await facilitator.pay(requirements);
-            log.log(`[mcp-x402] Payment settled. TxHash: ${proof.txHash}`);
-            // Attach proof header and allow the MCP server to verify
-            req.headers["x-payment-proof"] = Buffer.from(JSON.stringify(proof)).toString("base64");
-            // Clear the requirements header so the server doesn't loop
-            delete req.headers["x-payment-requirements"];
-            next();
-        }
-        catch (err) {
-            log.error("[mcp-x402] Payment failed:", err);
-            res.status(402).json({ error: "payment_failed", details: String(err) });
-        }
-    };
-}
-export function createPaymentGate(opts) {
-    return function paymentGate(req, res, next) {
-        const proofHeader = req.headers["x-payment-proof"];
-        if (proofHeader) {
-            // Proof attached — let the facilitator verify downstream, pass through
-            next();
-            return;
-        }
-        // No proof — issue the 402 challenge
-        const requirements = {
-            destination: opts.destination,
-            destinationTag: opts.destinationTag,
-            amountDrops: opts.amountDrops,
-            amount: opts.amount,
-            currency: opts.currency ?? "XRP",
-            network: "xrpl-mainnet",
-            description: opts.description ?? "Payment required for MCP tool access",
-            expiresAt: new Date(Date.now() + 60_000).toISOString(), // 60-second window
-        };
-        const encoded = Buffer.from(JSON.stringify(requirements)).toString("base64");
-        res
-            .status(402)
-            .setHeader("X-Payment-Requirements", encoded)
-            .json({
-            error: "payment_required",
-            protocol: "x402",
-            network: "xrpl",
-            requirements,
-            paymentInstructions: "Attach X-Payment-Proof header with base64-encoded XRPL tx proof to retry.",
-        });
-    };
-}
-//# sourceMappingURL=x402-middleware.js.map

package/dist/x402-middleware.js.map

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

package/dist/xrpl-facilitator.d.ts

@@ -1,77 +0,0 @@
-/**
- * @scriptmasterlabs/mcp-x402
- *
- * xrpl-facilitator.ts — XRPL/Xahau payment facilitator.
- *
- * Responsibilities:
- *  - Connect to the correct XRPL / Xahau network
- *  - Sign and submit payment transactions (XRP drops, RLUSD IOU, XAH)
- *  - Return a PaymentProof that the receiving MCP server can verify on-ledger
- *  - Verify incoming PaymentProof objects (server-side gate)
- *
- * This is the ONLY component that touches private key material.
- * Never log walletSeed. Never expose wallet.privateKey downstream.
- */
-export interface PaymentRequirements {
-    /** Receiving XRPL address */
-    destination: string;
-    /** Optional destination tag */
-    destinationTag?: number;
-    /** XRP amount in drops (string to avoid BigInt precision issues) */
-    amountDrops?: string;
-    /** Human-readable amount for non-XRP currencies */
-    amount?: string;
-    /** Currency code */
-    currency?: "XRP" | "RLUSD" | "XAH";
-    /** Network identifier */
-    network?: string;
-    /** Human-readable description of the tool / service */
-    description?: string;
-    /** ISO timestamp — proof must be submitted before this */
-    expiresAt?: string;
-}
-export interface PaymentProof {
-    /** Transaction hash (hex) on XRPL/Xahau ledger */
-    txHash: string;
-    /** Ledger index where the tx was validated */
-    ledgerIndex: number;
-    /** Paying wallet address (public, safe to expose) */
-    payer: string;
-    /** The destination address paid */
-    destination: string;
-    /** Amount in drops or human-readable string */
-    amount: string;
-    /** Currency code */
-    currency: string;
-    /** Network the payment was submitted on */
-    network: string;
-    /** ISO timestamp of settlement */
-    settledAt: string;
-}
-export type XrplNetwork = "xrpl-mainnet" | "xrpl-testnet" | "xahau-mainnet" | "xahau-testnet";
-export interface XrplFacilitatorOptions {
-    walletSeed: string;
-    network: XrplNetwork;
-}
-export declare class XrplFacilitator {
-    private readonly wallet;
-    private readonly network;
-    private readonly wsUrl;
-    constructor(opts: XrplFacilitatorOptions);
-    /** Public address of the paying wallet (safe to log/expose) */
-    get payerAddress(): string;
-    /**
-     * pay() — fulfil a PaymentRequirements challenge.
-     * Connects, submits, waits for validation, disconnects.
-     * Returns a PaymentProof the server can verify on-ledger.
-     */
-    pay(req: PaymentRequirements): Promise<PaymentProof>;
-    /**
-     * verify() — server-side: confirm that a PaymentProof actually exists on-ledger
-     * and matches the expected requirements.
-     */
-    verify(proof: PaymentProof, expected: PaymentRequirements): Promise<boolean>;
-    private buildPaymentTx;
-    private extractProof;
-}
-//# sourceMappingURL=xrpl-facilitator.d.ts.map

package/dist/xrpl-facilitator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"xrpl-facilitator.d.ts","sourceRoot":"","sources":["../src/xrpl-facilitator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;IACnC,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;CACtB;AAaD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,EAAE,sBAAsB;IAOxC,+DAA+D;IAC/D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB1D;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;YAyCpE,cAAc;IAmC5B,OAAO,CAAC,YAAY;CAmBrB"}