@raycashxyz/mpp-pay 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @raycashxyz/mpp-pay
+
+CLI for making paid API requests via the [Machine Payments Protocol](https://mpp.dev) with [Raycash](https://raycash.xyz) private payments.
+
+## Install
+
+```bash
+npm install -g @raycashxyz/mpp-pay
+```
+
+Or use directly with `npx`:
+
+```bash
+npx @raycashxyz/mpp-pay <url>
+```
+
+## Usage
+
+```bash
+# Create a signing wallet (first time only — no ETH needed)
+mpp-pay --create-wallet
+
+# Make a paid request
+mpp-pay "https://your-api.com/endpoint"
+
+# POST with body
+mpp-pay "https://your-api.com/endpoint" --method POST --body '{"input":"hello"}'
+
+# Check wallet
+mpp-pay --wallet
+```
+
+## How It Works
+
+1. You request a paid endpoint → gets `402 Payment Required`
+2. `mpp-pay` reads the payment challenge, creates a channel (first time), signs a voucher
+3. Retries with payment → returns the response
+4. If the channel needs funding, shows the address to send tokens to
+
+The wallet is a local signing key (`~/.mpp-wallet.json`). It never needs gas or on-chain transactions — it only signs payment vouchers off-chain.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { homedir } from "os";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { Mppx } from "mppx/client";
+import { raycash } from "@raycashxyz/mpp/client";
+var WALLET_PATH = resolve(homedir(), ".mpp-wallet.json");
+function loadWallet() {
+  if (!existsSync(WALLET_PATH)) return null;
+  return JSON.parse(readFileSync(WALLET_PATH, "utf-8"));
+}
+function createWallet() {
+  const existing = loadWallet();
+  if (existing) return existing;
+  const wallet2 = {
+    privateKey: generatePrivateKey(),
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeFileSync(WALLET_PATH, JSON.stringify(wallet2, null, 2));
+  return wallet2;
+}
+var args = process.argv.slice(2);
+if (args.includes("--create-wallet")) {
+  const wallet2 = createWallet();
+  const account2 = privateKeyToAccount(wallet2.privateKey);
+  console.log(`[mpp-pay] Wallet created`);
+  console.log(`[mpp-pay] Signer: ${account2.address}`);
+  console.log(`[mpp-pay] File: ${WALLET_PATH}`);
+  console.log(`[mpp-pay]`);
+  console.log(`[mpp-pay] This is a signing-only key. It does not hold tokens.`);
+  console.log(`[mpp-pay] When you make a paid request, the channel address to fund will be shown.`);
+  process.exit(0);
+}
+if (args.includes("--wallet")) {
+  const wallet2 = loadWallet();
+  if (!wallet2) {
+    console.log("[mpp-pay] No wallet found. Run: mpp-pay --create-wallet");
+    process.exit(0);
+  }
+  const account2 = privateKeyToAccount(wallet2.privateKey);
+  console.log(`[mpp-pay] Signer: ${account2.address}`);
+  console.log(`[mpp-pay] File: ${WALLET_PATH}`);
+  process.exit(0);
+}
+var url = args.find((a) => !a.startsWith("--"));
+if (!url) {
+  console.log("Usage:");
+  console.log("  mpp-pay <url>                           Make a paid request");
+  console.log("  mpp-pay <url> --method POST --body '{}'  POST with body");
+  console.log("  mpp-pay --create-wallet                 Create signing wallet");
+  console.log("  mpp-pay --wallet                        Show wallet info");
+  process.exit(0);
+}
+var wallet = loadWallet();
+if (!wallet) {
+  console.error("[mpp-pay] No wallet found. Create one first:");
+  console.error("[mpp-pay]   mpp-pay --create-wallet");
+  process.exit(1);
+}
+var account = privateKeyToAccount(wallet.privateKey);
+var methodIdx = args.indexOf("--method");
+var method = methodIdx !== -1 ? args[methodIdx + 1] ?? "GET" : "GET";
+var bodyIdx = args.indexOf("--body");
+var body = bodyIdx !== -1 ? args[bodyIdx + 1] : void 0;
+console.log(`[mpp-pay] Signer: ${account.address}`);
+console.log(`[mpp-pay] Request: ${method} ${url}`);
+var mppx = Mppx.create({
+  polyfill: false,
+  methods: [
+    raycash({
+      account,
+      serviceOrigin: new URL(url).origin,
+      onFundChannel: async (params) => {
+        console.log(`[mpp-pay] Payment channel created: ${params.channelAddress}`);
+        console.log(`[mpp-pay]`);
+        console.log(`[mpp-pay] Fund this channel to start paying:`);
+        console.log(`[mpp-pay]   Send at least ${params.minDeposit} smallest units to:`);
+        console.log(`[mpp-pay]   Address: ${params.channelAddress}`);
+        console.log(`[mpp-pay]   Token: ${params.underlying}`);
+        console.log(`[mpp-pay]   Chain ID: ${params.chainId}`);
+        console.log(`[mpp-pay]`);
+        console.log(`[mpp-pay] After funding, re-run the same command.`);
+        process.exit(1);
+      }
+    })
+  ]
+});
+var init = { method };
+if (body) {
+  init.body = body;
+  init.headers = { "Content-Type": "application/json" };
+}
+var response = await mppx.fetch(url, init);
+console.log(`[mpp-pay] Status: ${response.status}`);
+var contentType = response.headers.get("content-type") ?? "";
+if (contentType.includes("json")) {
+  console.log(JSON.stringify(await response.json(), null, 2));
+} else {
+  console.log(await response.text());
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@raycashxyz/mpp-pay",
+  "version": "0.1.0",
+  "description": "CLI for making paid API requests via the Machine Payments Protocol",
+  "type": "module",
+  "bin": {
+    "mpp-pay": "./dist/cli.js"
+  },
+  "files": ["dist"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/raycashxyz/mpp-pay"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@raycashxyz/mpp": "^0.1.1",
+    "mppx": "^0.4.7",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3"
+  }
+}