@nodana/phoenixd-mpp-sdk 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nodana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,27 @@
+The Lightning charge wire schema in src/Methods.ts is adapted from:
+https://github.com/buildonspark/lightning-mpp-sdk
+Copyright (c) 2026 Lightspark Group, Inc.
+
+The upstream licence follows:
+
+MIT License
+
+Copyright (c) 2026 Lightspark Group, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,148 @@
-# Temporary Holding Version
+# Phoenixd MPP SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Accept or send Lightning payments for API requests using the Machine Payments Protocol (MPP) and a Phoenixd node. This package supplies the Phoenixd payment method for `mppx`; `@nodana/phoenixd-ts` connects it to your node.
+
+Use Node.js 22.12 or later. The package provides TypeScript declarations and ESM and CommonJS exports.
+
+## Install
+
+Install the adapter and its dependencies:
+
+```sh
+npm install @nodana/phoenixd-mpp-sdk @nodana/phoenixd-ts mppx
+```
+
+## Accept payment for a request
+
+Configure `PHOENIXD_URL`, `PHOENIXD_PASSWORD` and `MPP_SECRET_KEY` in your service's environment. Use your node's HTTPS endpoint and set `PHOENIXD_PASSWORD` to its restricted password (`http-password-limited-access`). The receiving adapter only creates and decodes invoices; it does not need permission to send payments. Generate a signing secret with `openssl rand -hex 32` and save it in your service's secret configuration. Keep the same secret across instances and restarts.
+
+```ts
+import { Phoenixd } from "@nodana/phoenixd-ts";
+import { Mppx, phoenixd } from "@nodana/phoenixd-mpp-sdk/server";
+
+const node = new Phoenixd(
+  process.env.PHOENIXD_URL!,
+  process.env.PHOENIXD_PASSWORD!,
+  { timeoutMs: 15_000 },
+);
+const payments = Mppx.create({
+  methods: [phoenixd.charge({ client: node })],
+  secretKey: process.env.MPP_SECRET_KEY!,
+});
+
+export async function handler(request: Request): Promise<Response> {
+  const payment = await payments.charge({
+    amount: "100",
+    description: "Paid API query",
+  })(request);
+
+  if (payment.status === 402) return payment.challenge;
+
+  // Run your query or tool only after payment is accepted.
+  return payment.withReceipt(Response.json({ answer: "Your paid result" }));
+}
+```
+
+Mount the handler at your paid endpoint. `amount: '100'` charges 100 satoshis. An unpaid request receives a payment challenge; a paid request receives your result and a receipt.
+
+## Choose payment storage
+
+The adapter uses in-memory storage by default, suitable for development. For deployed services, use Redis so every server instance shares payment state. The adapter handles the checks; you supply a connected Redis client.
+
+Install the Redis client if your application does not already use it:
+
+```sh
+npm install redis
+```
+
+```ts
+import { createClient } from "redis";
+import { redisStore } from "@nodana/phoenixd-mpp-sdk/server";
+
+const redis = createClient({ url: process.env.REDIS_URL! });
+redis.on("error", () => console.error("Redis connection error"));
+await redis.connect();
+
+const payments = Mppx.create({
+  methods: [phoenixd.charge({ client: node, store: redisStore(redis) })],
+  secretKey: process.env.MPP_SECRET_KEY!,
+});
+```
+
+Reuse your existing connected client if you have one. Use the same persistent Redis service and signing secret across your server instances. Expired payment records are removed automatically.
+
+If several services share Redis, choose a namespace with `redisStore(redis, { keyPrefix: 'my-api' })` and use it consistently across that service's instances.
+
+## Pay for a request
+
+Run the payer in a backend or a trusted Node.js application with its own funded Phoenixd node. Set its `PHOENIXD_PASSWORD` to the full-access password (`http-password`), since paying invoices requires spending permission. `maxAmountSat` is required and limits the invoice amount for each challenge; routing fees are additional.
+
+```ts
+import { Phoenixd } from "@nodana/phoenixd-ts";
+import { Mppx, phoenixd } from "@nodana/phoenixd-mpp-sdk/client";
+
+const node = new Phoenixd(
+  process.env.PHOENIXD_URL!,
+  process.env.PHOENIXD_PASSWORD!,
+  { timeoutMs: 15_000 },
+);
+const payments = Mppx.create({
+  methods: [phoenixd.charge({ client: node, maxAmountSat: 100 })],
+  polyfill: false,
+});
+
+const response = await payments.fetch("https://api.example.com/query");
+if (!response.ok) throw new Error(`API request failed: ${response.status}`);
+console.log(await response.json());
+```
+
+`payments.fetch` pays a supported challenge within the limit and retries the request. Choose a limit appropriate for the API you are calling. Keep Phoenixd credentials in your backend; they allow spending from the node. Use HTTPS for paid endpoints.
+
+## Configure a charge
+
+| Option                 | Server                                                                 | Client                                                         |
+| ---------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `client`               | Configured Phoenixd client for creating and decoding invoices          | Configured client for decoding, paying and looking up payments |
+| `store`                | `redisStore(redis)` for shared state; defaults to process-local memory | —                                                              |
+| `invoiceExpirySeconds` | Invoice lifetime; defaults to 3600 seconds                             | —                                                              |
+| `network`              | Optional expected invoice network                                      | Expected network; defaults to `mainnet`                        |
+| `maxAmountSat`         | —                                                                      | Required maximum invoice amount per challenge                  |
+
+Set the challenge expiry on the handler when needed:
+
+```ts
+const payment = await payments.charge({
+  amount: "100",
+  expires: new Date(Date.now() + 60_000),
+})(request);
+```
+
+The challenge expires no later than its invoice. Use `network: 'regtest'` on both payment methods when testing with regtest nodes.
+
+## Troubleshoot
+
+Probe an endpoint without paying:
+
+```sh
+curl -i https://api.example.com/query
+```
+
+Expect HTTP `402` and a `WWW-Authenticate: Payment` header. Server failures creating invoices or accessing storage must be caught by your application's error handling; respond with a service error and keep the paid result behind the payment check.
+
+Client errors expose a `code` through `PhoenixdPaymentError`, exported from the client entry point:
+
+| Code              | Action                                                                              |
+| ----------------- | ----------------------------------------------------------------------------------- |
+| `amount_limit`    | Check the endpoint's price and your configured limit.                               |
+| `invalid_invoice` | Check the invoice amount, expiry and network. Request a fresh challenge if expired. |
+| `payment_failed`  | Check your node balance and outgoing payment history.                               |
+| `payment_unknown` | Check outgoing payment history before trying again; the payment may have succeeded. |
+
+If a paid request is rejected, check that you retried the same URL, method and body before expiry. A credential authorises one request. Check that all server instances use the same signing secret and storage.
+
+## Reference
+
+- [MPP overview](https://mpp.dev/overview)
+- [mppx SDK](https://mpp.dev/sdk/typescript)
+- [Phoenixd HTTP API](https://phoenix.acinq.co/server/api)
+- [Development and storage integration](docs/development.md)

package/dist/chunk-7BE7G2UI.js

@@ -0,0 +1,45 @@
+// src/shared.ts
+import { createHash } from "crypto";
+function satoshis(amount) {
+  if (!/^[1-9][0-9]*$/.test(amount))
+    throw new TypeError("amount must be a positive integer string in satoshis");
+  const value = Number(amount);
+  if (!Number.isSafeInteger(value * 1e3))
+    throw new TypeError(
+      "amount exceeds the safely representable millisatoshi range"
+    );
+  return value;
+}
+function paymentHash(preimage) {
+  if (!/^[0-9a-f]{64}$/.test(preimage))
+    throw new TypeError("Invalid payment preimage");
+  return createHash("sha256").update(Buffer.from(preimage, "hex")).digest("hex");
+}
+function invoiceDetails(invoice, request, expected) {
+  if (request.currency !== "sat" || invoice.amount !== satoshis(request.amount) * 1e3)
+    throw new TypeError("Invoice amount does not match the requested satoshis");
+  if (!/^[0-9a-f]{64}$/.test(invoice.paymentHash))
+    throw new TypeError("Invoice has an invalid payment hash");
+  const network = invoice.chain;
+  if (network !== "mainnet" && network !== "regtest" && network !== "signet")
+    throw new TypeError("Invoice uses an unsupported Lightning network");
+  if (expected !== void 0 && network !== expected)
+    throw new TypeError(
+      "Invoice network does not match the configured network"
+    );
+  const expiresAt = (invoice.timestampSeconds + (invoice.expirySeconds ?? 3600)) * 1e3;
+  if (!Number.isSafeInteger(expiresAt) || expiresAt <= Date.now())
+    throw new TypeError("Invoice is expired or has an invalid expiry");
+  return { paymentHash: invoice.paymentHash, network, expiresAt };
+}
+async function bodyHash(request) {
+  return createHash("sha256").update(Buffer.from(await request.clone().arrayBuffer())).digest("hex");
+}
+
+export {
+  satoshis,
+  paymentHash,
+  invoiceDetails,
+  bodyHash
+};
+//# sourceMappingURL=chunk-7BE7G2UI.js.map

package/dist/chunk-7BE7G2UI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { DecodedInvoice } from \"@nodana/phoenixd-ts\";\nimport type { ChargeRequest, LightningNetwork } from \"./Methods\";\n\nexport function satoshis(amount: string): number {\n  if (!/^[1-9][0-9]*$/.test(amount))\n    throw new TypeError(\"amount must be a positive integer string in satoshis\");\n\n  const value = Number(amount);\n\n  if (!Number.isSafeInteger(value * 1000))\n    throw new TypeError(\n      \"amount exceeds the safely representable millisatoshi range\",\n    );\n\n  return value;\n}\n\nexport function paymentHash(preimage: string): string {\n  if (!/^[0-9a-f]{64}$/.test(preimage))\n    throw new TypeError(\"Invalid payment preimage\");\n\n  return createHash(\"sha256\")\n    .update(Buffer.from(preimage, \"hex\"))\n    .digest(\"hex\");\n}\n\nexport function invoiceDetails(\n  invoice: DecodedInvoice,\n  request: Pick<ChargeRequest, \"amount\" | \"currency\">,\n  expected?: LightningNetwork,\n): { paymentHash: string; network: LightningNetwork; expiresAt: number } {\n  if (\n    request.currency !== \"sat\" ||\n    invoice.amount !== satoshis(request.amount) * 1000\n  )\n    throw new TypeError(\"Invoice amount does not match the requested satoshis\");\n\n  if (!/^[0-9a-f]{64}$/.test(invoice.paymentHash))\n    throw new TypeError(\"Invoice has an invalid payment hash\");\n\n  const network = invoice.chain;\n\n  if (network !== \"mainnet\" && network !== \"regtest\" && network !== \"signet\")\n    throw new TypeError(\"Invoice uses an unsupported Lightning network\");\n\n  if (expected !== undefined && network !== expected)\n    throw new TypeError(\n      \"Invoice network does not match the configured network\",\n    );\n\n  const expiresAt =\n    (invoice.timestampSeconds + (invoice.expirySeconds ?? 3600)) * 1000;\n\n  if (!Number.isSafeInteger(expiresAt) || expiresAt <= Date.now())\n    throw new TypeError(\"Invoice is expired or has an invalid expiry\");\n\n  return { paymentHash: invoice.paymentHash, network, expiresAt };\n}\n\nexport async function bodyHash(request: Request): Promise<string> {\n  // Clone preserves the body for the application handler.\n  return createHash(\"sha256\")\n    .update(Buffer.from(await request.clone().arrayBuffer()))\n    .digest(\"hex\");\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAIpB,SAAS,SAAS,QAAwB;AAC/C,MAAI,CAAC,gBAAgB,KAAK,MAAM;AAC9B,UAAM,IAAI,UAAU,sDAAsD;AAE5E,QAAM,QAAQ,OAAO,MAAM;AAE3B,MAAI,CAAC,OAAO,cAAc,QAAQ,GAAI;AACpC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAEF,SAAO;AACT;AAEO,SAAS,YAAY,UAA0B;AACpD,MAAI,CAAC,iBAAiB,KAAK,QAAQ;AACjC,UAAM,IAAI,UAAU,0BAA0B;AAEhD,SAAO,WAAW,QAAQ,EACvB,OAAO,OAAO,KAAK,UAAU,KAAK,CAAC,EACnC,OAAO,KAAK;AACjB;AAEO,SAAS,eACd,SACA,SACA,UACuE;AACvE,MACE,QAAQ,aAAa,SACrB,QAAQ,WAAW,SAAS,QAAQ,MAAM,IAAI;AAE9C,UAAM,IAAI,UAAU,sDAAsD;AAE5E,MAAI,CAAC,iBAAiB,KAAK,QAAQ,WAAW;AAC5C,UAAM,IAAI,UAAU,qCAAqC;AAE3D,QAAM,UAAU,QAAQ;AAExB,MAAI,YAAY,aAAa,YAAY,aAAa,YAAY;AAChE,UAAM,IAAI,UAAU,+CAA+C;AAErE,MAAI,aAAa,UAAa,YAAY;AACxC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAEF,QAAM,aACH,QAAQ,oBAAoB,QAAQ,iBAAiB,SAAS;AAEjE,MAAI,CAAC,OAAO,cAAc,SAAS,KAAK,aAAa,KAAK,IAAI;AAC5D,UAAM,IAAI,UAAU,6CAA6C;AAEnE,SAAO,EAAE,aAAa,QAAQ,aAAa,SAAS,UAAU;AAChE;AAEA,eAAsB,SAAS,SAAmC;AAEhE,SAAO,WAAW,QAAQ,EACvB,OAAO,OAAO,KAAK,MAAM,QAAQ,MAAM,EAAE,YAAY,CAAC,CAAC,EACvD,OAAO,KAAK;AACjB;","names":[]}

package/dist/chunk-EQRLZHAJ.js

@@ -0,0 +1,67 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/Methods.ts
+var Methods_exports = {};
+__export(Methods_exports, {
+  charge: () => charge
+});
+import { Method, z } from "mppx";
+var charge = Method.from({
+  name: "lightning",
+  intent: "charge",
+  schema: {
+    credential: {
+      payload: z.object({
+        preimage: z.string().check(z.regex(/^[0-9a-f]{64}$/))
+      })
+    },
+    request: z.object({
+      amount: z.string().check(z.regex(/^[1-9][0-9]*$/)),
+      currency: z.literal("sat"),
+      description: z.optional(z.string()),
+      methodDetails: z.object({
+        invoice: z.string(),
+        paymentHash: z.optional(z.string().check(z.regex(/^[0-9a-f]{64}$/))),
+        network: z.optional(z.enum(["mainnet", "regtest", "signet"]))
+      })
+    })
+  }
+});
+
+// src/errors.ts
+import { Errors } from "mppx";
+var ChargeError = class extends Errors.PaymentError {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    const problem = code === "store_unavailable" || code === "invalid_invoice" ? "internal-payment-error" : code === "invoice_expired" ? "payment-expired" : code === "invalid_preimage" || code === "already_consumed" ? "verification-failed" : "invalid-challenge";
+    this.type = `https://paymentauth.org/problems/${problem}`;
+    this.status = code === "store_unavailable" ? 503 : code === "invalid_invoice" ? 502 : 402;
+  }
+  code;
+  name = "ChargeError";
+  title = "Lightning payment rejected";
+  type;
+  status;
+};
+var PhoenixdPaymentError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+  code;
+  name = "PhoenixdPaymentError";
+};
+
+export {
+  __export,
+  charge,
+  Methods_exports,
+  ChargeError,
+  PhoenixdPaymentError
+};
+//# sourceMappingURL=chunk-EQRLZHAJ.js.map

