@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta → 1.0.2

package/dist/esm/ai/gateway/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai/gateway/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/ai/gateway/types.js

@@ -0,0 +1,18 @@
+/**
+ * @module ai/gateway/types
+ * @description Synapse Agent Gateway — Core type definitions.
+ *
+ * This module defines the primitives for agent-to-agent commerce:
+ * metered sessions, payment channels, response attestations,
+ * and tool marketplace listings.
+ *
+ * @since 1.0.0
+ */
+/**
+ * @description Create a branded AgentId from a plain string.
+ * @param {string} v - The string value to brand as an AgentId
+ * @returns {AgentId} A branded AgentId
+ * @since 1.0.0
+ */
+export const AgentId = (v) => v;
+//# sourceMappingURL=types.js.map

package/dist/esm/ai/gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/gateway/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAY,CAAC"}

package/dist/esm/ai/gateway/validator.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @module ai/gateway/validator
+ * @description ResponseValidator — Cryptographic attestation of RPC responses.
+ *
+ * Provides "Proof of Computation":
+ * - Hashes request params + response body
+ * - Signs the attestation with the gateway's Ed25519 key
+ * - Allows third-party verification without re-executing the RPC call
+ *
+ * This is the foundation for:
+ * - Selling validated/certified RPC responses
+ * - Agent trust scoring based on attestation correctness
+ * - On-chain dispute resolution (post attestation as evidence)
+ *
+ * @since 1.0.0
+ */
+import type { ResponseAttestation, AttestedResult, GatewayConfig } from './types';
+/**
+ * @description Cryptographic response attestation engine for Proof of Computation.
+ *
+ * Creates signed attestations of RPC responses that can be verified by buyers
+ * without re-executing the call. Maintains a bounded ring buffer of attestation history.
+ *
+ * @example
+ * ```ts
+ * const validator = new ResponseValidator(config);
+ * const attestation = await validator.attest(sessionId, 'getBalance', params, response, slot);
+ * const integrity = ResponseValidator.verifyIntegrity(attestation, params, response);
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare class ResponseValidator {
+    private readonly attesterId;
+    private readonly signer;
+    /** In-memory attestation log (bounded ring buffer). */
+    private readonly attestationLog;
+    private readonly maxLogSize;
+    /**
+     * @description Create a new ResponseValidator.
+     * @param {GatewayConfig} config - Gateway config providing identity and signer
+     * @param {number} [maxLogSize=10000] - Maximum attestation log size (ring buffer)
+     * @since 1.0.0
+     */
+    constructor(config: GatewayConfig, maxLogSize?: number);
+    /**
+     * @description Create an attestation for a completed RPC call.
+     *
+     * @param {string} sessionId - Session the call belongs to
+     * @param {string} method - RPC method name
+     * @param {unknown} params - Request params (will be hashed)
+     * @param {unknown} response - Response body (will be hashed)
+     * @param {number} slot - The Solana slot at the time of response
+     * @returns {Promise<ResponseAttestation>} The signed ResponseAttestation
+     * @since 1.0.0
+     */
+    attest(sessionId: string, method: string, params: unknown, response: unknown, slot: number): Promise<ResponseAttestation>;
+    /**
+     * @description Wrap an RPC result with optional attestation.
+     * @template T The type of the RPC result data
+     * @param {T} data - The RPC result data
+     * @param {string} sessionId - The session ID
+     * @param {string} method - RPC method name
+     * @param {unknown} params - Request params
+     * @param {number} slot - Solana slot
+     * @param {number} latencyMs - Call latency in milliseconds
+     * @param {number} callIndex - Sequential call number
+     * @param {boolean} shouldAttest - Whether to produce an attestation
+     * @returns {Promise<AttestedResult<T>>} The wrapped result with optional attestation
+     * @since 1.0.0
+     */
+    wrapResult<T>(data: T, sessionId: string, method: string, params: unknown, slot: number, latencyMs: number, callIndex: number, shouldAttest: boolean): Promise<AttestedResult<T>>;
+    /**
+     * @description Verify the integrity of an attestation.
+     * Checks that requestHash and responseHash match the provided data.
+     * Signature verification requires the attester's public key.
+     *
+     * @param {ResponseAttestation} attestation - The attestation to verify
+     * @param {unknown} params - Original request params
+     * @param {unknown} response - Original response body
+     * @returns {{ valid: boolean; requestMatch: boolean; responseMatch: boolean }} Verification result
+     * @since 1.0.0
+     */
+    static verifyIntegrity(attestation: ResponseAttestation, params: unknown, response: unknown): {
+        valid: boolean;
+        requestMatch: boolean;
+        responseMatch: boolean;
+    };
+    /**
+     * @description Verify a signature against an attestation.
+     * The verifier function should be provided by the caller (e.g. using @solana/web3.js).
+     *
+     * @param {ResponseAttestation} attestation - The attestation to verify
+     * @param {Function} verifier - Async function that verifies (message, signature, pubkey) → boolean
+     * @param {string} attesterPubkey - The expected attester's public key
+     * @returns {Promise<boolean>} Whether the signature is valid
+     * @since 1.0.0
+     */
+    static verifySignature(attestation: ResponseAttestation, verifier: (message: Uint8Array, signature: Uint8Array, pubkey: string) => Promise<boolean>, attesterPubkey: string): Promise<boolean>;
+    /**
+     * @description Get all attestations for a session.
+     * @param {string} sessionId - The session ID to query
+     * @returns {ResponseAttestation[]} Array of attestations for the session
+     * @since 1.0.0
+     */
+    getSessionAttestations(sessionId: string): ResponseAttestation[];
+    /**
+     * @description Get attestations by method name.
+     * @param {string} method - The RPC method name to filter by
+     * @param {number} [limit=100] - Maximum number of results
+     * @returns {ResponseAttestation[]} Array of matching attestations
+     * @since 1.0.0
+     */
+    getMethodAttestations(method: string, limit?: number): ResponseAttestation[];
+    /**
+     * @description Get total attestation count.
+     * @returns {number} Total number of attestations in the log
+     * @since 1.0.0
+     */
+    get totalAttestations(): number;
+    /**
+     * @description Export the full attestation log (for off-chain archival).
+     * @returns {ResponseAttestation[]} Copy of the full attestation log
+     * @since 1.0.0
+     */
+    exportLog(): ResponseAttestation[];
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/esm/ai/gateway/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/ai/gateway/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAW,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAkB3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwD;IAE/E,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;;;;OAKG;gBACS,MAAM,EAAE,aAAa,EAAE,UAAU,SAAS;IAQtD;;;;;;;;;;OAUG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC;IAmC/B;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,CAAC,EAChB,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAgB7B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,GAChB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE;IAWpE;;;;;;;;;OASG;WACU,eAAe,CAC1B,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC1F,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAYnB;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIhE;;;;;;OAMG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,mBAAmB,EAAE;IAIzE;;;;OAIG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;;;OAIG;IACH,SAAS,IAAI,mBAAmB,EAAE;CAGnC"}

