aptos-x402 1.0.0

package/dist/x402-axios.js

@@ -0,0 +1,310 @@
+/**
+ * x402-axios for Aptos
+ *
+ * Axios-compatible wrapper with x402 payment support
+ *
+ * Usage:
+ * ```typescript
+ * import { x402axios } from '@adipundir/aptos-x402';
+ *
+ * // Works exactly like axios
+ * const response = await x402axios.get('https://api.example.com/data');
+ *
+ * // With x402 payment support
+ * const response = await x402axios.get('https://api.example.com/protected/data', {
+ *   privateKey: '0x...'
+ * });
+ *
+ * console.log(response.data);
+ * ```
+ */
+import { Account, Aptos, AptosConfig, Network, Ed25519PrivateKey, } from "@aptos-labs/ts-sdk";
+/**
+ * Decode X-Payment-Response header
+ */
+export function decodeXPaymentResponse(header) {
+    if (!header)
+        return null;
+    try {
+        return JSON.parse(Buffer.from(header, 'base64').toString('utf-8'));
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Build URL with baseURL and params
+ */
+function buildURL(config) {
+    let url = config.url || '';
+    if (config.baseURL) {
+        url = config.baseURL.replace(/\/$/, '') + '/' + url.replace(/^\//, '');
+    }
+    if (config.params) {
+        const searchParams = new URLSearchParams();
+        Object.entries(config.params).forEach(([key, value]) => {
+            if (value !== null && value !== undefined) {
+                searchParams.append(key, String(value));
+            }
+        });
+        const queryString = searchParams.toString();
+        if (queryString) {
+            url += (url.includes('?') ? '&' : '?') + queryString;
+        }
+    }
+    return url;
+}
+/**
+ * Transform request data based on config
+ */
+function transformRequestData(data, config) {
+    if (!data)
+        return data;
+    if (config.transformRequest && config.transformRequest.length > 0) {
+        return config.transformRequest.reduce((acc, transformer) => {
+            return transformer(acc, config.headers);
+        }, data);
+    }
+    // Default transformation
+    if (typeof data === 'object' && !(data instanceof FormData) && !(data instanceof Blob)) {
+        return JSON.stringify(data);
+    }
+    return data;
+}
+/**
+ * Transform response data based on config
+ */
+function transformResponseData(data, config) {
+    if (config.transformResponse && config.transformResponse.length > 0) {
+        return config.transformResponse.reduce((acc, transformer) => {
+            return transformer(acc);
+        }, data);
+    }
+    return data;
+}
+/**
+ * Main x402-axios function - works exactly like axios
+ */
+async function x402axiosMain(configOrUrl, config) {
+    // Handle both axios-style calls: axios(url) and axios(url, config)
+    const finalConfig = typeof configOrUrl === 'string'
+        ? { ...config, url: configOrUrl }
+        : configOrUrl;
+    const { privateKey, account, method = 'GET', data, headers = {}, timeout, validateStatus = (status) => status >= 200 && status < 300, responseType = 'json', ...otherConfig } = finalConfig;
+    const url = buildURL(finalConfig);
+    console.log('[x402-axios] Making request to:', url);
+    // Step 1: Make initial request (no payment)
+    const init = {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+            ...headers,
+        },
+        ...otherConfig,
+    };
+    // Add body for methods that support it
+    if (data && (method === 'POST' || method === 'PUT' || method === 'PATCH')) {
+        init.body = transformRequestData(data, finalConfig);
+    }
+    // Add timeout if specified
+    if (timeout) {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), timeout);
+        init.signal = controller.signal;
+    }
+    let response = await fetch(url, init);
+    // Handle response based on responseType
+    let responseData;
+    if (responseType === 'json') {
+        responseData = await response.json();
+    }
+    else if (responseType === 'text') {
+        responseData = await response.text();
+    }
+    else if (responseType === 'blob') {
+        responseData = await response.blob();
+    }
+    else if (responseType === 'arraybuffer') {
+        responseData = await response.arrayBuffer();
+    }
+    else {
+        responseData = await response.text();
+    }
+    console.log(`[x402-axios] Initial response: ${response.status}`);
+    // If not 402, return immediately (no payment required)
+    if (response.status !== 402) {
+        console.log('[x402-axios] No payment required');
+        const transformedData = transformResponseData(responseData, finalConfig);
+        return {
+            data: transformedData,
+            status: response.status,
+            statusText: response.statusText,
+            headers: Object.fromEntries(response.headers.entries()),
+            config: finalConfig,
+        };
+    }
+    console.log('[x402-axios] Received 402 Payment Required');
+    // Step 2: Extract payment requirements from 402 response
+    const paymentReqs = responseData.accepts?.[0] || responseData;
+    const recipient = paymentReqs.payTo || paymentReqs.paymentAddress;
+    const amount = paymentReqs.maxAmountRequired || paymentReqs.price;
+    const networkId = paymentReqs.network;
+    if (!networkId) {
+        throw new Error('Network not specified in 402 payment requirements');
+    }
+    const scheme = paymentReqs.scheme || 'exact';
+    if (!recipient || !amount) {
+        throw new Error('Invalid 402 response: missing payment requirements');
+    }
+    console.log('[x402-axios] Payment requirements:', {
+        scheme,
+        network: networkId,
+        amount: `${amount} Octas`,
+        recipient: recipient.slice(0, 10) + '...',
+    });
+    // Step 3: Determine network from 402 response
+    const networkMap = {
+        'aptos-testnet': Network.TESTNET,
+        'aptos-mainnet': Network.MAINNET,
+    };
+    const network = networkMap[networkId] || Network.TESTNET;
+    console.log('[x402-axios] Network mapping:', {
+        networkId,
+        mappedNetwork: network,
+        networkMap
+    });
+    // Step 4: Initialize Aptos client based on discovered network
+    const aptosConfig = new AptosConfig({ network });
+    const aptos = new Aptos(aptosConfig);
+    console.log('[x402-axios] Aptos client initialized with network:', network);
+    // Create account from private key or use provided account
+    let aptosAccount;
+    if (account) {
+        aptosAccount = account;
+    }
+    else if (privateKey) {
+        const privateKeyObj = new Ed25519PrivateKey(privateKey);
+        aptosAccount = Account.fromPrivateKey({ privateKey: privateKeyObj });
+    }
+    else {
+        throw new Error('Either privateKey or account must be provided');
+    }
+    console.log(`[x402-axios] Building transaction for ${amount} Octas to ${recipient.slice(0, 10)}...`);
+    // Step 5: Build transaction based on scheme
+    let transaction;
+    if (scheme === 'exact') {
+        transaction = await aptos.transaction.build.simple({
+            sender: aptosAccount.accountAddress,
+            data: {
+                function: "0x1::aptos_account::transfer",
+                functionArguments: [recipient, amount],
+            },
+        });
+    }
+    else {
+        throw new Error(`Unsupported payment scheme: ${scheme}`);
+    }
+    console.log('[x402-axios] Signing transaction...');
+    // Step 6: Sign transaction
+    const senderAuthenticator = aptos.transaction.sign({
+        signer: aptosAccount,
+        transaction
+    });
+    // Step 7: Serialize transaction and signature separately
+    const transactionBytes = transaction.bcsToBytes();
+    const signatureBytes = senderAuthenticator.bcsToBytes();
+    const transactionBase64 = Buffer.from(transactionBytes).toString('base64');
+    const signatureBase64 = Buffer.from(signatureBytes).toString('base64');
+    // Step 8: Create x402 PaymentPayload
+    const paymentPayload = {
+        x402Version: 1,
+        scheme,
+        network: networkId,
+        payload: {
+            transaction: transactionBase64,
+            signature: signatureBase64,
+        },
+    };
+    // Step 9: Encode as base64 for X-PAYMENT header
+    const paymentHeader = Buffer.from(JSON.stringify(paymentPayload)).toString('base64');
+    console.log(`[x402-axios] Retrying with payment (header: ${paymentHeader.length} chars)...`);
+    // Step 10: Retry request with X-PAYMENT header
+    const paidInit = {
+        ...init,
+        headers: {
+            ...init.headers,
+            'X-PAYMENT': paymentHeader,
+        },
+    };
+    response = await fetch(url, paidInit);
+    // Handle response based on responseType
+    if (responseType === 'json') {
+        responseData = await response.json();
+    }
+    else if (responseType === 'text') {
+        responseData = await response.text();
+    }
+    else if (responseType === 'blob') {
+        responseData = await response.blob();
+    }
+    else if (responseType === 'arraybuffer') {
+        responseData = await response.arrayBuffer();
+    }
+    else {
+        responseData = await response.text();
+    }
+    console.log(`[x402-axios] Payment response: ${response.status}`);
+    // Step 11: Extract payment info from X-Payment-Response header
+    let paymentInfo;
+    const paymentResponseHeader = response.headers.get('x-payment-response');
+    if (paymentResponseHeader) {
+        const decoded = decodeXPaymentResponse(paymentResponseHeader);
+        if (decoded?.settlement?.txHash) {
+            paymentInfo = {
+                transactionHash: decoded.settlement.txHash,
+                amount: amount,
+                recipient: recipient,
+                settled: decoded.settlement.success === true,
+            };
+            console.log(`[x402-axios] Payment settled: ${paymentInfo.transactionHash}`);
+        }
+    }
+    const transformedData = transformResponseData(responseData, finalConfig);
+    return {
+        data: transformedData,
+        status: response.status,
+        statusText: response.statusText,
+        headers: Object.fromEntries(response.headers.entries()),
+        config: finalConfig,
+        paymentInfo,
+    };
+}
+// Axios-like convenience methods
+export const x402axios = Object.assign(async function (configOrUrl, config) {
+    return x402axiosMain(configOrUrl, config);
+}, {
+    get: (url, config) => x402axiosMain({ ...config, url, method: 'GET' }),
+    post: (url, data, config) => x402axiosMain({ ...config, url, method: 'POST', data }),
+    put: (url, data, config) => x402axiosMain({ ...config, url, method: 'PUT', data }),
+    patch: (url, data, config) => x402axiosMain({ ...config, url, method: 'PATCH', data }),
+    delete: (url, config) => x402axiosMain({ ...config, url, method: 'DELETE' }),
+    head: (url, config) => x402axiosMain({ ...config, url, method: 'HEAD' }),
+    options: (url, config) => x402axiosMain({ ...config, url, method: 'OPTIONS' }),
+    // Create instance with default config
+    create: (defaultConfig) => {
+        const instance = Object.assign(async function (configOrUrl, config) {
+            const mergedConfig = { ...defaultConfig, ...(typeof configOrUrl === 'string' ? { ...config, url: configOrUrl } : configOrUrl) };
+            return x402axiosMain(mergedConfig);
+        }, {
+            get: (url, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'GET' }),
+            post: (url, data, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'POST', data }),
+            put: (url, data, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'PUT', data }),
+            patch: (url, data, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'PATCH', data }),
+            delete: (url, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'DELETE' }),
+            head: (url, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'HEAD' }),
+            options: (url, config) => x402axiosMain({ ...defaultConfig, ...config, url, method: 'OPTIONS' }),
+        });
+        return instance;
+    },
+});
+//# sourceMappingURL=x402-axios.js.map

