aipp-node 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -6,16 +6,22 @@ interface ChargeParams {
     amountSats?: number;
     amountUsd?: number;
     memo?: string;
+    protocol?: 'L402' | 'x402';
 }
 interface ChargeResponse {
-    payment_request: string;
     payment_hash: string;
-    amount_sats: number;
+    protocol: 'L402' | 'x402';
+    amount_usd?: number;
+    pay_to?: string;
+    network?: string;
+    token?: string;
+    payment_request?: string;
+    amount_sats?: number;
 }
 interface ChargeStatus {
+    paid: boolean;
     status: 'pending' | 'settled';
-    payment_hash: string;
-    amount_sats: number;
+    preimage: string | null;
 }
 interface AippErrorResponse {
     error: string;
@@ -24,6 +30,7 @@ interface AippErrorResponse {
 interface PayoutResponse {
     message: string;
     amount_sats?: number;
+    amount_usd?: number;
 }
 
 declare class Aipp {
@@ -32,13 +39,13 @@ declare class Aipp {
     constructor(config: AippConfig);
     private request;
     /**
-     * Creates a new Lightning Invoice
+     * Creates a new Invoice (either L402 or x402)
      */
     createCharge(params: ChargeParams): Promise<ChargeResponse>;
     /**
      * Checks the status of an existing charge
      */
-    getCharge(paymentHash: string): Promise<ChargeStatus>;
+    getCharge(paymentHash: string, txHash?: string): Promise<ChargeStatus>;
     /**
      * Triggers a manual withdrawal of your merchant balance
      */
@@ -54,5 +61,11 @@ interface L402Options {
     expiresInSeconds?: number;
 }
 declare function l402Paywall(options: L402Options): (req: any, res: any, next: any) => Promise<any>;
+interface X402Options {
+    client: Aipp;
+    resourceId: string;
+    amountUsd: number;
+}
+declare function x402Paywall(options: X402Options): (req: any, res: any, next: any) => Promise<any>;
 
-export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type L402Options, type PayoutResponse, l402Paywall };
+export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type L402Options, type PayoutResponse, type X402Options, l402Paywall, x402Paywall };

package/dist/index.d.ts

@@ -6,16 +6,22 @@ interface ChargeParams {
     amountSats?: number;
     amountUsd?: number;
     memo?: string;
+    protocol?: 'L402' | 'x402';
 }
 interface ChargeResponse {
-    payment_request: string;
     payment_hash: string;
-    amount_sats: number;
+    protocol: 'L402' | 'x402';
+    amount_usd?: number;
+    pay_to?: string;
+    network?: string;
+    token?: string;
+    payment_request?: string;
+    amount_sats?: number;
 }
 interface ChargeStatus {
+    paid: boolean;
     status: 'pending' | 'settled';
-    payment_hash: string;
-    amount_sats: number;
+    preimage: string | null;
 }
 interface AippErrorResponse {
     error: string;
@@ -24,6 +30,7 @@ interface AippErrorResponse {
 interface PayoutResponse {
     message: string;
     amount_sats?: number;
+    amount_usd?: number;
 }
 
 declare class Aipp {
@@ -32,13 +39,13 @@ declare class Aipp {
     constructor(config: AippConfig);
     private request;
     /**
-     * Creates a new Lightning Invoice
+     * Creates a new Invoice (either L402 or x402)
      */
     createCharge(params: ChargeParams): Promise<ChargeResponse>;
     /**
      * Checks the status of an existing charge
      */
-    getCharge(paymentHash: string): Promise<ChargeStatus>;
+    getCharge(paymentHash: string, txHash?: string): Promise<ChargeStatus>;
     /**
      * Triggers a manual withdrawal of your merchant balance
      */
@@ -54,5 +61,11 @@ interface L402Options {
     expiresInSeconds?: number;
 }
 declare function l402Paywall(options: L402Options): (req: any, res: any, next: any) => Promise<any>;
+interface X402Options {
+    client: Aipp;
+    resourceId: string;
+    amountUsd: number;
+}
+declare function x402Paywall(options: X402Options): (req: any, res: any, next: any) => Promise<any>;
 
-export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type L402Options, type PayoutResponse, l402Paywall };
+export { Aipp, type AippConfig, type AippErrorResponse, type ChargeParams, type ChargeResponse, type ChargeStatus, type L402Options, type PayoutResponse, type X402Options, l402Paywall, x402Paywall };

package/dist/index.js

@@ -31,7 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Aipp: () => Aipp,
-  l402Paywall: () => l402Paywall
+  l402Paywall: () => l402Paywall,
+  x402Paywall: () => x402Paywall
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -66,7 +67,7 @@ var Aipp = class {
     return response.json();
   }
   /**
-   * Creates a new Lightning Invoice
+   * Creates a new Invoice (either L402 or x402)
    */
   async createCharge(params) {
     if (!params.amountSats && !params.amountUsd) {
@@ -75,6 +76,7 @@ var Aipp = class {
     const body = { memo: params.memo };
     if (params.amountSats) body.amount_sats = params.amountSats;
     if (params.amountUsd) body.amount_usd = params.amountUsd;
+    if (params.protocol) body.protocol = params.protocol;
     return this.request("/invoice/create", {
       method: "POST",
       body: JSON.stringify(body)
@@ -83,11 +85,12 @@ var Aipp = class {
   /**
    * Checks the status of an existing charge
    */
-  async getCharge(paymentHash) {
+  async getCharge(paymentHash, txHash) {
     if (!paymentHash) {
       throw new Error("AIPP: paymentHash is required");
     }
-    return this.request(`/invoice/status/${paymentHash}`, {
+    const query = txHash ? `?tx_hash=${txHash}` : "";
+    return this.request(`/invoice/status/${paymentHash}${query}`, {
       method: "GET"
     });
   }
@@ -196,8 +199,67 @@ function l402Paywall(options) {
     }
   };
 }
+function x402Paywall(options) {
+  return async (req, res, next) => {
+    const authHeader = req.headers.authorization || req.headers.Authorization;
+    let txHash = req.query.tx_hash || req.headers["payment-signature"] || req.headers["x-payment-signature"];
+    let paymentHash = req.query.payment_hash || req.headers["x-payment-hash"];
+    if (!txHash && authHeader && typeof authHeader === "string") {
+      if (authHeader.startsWith("Bearer ")) {
+        txHash = authHeader.substring(7).trim();
+      } else if (authHeader.startsWith("x402 ")) {
+        txHash = authHeader.substring(5).trim();
+      } else if (authHeader.startsWith("L402 ")) {
+        const parts = authHeader.substring(5).split(":");
+        if (parts.length === 2) {
+          paymentHash = parts[0];
+          txHash = parts[1];
+        }
+      }
+    }
+    if (paymentHash && txHash) {
+      try {
+        const chargeStatus = await options.client.getCharge(paymentHash, txHash);
+        if (chargeStatus.status === "settled") {
+          return next();
+        }
+      } catch (e) {
+      }
+    }
+    try {
+      const charge = await options.client.createCharge({
+        amountUsd: options.amountUsd,
+        protocol: "x402",
+        memo: `x402 Payment for ${options.resourceId}`
+      });
+      const challengeObj = {
+        scheme: "exact",
+        network: "base",
+        payTo: charge.pay_to || "",
+        price: options.amountUsd.toFixed(2),
+        token: charge.token || "",
+        payment_hash: charge.payment_hash
+      };
+      const challengeBase64 = Buffer.from(JSON.stringify(challengeObj), "utf8").toString("base64");
+      res.setHeader("PAYMENT-REQUIRED", challengeBase64);
+      res.status(402);
+      res.json({
+        error: "Payment Required",
+        code: "x402",
+        payment_hash: charge.payment_hash,
+        pay_to: challengeObj.payTo,
+        price: challengeObj.price,
+        token: challengeObj.token,
+        network: challengeObj.network
+      });
+    } catch (err) {
+      res.status(500).json({ error: "Failed to generate x402 challenge", details: err.message || err });
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Aipp,
-  l402Paywall
+  l402Paywall,
+  x402Paywall
 });

package/dist/index.mjs

@@ -29,7 +29,7 @@ var Aipp = class {
     return response.json();
   }
   /**
-   * Creates a new Lightning Invoice
+   * Creates a new Invoice (either L402 or x402)
    */
   async createCharge(params) {
     if (!params.amountSats && !params.amountUsd) {
@@ -38,6 +38,7 @@ var Aipp = class {
     const body = { memo: params.memo };
     if (params.amountSats) body.amount_sats = params.amountSats;
     if (params.amountUsd) body.amount_usd = params.amountUsd;
+    if (params.protocol) body.protocol = params.protocol;
     return this.request("/invoice/create", {
       method: "POST",
       body: JSON.stringify(body)
@@ -46,11 +47,12 @@ var Aipp = class {
   /**
    * Checks the status of an existing charge
    */
-  async getCharge(paymentHash) {
+  async getCharge(paymentHash, txHash) {
     if (!paymentHash) {
       throw new Error("AIPP: paymentHash is required");
     }
-    return this.request(`/invoice/status/${paymentHash}`, {
+    const query = txHash ? `?tx_hash=${txHash}` : "";
+    return this.request(`/invoice/status/${paymentHash}${query}`, {
       method: "GET"
     });
   }
@@ -159,7 +161,66 @@ function l402Paywall(options) {
     }
   };
 }
+function x402Paywall(options) {
+  return async (req, res, next) => {
+    const authHeader = req.headers.authorization || req.headers.Authorization;
+    let txHash = req.query.tx_hash || req.headers["payment-signature"] || req.headers["x-payment-signature"];
+    let paymentHash = req.query.payment_hash || req.headers["x-payment-hash"];
+    if (!txHash && authHeader && typeof authHeader === "string") {
+      if (authHeader.startsWith("Bearer ")) {
+        txHash = authHeader.substring(7).trim();
+      } else if (authHeader.startsWith("x402 ")) {
+        txHash = authHeader.substring(5).trim();
+      } else if (authHeader.startsWith("L402 ")) {
+        const parts = authHeader.substring(5).split(":");
+        if (parts.length === 2) {
+          paymentHash = parts[0];
+          txHash = parts[1];
+        }
+      }
+    }
+    if (paymentHash && txHash) {
+      try {
+        const chargeStatus = await options.client.getCharge(paymentHash, txHash);
+        if (chargeStatus.status === "settled") {
+          return next();
+        }
+      } catch (e) {
+      }
+    }
+    try {
+      const charge = await options.client.createCharge({
+        amountUsd: options.amountUsd,
+        protocol: "x402",
+        memo: `x402 Payment for ${options.resourceId}`
+      });
+      const challengeObj = {
+        scheme: "exact",
+        network: "base",
+        payTo: charge.pay_to || "",
+        price: options.amountUsd.toFixed(2),
+        token: charge.token || "",
+        payment_hash: charge.payment_hash
+      };
+      const challengeBase64 = Buffer.from(JSON.stringify(challengeObj), "utf8").toString("base64");
+      res.setHeader("PAYMENT-REQUIRED", challengeBase64);
+      res.status(402);
+      res.json({
+        error: "Payment Required",
+        code: "x402",
+        payment_hash: charge.payment_hash,
+        pay_to: challengeObj.payTo,
+        price: challengeObj.price,
+        token: challengeObj.token,
+        network: challengeObj.network
+      });
+    } catch (err) {
+      res.status(500).json({ error: "Failed to generate x402 challenge", details: err.message || err });
+    }
+  };
+}
 export {
   Aipp,
-  l402Paywall
+  l402Paywall,
+  x402Paywall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aipp-node",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Official Node.js SDK for AIPP - The Lightning Network Split-Payment Gateway",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client.ts

@@ -36,7 +36,7 @@ export class Aipp {
   }
 
   /**
-   * Creates a new Lightning Invoice
+   * Creates a new Invoice (either L402 or x402)
    */
   async createCharge(params: ChargeParams): Promise<ChargeResponse> {
     if (!params.amountSats && !params.amountUsd) {
@@ -46,6 +46,7 @@ export class Aipp {
     const body: any = { memo: params.memo };
     if (params.amountSats) body.amount_sats = params.amountSats;
     if (params.amountUsd) body.amount_usd = params.amountUsd;
+    if (params.protocol) body.protocol = params.protocol;
 
     return this.request<ChargeResponse>('/invoice/create', {
       method: 'POST',
@@ -56,11 +57,12 @@ export class Aipp {
   /**
    * Checks the status of an existing charge
    */
-  async getCharge(paymentHash: string): Promise<ChargeStatus> {
+  async getCharge(paymentHash: string, txHash?: string): Promise<ChargeStatus> {
     if (!paymentHash) {
       throw new Error('AIPP: paymentHash is required');
     }
-    return this.request<ChargeStatus>(`/invoice/status/${paymentHash}`, {
+    const query = txHash ? `?tx_hash=${txHash}` : '';
+    return this.request<ChargeStatus>(`/invoice/status/${paymentHash}${query}`, {
       method: 'GET',
     });
   }

package/src/middleware.ts

@@ -84,3 +84,76 @@ export function l402Paywall(options: L402Options) {
     }
   };
 }
+
+export interface X402Options {
+  client: Aipp;
+  resourceId: string;
+  amountUsd: number;
+}
+
+export function x402Paywall(options: X402Options) {
+  return async (req: any, res: any, next: any) => {
+    const authHeader = req.headers.authorization || req.headers.Authorization;
+    let txHash = (req.query.tx_hash || req.headers['payment-signature'] || req.headers['x-payment-signature']) as string;
+    let paymentHash = (req.query.payment_hash || req.headers['x-payment-hash']) as string;
+
+    if (!txHash && authHeader && typeof authHeader === 'string') {
+      if (authHeader.startsWith('Bearer ')) {
+        txHash = authHeader.substring(7).trim();
+      } else if (authHeader.startsWith('x402 ')) {
+        txHash = authHeader.substring(5).trim();
+      } else if (authHeader.startsWith('L402 ')) {
+        // Fallback or double format check
+        const parts = authHeader.substring(5).split(':');
+        if (parts.length === 2) {
+          paymentHash = parts[0];
+          txHash = parts[1];
+        }
+      }
+    }
+
+    if (paymentHash && txHash) {
+      try {
+        const chargeStatus = await options.client.getCharge(paymentHash, txHash);
+        if (chargeStatus.status === 'settled') {
+          return next();
+        }
+      } catch (e) {
+        // Validation failed, proceed to challenge
+      }
+    }
+
+    try {
+      const charge = await options.client.createCharge({
+        amountUsd: options.amountUsd,
+        protocol: 'x402',
+        memo: `x402 Payment for ${options.resourceId}`
+      });
+
+      const challengeObj = {
+        scheme: 'exact',
+        network: 'base',
+        payTo: charge.pay_to || '',
+        price: options.amountUsd.toFixed(2),
+        token: charge.token || '',
+        payment_hash: charge.payment_hash
+      };
+      
+      const challengeBase64 = Buffer.from(JSON.stringify(challengeObj), 'utf8').toString('base64');
+      res.setHeader('PAYMENT-REQUIRED', challengeBase64);
+
+      res.status(402);
+      res.json({
+        error: "Payment Required",
+        code: "x402",
+        payment_hash: charge.payment_hash,
+        pay_to: challengeObj.payTo,
+        price: challengeObj.price,
+        token: challengeObj.token,
+        network: challengeObj.network
+      });
+    } catch (err: any) {
+      res.status(500).json({ error: "Failed to generate x402 challenge", details: err.message || err });
+    }
+  };
+}

package/src/types.ts

@@ -7,18 +7,24 @@ export interface ChargeParams {
   amountSats?: number;
   amountUsd?: number;
   memo?: string;
+  protocol?: 'L402' | 'x402';
 }
 
 export interface ChargeResponse {
-  payment_request: string;
   payment_hash: string;
-  amount_sats: number;
+  protocol: 'L402' | 'x402';
+  amount_usd?: number;
+  pay_to?: string;
+  network?: string;
+  token?: string;
+  payment_request?: string; // For L402
+  amount_sats?: number; // For L402
 }
 
 export interface ChargeStatus {
+  paid: boolean;
   status: 'pending' | 'settled';
-  payment_hash: string;
-  amount_sats: number;
+  preimage: string | null;
 }
 
 export interface AippErrorResponse {
@@ -29,4 +35,5 @@ export interface AippErrorResponse {
 export interface PayoutResponse {
   message: string;
   amount_sats?: number;
+  amount_usd?: number;
 }