@dominusnode/sdk 1.1.2 → 1.3.0

package/dist/esm/resources/x402.d.ts

@@ -1,37 +1,92 @@
 import type { HttpClient } from "../http.js";
+/**
+ * x402 V2 protocol version.
+ * V2 uses CAIP-2 network identifiers (e.g. "eip155:8453" instead of "base").
+ */
+export declare const X402_PROTOCOL_VERSION = "2";
+/**
+ * x402 V2 header constants.
+ * V2 renamed the payment headers. Servers should accept both old and new
+ * for backward compatibility during the transition period.
+ */
+export declare const X402_HEADERS: {
+    /** V2 payment header (replaces V1 "X-PAYMENT"). */
+    readonly PAYMENT_SIGNATURE: "PAYMENT-SIGNATURE";
+    /** V1 legacy payment header — kept for backward compatibility. */
+    readonly PAYMENT_SIGNATURE_LEGACY: "X-PAYMENT";
+    /** V2 payment response header (replaces V1 "X-PAYMENT-RESPONSE"). */
+    readonly PAYMENT_RESPONSE: "PAYMENT-RESPONSE";
+    /** V1 legacy payment response header. */
+    readonly PAYMENT_RESPONSE_LEGACY: "X-PAYMENT-RESPONSE";
+    /** V2 payment requirements header. */
+    readonly PAYMENT_REQUIRED: "PAYMENT-REQUIRED";
+};
+/** Payment scheme supported by x402. "exact" is the original; "permit2" is new in V2. */
+export type X402Scheme = "exact" | "permit2";
+/** Token supported by x402. V2 adds EURC alongside USDC. */
+export type X402Token = "USDC" | "EURC";
 export interface X402Facilitator {
     address: string;
     chain: string;
+    /** Human-readable network name (e.g. "base", "ethereum"). */
     network: string;
+    /** CAIP-2 network identifier (e.g. "eip155:8453"). Added in V2. */
+    networkId: string;
 }
 export interface X402Pricing {
     perRequestCents: number;
     perGbCents: number;
     currency: string;
 }