package/dist/x402-axios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-axios.js","sourceRoot":"","sources":["../lib/x402-axios.ts"],"names":[],"mappings":"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"}

package/dist/x402-client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * x402 Client for Aptos
+ *
+ * Simple client that automatically handles x402 payment flow:
+ * 1. Make request to protected resource
+ * 2. If 402, create and sign payment transaction
+ * 3. Retry with X-PAYMENT header
+ * 4. Return response
+ */
+import { Aptos, Network } from "@aptos-labs/ts-sdk";
+export interface X402ClientConfig {
+    privateKey: string;
+    network?: Network;
+    nodeUrl?: string;
+}
+export interface X402Response {
+    status: number;
+    data: any;
+    headers: Record<string, string>;
+    paymentDetails?: {
+        transactionHash: string;
+        amount: string;
+        recipient: string;
+        settled: boolean;
+    };
+}
+/**
+ * Create an x402 client for Aptos
+ */
+export declare function createX402Client(config: X402ClientConfig): {
+    request: (url: string, options?: RequestInit) => Promise<X402Response>;
+    get: (url: string, options?: RequestInit) => Promise<X402Response>;
+    post: (url: string, body?: any, options?: RequestInit) => Promise<X402Response>;
+    getBalance: () => Promise<number>;
+    getAddress: () => string;
+    account: import("@aptos-labs/ts-sdk").Ed25519Account;
+    aptos: Aptos;
+};
+/**
+ * Example usage:
+ *
+ * ```typescript
+ * import { createX402Client } from './lib/x402-client';
+ *
+ * const client = createX402Client({
+ *   privateKey: process.env.DEMO_PRIVATE_KEY!,
+ *   network: Network.TESTNET,
+ * });
+ *
+ * // Make a request - payment is handled automatically
+ * const response = await client.get('http://localhost:3000/api/protected/weather');
+ * console.log(response.data);
+ * console.log('Payment details:', response.paymentDetails);
+ * ```
+ */
+//# sourceMappingURL=x402-client.d.ts.map

