lightning-toll 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,10 @@
 # ⚡ lightning-toll
 
-**Drop-in Express middleware that puts any API endpoint behind a Lightning paywall.** Consumers pay per request with Bitcoin Lightning — no API keys to manage, no billing system, no Stripe integration. Just `npm install lightning-toll`, wrap your routes, and start earning sats. Implements the [L402 protocol](https://docs.lightning.engineering/the-lightning-network/l402) with proper macaroon credentials.
+**Pay before accessing this endpoint.**
+
+You can't get the data without paying. lightning-toll is the gate — drop-in Express middleware that puts any API behind a Lightning paywall. No API keys to manage, no billing system, no Stripe. Send a request, get a 402 with an invoice, pay it, retry with the preimage, get your data. Implements the [L402 protocol](https://docs.lightning.engineering/the-lightning-network/l402) with proper macaroon credentials.
+
+Part of the constraint chain: [agent-discovery](https://github.com/jeletor/agent-discovery) (find) → [ai-wot](https://github.com/jeletor/ai-wot) (verify) → [lightning-agent](https://github.com/jeletor/lightning-agent) (pay) → **lightning-toll** (gate).
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightning-toll",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Drop-in Express middleware for Lightning-gated API endpoints. L402 protocol, macaroons, auto-pay client — monetize any API with Bitcoin Lightning.",
   "main": "src/index.js",
   "exports": {

package/src/client/index.js

@@ -99,16 +99,26 @@ class TollClient {
 /**
  * Simple one-shot toll fetch.
  *
+ * Supports two calling styles:
+ *   tollFetch(url, { wallet, maxSats, method, body, headers })  — single opts
+ *   tollFetch(url, fetchOpts, { wallet, maxSats })               — separate fetch + pay opts
+ *
  * @param {string} url - URL to fetch
- * @param {object} [opts] - Options
- * @param {string|object} opts.wallet - NWC URL or wallet instance
- * @param {number} [opts.maxSats=50] - Max sats to pay
- * @param {object} [opts.headers] - Additional headers
- * @param {string} [opts.method] - HTTP method
- * @param {*} [opts.body] - Request body
+ * @param {object} [optsOrFetchOpts] - Combined options, or standard fetch options
+ * @param {object} [payOpts] - Pay options (if using 3-arg form)
  * @returns {Promise<Response>}
  */
-async function tollFetch(url, opts = {}) {
+async function tollFetch(url, optsOrFetchOpts = {}, payOpts) {
+  // Support both 2-arg and 3-arg calling styles
+  let opts;
+  if (payOpts && typeof payOpts === 'object') {
+    // 3-arg: tollFetch(url, fetchOpts, payOpts)
+    opts = { ...optsOrFetchOpts, ...payOpts };
+  } else {
+    // 2-arg: tollFetch(url, opts)
+    opts = optsOrFetchOpts;
+  }
+
   if (!opts.wallet) {
     throw new Error('tollFetch: wallet is required');
   }
@@ -125,14 +135,14 @@ async function tollFetch(url, opts = {}) {
   if (opts.body) fetchOpts.body = opts.body;
   if (opts.headers) fetchOpts.headers = opts.headers;
 
-  const payOpts = {
+  const paymentOpts = {
     wallet,
     maxSats: opts.maxSats || 50,
     autoRetry: true,
     headers: opts.headers || {}
   };
 
-  return autoPay(url, fetchOpts, payOpts);
+  return autoPay(url, fetchOpts, paymentOpts);
 }
 
 module.exports = {