package/dist/chunk-EQRLZHAJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Methods.ts","../src/errors.ts"],"sourcesContent":["// Lightning wire schema adapted from buildonspark/lightning-mpp-sdk (MIT).\n// Copyright (c) 2026 Lightspark Group, Inc. See NOTICE.\nimport { Method, z } from \"mppx\";\n\nexport const charge = Method.from({\n  name: \"lightning\",\n  intent: \"charge\",\n  schema: {\n    credential: {\n      payload: z.object({\n        preimage: z.string().check(z.regex(/^[0-9a-f]{64}$/)),\n      }),\n    },\n    request: z.object({\n      amount: z.string().check(z.regex(/^[1-9][0-9]*$/)),\n      currency: z.literal(\"sat\"),\n      description: z.optional(z.string()),\n      methodDetails: z.object({\n        invoice: z.string(),\n        paymentHash: z.optional(z.string().check(z.regex(/^[0-9a-f]{64}$/))),\n        network: z.optional(z.enum([\"mainnet\", \"regtest\", \"signet\"])),\n      }),\n    }),\n  },\n});\n\nexport type ChargeRequest = z.output<typeof charge.schema.request>;\n\nexport type LightningNetwork = NonNullable<\n  ChargeRequest[\"methodDetails\"][\"network\"]\n>;\n","import { Errors } from \"mppx\";\n\nexport type ChargeErrorCode =\n  | \"unknown_challenge\"\n  | \"invalid_challenge\"\n  | \"invalid_preimage\"\n  | \"invoice_expired\"\n  | \"already_consumed\"\n  | \"invalid_invoice\"\n  | \"store_unavailable\";\n\nexport class ChargeError extends Errors.PaymentError {\n  readonly name = \"ChargeError\";\n  readonly title = \"Lightning payment rejected\";\n  readonly type: string;\n  override readonly status: number;\n\n  constructor(\n    public readonly code: ChargeErrorCode,\n    message: string,\n  ) {\n    super(message);\n\n    const problem =\n      code === \"store_unavailable\" || code === \"invalid_invoice\"\n        ? \"internal-payment-error\"\n        : code === \"invoice_expired\"\n          ? \"payment-expired\"\n          : code === \"invalid_preimage\" || code === \"already_consumed\"\n            ? \"verification-failed\"\n            : \"invalid-challenge\";\n\n    this.type = `https://paymentauth.org/problems/${problem}`;\n    this.status =\n      code === \"store_unavailable\"\n        ? 503\n        : code === \"invalid_invoice\"\n          ? 502\n          : 402;\n  }\n}\n\nexport type ClientErrorCode =\n  \"invalid_invoice\" | \"amount_limit\" | \"payment_failed\" | \"payment_unknown\";\n\nexport class PhoenixdPaymentError extends Error {\n  readonly name = \"PhoenixdPaymentError\";\n\n  constructor(\n    public readonly code: ClientErrorCode,\n    message: string,\n  ) {\n    super(message);\n  }\n}\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAEA,SAAS,QAAQ,SAAS;AAEnB,IAAM,SAAS,OAAO,KAAK;AAAA,EAChC,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,SAAS,EAAE,OAAO;AAAA,QAChB,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAAA,MACtD,CAAC;AAAA,IACH;AAAA,IACA,SAAS,EAAE,OAAO;AAAA,MAChB,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAAA,MACjD,UAAU,EAAE,QAAQ,KAAK;AAAA,MACzB,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,MAClC,eAAe,EAAE,OAAO;AAAA,QACtB,SAAS,EAAE,OAAO;AAAA,QAClB,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC,CAAC;AAAA,QACnE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,WAAW,QAAQ,CAAC,CAAC;AAAA,MAC9D,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF,CAAC;;;ACxBD,SAAS,cAAc;AAWhB,IAAM,cAAN,cAA0B,OAAO,aAAa;AAAA,EAMnD,YACkB,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAKhB,UAAM,UACJ,SAAS,uBAAuB,SAAS,oBACrC,2BACA,SAAS,oBACP,oBACA,SAAS,sBAAsB,SAAS,qBACtC,wBACA;AAEV,SAAK,OAAO,oCAAoC,OAAO;AACvD,SAAK,SACH,SAAS,sBACL,MACA,SAAS,oBACP,MACA;AAAA,EACV;AAAA,EArBkB;AAAA,EANT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR;AAAA,EACS;AAyBpB;AAKO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAG9C,YACkB,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAAA,EAIlB;AAAA,EAJkB;AAAA,EAHT,OAAO;AAQlB;","names":[]}

