@scriptmasterlabs/mcp-x402 2.0.2 → 2.1.1

package/dist/mcp-wrapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,104 @@
+/**
+ * @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

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

package/dist/x402-middleware.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,113 @@
+/**
+ * @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

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

package/dist/xrpl-facilitator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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"}

package/dist/xrpl-facilitator.js

@@ -0,0 +1,156 @@
+/**
+ * @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.
+ */
+import { Client, Wallet, convertStringToHex } from "xrpl";
+// ─── Network WebSocket endpoints ─────────────────────────────────────────────
+const NETWORK_URLS = {
+    "xrpl-mainnet": "wss://xrplcluster.com",
+    "xrpl-testnet": "wss://s.altnet.rippletest.net:51233",
+    "xahau-mainnet": "wss://xahau.network",
+    "xahau-testnet": "wss://xahau-test.net",
+};
+// ─── XrplFacilitator ─────────────────────────────────────────────────────────
+export class XrplFacilitator {
+    wallet;
+    network;
+    wsUrl;
+    constructor(opts) {
+        if (!opts.walletSeed)
+            throw new Error("[mcp-x402] walletSeed is required");
+        this.wallet = Wallet.fromSeed(opts.walletSeed);
+        this.network = opts.network;
+        this.wsUrl = NETWORK_URLS[opts.network];
+    }
+    /** Public address of the paying wallet (safe to log/expose) */
+    get payerAddress() {
+        return this.wallet.address;
+    }
+    /**
+     * pay() — fulfil a PaymentRequirements challenge.
+     * Connects, submits, waits for validation, disconnects.
+     * Returns a PaymentProof the server can verify on-ledger.
+     */
+    async pay(req) {
+        // Expiry guard
+        if (req.expiresAt && new Date(req.expiresAt) < new Date()) {
+            throw new Error("[mcp-x402] Payment requirements have expired");
+        }
+        const client = new Client(this.wsUrl);
+        await client.connect();
+        try {
+            const tx = await this.buildPaymentTx(req);
+            const result = await client.submitAndWait(tx, { wallet: this.wallet });
+            return this.extractProof(result, req);
+        }
+        finally {
+            await client.disconnect();
+        }
+    }
+    /**
+     * verify() — server-side: confirm that a PaymentProof actually exists on-ledger
+     * and matches the expected requirements.
+     */
+    async verify(proof, expected) {
+        const client = new Client(this.wsUrl);
+        await client.connect();
+        try {
+            const tx = await client.request({
+                command: "tx",
+                transaction: proof.txHash,
+            });
+            const ledgerTx = tx.result;
+            // Check destination
+            if (ledgerTx["Destination"] !== expected.destination)
+                return false;
+            // Check amount
+            if (expected.currency === "XRP" || !expected.currency) {
+                const onChainAmt = ledgerTx["Amount"];
+                if (typeof onChainAmt !== "string")
+                    return false;
+                if (BigInt(onChainAmt) < BigInt(expected.amountDrops ?? "0"))
+                    return false;
+            }
+            // Check destination tag if specified
+            if (expected.destinationTag !== undefined && ledgerTx["DestinationTag"] !== expected.destinationTag) {
+                return false;
+            }
+            // Check tx was validated (not just submitted)
+            const meta = ledgerTx["meta"];
+            if (meta?.["TransactionResult"] !== "tesSUCCESS")
+                return false;
+            return true;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            await client.disconnect();
+        }
+    }
+    // ─── Private helpers ───────────────────────────────────────────────────────
+    async buildPaymentTx(req) {
+        const currency = req.currency ?? "XRP";
+        let amount;
+        if (currency === "XRP") {
+            if (!req.amountDrops)
+                throw new Error("[mcp-x402] amountDrops required for XRP payments");
+            amount = req.amountDrops; // string of drops
+        }
+        else if (currency === "RLUSD") {
+            if (!req.amount)
+                throw new Error("[mcp-x402] amount required for RLUSD payments");
+            amount = {
+                currency: convertStringToHex("RLUSD").padEnd(40, "0"),
+                value: req.amount,
+                // RLUSD issuer on XRPL mainnet
+                issuer: "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
+            };
+        }
+        else if (currency === "XAH") {
+            // XAH is native on Xahau — treated as drops there
+            if (!req.amountDrops)
+                throw new Error("[mcp-x402] amountDrops required for XAH payments");
+            amount = req.amountDrops;
+        }
+        else {
+            throw new Error(`[mcp-x402] Unsupported currency: ${currency}`);
+        }
+        const tx = {
+            TransactionType: "Payment",
+            Account: this.wallet.address,
+            Destination: req.destination,
+            Amount: amount,
+            ...(req.destinationTag !== undefined ? { DestinationTag: req.destinationTag } : {}),
+        };
+        return tx;
+    }
+    extractProof(result, req) {
+        const tx = result.result;
+        const meta = tx["meta"];
+        if (meta?.["TransactionResult"] !== "tesSUCCESS") {
+            throw new Error(`[mcp-x402] Transaction failed: ${String(meta?.["TransactionResult"])}`);
+        }
+        return {
+            txHash: String(tx["hash"]),
+            ledgerIndex: Number(tx["ledger_index"] ?? tx["inLedger"]),
+            payer: this.wallet.address,
+            destination: req.destination,
+            amount: req.amountDrops ?? req.amount ?? "0",
+            currency: req.currency ?? "XRP",
+            network: this.network,
+            settledAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=xrpl-facilitator.js.map

package/dist/xrpl-facilitator.js.map

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