@dominusnode/sdk 1.1.2 → 1.2.0

package/README.md

@@ -46,7 +46,7 @@ const proxyUrl = client.proxy.buildUrl('dn_live_your_key', {
   city: 'losangeles',
 });
 console.log(proxyUrl);
-// => http://user-country_US-state_california-city_losangeles:dn_live_your_key@proxy.dominusnode.com:8080
+// => http://user-country-US-state-california-city-losangeles:dn_live_your_key@proxy.dominusnode.com:8080
 ```
 
 ## Authentication
@@ -291,11 +291,11 @@ const geoUrl = client.proxy.buildUrl('dn_live_key', {
   city: 'losangeles',
   sessionId: 'sticky123',
 });
-// => http://user-country_US-state_california-city_losangeles-session_sticky123:dn_live_key@proxy.dominusnode.com:8080
+// => http://user-country-US-state-california-city-losangeles-session-sticky123:dn_live_key@proxy.dominusnode.com:8080
 
 // ASN targeting
 const asnUrl = client.proxy.buildUrl('dn_live_key', { asn: 7922 });
-// => http://user-asn_7922:dn_live_key@proxy.dominusnode.com:8080
+// => http://user-asn-7922:dn_live_key@proxy.dominusnode.com:8080
 
 // Proxy health (no auth required)
 const health = await client.proxy.getHealth();

package/dist/cjs/auth.d.ts

@@ -3,6 +3,7 @@ import type { User, LoginResult, MfaStatus, MfaSetup } from "./types.js";
 export declare class AuthResource {
     private http;
     constructor(http: HttpClient);
+    private solvePoW;
     register(email: string, password: string): Promise<{
         user: User;
         token?: string;

package/dist/cjs/auth.js

@@ -1,13 +1,87 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthResource = void 0;
+const crypto = __importStar(require("node:crypto"));
+const POW_MAX_NONCE = 100_000_000;
+function countLeadingZeroBits(hash) {
+    let count = 0;
+    for (const byte of hash) {
+        if (byte === 0) {
+            count += 8;
+        }
+        else {
+            let mask = 0x80;
+            while (mask && !(byte & mask)) {
+                count += 1;
+                mask >>= 1;
+            }
+            break;
+        }
+    }
+    return count;
+}
 class AuthResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    async solvePoW() {
+        try {
+            const challenge = await this.http.post("/api/auth/pow/challenge", {}, false);
+            const { challengeId, prefix } = challenge;
+            const difficulty = Math.min(challenge.difficulty, 32);
+            for (let nonce = 0; nonce < POW_MAX_NONCE; nonce++) {
+                const hash = crypto.createHash("sha256").update(prefix + nonce).digest();
+                if (countLeadingZeroBits(hash) >= difficulty) {
+                    return { challengeId, nonce };
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
     async register(email, password) {
-        return this.http.post("/api/auth/register", { email, password }, false);
+        const pow = await this.solvePoW();
+        const body = { email, password };
+        if (pow) {
+            body.pow = pow;
+        }
+        return this.http.post("/api/auth/register", body, false);
     }
     async login(email, password) {
         return this.http.post("/api/auth/login", { email, password }, false);

package/dist/cjs/client.d.ts

@@ -11,6 +11,7 @@ import { AgenticWalletResource } from "./resources/agent-wallet.js";
 import { TeamsResource } from "./resources/teams.js";
 import { X402Resource } from "./resources/x402.js";
 import { WalletAuthResource } from "./resources/wallet-auth.js";
+import { MppResource } from "./resources/mpp.js";
 import type { DominusNodeConfig, LoginResult } from "./types.js";
 export declare class DominusNodeClient {
     readonly auth: AuthResource;
@@ -26,6 +27,7 @@ export declare class DominusNodeClient {
     readonly teams: TeamsResource;
     readonly x402: X402Resource;
     readonly walletAuth: WalletAuthResource;
+    readonly mpp: MppResource;
     private tokenManager;
     private http;
     private apiKey;

package/dist/cjs/client.js

@@ -16,6 +16,7 @@ const agent_wallet_js_1 = require("./resources/agent-wallet.js");
 const teams_js_1 = require("./resources/teams.js");
 const x402_js_1 = require("./resources/x402.js");
 const wallet_auth_js_1 = require("./resources/wallet-auth.js");
+const mpp_js_1 = require("./resources/mpp.js");
 const constants_js_1 = require("./constants.js");
 class DominusNodeClient {
     auth;
@@ -31,6 +32,7 @@ class DominusNodeClient {
     teams;
     x402;
     walletAuth;
+    mpp;
     tokenManager;
     http;
     apiKey = null;
@@ -53,6 +55,7 @@ class DominusNodeClient {
         this.teams = new teams_js_1.TeamsResource(this.http);
         this.x402 = new x402_js_1.X402Resource(this.http);
         this.walletAuth = new wallet_auth_js_1.WalletAuthResource(this.http, this.tokenManager);
+        this.mpp = new mpp_js_1.MppResource(this.http);
         // Set refresh function AFTER auth is initialized
         this.tokenManager.setRefreshFunction(async (rt) => {
             const res = await this.auth.refresh(rt);

package/dist/cjs/index.d.ts

@@ -18,10 +18,12 @@ export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export type { AgenticWallet, AgenticWalletTransaction, AgenticWalletListResponse, AgenticWalletFundResponse, AgenticWalletTransactionsResponse, AgenticWalletDeleteResponse, } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
 export type { Team, TeamMember, TeamInvite, TeamListResponse, TeamMembersResponse, TeamInvitesResponse, TeamKeysResponse, TeamKeyCreateResponse, TeamDeleteResponse, TeamFundResponse, TeamTransactionsResponse, } from "./resources/teams.js";
-export { X402Resource } from "./resources/x402.js";
-export type { X402Info, X402Facilitator, X402Pricing, } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
+export type { X402Info, X402Facilitator, X402PaymentHeaders, X402Pricing, X402Scheme, X402Token, } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
 export type { WalletChallenge, WalletVerifyResult, WalletLinkResult, } from "./resources/wallet-auth.js";
+export { MppResource } from "./resources/mpp.js";
+export type { MppInfo, MppPricing, MppLimits, MppTopUpResponse, MppSessionResponse, MppCloseResponse, MppSessionStatus, MppChallengeResponse, MppCredentialPayload, } from "./resources/mpp.js";
 export type { DateRangeOptions as AdminDateRangeOptions, ListUsersResponse, GetUserResponse, RevenueResponse, DailyRevenueEntry, DailyRevenueResponse, } from "./admin.js";
 export { HttpClient } from "./http.js";
 export type { HttpOptions } from "./http.js";

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SOCKS5_PROXY_PORT = exports.DEFAULT_HTTP_PROXY_PORT = exports.DEFAULT_PROXY_HOST = exports.DEFAULT_BASE_URL = exports.USER_AGENT = exports.SDK_VERSION = exports.ProxyError = exports.NetworkError = exports.ServerError = exports.ConflictError = exports.NotFoundError = exports.ValidationError = exports.InsufficientBalanceError = exports.RateLimitError = exports.AuthorizationError = exports.AuthenticationError = exports.DominusNodeError = exports.HttpClient = exports.WalletAuthResource = exports.X402Resource = exports.TeamsResource = exports.AgenticWalletResource = exports.SlotsResource = exports.AdminResource = exports.ProxyResource = exports.SessionsResource = exports.PlansResource = exports.UsageResource = exports.WalletResource = exports.KeysResource = exports.AuthResource = exports.DominusNodeClient = void 0;
+exports.DEFAULT_SOCKS5_PROXY_PORT = exports.DEFAULT_HTTP_PROXY_PORT = exports.DEFAULT_PROXY_HOST = exports.DEFAULT_BASE_URL = exports.USER_AGENT = exports.SDK_VERSION = exports.ProxyError = exports.NetworkError = exports.ServerError = exports.ConflictError = exports.NotFoundError = exports.ValidationError = exports.InsufficientBalanceError = exports.RateLimitError = exports.AuthorizationError = exports.AuthenticationError = exports.DominusNodeError = exports.HttpClient = exports.MppResource = exports.WalletAuthResource = exports.X402_HEADERS = exports.X402_PROTOCOL_VERSION = exports.X402Resource = exports.TeamsResource = exports.AgenticWalletResource = exports.SlotsResource = exports.AdminResource = exports.ProxyResource = exports.SessionsResource = exports.PlansResource = exports.UsageResource = exports.WalletResource = exports.KeysResource = exports.AuthResource = exports.DominusNodeClient = void 0;
 // Main client
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "DominusNodeClient", { enumerable: true, get: function () { return client_js_1.DominusNodeClient; } });
@@ -29,8 +29,12 @@ var teams_js_1 = require("./resources/teams.js");
 Object.defineProperty(exports, "TeamsResource", { enumerable: true, get: function () { return teams_js_1.TeamsResource; } });
 var x402_js_1 = require("./resources/x402.js");
 Object.defineProperty(exports, "X402Resource", { enumerable: true, get: function () { return x402_js_1.X402Resource; } });
+Object.defineProperty(exports, "X402_PROTOCOL_VERSION", { enumerable: true, get: function () { return x402_js_1.X402_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "X402_HEADERS", { enumerable: true, get: function () { return x402_js_1.X402_HEADERS; } });
 var wallet_auth_js_1 = require("./resources/wallet-auth.js");
 Object.defineProperty(exports, "WalletAuthResource", { enumerable: true, get: function () { return wallet_auth_js_1.WalletAuthResource; } });
+var mpp_js_1 = require("./resources/mpp.js");
+Object.defineProperty(exports, "MppResource", { enumerable: true, get: function () { return mpp_js_1.MppResource; } });
 // Infrastructure (HttpClient for advanced custom integrations)
 var http_js_1 = require("./http.js");
 Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_js_1.HttpClient; } });

package/dist/cjs/resources/mpp.d.ts

@@ -0,0 +1,157 @@
+import type { HttpClient } from "../http.js";
+export interface MppInfo {
+    supported: boolean;
+    enabled: boolean;
+    protocol: string;
+    version: string;
+    methods: string[];
+    pricing: MppPricing;
+    limits: MppLimits;
+}
+export interface MppPricing {
+    perGbCents: number;
+    depositMinCents: number;
+    currency: string;
+}
+export interface MppLimits {
+    maxDepositCents: number;
+    maxSessionDurationSeconds: number;
+}
+export interface MppTopUpResponse {
+    success: boolean;
+    amountCents: number;
+    method: string;
+    transactionId: string;
+}
+export interface MppSessionResponse {
+    channelId: string;
+    depositCents: number;
+    method: string;
+    poolType: string;
+    expiresAt: string;
+}
+export interface MppCloseResponse {
+    channelId: string;
+    refundedCents: number;
+    usedCents: number;
+    closed: boolean;
+}
+export interface MppSessionStatus {
+    channelId: string;
+    status: string;
+    depositCents: number;
+    usedCents: number;
+    method: string;
+    poolType: string;
+    createdAt: string;
+    expiresAt: string;
+}
+/**
+ * MPP challenge response returned by POST /api/mpp/challenge.
+ * Used for keyless proxy access -- AI agents can use the proxy
+ * without any API key by solving a challenge and paying per request.
+ */
+export interface MppChallengeResponse {
+    challengeId: string;
+    nonce: string;
+    expiresAt: string;
+    poolType: string;
+    credential: MppCredentialPayload;
+}
+/**
+ * Credential payload for keyless MPP proxy access.
+ * Pass this to `buildProxyHeaders()` to construct the headers
+ * needed to route through the proxy without an API key.
+ */
+export interface MppCredentialPayload {
+    challengeId: string;
+    nonce: string;
+    poolType: string;
+    sessionToken?: string;
+}
+/**
+ * Micropayment Payment Protocol (MPP) resource.
+ *
+ * Provides pay-per-use proxy sessions with real-time micropayment channels.
+ * Supports multiple payment methods: Tempo streaming, Stripe SPT, and Lightning.
+ *
+ * MPP also enables keyless proxy access for AI agents: call `getChallenge()` to
+ * obtain a credential, then use `buildProxyHeaders()` to construct the proxy
+ * Authorization header -- no API key needed.
+ */
+export declare class MppResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get MPP protocol information including supported methods, pricing, and limits.
+     *
+     * This endpoint does not require authentication.
+     */
+    getInfo(): Promise<MppInfo>;
+    /**
+     * Request an MPP challenge for keyless proxy access.
+     *
+     * This endpoint does not require authentication. The returned credential
+     * can be used with `buildProxyHeaders()` to access the proxy without an API key.
+     *
+     * @param poolType - Proxy pool type: "dc" (datacenter, $3/GB) or "residential" ($5/GB)
+     */
+    getChallenge(poolType: "dc" | "residential"): Promise<MppChallengeResponse>;
+    /**
+     * Build proxy Authorization header for keyless MPP access.
+     *
+     * Returns headers that should be set on the HTTP CONNECT / proxy request
+     * to route through the proxy without an API key.
+     *
+     * @param credential - The credential payload from `getChallenge()`
+     * @returns Headers object with `Authorization: MPP <json>`
+     */
+    buildProxyHeaders(credential: MppCredentialPayload): Record<string, string>;
+    /**
+     * Build proxy session token header for ongoing MPP sessions.
+     *
+     * After opening a session, use the session token for subsequent requests
+     * within the same session.
+     *
+     * @param sessionToken - The session token from an active MPP session
+     * @returns Headers object with `MPP-SESSION-TOKEN`
+     */
+    buildSessionHeaders(sessionToken: string): Record<string, string>;
+    /**
+     * Top up MPP balance using the specified payment method.
+     *
+     * Requires authentication (wallet credit needs a user account).
+     *
+     * @param amountCents - Amount to top up in cents (must be > 0 and <= 2,147,483,647)
+     * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
+     */
+    topUp(amountCents: number, method: "tempo" | "stripe_spt" | "lightning"): Promise<MppTopUpResponse>;
+    /**
+     * Open a new micropayment session channel.
+     *
+     * This endpoint does not require authentication -- anonymous agents can
+     * open sessions by providing a payment method and deposit.
+     *
+     * @param opts.maxDepositCents - Maximum deposit for the session in cents
+     * @param opts.method - Payment method identifier
+     * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
+     */
+    openSession(opts: {
+        maxDepositCents: number;
+        method: string;
+        poolType: string;
+    }): Promise<MppSessionResponse>;
+    /**
+     * Close an active micropayment session channel.
+     * Any unused deposit is refunded.
+     *
+     * @param channelId - The channel ID to close
+     */
+    closeSession(channelId: string): Promise<MppCloseResponse>;
+    /**
+     * Get the status of a micropayment session channel.
+     *
+     * @param channelId - The channel ID to query
+     */
+    getSession(channelId: string): Promise<MppSessionStatus>;
+}

package/dist/cjs/resources/mpp.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MppResource = void 0;
+/**
+ * Micropayment Payment Protocol (MPP) resource.
+ *
+ * Provides pay-per-use proxy sessions with real-time micropayment channels.
+ * Supports multiple payment methods: Tempo streaming, Stripe SPT, and Lightning.
+ *
+ * MPP also enables keyless proxy access for AI agents: call `getChallenge()` to
+ * obtain a credential, then use `buildProxyHeaders()` to construct the proxy
+ * Authorization header -- no API key needed.
+ */
+class MppResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get MPP protocol information including supported methods, pricing, and limits.
+     *
+     * This endpoint does not require authentication.
+     */
+    async getInfo() {
+        return this.http.get("/api/mpp/info", false);
+    }
+    /**
+     * Request an MPP challenge for keyless proxy access.
+     *
+     * This endpoint does not require authentication. The returned credential
+     * can be used with `buildProxyHeaders()` to access the proxy without an API key.
+     *
+     * @param poolType - Proxy pool type: "dc" (datacenter, $3/GB) or "residential" ($5/GB)
+     */
+    async getChallenge(poolType) {
+        if (poolType !== "dc" && poolType !== "residential") {
+            throw new Error("poolType must be 'dc' or 'residential'");
+        }
+        return this.http.post("/api/mpp/challenge", { poolType }, false);
+    }
+    /**
+     * Build proxy Authorization header for keyless MPP access.
+     *
+     * Returns headers that should be set on the HTTP CONNECT / proxy request
+     * to route through the proxy without an API key.
+     *
+     * @param credential - The credential payload from `getChallenge()`
+     * @returns Headers object with `Authorization: MPP <json>`
+     */
+    buildProxyHeaders(credential) {
+        return {
+            Authorization: "MPP " + JSON.stringify(credential),
+        };
+    }
+    /**
+     * Build proxy session token header for ongoing MPP sessions.
+     *
+     * After opening a session, use the session token for subsequent requests
+     * within the same session.
+     *
+     * @param sessionToken - The session token from an active MPP session
+     * @returns Headers object with `MPP-SESSION-TOKEN`
+     */
+    buildSessionHeaders(sessionToken) {
+        if (!sessionToken || typeof sessionToken !== "string") {
+            throw new Error("sessionToken must be a non-empty string");
+        }
+        return {
+            "MPP-SESSION-TOKEN": sessionToken,
+        };
+    }
+    /**
+     * Top up MPP balance using the specified payment method.
+     *
+     * Requires authentication (wallet credit needs a user account).
+     *
+     * @param amountCents - Amount to top up in cents (must be > 0 and <= 2,147,483,647)
+     * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
+     */
+    async topUp(amountCents, method) {
+        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/mpp/topup", { amountCents, method });
+    }
+    /**
+     * Open a new micropayment session channel.
+     *
+     * This endpoint does not require authentication -- anonymous agents can
+     * open sessions by providing a payment method and deposit.
+     *
+     * @param opts.maxDepositCents - Maximum deposit for the session in cents
+     * @param opts.method - Payment method identifier
+     * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
+     */
+    async openSession(opts) {
+        if (!Number.isInteger(opts.maxDepositCents) || opts.maxDepositCents <= 0 || opts.maxDepositCents > 2_147_483_647) {
+            throw new Error("maxDepositCents must be a positive integer <= 2,147,483,647");
+        }
+        return this.http.post("/api/mpp/session/open", {
+            maxDepositCents: opts.maxDepositCents,
+            method: opts.method,
+            poolType: opts.poolType,
+        }, false);
+    }
+    /**
+     * Close an active micropayment session channel.
+     * Any unused deposit is refunded.
+     *
+     * @param channelId - The channel ID to close
+     */
+    async closeSession(channelId) {
+        return this.http.post("/api/mpp/session/close", { channelId });
+    }
+    /**
+     * Get the status of a micropayment session channel.
+     *
+     * @param channelId - The channel ID to query
+     */
+    async getSession(channelId) {
+        return this.http.get(`/api/mpp/session/${encodeURIComponent(channelId)}`);
+    }
+}
+exports.MppResource = MppResource;

package/dist/cjs/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/cjs/resources/x402.js

@@ -1,11 +1,45 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.X402Resource = void 0;
+exports.X402Resource = exports.X402_HEADERS = exports.X402_PROTOCOL_VERSION = void 0;
 /**
- * x402 (HTTP 402 Payment Required) protocol information.
+ * x402 V2 protocol version.
+ * V2 uses CAIP-2 network identifiers (e.g. "eip155:8453" instead of "base").
+ */
+exports.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.
+ */
+exports.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
  */
 class X402Resource {
     http;
@@ -13,8 +47,8 @@ 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/auth.d.ts

@@ -3,6 +3,7 @@ import type { User, LoginResult, MfaStatus, MfaSetup } from "./types.js";
 export declare class AuthResource {
     private http;
     constructor(http: HttpClient);
+    private solvePoW;
     register(email: string, password: string): Promise<{
         user: User;
         token?: string;

package/dist/esm/auth.js

@@ -1,10 +1,51 @@
+import * as crypto from "node:crypto";
+const POW_MAX_NONCE = 100_000_000;
+function countLeadingZeroBits(hash) {
+    let count = 0;
+    for (const byte of hash) {
+        if (byte === 0) {
+            count += 8;
+        }
+        else {
+            let mask = 0x80;
+            while (mask && !(byte & mask)) {
+                count += 1;
+                mask >>= 1;
+            }
+            break;
+        }
+    }
+    return count;
+}
 export class AuthResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    async solvePoW() {
+        try {
+            const challenge = await this.http.post("/api/auth/pow/challenge", {}, false);
+            const { challengeId, prefix } = challenge;
+            const difficulty = Math.min(challenge.difficulty, 32);
+            for (let nonce = 0; nonce < POW_MAX_NONCE; nonce++) {
+                const hash = crypto.createHash("sha256").update(prefix + nonce).digest();
+                if (countLeadingZeroBits(hash) >= difficulty) {
+                    return { challengeId, nonce };
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
     async register(email, password) {
-        return this.http.post("/api/auth/register", { email, password }, false);
+        const pow = await this.solvePoW();
+        const body = { email, password };
+        if (pow) {
+            body.pow = pow;
+        }
+        return this.http.post("/api/auth/register", body, false);
     }
     async login(email, password) {
         return this.http.post("/api/auth/login", { email, password }, false);

package/dist/esm/client.d.ts

@@ -11,6 +11,7 @@ import { AgenticWalletResource } from "./resources/agent-wallet.js";
 import { TeamsResource } from "./resources/teams.js";
 import { X402Resource } from "./resources/x402.js";
 import { WalletAuthResource } from "./resources/wallet-auth.js";
+import { MppResource } from "./resources/mpp.js";
 import type { DominusNodeConfig, LoginResult } from "./types.js";
 export declare class DominusNodeClient {
     readonly auth: AuthResource;
@@ -26,6 +27,7 @@ export declare class DominusNodeClient {
     readonly teams: TeamsResource;
     readonly x402: X402Resource;
     readonly walletAuth: WalletAuthResource;
+    readonly mpp: MppResource;
     private tokenManager;
     private http;
     private apiKey;

package/dist/esm/client.js

@@ -13,6 +13,7 @@ import { AgenticWalletResource } from "./resources/agent-wallet.js";
 import { TeamsResource } from "./resources/teams.js";
 import { X402Resource } from "./resources/x402.js";
 import { WalletAuthResource } from "./resources/wallet-auth.js";
+import { MppResource } from "./resources/mpp.js";
 import { DEFAULT_BASE_URL } from "./constants.js";
 export class DominusNodeClient {
     auth;
@@ -28,6 +29,7 @@ export class DominusNodeClient {
     teams;
     x402;
     walletAuth;
+    mpp;
     tokenManager;
     http;
     apiKey = null;
@@ -50,6 +52,7 @@ export class DominusNodeClient {
         this.teams = new TeamsResource(this.http);
         this.x402 = new X402Resource(this.http);
         this.walletAuth = new WalletAuthResource(this.http, this.tokenManager);
+        this.mpp = new MppResource(this.http);
         // Set refresh function AFTER auth is initialized
         this.tokenManager.setRefreshFunction(async (rt) => {
             const res = await this.auth.refresh(rt);

package/dist/esm/index.d.ts

@@ -18,10 +18,12 @@ export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export type { AgenticWallet, AgenticWalletTransaction, AgenticWalletListResponse, AgenticWalletFundResponse, AgenticWalletTransactionsResponse, AgenticWalletDeleteResponse, } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
 export type { Team, TeamMember, TeamInvite, TeamListResponse, TeamMembersResponse, TeamInvitesResponse, TeamKeysResponse, TeamKeyCreateResponse, TeamDeleteResponse, TeamFundResponse, TeamTransactionsResponse, } from "./resources/teams.js";
-export { X402Resource } from "./resources/x402.js";
-export type { X402Info, X402Facilitator, X402Pricing, } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
+export type { X402Info, X402Facilitator, X402PaymentHeaders, X402Pricing, X402Scheme, X402Token, } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
 export type { WalletChallenge, WalletVerifyResult, WalletLinkResult, } from "./resources/wallet-auth.js";
+export { MppResource } from "./resources/mpp.js";
+export type { MppInfo, MppPricing, MppLimits, MppTopUpResponse, MppSessionResponse, MppCloseResponse, MppSessionStatus, MppChallengeResponse, MppCredentialPayload, } from "./resources/mpp.js";
 export type { DateRangeOptions as AdminDateRangeOptions, ListUsersResponse, GetUserResponse, RevenueResponse, DailyRevenueEntry, DailyRevenueResponse, } from "./admin.js";
 export { HttpClient } from "./http.js";
 export type { HttpOptions } from "./http.js";

package/dist/esm/index.js

@@ -12,8 +12,9 @@ export { AdminResource } from "./admin.js";
 export { SlotsResource } from "./slots.js";
 export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
-export { X402Resource } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
+export { MppResource } from "./resources/mpp.js";
 // Infrastructure (HttpClient for advanced custom integrations)
 export { HttpClient } from "./http.js";
 // TokenManager is internal — not exported to prevent misuse of token lifecycle

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

@@ -0,0 +1,157 @@
+import type { HttpClient } from "../http.js";
+export interface MppInfo {
+    supported: boolean;
+    enabled: boolean;
+    protocol: string;
+    version: string;
+    methods: string[];
+    pricing: MppPricing;
+    limits: MppLimits;
+}
+export interface MppPricing {
+    perGbCents: number;
+    depositMinCents: number;
+    currency: string;
+}
+export interface MppLimits {
+    maxDepositCents: number;
+    maxSessionDurationSeconds: number;
+}
+export interface MppTopUpResponse {
+    success: boolean;
+    amountCents: number;
+    method: string;
+    transactionId: string;
+}
+export interface MppSessionResponse {
+    channelId: string;
+    depositCents: number;
+    method: string;
+    poolType: string;
+    expiresAt: string;
+}
+export interface MppCloseResponse {
+    channelId: string;
+    refundedCents: number;
+    usedCents: number;
+    closed: boolean;
+}
+export interface MppSessionStatus {
+    channelId: string;
+    status: string;
+    depositCents: number;
+    usedCents: number;
+    method: string;
+    poolType: string;
+    createdAt: string;
+    expiresAt: string;
+}
+/**
+ * MPP challenge response returned by POST /api/mpp/challenge.
+ * Used for keyless proxy access -- AI agents can use the proxy
+ * without any API key by solving a challenge and paying per request.
+ */
+export interface MppChallengeResponse {
+    challengeId: string;
+    nonce: string;
+    expiresAt: string;
+    poolType: string;
+    credential: MppCredentialPayload;
+}
+/**
+ * Credential payload for keyless MPP proxy access.
+ * Pass this to `buildProxyHeaders()` to construct the headers
+ * needed to route through the proxy without an API key.
+ */
+export interface MppCredentialPayload {
+    challengeId: string;
+    nonce: string;
+    poolType: string;
+    sessionToken?: string;
+}
+/**
+ * Micropayment Payment Protocol (MPP) resource.
+ *
+ * Provides pay-per-use proxy sessions with real-time micropayment channels.
+ * Supports multiple payment methods: Tempo streaming, Stripe SPT, and Lightning.
+ *
+ * MPP also enables keyless proxy access for AI agents: call `getChallenge()` to
+ * obtain a credential, then use `buildProxyHeaders()` to construct the proxy
+ * Authorization header -- no API key needed.
+ */
+export declare class MppResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get MPP protocol information including supported methods, pricing, and limits.
+     *
+     * This endpoint does not require authentication.
+     */
+    getInfo(): Promise<MppInfo>;
+    /**
+     * Request an MPP challenge for keyless proxy access.
+     *
+     * This endpoint does not require authentication. The returned credential
+     * can be used with `buildProxyHeaders()` to access the proxy without an API key.
+     *
+     * @param poolType - Proxy pool type: "dc" (datacenter, $3/GB) or "residential" ($5/GB)
+     */
+    getChallenge(poolType: "dc" | "residential"): Promise<MppChallengeResponse>;
+    /**
+     * Build proxy Authorization header for keyless MPP access.
+     *
+     * Returns headers that should be set on the HTTP CONNECT / proxy request
+     * to route through the proxy without an API key.
+     *
+     * @param credential - The credential payload from `getChallenge()`
+     * @returns Headers object with `Authorization: MPP <json>`
+     */
+    buildProxyHeaders(credential: MppCredentialPayload): Record<string, string>;
+    /**
+     * Build proxy session token header for ongoing MPP sessions.
+     *
+     * After opening a session, use the session token for subsequent requests
+     * within the same session.
+     *
+     * @param sessionToken - The session token from an active MPP session
+     * @returns Headers object with `MPP-SESSION-TOKEN`
+     */
+    buildSessionHeaders(sessionToken: string): Record<string, string>;
+    /**
+     * Top up MPP balance using the specified payment method.
+     *
+     * Requires authentication (wallet credit needs a user account).
+     *
+     * @param amountCents - Amount to top up in cents (must be > 0 and <= 2,147,483,647)
+     * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
+     */
+    topUp(amountCents: number, method: "tempo" | "stripe_spt" | "lightning"): Promise<MppTopUpResponse>;
+    /**
+     * Open a new micropayment session channel.
+     *
+     * This endpoint does not require authentication -- anonymous agents can
+     * open sessions by providing a payment method and deposit.
+     *
+     * @param opts.maxDepositCents - Maximum deposit for the session in cents
+     * @param opts.method - Payment method identifier
+     * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
+     */
+    openSession(opts: {
+        maxDepositCents: number;
+        method: string;
+        poolType: string;
+    }): Promise<MppSessionResponse>;
+    /**
+     * Close an active micropayment session channel.
+     * Any unused deposit is refunded.
+     *
+     * @param channelId - The channel ID to close
+     */
+    closeSession(channelId: string): Promise<MppCloseResponse>;
+    /**
+     * Get the status of a micropayment session channel.
+     *
+     * @param channelId - The channel ID to query
+     */
+    getSession(channelId: string): Promise<MppSessionStatus>;
+}

package/dist/esm/resources/mpp.js

@@ -0,0 +1,120 @@
+/**
+ * Micropayment Payment Protocol (MPP) resource.
+ *
+ * Provides pay-per-use proxy sessions with real-time micropayment channels.
+ * Supports multiple payment methods: Tempo streaming, Stripe SPT, and Lightning.
+ *
+ * MPP also enables keyless proxy access for AI agents: call `getChallenge()` to
+ * obtain a credential, then use `buildProxyHeaders()` to construct the proxy
+ * Authorization header -- no API key needed.
+ */
+export class MppResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get MPP protocol information including supported methods, pricing, and limits.
+     *
+     * This endpoint does not require authentication.
+     */
+    async getInfo() {
+        return this.http.get("/api/mpp/info", false);
+    }
+    /**
+     * Request an MPP challenge for keyless proxy access.
+     *
+     * This endpoint does not require authentication. The returned credential
+     * can be used with `buildProxyHeaders()` to access the proxy without an API key.
+     *
+     * @param poolType - Proxy pool type: "dc" (datacenter, $3/GB) or "residential" ($5/GB)
+     */
+    async getChallenge(poolType) {
+        if (poolType !== "dc" && poolType !== "residential") {
+            throw new Error("poolType must be 'dc' or 'residential'");
+        }
+        return this.http.post("/api/mpp/challenge", { poolType }, false);
+    }
+    /**
+     * Build proxy Authorization header for keyless MPP access.
+     *
+     * Returns headers that should be set on the HTTP CONNECT / proxy request
+     * to route through the proxy without an API key.
+     *
+     * @param credential - The credential payload from `getChallenge()`
+     * @returns Headers object with `Authorization: MPP <json>`
+     */
+    buildProxyHeaders(credential) {
+        return {
+            Authorization: "MPP " + JSON.stringify(credential),
+        };
+    }
+    /**
+     * Build proxy session token header for ongoing MPP sessions.
+     *
+     * After opening a session, use the session token for subsequent requests
+     * within the same session.
+     *
+     * @param sessionToken - The session token from an active MPP session
+     * @returns Headers object with `MPP-SESSION-TOKEN`
+     */
+    buildSessionHeaders(sessionToken) {
+        if (!sessionToken || typeof sessionToken !== "string") {
+            throw new Error("sessionToken must be a non-empty string");
+        }
+        return {
+            "MPP-SESSION-TOKEN": sessionToken,
+        };
+    }
+    /**
+     * Top up MPP balance using the specified payment method.
+     *
+     * Requires authentication (wallet credit needs a user account).
+     *
+     * @param amountCents - Amount to top up in cents (must be > 0 and <= 2,147,483,647)
+     * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
+     */
+    async topUp(amountCents, method) {
+        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/mpp/topup", { amountCents, method });
+    }
+    /**
+     * Open a new micropayment session channel.
+     *
+     * This endpoint does not require authentication -- anonymous agents can
+     * open sessions by providing a payment method and deposit.
+     *
+     * @param opts.maxDepositCents - Maximum deposit for the session in cents
+     * @param opts.method - Payment method identifier
+     * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
+     */
+    async openSession(opts) {
+        if (!Number.isInteger(opts.maxDepositCents) || opts.maxDepositCents <= 0 || opts.maxDepositCents > 2_147_483_647) {
+            throw new Error("maxDepositCents must be a positive integer <= 2,147,483,647");
+        }
+        return this.http.post("/api/mpp/session/open", {
+            maxDepositCents: opts.maxDepositCents,
+            method: opts.method,
+            poolType: opts.poolType,
+        }, false);
+    }
+    /**
+     * Close an active micropayment session channel.
+     * Any unused deposit is refunded.
+     *
+     * @param channelId - The channel ID to close
+     */
+    async closeSession(channelId) {
+        return this.http.post("/api/mpp/session/close", { channelId });
+    }
+    /**
+     * Get the status of a micropayment session channel.
+     *
+     * @param channelId - The channel ID to query
+     */
+    async getSession(channelId) {
+        return this.http.get(`/api/mpp/session/${encodeURIComponent(channelId)}`);
+    }
+}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dominusnode/sdk",
-  "version": "1.1.2",
+  "version": "1.2.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"
   }