package/dist/client/index.cjs

@@ -0,0 +1,244 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  Mppx: () => import_client.Mppx,
+  PhoenixdPaymentError: () => PhoenixdPaymentError,
+  charge: () => charge2,
+  phoenixd: () => methods_exports
+});
+module.exports = __toCommonJS(client_exports);
+var import_client = require("mppx/client");
+
+// src/client/methods.ts
+var methods_exports = {};
+__export(methods_exports, {
+  charge: () => charge2
+});
+
+// src/client/charge.ts
+var import_mppx3 = require("mppx");
+
+// src/Methods.ts
+var import_mppx = require("mppx");
+var charge = import_mppx.Method.from({
+  name: "lightning",
+  intent: "charge",
+  schema: {
+    credential: {
+      payload: import_mppx.z.object({
+        preimage: import_mppx.z.string().check(import_mppx.z.regex(/^[0-9a-f]{64}$/))
+      })
+    },
+    request: import_mppx.z.object({
+      amount: import_mppx.z.string().check(import_mppx.z.regex(/^[1-9][0-9]*$/)),
+      currency: import_mppx.z.literal("sat"),
+      description: import_mppx.z.optional(import_mppx.z.string()),
+      methodDetails: import_mppx.z.object({
+        invoice: import_mppx.z.string(),
+        paymentHash: import_mppx.z.optional(import_mppx.z.string().check(import_mppx.z.regex(/^[0-9a-f]{64}$/))),
+        network: import_mppx.z.optional(import_mppx.z.enum(["mainnet", "regtest", "signet"]))
+      })
+    })
+  }
+});
+
+// src/errors.ts
+var import_mppx2 = require("mppx");
+var ChargeError = class extends import_mppx2.Errors.PaymentError {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    const problem = code === "store_unavailable" || code === "invalid_invoice" ? "internal-payment-error" : code === "invoice_expired" ? "payment-expired" : code === "invalid_preimage" || code === "already_consumed" ? "verification-failed" : "invalid-challenge";
+    this.type = `https://paymentauth.org/problems/${problem}`;
+    this.status = code === "store_unavailable" ? 503 : code === "invalid_invoice" ? 502 : 402;
+  }
+  code;
+  name = "ChargeError";
+  title = "Lightning payment rejected";
+  type;
+  status;
+};
+var PhoenixdPaymentError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+  code;
+  name = "PhoenixdPaymentError";
+};
+
+// src/shared.ts
+var import_node_crypto = require("crypto");
+function satoshis(amount) {
+  if (!/^[1-9][0-9]*$/.test(amount))
+    throw new TypeError("amount must be a positive integer string in satoshis");
+  const value = Number(amount);
+  if (!Number.isSafeInteger(value * 1e3))
+    throw new TypeError(
+      "amount exceeds the safely representable millisatoshi range"
+    );
+  return value;
+}
+function paymentHash(preimage) {
+  if (!/^[0-9a-f]{64}$/.test(preimage))
+    throw new TypeError("Invalid payment preimage");
+  return (0, import_node_crypto.createHash)("sha256").update(Buffer.from(preimage, "hex")).digest("hex");
+}
+function invoiceDetails(invoice, request, expected) {
+  if (request.currency !== "sat" || invoice.amount !== satoshis(request.amount) * 1e3)
+    throw new TypeError("Invoice amount does not match the requested satoshis");
+  if (!/^[0-9a-f]{64}$/.test(invoice.paymentHash))
+    throw new TypeError("Invoice has an invalid payment hash");
+  const network = invoice.chain;
+  if (network !== "mainnet" && network !== "regtest" && network !== "signet")
+    throw new TypeError("Invoice uses an unsupported Lightning network");
+  if (expected !== void 0 && network !== expected)
+    throw new TypeError(
+      "Invoice network does not match the configured network"
+    );
+  const expiresAt = (invoice.timestampSeconds + (invoice.expirySeconds ?? 3600)) * 1e3;
+  if (!Number.isSafeInteger(expiresAt) || expiresAt <= Date.now())
+    throw new TypeError("Invoice is expired or has an invalid expiry");
+  return { paymentHash: invoice.paymentHash, network, expiresAt };
+}
+
+// src/client/charge.ts
+function charge2({
+  client,
+  maxAmountSat,
+  network = "mainnet"
+}) {
+  if (!Number.isSafeInteger(maxAmountSat) || maxAmountSat < 1)
+    throw new TypeError("maxAmountSat must be a positive integer");
+  const pending = /* @__PURE__ */ new Map();
+  const verifiedProof = (preimage, hash) => {
+    let actual;
+    try {
+      actual = paymentHash(preimage);
+    } catch {
+      throw new PhoenixdPaymentError(
+        "payment_unknown",
+        "Phoenixd returned an invalid payment proof"
+      );
+    }
+    if (actual !== hash)
+      throw new PhoenixdPaymentError(
+        "payment_unknown",
+        "Phoenixd returned a payment proof that does not match the invoice"
+      );
+    return preimage;
+  };
+  async function pay(invoice, hash) {
+    const existing = await client.getOutgoingPaymentByHash(hash);
+    if (existing?.isPaid) {
+      if (!existing.preimage)
+        throw new PhoenixdPaymentError(
+          "payment_unknown",
+          "The invoice is paid but its proof is unavailable; check outgoing payment history"
+        );
+      return verifiedProof(existing.preimage, hash);
+    }
+    if (existing && existing.completedAt == null)
+      throw new PhoenixdPaymentError(
+        "payment_unknown",
+        "A payment for this invoice is already pending; check outgoing payment history"
+      );
+    let result;
+    try {
+      result = await client.payInvoice({ invoice });
+    } catch {
+      try {
+        const payment = await client.getOutgoingPaymentByHash(hash);
+        if (payment?.isPaid && payment.preimage)
+          return verifiedProof(payment.preimage, hash);
+      } catch {
+      }
+      throw new PhoenixdPaymentError(
+        "payment_unknown",
+        "The payment outcome is unknown; check outgoing payment history before retrying"
+      );
+    }
+    if (result.type === "payment_failed")
+      throw new PhoenixdPaymentError(
+        "payment_failed",
+        "Phoenixd rejected the payment"
+      );
+    if (result.paymentHash !== hash)
+      throw new PhoenixdPaymentError(
+        "payment_unknown",
+        "Phoenixd returned a different payment hash"
+      );
+    return verifiedProof(result.paymentPreimage, hash);
+  }
+  return import_mppx3.Method.toClient(charge, {
+    async createCredential({ challenge }) {
+      const request = charge.schema.request.parse(challenge.request);
+      let details;
+      try {
+        details = invoiceDetails(
+          await client.decodeInvoice({
+            invoice: request.methodDetails.invoice
+          }),
+          request,
+          network
+        );
+        if (request.methodDetails.paymentHash !== void 0 && request.methodDetails.paymentHash !== details.paymentHash)
+          throw new TypeError("Challenge payment hash does not match invoice");
+        if (request.methodDetails.network !== void 0 && request.methodDetails.network !== details.network)
+          throw new TypeError("Challenge network does not match invoice");
+        if (challenge.expires !== void 0 && Date.parse(challenge.expires) <= Date.now())
+          throw new TypeError("The challenge is expired");
+      } catch {
+        throw new PhoenixdPaymentError(
+          "invalid_invoice",
+          "The challenge contains an invalid, expired or mismatched invoice"
+        );
+      }
+      if (Number(request.amount) > maxAmountSat)
+        throw new PhoenixdPaymentError(
+          "amount_limit",
+          "The requested payment exceeds maxAmountSat"
+        );
+      let promise = pending.get(details.paymentHash);
+      if (!promise) {
+        promise = pay(request.methodDetails.invoice, details.paymentHash);
+        pending.set(details.paymentHash, promise);
+      }
+      let preimage;
+      try {
+        preimage = await promise;
+      } finally {
+        if (pending.get(details.paymentHash) === promise)
+          pending.delete(details.paymentHash);
+      }
+      return import_mppx3.Credential.serialize({ challenge, payload: { preimage } });
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Mppx,
+  PhoenixdPaymentError,
+  charge,
+  phoenixd
+});
+//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/methods.ts","../../src/client/charge.ts","../../src/Methods.ts","../../src/errors.ts","../../src/shared.ts"],"sourcesContent":["export { Mppx } from \"mppx/client\";\nexport * as phoenixd from \"./methods\";\nexport { charge } from \"./charge\";\nexport type { ChargeOptions, ClientChargeMethod } from \"./charge\";\nexport { PhoenixdPaymentError } from \"../errors\";\n","export { charge } from \"./charge\";\n","import { Credential, Method } from \"mppx\";\nimport type { PhoenixdClient, PaymentResult } from \"@nodana/phoenixd-ts\";\nimport * as Methods from \"../Methods\";\nimport { PhoenixdPaymentError } from \"../errors\";\nimport { invoiceDetails, paymentHash } from \"../shared\";\n\nexport interface ChargeOptions {\n  client: Pick<\n    PhoenixdClient,\n    \"decodeInvoice\" | \"payInvoice\" | \"getOutgoingPaymentByHash\"\n  >;\n  /** Maximum payment amount per challenge, in satoshis. */\n  maxAmountSat: number;\n  /** Expected invoice network. Defaults to mainnet. */\n  network?: Methods.LightningNetwork;\n}\n\nexport type ClientChargeMethod = Method.Client<typeof Methods.charge>;\n\nexport function charge({\n  client,\n  maxAmountSat,\n  network = \"mainnet\",\n}: ChargeOptions): ClientChargeMethod {\n  if (!Number.isSafeInteger(maxAmountSat) || maxAmountSat < 1)\n    throw new TypeError(\"maxAmountSat must be a positive integer\");\n\n  const pending = new Map<string, Promise<string>>();\n\n  const verifiedProof = (preimage: string, hash: string) => {\n    let actual: string;\n\n    try {\n      actual = paymentHash(preimage);\n    } catch {\n      throw new PhoenixdPaymentError(\n        \"payment_unknown\",\n        \"Phoenixd returned an invalid payment proof\",\n      );\n    }\n\n    if (actual !== hash)\n      throw new PhoenixdPaymentError(\n        \"payment_unknown\",\n        \"Phoenixd returned a payment proof that does not match the invoice\",\n      );\n\n    return preimage;\n  };\n\n  async function pay(invoice: string, hash: string): Promise<string> {\n    // Check history before sending, including after a previous uncertain result.\n    const existing = await client.getOutgoingPaymentByHash(hash);\n\n    if (existing?.isPaid) {\n      if (!existing.preimage)\n        throw new PhoenixdPaymentError(\n          \"payment_unknown\",\n          \"The invoice is paid but its proof is unavailable; check outgoing payment history\",\n        );\n\n      return verifiedProof(existing.preimage, hash);\n    }\n\n    if (existing && existing.completedAt == null)\n      throw new PhoenixdPaymentError(\n        \"payment_unknown\",\n        \"A payment for this invoice is already pending; check outgoing payment history\",\n      );\n\n    let result: PaymentResult;\n\n    try {\n      result = await client.payInvoice({ invoice });\n    } catch {\n      try {\n        const payment = await client.getOutgoingPaymentByHash(hash);\n\n        if (payment?.isPaid && payment.preimage)\n          return verifiedProof(payment.preimage, hash);\n      } catch {\n        /* The payment outcome remains unknown. */\n      }\n\n      throw new PhoenixdPaymentError(\n        \"payment_unknown\",\n        \"The payment outcome is unknown; check outgoing payment history before retrying\",\n      );\n    }\n\n    if (result.type === \"payment_failed\")\n      throw new PhoenixdPaymentError(\n        \"payment_failed\",\n        \"Phoenixd rejected the payment\",\n      );\n\n    if (result.paymentHash !== hash)\n      throw new PhoenixdPaymentError(\n        \"payment_unknown\",\n        \"Phoenixd returned a different payment hash\",\n      );\n\n    return verifiedProof(result.paymentPreimage, hash);\n  }\n\n  return Method.toClient(Methods.charge, {\n    async createCredential({ challenge }) {\n      const request = Methods.charge.schema.request.parse(challenge.request);\n      let details: ReturnType<typeof invoiceDetails>;\n\n      try {\n        details = invoiceDetails(\n          await client.decodeInvoice({\n            invoice: request.methodDetails.invoice,\n          }),\n          request,\n          network,\n        );\n\n        if (\n          request.methodDetails.paymentHash !== undefined &&\n          request.methodDetails.paymentHash !== details.paymentHash\n        )\n          throw new TypeError(\"Challenge payment hash does not match invoice\");\n\n        if (\n          request.methodDetails.network !== undefined &&\n          request.methodDetails.network !== details.network\n        )\n          throw new TypeError(\"Challenge network does not match invoice\");\n\n        if (\n          challenge.expires !== undefined &&\n          Date.parse(challenge.expires) <= Date.now()\n        )\n          throw new TypeError(\"The challenge is expired\");\n      } catch {\n        throw new PhoenixdPaymentError(\n          \"invalid_invoice\",\n          \"The challenge contains an invalid, expired or mismatched invoice\",\n        );\n      }\n\n      if (Number(request.amount) > maxAmountSat)\n        throw new PhoenixdPaymentError(\n          \"amount_limit\",\n          \"The requested payment exceeds maxAmountSat\",\n        );\n\n      let promise = pending.get(details.paymentHash);\n\n      if (!promise) {\n        promise = pay(request.methodDetails.invoice, details.paymentHash);\n        pending.set(details.paymentHash, promise);\n      }\n\n      let preimage: string;\n\n      try {\n        preimage = await promise;\n      } finally {\n        if (pending.get(details.paymentHash) === promise)\n          pending.delete(details.paymentHash);\n      }\n\n      return Credential.serialize({ challenge, payload: { preimage } });\n    },\n  });\n}\n","// Lightning wire schema adapted from buildonspark/lightning-mpp-sdk (MIT).\n// Copyright (c) 2026 Lightspark Group, Inc. See NOTICE.\nimport { Method, z } from \"mppx\";\n\nexport const charge = Method.from({\n  name: \"lightning\",\n  intent: \"charge\",\n  schema: {\n    credential: {\n      payload: z.object({\n        preimage: z.string().check(z.regex(/^[0-9a-f]{64}$/)),\n      }),\n    },\n    request: z.object({\n      amount: z.string().check(z.regex(/^[1-9][0-9]*$/)),\n      currency: z.literal(\"sat\"),\n      description: z.optional(z.string()),\n      methodDetails: z.object({\n        invoice: z.string(),\n        paymentHash: z.optional(z.string().check(z.regex(/^[0-9a-f]{64}$/))),\n        network: z.optional(z.enum([\"mainnet\", \"regtest\", \"signet\"])),\n      }),\n    }),\n  },\n});\n\nexport type ChargeRequest = z.output<typeof charge.schema.request>;\n\nexport type LightningNetwork = NonNullable<\n  ChargeRequest[\"methodDetails\"][\"network\"]\n>;\n","import { Errors } from \"mppx\";\n\nexport type ChargeErrorCode =\n  | \"unknown_challenge\"\n  | \"invalid_challenge\"\n  | \"invalid_preimage\"\n  | \"invoice_expired\"\n  | \"already_consumed\"\n  | \"invalid_invoice\"\n  | \"store_unavailable\";\n\nexport class ChargeError extends Errors.PaymentError {\n  readonly name = \"ChargeError\";\n  readonly title = \"Lightning payment rejected\";\n  readonly type: string;\n  override readonly status: number;\n\n  constructor(\n    public readonly code: ChargeErrorCode,\n    message: string,\n  ) {\n    super(message);\n\n    const problem =\n      code === \"store_unavailable\" || code === \"invalid_invoice\"\n        ? \"internal-payment-error\"\n        : code === \"invoice_expired\"\n          ? \"payment-expired\"\n          : code === \"invalid_preimage\" || code === \"already_consumed\"\n            ? \"verification-failed\"\n            : \"invalid-challenge\";\n\n    this.type = `https://paymentauth.org/problems/${problem}`;\n    this.status =\n      code === \"store_unavailable\"\n        ? 503\n        : code === \"invalid_invoice\"\n          ? 502\n          : 402;\n  }\n}\n\nexport type ClientErrorCode =\n  \"invalid_invoice\" | \"amount_limit\" | \"payment_failed\" | \"payment_unknown\";\n\nexport class PhoenixdPaymentError extends Error {\n  readonly name = \"PhoenixdPaymentError\";\n\n  constructor(\n    public readonly code: ClientErrorCode,\n    message: string,\n  ) {\n    super(message);\n  }\n}\n","import { createHash } from \"node:crypto\";\nimport type { DecodedInvoice } from \"@nodana/phoenixd-ts\";\nimport type { ChargeRequest, LightningNetwork } from \"./Methods\";\n\nexport function satoshis(amount: string): number {\n  if (!/^[1-9][0-9]*$/.test(amount))\n    throw new TypeError(\"amount must be a positive integer string in satoshis\");\n\n  const value = Number(amount);\n\n  if (!Number.isSafeInteger(value * 1000))\n    throw new TypeError(\n      \"amount exceeds the safely representable millisatoshi range\",\n    );\n\n  return value;\n}\n\nexport function paymentHash(preimage: string): string {\n  if (!/^[0-9a-f]{64}$/.test(preimage))\n    throw new TypeError(\"Invalid payment preimage\");\n\n  return createHash(\"sha256\")\n    .update(Buffer.from(preimage, \"hex\"))\n    .digest(\"hex\");\n}\n\nexport function invoiceDetails(\n  invoice: DecodedInvoice,\n  request: Pick<ChargeRequest, \"amount\" | \"currency\">,\n  expected?: LightningNetwork,\n): { paymentHash: string; network: LightningNetwork; expiresAt: number } {\n  if (\n    request.currency !== \"sat\" ||\n    invoice.amount !== satoshis(request.amount) * 1000\n  )\n    throw new TypeError(\"Invoice amount does not match the requested satoshis\");\n\n  if (!/^[0-9a-f]{64}$/.test(invoice.paymentHash))\n    throw new TypeError(\"Invoice has an invalid payment hash\");\n\n  const network = invoice.chain;\n\n  if (network !== \"mainnet\" && network !== \"regtest\" && network !== \"signet\")\n    throw new TypeError(\"Invoice uses an unsupported Lightning network\");\n\n  if (expected !== undefined && network !== expected)\n    throw new TypeError(\n      \"Invoice network does not match the configured network\",\n    );\n\n  const expiresAt =\n    (invoice.timestampSeconds + (invoice.expirySeconds ?? 3600)) * 1000;\n\n  if (!Number.isSafeInteger(expiresAt) || expiresAt <= Date.now())\n    throw new TypeError(\"Invoice is expired or has an invalid expiry\");\n\n  return { paymentHash: invoice.paymentHash, network, expiresAt };\n}\n\nexport async function bodyHash(request: Request): Promise<string> {\n  // Clone preserves the body for the application handler.\n  return createHash(\"sha256\")\n    .update(Buffer.from(await request.clone().arrayBuffer()))\n    .digest(\"hex\");\n}\n"],"mappings":"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","names":["charge","charge","import_mppx","import_mppx","charge"]}

package/dist/client/index.d.cts

@@ -0,0 +1,22 @@
+export { Mppx } from 'mppx/client';
+import { Method } from 'mppx';
+import { PhoenixdClient } from '@nodana/phoenixd-ts';
+import { L as LightningNetwork, c as charge$1 } from '../index-3V4vmG3I.cjs';
+export { P as PhoenixdPaymentError } from '../index-3V4vmG3I.cjs';
+
+interface ChargeOptions {
+    client: Pick<PhoenixdClient, "decodeInvoice" | "payInvoice" | "getOutgoingPaymentByHash">;
+    /** Maximum payment amount per challenge, in satoshis. */
+    maxAmountSat: number;
+    /** Expected invoice network. Defaults to mainnet. */
+    network?: LightningNetwork;
+}
+type ClientChargeMethod = Method.Client<typeof charge$1>;
+declare function charge({ client, maxAmountSat, network, }: ChargeOptions): ClientChargeMethod;
+
+declare const methods_charge: typeof charge;
+declare namespace methods {
+  export { methods_charge as charge };
+}
+
+export { type ChargeOptions, type ClientChargeMethod, charge, methods as phoenixd };

package/dist/client/index.d.ts

@@ -0,0 +1,22 @@
+export { Mppx } from 'mppx/client';
+import { Method } from 'mppx';
+import { PhoenixdClient } from '@nodana/phoenixd-ts';
+import { L as LightningNetwork, c as charge$1 } from '../index-3V4vmG3I.js';
+export { P as PhoenixdPaymentError } from '../index-3V4vmG3I.js';
+
+interface ChargeOptions {
+    client: Pick<PhoenixdClient, "decodeInvoice" | "payInvoice" | "getOutgoingPaymentByHash">;
+    /** Maximum payment amount per challenge, in satoshis. */
+    maxAmountSat: number;
+    /** Expected invoice network. Defaults to mainnet. */
+    network?: LightningNetwork;
+}
+type ClientChargeMethod = Method.Client<typeof charge$1>;
+declare function charge({ client, maxAmountSat, network, }: ChargeOptions): ClientChargeMethod;
+
+declare const methods_charge: typeof charge;
+declare namespace methods {
+  export { methods_charge as charge };
+}
+
+export { type ChargeOptions, type ClientChargeMethod, charge, methods as phoenixd };