package/dist/esm/ai/gateway/validator.js

@@ -0,0 +1,204 @@
+/**
+ * @module ai/gateway/validator
+ * @description ResponseValidator — Cryptographic attestation of RPC responses.
+ *
+ * Provides "Proof of Computation":
+ * - Hashes request params + response body
+ * - Signs the attestation with the gateway's Ed25519 key
+ * - Allows third-party verification without re-executing the RPC call
+ *
+ * This is the foundation for:
+ * - Selling validated/certified RPC responses
+ * - Agent trust scoring based on attestation correctness
+ * - On-chain dispute resolution (post attestation as evidence)
+ *
+ * @since 1.0.0
+ */
+import { createHash } from 'crypto';
+/* ═══════════════════════════════════════════════════════════════
+ *  Hashing helpers
+ * ═══════════════════════════════════════════════════════════════ */
+function sha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+function canonicalize(obj) {
+    return JSON.stringify(obj, Object.keys(obj).sort());
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  ResponseValidator
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Cryptographic response attestation engine for Proof of Computation.
+ *
+ * Creates signed attestations of RPC responses that can be verified by buyers
+ * without re-executing the call. Maintains a bounded ring buffer of attestation history.
+ *
+ * @example
+ * ```ts
+ * const validator = new ResponseValidator(config);
+ * const attestation = await validator.attest(sessionId, 'getBalance', params, response, slot);
+ * const integrity = ResponseValidator.verifyIntegrity(attestation, params, response);
+ * ```
+ *
+ * @since 1.0.0
+ */
+export class ResponseValidator {
+    attesterId;
+    signer;
+    /** In-memory attestation log (bounded ring buffer). */
+    attestationLog = [];
+    maxLogSize;
+    /**
+     * @description Create a new ResponseValidator.
+     * @param {GatewayConfig} config - Gateway config providing identity and signer
+     * @param {number} [maxLogSize=10000] - Maximum attestation log size (ring buffer)
+     * @since 1.0.0
+     */
+    constructor(config, maxLogSize = 10_000) {
+        this.attesterId = config.identity.id;
+        this.signer = config.signer ?? null;
+        this.maxLogSize = maxLogSize;
+    }
+    /* ── Attestation creation ────────────────────────────────── */
+    /**
+     * @description Create an attestation for a completed RPC call.
+     *
+     * @param {string} sessionId - Session the call belongs to
+     * @param {string} method - RPC method name
+     * @param {unknown} params - Request params (will be hashed)
+     * @param {unknown} response - Response body (will be hashed)
+     * @param {number} slot - The Solana slot at the time of response
+     * @returns {Promise<ResponseAttestation>} The signed ResponseAttestation
+     * @since 1.0.0
+     */
+    async attest(sessionId, method, params, response, slot) {
+        const requestHash = sha256(canonicalize(params));
+        const responseHash = sha256(canonicalize(response));
+        // Build the message to sign: deterministic concatenation
+        const message = `${method}|${requestHash}|${responseHash}|${slot}`;
+        const messageBytes = new TextEncoder().encode(message);
+        // Sign if signer is available, otherwise empty signature (unsigned attestation)
+        let signature = '';
+        if (this.signer) {
+            const sig = await this.signer(messageBytes);
+            signature = Buffer.from(sig).toString('base64');
+        }
+        const attestation = {
+            sessionId,
+            method,
+            requestHash,
+            responseHash,
+            slot,
+            attesterId: this.attesterId,
+            signature,
+            timestamp: Date.now(),
+        };
+        // Push to ring buffer
+        if (this.attestationLog.length >= this.maxLogSize) {
+            this.attestationLog.shift();
+        }
+        this.attestationLog.push(attestation);
+        return attestation;
+    }
+    /**
+     * @description Wrap an RPC result with optional attestation.
+     * @template T The type of the RPC result data
+     * @param {T} data - The RPC result data
+     * @param {string} sessionId - The session ID
+     * @param {string} method - RPC method name
+     * @param {unknown} params - Request params
+     * @param {number} slot - Solana slot
+     * @param {number} latencyMs - Call latency in milliseconds
+     * @param {number} callIndex - Sequential call number
+     * @param {boolean} shouldAttest - Whether to produce an attestation
+     * @returns {Promise<AttestedResult<T>>} The wrapped result with optional attestation
+     * @since 1.0.0
+     */
+    async wrapResult(data, sessionId, method, params, slot, latencyMs, callIndex, shouldAttest) {
+        const result = {
+            data,
+            latencyMs,
+            callIndex,
+        };
+        if (shouldAttest) {
+            result.attestation = await this.attest(sessionId, method, params, data, slot);
+        }
+        return result;
+    }
+    /* ── Verification (static — can be called by buyers) ─────── */
+    /**
+     * @description Verify the integrity of an attestation.
+     * Checks that requestHash and responseHash match the provided data.
+     * Signature verification requires the attester's public key.
+     *
+     * @param {ResponseAttestation} attestation - The attestation to verify
+     * @param {unknown} params - Original request params
+     * @param {unknown} response - Original response body
+     * @returns {{ valid: boolean; requestMatch: boolean; responseMatch: boolean }} Verification result
+     * @since 1.0.0
+     */
+    static verifyIntegrity(attestation, params, response) {
+        const requestHash = sha256(canonicalize(params));
+        const responseHash = sha256(canonicalize(response));
+        return {
+            valid: requestHash === attestation.requestHash && responseHash === attestation.responseHash,
+            requestMatch: requestHash === attestation.requestHash,
+            responseMatch: responseHash === attestation.responseHash,
+        };
+    }
+    /**
+     * @description Verify a signature against an attestation.
+     * The verifier function should be provided by the caller (e.g. using @solana/web3.js).
+     *
+     * @param {ResponseAttestation} attestation - The attestation to verify
+     * @param {Function} verifier - Async function that verifies (message, signature, pubkey) → boolean
+     * @param {string} attesterPubkey - The expected attester's public key
+     * @returns {Promise<boolean>} Whether the signature is valid
+     * @since 1.0.0
+     */
+    static async verifySignature(attestation, verifier, attesterPubkey) {
+        if (!attestation.signature)
+            return false;
+        const message = `${attestation.method}|${attestation.requestHash}|${attestation.responseHash}|${attestation.slot}`;
+        const messageBytes = new TextEncoder().encode(message);
+        const signatureBytes = Buffer.from(attestation.signature, 'base64');
+        return verifier(messageBytes, signatureBytes, attesterPubkey);
+    }
+    /* ── Attestation log queries ─────────────────────────────── */
+    /**
+     * @description Get all attestations for a session.
+     * @param {string} sessionId - The session ID to query
+     * @returns {ResponseAttestation[]} Array of attestations for the session
+     * @since 1.0.0
+     */
+    getSessionAttestations(sessionId) {
+        return this.attestationLog.filter(a => a.sessionId === sessionId);
+    }
+    /**
+     * @description Get attestations by method name.
+     * @param {string} method - The RPC method name to filter by
+     * @param {number} [limit=100] - Maximum number of results
+     * @returns {ResponseAttestation[]} Array of matching attestations
+     * @since 1.0.0
+     */
+    getMethodAttestations(method, limit = 100) {
+        return this.attestationLog.filter(a => a.method === method).slice(-limit);
+    }
+    /**
+     * @description Get total attestation count.
+     * @returns {number} Total number of attestations in the log
+     * @since 1.0.0
+     */
+    get totalAttestations() {
+        return this.attestationLog.length;
+    }
+    /**
+     * @description Export the full attestation log (for off-chain archival).
+     * @returns {ResponseAttestation[]} Copy of the full attestation log
+     * @since 1.0.0
+     */
+    exportLog() {
+        return [...this.attestationLog];
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/esm/ai/gateway/validator.js.map

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

package/dist/esm/ai/gateway/x402/client.d.ts

@@ -0,0 +1,274 @@
+/**
+ * @module ai/gateway/x402/client
+ * @description x402 Client — Buyer-side x402 payment handler.
+ *
+ * When an agent acts as a BUYER and receives a 402 Payment Required
+ * response, this module handles:
+ *  1. Detecting 402 responses and extracting PaymentRequired headers
+ *  2. Selecting the best matching PaymentRequirements from accepts[]
+ *  3. Calling the developer-provided signer to create a PaymentPayload
+ *  4. Retrying the request with the PAYMENT-SIGNATURE header
+ *  5. Decoding the PAYMENT-RESPONSE header from the final 200 response
+ *
+ * The module is transport-agnostic: works as a fetch wrapper, a middleware,
+ * or integrated into the AgentGateway's execute() pipeline.
+ *
+ * @since 1.0.0
+ */
+import type { X402PaymentRequired, X402PaymentPayload, X402PaymentRequirements, X402ResourceInfo, X402SettlementResponse, X402Network } from './types';
+/**
+ * @description Base error class for x402 client-side errors.
+ * @since 1.0.0
+ */
+export declare class X402ClientError extends Error {
+    constructor(message: string);
+}
+/**
+ * @description Error thrown when no acceptable payment method is found in the 402 response.
+ * @since 1.0.0
+ */
+export declare class NoAcceptablePaymentError extends X402ClientError {
+    readonly paymentRequired: X402PaymentRequired;
+    readonly reason: string;
+    /**
+     * @description Create a NoAcceptablePaymentError.
+     * @param {X402PaymentRequired} paymentRequired - The full 402 response
+     * @param {string} reason - Why no payment method was acceptable
+     * @since 1.0.0
+     */
+    constructor(paymentRequired: X402PaymentRequired, reason: string);
+}
+/**
+ * @description Error thrown when signing a payment payload fails.
+ * @since 1.0.0
+ */
+export declare class PaymentSigningError extends X402ClientError {
+    readonly requirements: X402PaymentRequirements;
+    readonly cause: unknown;
+    /**
+     * @description Create a PaymentSigningError.
+     * @param {X402PaymentRequirements} requirements - The requirements being signed
+     * @param {unknown} cause - The underlying error
+     * @since 1.0.0
+     */
+    constructor(requirements: X402PaymentRequirements, cause: unknown);
+}
+/**
+ * @description Error thrown when the payment retry request fails with a non-402 status.
+ * @since 1.0.0
+ */
+export declare class PaymentRetryError extends X402ClientError {
+    readonly statusCode: number;
+    readonly body: unknown;
+    /**
+     * @description Create a PaymentRetryError.
+     * @param {number} statusCode - The HTTP status code of the failed retry
+     * @param {unknown} body - The response body
+     * @since 1.0.0
+     */
+    constructor(statusCode: number, body: unknown);
+}
+/**
+ * @description Signer function that takes payment requirements and resource info
+ * and returns a fully-signed PaymentPayload.
+ *
+ * The developer provides this. For Solana exact scheme,
+ * the signer should:
+ *  1. Deserialize the transaction from requirements.extra.feePayer
+ *  2. Build a TransferChecked instruction to payTo
+ *  3. Partially sign with the agent's keypair
+ *  4. Set payload.transaction = base64-encoded tx
+ *
+ * @since 1.0.0
+ */
+export type X402PayloadSigner = (requirements: X402PaymentRequirements, resource: X402ResourceInfo) => Promise<X402PaymentPayload>;
+/**
+ * @description Selector function that picks the best payment requirements
+ * from the accepts array. The developer can customize this
+ * to prefer specific networks, assets, or schemes.
+ *
+ * Default: picks the first requirements matching the configured network + asset.
+ * @since 1.0.0
+ */
+export type X402RequirementsSelector = (accepts: X402PaymentRequirements[], config: X402ClientConfig) => X402PaymentRequirements | undefined;
+/**
+ * @description Budget tracker callback — called before paying to check
+ * if the agent has sufficient budget remaining.
+ * @since 1.0.0
+ */
+export type X402BudgetCheck = (amount: string, asset: string, network: X402Network) => Promise<boolean>;
+/**
+ * @description Configuration for the buyer-side x402 client.
+ * @since 1.0.0
+ */
+export interface X402ClientConfig {
+    /** Whether x402 auto-pay is enabled */
+    enabled: boolean;
+    /** The signer that creates signed PaymentPayloads */
+    signer: X402PayloadSigner;
+    /** Preferred network (used for selecting from accepts[]) */
+    preferredNetwork?: X402Network;
+    /** Preferred asset mint (used for selecting from accepts[]) */
+    preferredAsset?: string;
+    /** Maximum amount willing to pay per call (in atomic units) */
+    maxAmountPerCall?: string;
+    /** Custom requirements selector (overrides default selection logic) */
+    requirementsSelector?: X402RequirementsSelector;
+    /** Budget check callback (called before signing a payment) */
+    budgetCheck?: X402BudgetCheck;
+    /** Max number of 402 retries before giving up (default: 1) */
+    maxRetries?: number;
+    /** Whether to automatically detect and handle 402 responses (default: true) */
+    autoDetect?: boolean;
+}
+/**
+ * @description The outcome of a successful x402 payment flow.
+ * @since 1.0.0
+ */
+export interface X402PaymentOutcome {
+    /** The settlement response from the resource server */
+    settlement: X402SettlementResponse | null;
+    /** The payment payload that was sent */
+    paymentPayload: X402PaymentPayload;
+    /** The requirements that were fulfilled */
+    requirements: X402PaymentRequirements;
+    /** Amount paid in atomic units */
+    amountPaid: string;
+}
+/**
+ * @description Default selection logic:
+ * 1. Filter by preferred network (if set)
+ * 2. Filter by preferred asset (if set)
+ * 3. Filter by maxAmountPerCall (if set)
+ * 4. Pick the cheapest remaining option
+ *
+ * @param {X402PaymentRequirements[]} accepts - Available payment options from the 402 response
+ * @param {X402ClientConfig} config - Client configuration with preferences
+ * @returns {X402PaymentRequirements | undefined} The selected requirements, or undefined if none match
+ * @since 1.0.0
+ */
+export declare function defaultRequirementsSelector(accepts: X402PaymentRequirements[], config: X402ClientConfig): X402PaymentRequirements | undefined;
+/**
+ * @description Buyer-side x402 client.
+ *
+ * Wraps outgoing HTTP requests to automatically handle 402 Payment Required
+ * responses by signing a payment and retrying.
+ *
+ * @example
+ * ```ts
+ * const x402Client = new X402Client({
+ *   enabled: true,
+ *   signer: async (requirements, resource) => {
+ *     // Build and sign a Solana transaction
+ *     return { x402Version: 2, accepted: requirements, resource, payload: { transaction: '...' } };
+ *   },
+ *   preferredNetwork: SOLANA_MAINNET,
+ *   preferredAsset: USDC_MAINNET,
+ *   maxAmountPerCall: '100000', // 0.1 USDC max
+ * });
+ *
+ * // Wrap a fetch call
+ * const result = await x402Client.fetch('https://rpc-gateway.example/rpc', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ jsonrpc: '2.0', method: 'getBalance', params: ['...'], id: 1 }),
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare class X402Client {
+    private readonly config;
+    private readonly selector;
+    /** Running tally of total amount paid (in atomic units, per-asset) */
+    private readonly totalPaid;
+    private paymentCount;
+    /**
+     * @description Create a new X402Client.
+     * @param {X402ClientConfig} config - Client configuration including signer, preferences, and budget
+     * @since 1.0.0
+     */
+    constructor(config: X402ClientConfig);
+    /**
+     * @description Perform an HTTP request with automatic x402 payment handling.
+     *
+     * If the server responds with 402, the client:
+     * 1. Decodes PaymentRequired from the header
+     * 2. Selects requirements
+     * 3. Calls the signer
+     * 4. Retries with PAYMENT-SIGNATURE header
+     *
+     * @param {string} url - Target URL
+     * @param {RequestInit} [init] - Fetch options
+     * @returns {Promise<{ response: Response; payment: X402PaymentOutcome | null }>} Response + optional PaymentOutcome
+     * @throws {PaymentRetryError} If the retry response is not 402 but still not OK
+     * @throws {X402ClientError} If max retries are exceeded
+     * @since 1.0.0
+     */
+    fetch(url: string, init?: RequestInit): Promise<{
+        response: Response;
+        payment: X402PaymentOutcome | null;
+    }>;
+    /**
+     * @description Process a raw 402 response (for integration with custom transports).
+     *
+     * Use this when you have a custom HTTP transport (like SynapseClient's
+     * HttpTransport) and want to intercept 402 responses.
+     *
+     * @param {number} statusCode - HTTP status code
+     * @param {Record<string, string>} headers - Response headers (key-value)
+     * @param {unknown} [body] - Response body (parsed JSON or raw string)
+     * @returns {Promise<{ shouldRetry: boolean; paymentSignatureHeader?: string; paymentPayload?: X402PaymentPayload; requirements?: X402PaymentRequirements }>} Whether to retry and the payment header to attach
+     * @throws {PaymentSigningError} If the signer fails
+     * @since 1.0.0
+     */
+    interceptResponse(statusCode: number, headers: Record<string, string>, body?: unknown): Promise<{
+        shouldRetry: boolean;
+        paymentSignatureHeader?: string;
+        paymentPayload?: X402PaymentPayload;
+        requirements?: X402PaymentRequirements;
+    }>;
+    /**
+     * @description Parse a PAYMENT-RESPONSE header from a successful response.
+     * @param {Record<string, string>} headers - Response headers containing the payment response
+     * @returns {X402SettlementResponse | null} The parsed settlement response, or null if not present
+     * @since 1.0.0
+     */
+    parseSettlementResponse(headers: Record<string, string>): X402SettlementResponse | null;
+    private handlePaymentRequired;
+    private selectAndSign;
+    private trackPayment;
+    /**
+     * @description Total payments made in this client instance.
+     * @returns {number} Number of completed payments
+     * @since 1.0.0
+     */
+    get payments(): number;
+    /**
+     * @description Total amount paid per asset (network:asset → bigint).
+     * @returns {ReadonlyMap<string, bigint>} Map of asset keys to total amounts paid
+     * @since 1.0.0
+     */
+    get totalAmountPaid(): ReadonlyMap<string, bigint>;
+    /**
+     * @description Get total paid for a specific asset on a network.
+     * @param {X402Network} network - The CAIP-2 network identifier
+     * @param {string} asset - The token contract address
+     * @returns {bigint} Total amount paid in atomic units
+     * @since 1.0.0
+     */
+    getTotalPaid(network: X402Network, asset: string): bigint;
+    /**
+     * @description Check if auto-pay is enabled.
+     * @returns {boolean} Whether the client is enabled for automatic payments
+     * @since 1.0.0
+     */
+    get isEnabled(): boolean;
+}
+/**
+ * @description Create an X402Client with the provided configuration.
+ * @param {X402ClientConfig} config - Client configuration
+ * @returns {X402Client} A new X402Client instance
+ * @since 1.0.0
+ */
+export declare function createX402Client(config: X402ClientConfig): X402Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/ai/gateway/x402/client.d.ts.map

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