package/dist/x402-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-client.d.ts","sourceRoot":"","sources":["../lib/x402-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,EAEL,OAAO,EAER,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;mBAmBhD,MAAM,YACF,WAAW,KACnB,OAAO,CAAC,YAAY,CAAC;eAiJA,MAAM,YAAW,WAAW,KAAQ,OAAO,CAAC,YAAY,CAAC;gBAQ1E,MAAM,SACJ,GAAG,YACD,WAAW,KACnB,OAAO,CAAC,YAAY,CAAC;sBAeK,OAAO,CAAC,MAAM,CAAC;sBASrB,MAAM;;;EAa9B;AAED;;;;;;;;;;;;;;;;GAgBG"}

package/dist/x402-client.js

@@ -0,0 +1,209 @@
+/**
+ * x402 Client for Aptos
+ *
+ * Simple client that automatically handles x402 payment flow:
+ * 1. Make request to protected resource
+ * 2. If 402, create and sign payment transaction
+ * 3. Retry with X-PAYMENT header
+ * 4. Return response
+ */
+import { Account, Aptos, AptosConfig, Network, Ed25519PrivateKey, } from "@aptos-labs/ts-sdk";
+/**
+ * Create an x402 client for Aptos
+ */
+export function createX402Client(config) {
+    const network = config.network || Network.TESTNET;
+    const aptosConfig = config.nodeUrl
+        ? new AptosConfig({ network, fullnode: config.nodeUrl })
+        : new AptosConfig({ network });
+    const aptos = new Aptos(aptosConfig);
+    // Create account from private key
+    const privateKey = new Ed25519PrivateKey(config.privateKey);
+    const account = Account.fromPrivateKey({ privateKey });
+    console.log(`[x402 Client] Initialized for address: ${account.accountAddress.toString()}`);
+    /**
+     * Make a request to an x402-protected endpoint
+     * Automatically handles 402 Payment Required and retries with payment
+     */
+    async function request(url, options = {}) {
+        console.log(`\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+        console.log(`[x402 Client] Starting x402 payment flow`);
+        console.log(`[x402 Client] URL: ${url}`);
+        console.log(`[x402 Client] Method: ${options.method || "GET"}`);
+        console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        // Step 1: Make initial request (without payment)
+        console.log(`[x402 Client] Step 1: Making initial request...`);
+        const initialResponse = await fetch(url, options);
+        const initialHeaders = Object.fromEntries(initialResponse.headers.entries());
+        console.log(`[x402 Client] Initial response status: ${initialResponse.status}`);
+        // If not 402, return immediately (resource is not payment-protected)
+        if (initialResponse.status !== 402) {
+            console.log(`[x402 Client] ✅ No payment required, returning response`);
+            const data = await initialResponse.json().catch(() => ({}));
+            return {
+                status: initialResponse.status,
+                data,
+                headers: initialHeaders,
+            };
+        }
+        console.log(`\n[x402 Client] 💳 Step 2: Received 402 Payment Required`);
+        // Step 2: Parse payment requirements from 402 response body
+        const paymentRequirements = await initialResponse.json();
+        console.log(`[x402 Client] Payment requirements:`, JSON.stringify(paymentRequirements, null, 2));
+        if (!paymentRequirements.price || !paymentRequirements.paymentAddress) {
+            throw new Error("Invalid 402 response: missing payment requirements");
+        }
+        console.log(`\n[x402 Client] 🔨 Step 3: Creating payment transaction`);
+        console.log(`[x402 Client] Building Aptos transfer transaction...`);
+        console.log(`[x402 Client]   Function: 0x1::aptos_account::transfer`);
+        console.log(`[x402 Client]   Recipient: ${paymentRequirements.paymentAddress}`);
+        console.log(`[x402 Client]   Amount: ${paymentRequirements.price} Octas`);
+        const transaction = await aptos.transaction.build.simple({
+            sender: account.accountAddress,
+            data: {
+                function: "0x1::aptos_account::transfer",
+                functionArguments: [
+                    paymentRequirements.paymentAddress,
+                    paymentRequirements.price,
+                ],
+            },
+        });
+        console.log(`[x402 Client] ✅ Transaction built successfully\n`);
+        // Step 4: Sign transaction (but don't submit - facilitator will submit it)
+        console.log(`[x402 Client] ✍️  Step 4: Signing transaction`);
+        console.log(`[x402 Client] Using account: ${account.accountAddress.toString()}`);
+        console.log(`[x402 Client] Signing with Ed25519 private key...`);
+        const signedTx = aptos.transaction.sign({
+            signer: account,
+            transaction
+        });
+        console.log(`[x402 Client] ✅ Transaction signed successfully\n`);
+        // Step 5: Serialize using BCS (Binary Canonical Serialization)
+        // This is the Aptos standard for transaction serialization
+        console.log(`[x402 Client] 📦 Step 5: Serializing transaction (BCS)`);
+        console.log(`[x402 Client] Using Binary Canonical Serialization (Aptos standard)...`);
+        const signedTxBytes = signedTx.bcsToBytes();
+        console.log(`[x402 Client] ✅ Serialized to ${signedTxBytes.length} bytes\n`);
+        // Step 6: Encode as base64 for HTTP transport (per x402 spec)
+        console.log(`[x402 Client] 🔐 Step 6: Encoding for HTTP transport`);
+        console.log(`[x402 Client] Encoding as base64 for X-PAYMENT header (per x402 spec)...`);
+        const signedTxBase64 = Buffer.from(signedTxBytes).toString("base64");
+        console.log(`[x402 Client] ✅ Encoded to ${signedTxBase64.length} characters`);
+        console.log(`[x402 Client] Preview: ${signedTxBase64.substring(0, 80)}...`);
+        console.log(`[x402 Client] This will be sent in X-PAYMENT header\n`);
+        // Step 7: Retry request with X-PAYMENT header (per x402 spec)
+        // The signed transaction is sent in the X-PAYMENT header as base64
+        console.log(`[x402 Client] 🔄 Step 7: Retrying request with payment`);
+        const requestHeaders = {
+            ...options.headers,
+            "X-PAYMENT": signedTxBase64,
+        };
+        console.log(`[x402 Client] Headers being sent:`);
+        console.log(`[x402 Client]   X-PAYMENT: ${signedTxBase64.substring(0, 50)}... (${signedTxBase64.length} chars)`);
+        console.log(`[x402 Client] Making request to: ${url}\n`);
+        const paidResponse = await fetch(url, {
+            ...options,
+            headers: requestHeaders,
+        });
+        console.log(`[x402 Client] ✅ Response received: ${paidResponse.status} ${paidResponse.statusText}\n`);
+        const paidHeaders = Object.fromEntries(paidResponse.headers.entries());
+        const data = await paidResponse.json().catch(() => ({}));
+        // Step 8: Parse X-Payment-Response header (per x402 spec)
+        // The facilitator returns payment settlement details in this header
+        console.log(`[x402 Client] 📋 Step 8: Checking payment settlement`);
+        let paymentDetails;
+        if (paidHeaders["x-payment-response"]) {
+            console.log(`[x402 Client] Found X-Payment-Response header in response`);
+            try {
+                paymentDetails = JSON.parse(paidHeaders["x-payment-response"]);
+                console.log(`[x402 Client] ✅ Payment settled on blockchain!`);
+                console.log(`[x402 Client] Settlement details:`);
+                console.log(`[x402 Client]   Transaction Hash: ${paymentDetails.transactionHash}`);
+                console.log(`[x402 Client]   Amount: ${paymentDetails.amount} Octas`);
+                console.log(`[x402 Client]   Recipient: ${paymentDetails.recipient}`);
+                console.log(`[x402 Client]   Status: ${paymentDetails.settled ? "Confirmed" : "Pending"}`);
+            }
+            catch (error) {
+                console.warn(`[x402 Client] ⚠️  Failed to parse X-Payment-Response header`);
+            }
+        }
+        else {
+            console.warn(`[x402 Client] ⚠️  No X-Payment-Response header found in response`);
+        }
+        if (!paidResponse.ok) {
+            console.error(`[x402 Client] ❌ Request failed after payment`);
+            throw new Error(`Request failed: ${paidResponse.status} ${paidResponse.statusText}`);
+        }
+        console.log(`\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+        console.log(`[x402 Client] ✅ Payment flow completed successfully!`);
+        console.log(`[x402 Client] ✅ Protected resource delivered`);
+        console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        return {
+            status: paidResponse.status,
+            data,
+            headers: paidHeaders,
+            paymentDetails,
+        };
+    }
+    /**
+     * GET request to x402-protected endpoint
+     */
+    async function get(url, options = {}) {
+        return request(url, { ...options, method: "GET" });
+    }
+    /**
+     * POST request to x402-protected endpoint
+     */
+    async function post(url, body, options = {}) {
+        return request(url, {
+            ...options,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+    }
+    /**
+     * Get account balance
+     */
+    async function getBalance() {
+        return await aptos.getAccountAPTAmount({
+            accountAddress: account.accountAddress,
+        });
+    }
+    /**
+     * Get account address
+     */
+    function getAddress() {
+        return account.accountAddress.toString();
+    }
+    return {
+        request,
+        get,
+        post,
+        getBalance,
+        getAddress,
+        account,
+        aptos,
+    };
+}
+/**
+ * Example usage:
+ *
+ * ```typescript
+ * import { createX402Client } from './lib/x402-client';
+ *
+ * const client = createX402Client({
+ *   privateKey: process.env.DEMO_PRIVATE_KEY!,
+ *   network: Network.TESTNET,
+ * });
+ *
+ * // Make a request - payment is handled automatically
+ * const response = await client.get('http://localhost:3000/api/protected/weather');
+ * console.log(response.data);
+ * console.log('Payment details:', response.paymentDetails);
+ * ```
+ */
+//# sourceMappingURL=x402-client.js.map

package/dist/x402-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-client.js","sourceRoot":"","sources":["../lib/x402-client.ts"],"names":[],"mappings":"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"}

package/dist/x402-fetch.d.ts

@@ -0,0 +1,59 @@
+/**
+ * x402 Fetch Wrapper for Aptos
+ *
+ * Drop-in replacement for fetch() that automatically handles x402 payments
+ *
+ * Usage:
+ * ```typescript
+ * import { createX402Fetch } from '@adipundir/aptos-x402';
+ *
+ * const fetch402 = createX402Fetch({
+ *   privateKey: process.env.PRIVATE_KEY!,
+ *   network: 'testnet'
+ * });
+ *
+ * // Use it like regular fetch - payment is automatic!
+ * const response = await fetch402('https://api.example.com/premium-data');
+ * const data = await response.json();
+ * ```
+ */
+export interface X402FetchConfig {
+    /** Private key for signing transactions (hex string starting with 0x) */
+    privateKey: string;
+    /** Aptos network (testnet, mainnet, devnet) */
+    network?: 'testnet' | 'mainnet' | 'devnet';
+    /** Custom node URL (optional) */
+    nodeUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface X402PaymentInfo {
+    /** Transaction hash on Aptos blockchain */
+    transactionHash: string;
+    /** Amount paid in Octas */
+    amountOctas: string;
+    /** Amount paid in APT */
+    amountAPT: number;
+    /** Recipient address */
+    recipient: string;
+    /** Network where payment was settled */
+    network: string;
+    /** Whether payment was settled successfully */
+    settled: boolean;
+}
+export interface X402Response extends Response {
+    /** Payment information if a payment was made */
+    paymentInfo?: X402PaymentInfo;
+}
+/**
+ * Create an x402-enabled fetch function
+ */
+export declare function createX402Fetch(config: X402FetchConfig): typeof fetch;
+/**
+ * Get account balance helper
+ */
+export declare function getAccountBalance(config: X402FetchConfig): Promise<{
+    octas: number;
+    apt: number;
+}>;
+//# sourceMappingURL=x402-fetch.d.ts.map