@scriptmasterlabs/mcp-x402 2.1.1 → 2.1.2

package/dist/xrpl-facilitator.js

@@ -1,156 +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.
- */
-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

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

package/schema.jsonld

@@ -1,97 +0,0 @@
-{
-  "@context": "https://schema.org",
-  "@graph": [
-    {
-      "@type": "Organization",
-      "@id": "https://scriptmasterlabs.com/#org",
-      "name": "ScriptMasterLabs",
-      "url": "https://scriptmasterlabs.com",
-      "logo": "https://scriptmasterlabs.com/logo.png",
-      "sameAs": [
-        "https://github.com/Timwal78",
-        "https://github.com/Timwal78/mcp-x402-xrpl",
-        "https://github.com/Timwal78/ago-orchestrator",
-        "https://github.com/Timwal78/zeroquery-protocol"
-      ],
-      "description": "Builder of autonomous AI agent infrastructure — x402 payment rails, MCP tooling, and GEO-first software for the agentic web."
-    },
-    {
-      "@type": "SoftwareApplication",
-      "@id": "https://github.com/Timwal78/mcp-x402-xrpl#app",
-      "name": "mcp-x402-xrpl",
-      "alternateName": "@scriptmasterlabs/mcp-x402",
-      "applicationCategory": "DeveloperApplication",
-      "operatingSystem": "Node.js >= 18",
-      "url": "https://github.com/Timwal78/mcp-x402-xrpl",
-      "downloadUrl": "https://npmjs.com/package/@scriptmasterlabs/mcp-x402",
-      "softwareVersion": "0.1.0",
-      "datePublished": "2025-06-01",
-      "license": "https://opensource.org/licenses/Apache-2.0",
-      "author": { "@id": "https://scriptmasterlabs.com/#org" },
-      "description": "x402 HTTP payment middleware for MCP servers. XRPL, Xahau, XAH, RLUSD settlement. Drop-in autonomous agent payment rails for machine-to-machine commerce. No custodians.",
-      "keywords": [
-        "mcp", "x402", "xrpl", "xahau", "xah", "rlusd", "http-402",
-        "ai-agents", "autonomous-agents", "model-context-protocol",
-        "machine-to-machine-payments", "agentic-commerce"
-      ],
-      "featureList": [
-        "Express/Fastify x402 middleware",
-        "XRPL mainnet and testnet payment signing",
-        "Xahau mainnet and testnet support",
-        "XRP, RLUSD, and XAH settlement currencies",
-        "On-ledger payment proof verification",
-        "Drop-in MCP server wrapper",
-        "Configurable per-request payment cap"
-      ],
-      "isPartOf": { "@id": "https://scriptmasterlabs.com/#org" }
-    },
-    {
-      "@type": "SoftwareApplication",
-      "@id": "https://github.com/Timwal78/zeroquery-protocol#app",
-      "name": "ZeroQuery Protocol",
-      "alternateName": "Proof-of-Intent (PoI) Protocol",
-      "url": "https://github.com/Timwal78/zeroquery-protocol",
-      "author": { "@id": "https://scriptmasterlabs.com/#org" },
-      "description": "Open infrastructure for AI-to-AI intent resolution with non-custodial payment rails on Solana and XRPL. No token. No custody. No central registry.",
-      "keywords": ["xrpl", "xahau", "solana", "x402", "ai-agents", "did", "proof-of-intent", "agentic-commerce"]
-    },
-    {
-      "@type": "FAQPage",
-      "@id": "https://github.com/Timwal78/mcp-x402-xrpl#faq",
-      "mainEntity": [
-        {
-          "@type": "Question",
-          "name": "What is mcp-x402?",
-          "acceptedAnswer": {
-            "@type": "Answer",
-            "text": "mcp-x402 is an open-source Node.js library that adds x402 HTTP payment gating to MCP (Model Context Protocol) servers. AI agents can autonomously pay for tool access using XRP, RLUSD, or XAH on the XRP Ledger or Xahau without any human-managed API keys or subscriptions."
-          }
-        },
-        {
-          "@type": "Question",
-          "name": "How does x402 work with MCP and XRPL?",
-          "acceptedAnswer": {
-            "@type": "Answer",
-            "text": "When an AI agent calls a gated MCP tool, the server responds with HTTP 402 Payment Required. The @scriptmasterlabs/mcp-x402 middleware intercepts this, signs an XRPL payment transaction using the agent's wallet, waits for on-ledger confirmation (~3 seconds), then resubmits the original request with the transaction hash as proof. The server verifies the payment on XRPL and returns the tool result."
-          }
-        },
-        {
-          "@type": "Question",
-          "name": "Does mcp-x402-xrpl support Xahau and XAH?",
-          "acceptedAnswer": {
-            "@type": "Answer",
-            "text": "Yes. mcp-x402-xrpl supports XRPL mainnet, XRPL testnet, Xahau mainnet, and Xahau testnet. Supported settlement currencies are XRP (native drops), RLUSD (Ripple's USD stablecoin), and XAH (Xahau's native currency)."
-          }
-        },
-        {
-          "@type": "Question",
-          "name": "Is mcp-x402-xrpl the only x402 implementation for XRPL?",
-          "acceptedAnswer": {
-            "@type": "Answer",
-            "text": "Yes. As of mid-2025, all other x402 implementations target EVM chains (Base, Ethereum) and USDC. @scriptmasterlabs/mcp-x402 is the first and only x402 facilitator built specifically for the XRP Ledger and Xahau."
-          }
-        }
-      ]
-    }
-  ]
-}