+export interface X402PaymentHeaders {
+    /** Header the client sends with the payment signature. */
+    request: string;
+    /** Header the server returns with the payment response. */
+    response: string;
+    /** Header the server uses to indicate payment requirements. */
+    required: string;
+}
 export interface X402Info {
     supported: boolean;
     enabled: boolean;
     protocol: string;
+    /** Protocol version — "2" for x402 V2. */
     version: string;
     facilitators: X402Facilitator[];
     pricing: X402Pricing;
+    /** Supported token symbols (e.g. ["USDC", "EURC"]). */
     currencies: string[];
+    /** Supported payment schemes (e.g. ["exact", "permit2"]). */
+    schemes: string[];
     walletType: string;
     agenticWallets: boolean;
+    /** Header names used by this protocol version. */
+    paymentHeaders: X402PaymentHeaders;
 }
 /**
- * x402 (HTTP 402 Payment Required) protocol information.
+ * x402 V2 (HTTP 402 Payment Required) protocol information.
  *
  * Provides details about x402 micropayment support, facilitator addresses,
- * pricing, and supported chains/currencies for AI agent payments.
+ * pricing, supported chains/currencies, and payment schemes for AI agent
+ * payments.
+ *
+ * V2 changes from V1:
+ * - Protocol version "2" (was "1")
+ * - CAIP-2 network IDs (e.g. "eip155:8453" instead of "base")
+ * - Payment header: PAYMENT-SIGNATURE (was X-PAYMENT)
+ * - Response header: PAYMENT-RESPONSE (was X-PAYMENT-RESPONSE)
+ * - Requirements header: PAYMENT-REQUIRED
+ * - New token: EURC (in addition to USDC)
+ * - New scheme: permit2 (in addition to exact)
+ * - Additional facilitator chains: Ethereum (eip155:1), Optimism (eip155:10),
+ *   Arbitrum (eip155:42161), and Solana
  */
 export declare class X402Resource {
     private http;
     constructor(http: HttpClient);
     /**
-     * Get x402 protocol information including facilitator details,
-     * pricing, supported chains, and currencies.
+     * Get x402 V2 protocol information including facilitator details,
+     * pricing, supported chains, currencies, and payment schemes.
      *
      * This endpoint does not require authentication.
      */

package/dist/esm/resources/x402.js

@@ -1,8 +1,42 @@
 /**
- * x402 (HTTP 402 Payment Required) protocol information.
+ * x402 V2 protocol version.
+ * V2 uses CAIP-2 network identifiers (e.g. "eip155:8453" instead of "base").
+ */
+export const X402_PROTOCOL_VERSION = "2";
+/**
+ * x402 V2 header constants.
+ * V2 renamed the payment headers. Servers should accept both old and new
+ * for backward compatibility during the transition period.
+ */
+export const X402_HEADERS = {
+    /** V2 payment header (replaces V1 "X-PAYMENT"). */
+    PAYMENT_SIGNATURE: "PAYMENT-SIGNATURE",
+    /** V1 legacy payment header — kept for backward compatibility. */
+    PAYMENT_SIGNATURE_LEGACY: "X-PAYMENT",
+    /** V2 payment response header (replaces V1 "X-PAYMENT-RESPONSE"). */
+    PAYMENT_RESPONSE: "PAYMENT-RESPONSE",
+    /** V1 legacy payment response header. */
+    PAYMENT_RESPONSE_LEGACY: "X-PAYMENT-RESPONSE",
+    /** V2 payment requirements header. */
+    PAYMENT_REQUIRED: "PAYMENT-REQUIRED",
+};
+/**
+ * x402 V2 (HTTP 402 Payment Required) protocol information.
  *
  * Provides details about x402 micropayment support, facilitator addresses,
- * pricing, and supported chains/currencies for AI agent payments.
+ * pricing, supported chains/currencies, and payment schemes for AI agent
+ * payments.
+ *
+ * V2 changes from V1:
+ * - Protocol version "2" (was "1")
+ * - CAIP-2 network IDs (e.g. "eip155:8453" instead of "base")
+ * - Payment header: PAYMENT-SIGNATURE (was X-PAYMENT)
+ * - Response header: PAYMENT-RESPONSE (was X-PAYMENT-RESPONSE)
+ * - Requirements header: PAYMENT-REQUIRED
+ * - New token: EURC (in addition to USDC)
+ * - New scheme: permit2 (in addition to exact)
+ * - Additional facilitator chains: Ethereum (eip155:1), Optimism (eip155:10),
+ *   Arbitrum (eip155:42161), and Solana
  */
 export class X402Resource {
     http;
@@ -10,8 +44,8 @@ export class X402Resource {
         this.http = http;
     }
     /**
-     * Get x402 protocol information including facilitator details,
-     * pricing, supported chains, and currencies.
+     * Get x402 V2 protocol information including facilitator details,
+     * pricing, supported chains, currencies, and payment schemes.
      *
      * This endpoint does not require authentication.
      */

package/dist/esm/wallet.js

@@ -19,14 +19,18 @@ export class WalletResource {
     }
     /** Create a Stripe checkout session for wallet top-up. */
     async topUpStripe(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/wallet/topup/stripe", { amountCents });
     }
     /** Create a crypto invoice for wallet top-up. Minimum $10 (1000 cents). */
     async topUpCrypto(amountCents, currency) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 1000) {
@@ -37,7 +41,9 @@ export class WalletResource {
     }
     /** Create a PayPal order for wallet top-up. Minimum $5 (500 cents). */
     async topUpPaypal(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 500) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dominusnode/sdk",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Official Dominus Node SDK for Node.js/TypeScript",
   "author": "Dominus Node",
   "license": "MIT",
@@ -20,6 +20,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "prepare": "npm run build",
     "test": "vitest run",
     "clean": "rm -rf dist"
   },
@@ -27,6 +28,7 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "typescript": "^5.3.0",
     "vitest": "^4.0.0"
   }