@ryanrfox/sdk 0.0.2 → 2.0.4

package/src/_esm/events/watchTransfer.js

@@ -0,0 +1,234 @@
+import { decodeEventLog, erc20Abi } from 'viem';
+/**
+ * Watches for ERC-20 Transfer events in real-time.
+ * Automatically decodes Transfer events and provides type-safe callbacks.
+ *
+ * @param client - The PublicClient to use (WebSocket transport recommended)
+ * @param params - Transfer event watching parameters
+ * @returns An unwatch function to stop the subscription
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient } from 'viem';
+ * import { createWebSocketTransport, watchTransfer } from '@radiustechsystems/sdk/events';
+ * import { radiusTestnet } from '@radiustechsystems/sdk/chains';
+ *
+ * const client = createPublicClient({
+ *   chain: radiusTestnet,
+ *   transport: createWebSocketTransport(radiusTestnet),
+ * });
+ *
+ * // Watch all transfers for a token
+ * const unwatch = watchTransfer(client, {
+ *   address: '0x...', // Token address
+ *   onTransfer: (events) => {
+ *     events.forEach(event => {
+ *       console.log(`Transfer: ${event.value} from ${event.from} to ${event.to}`);
+ *     });
+ *   },
+ * });
+ *
+ * // Watch transfers to a specific address
+ * const unwatchToAddress = watchTransfer(client, {
+ *   address: '0x...', // Token address
+ *   to: '0x...', // Recipient address
+ *   onTransfer: (events) => {
+ *     console.log(`Received ${events.length} transfers`);
+ *   },
+ * });
+ *
+ * // Stop watching
+ * unwatch();
+ * ```
+ *
+ * @remarks
+ * - Requires WebSocket transport for real-time subscriptions
+ * - Automatically decodes Transfer events using ERC-20 ABI
+ * - Filters by from/to addresses if provided
+ * - Event signature: Transfer(address indexed from, address indexed to, uint256 value)
+ * - Subscriptions consume gas from your RPC key on Radius (10 GAS/sec)
+ */
+export function watchTransfer(client, params) {
+    // Build event filter args based on from/to parameters
+    const args = {};
+    if (params.from)
+        args.from = params.from;
+    if (params.to)
+        args.to = params.to;
+    return client.watchContractEvent({
+        address: params.address,
+        abi: erc20Abi,
+        eventName: 'Transfer',
+        args: Object.keys(args).length > 0 ? args : undefined,
+        onLogs: (logs) => {
+            // Decode and transform logs to TransferEvent format
+            const events = logs
+                .map((log) => {
+                try {
+                    const decoded = decodeEventLog({
+                        abi: erc20Abi,
+                        data: log.data,
+                        topics: log.topics,
+                    });
+                    return {
+                        from: decoded.args.from,
+                        to: decoded.args.to,
+                        value: decoded.args.value,
+                        log: log,
+                    };
+                }
+                catch (error) {
+                    // Skip logs that can't be decoded
+                    if (params.onError) {
+                        params.onError(error instanceof Error ? error : new Error('Failed to decode Transfer event'));
+                    }
+                    return null;
+                }
+            })
+                .filter((event) => event !== null);
+            if (events.length > 0) {
+                params.onTransfer(events);
+            }
+        },
+        onError: params.onError,
+        pollingInterval: params.pollingInterval,
+    });
+}
+/**
+ * Watches for Transfer events involving a specific address (as sender or receiver).
+ * Convenience wrapper around watchTransfer for monitoring a single address.
+ *
+ * @param client - The PublicClient to use (WebSocket transport recommended)
+ * @param params - Transfer watching parameters for specific address
+ * @returns An unwatch function to stop the subscription
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient } from 'viem';
+ * import { createWebSocketTransport, watchTransferForAddress } from '@radiustechsystems/sdk/events';
+ * import { radiusTestnet } from '@radiustechsystems/sdk/chains';
+ *
+ * const client = createPublicClient({
+ *   chain: radiusTestnet,
+ *   transport: createWebSocketTransport(radiusTestnet),
+ * });
+ *
+ * // Watch all transfers involving an address (sent or received)
+ * const unwatch = watchTransferForAddress(client, {
+ *   tokenAddress: '0x...', // Token address
+ *   watchAddress: '0x...', // Address to monitor
+ *   onTransfer: (events) => {
+ *     events.forEach(event => {
+ *       if (event.from === watchAddress) {
+ *         console.log(`Sent ${event.value} to ${event.to}`);
+ *       } else {
+ *         console.log(`Received ${event.value} from ${event.from}`);
+ *       }
+ *     });
+ *   },
+ * });
+ *
+ * // Watch only transfers sent from an address
+ * const unwatchSent = watchTransferForAddress(client, {
+ *   tokenAddress: '0x...',
+ *   watchAddress: '0x...',
+ *   senderOnly: true,
+ *   onTransfer: (events) => {
+ *     console.log(`Sent ${events.length} transfers`);
+ *   },
+ * });
+ *
+ * // Stop watching
+ * unwatch();
+ * ```
+ *
+ * @remarks
+ * - If neither senderOnly nor receiverOnly is set, watches both directions
+ * - Cannot set both senderOnly and receiverOnly to true
+ * - More efficient than watching all transfers and filtering client-side
+ * - Server-side filtering reduces network traffic and processing
+ */
+export function watchTransferForAddress(client, params) {
+    // Validate parameters
+    if (params.senderOnly && params.receiverOnly) {
+        throw new Error('Cannot set both senderOnly and receiverOnly to true');
+    }
+    // Determine filter parameters
+    let from;
+    let to;
+    if (params.senderOnly) {
+        from = params.watchAddress;
+    }
+    else if (params.receiverOnly) {
+        to = params.watchAddress;
+    }
+    else {
+        // Watch both: need to create two separate subscriptions
+        // This is a limitation of eth_subscribe - can't do OR filters
+        // Use deduplication to prevent duplicate callbacks for the same event
+        const seenEvents = new Set();
+        const MAX_SEEN_EVENTS = 10000;
+        // Create a unique key for each event (using tx hash + log index)
+        const getEventKey = (event) => {
+            const txHash = event.log.transactionHash ?? 'pending';
+            const logIndex = event.log.logIndex ?? 0;
+            return `${txHash}-${logIndex}`;
+        };
+        // Wrapper that deduplicates events before calling the callback
+        const deduplicatedCallback = (events) => {
+            const newEvents = events.filter((event) => {
+                const key = getEventKey(event);
+                if (seenEvents.has(key)) {
+                    return false;
+                }
+                seenEvents.add(key);
+                return true;
+            });
+            // Bound the cache size to prevent memory leaks for long-running subscriptions
+            if (seenEvents.size > MAX_SEEN_EVENTS) {
+                // Remove oldest half of entries
+                const iterator = seenEvents.values();
+                for (let i = 0; i < MAX_SEEN_EVENTS / 2; i++) {
+                    const next = iterator.next();
+                    if (next.done)
+                        break;
+                    seenEvents.delete(next.value);
+                }
+            }
+            if (newEvents.length > 0) {
+                params.onTransfer(newEvents);
+            }
+        };
+        const unwatchFrom = watchTransfer(client, {
+            address: params.tokenAddress,
+            from: params.watchAddress,
+            onTransfer: deduplicatedCallback,
+            onError: params.onError,
+            sync: params.sync,
+            pollingInterval: params.pollingInterval,
+        });
+        const unwatchTo = watchTransfer(client, {
+            address: params.tokenAddress,
+            to: params.watchAddress,
+            onTransfer: deduplicatedCallback,
+            onError: params.onError,
+            sync: params.sync,
+            pollingInterval: params.pollingInterval,
+        });
+        // Return combined unwatch function
+        return () => {
+            unwatchFrom();
+            unwatchTo();
+        };
+    }
+    return watchTransfer(client, {
+        address: params.tokenAddress,
+        from,
+        to,
+        onTransfer: params.onTransfer,
+        onError: params.onError,
+        sync: params.sync,
+        pollingInterval: params.pollingInterval,
+    });
+}
+//# sourceMappingURL=watchTransfer.js.map

package/src/_esm/events/watchTransfer.js.map

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

package/src/_esm/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Radius TypeScript SDK v2
+ *
+ * A viem-based SDK for interacting with the Radius platform.
+ *
+ * @packageDocumentation
+ */
+export type { Abi, Address, Chain, Hash, Hex, LocalAccount, TransactionReceipt, Transport, } from 'viem';
+export { createPublicClient, createWalletClient, http } from 'viem';
+export { privateKeyToAccount } from 'viem/accounts';
+export { type SendTransactionBatchParameters, type SendTransactionBatchReturnType, sendTransactionBatch, } from './actions/index.js';
+export { MAX_GAS, radius, radiusTestnet } from './chains/index.js';
+export { type RadiusWalletActions, radiusWalletActions } from './decorators/index.js';
+export * from './errors/index.js';
+export * from './transport/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACX,GAAG,EACH,OAAO,EACP,KAAK,EACL,IAAI,EACJ,GAAG,EACH,YAAY,EACZ,kBAAkB,EAClB,SAAS,GACT,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EACN,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,oBAAoB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGtF,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC"}

package/src/_esm/index.js

@@ -0,0 +1,22 @@
+/**
+ * Radius TypeScript SDK v2
+ *
+ * A viem-based SDK for interacting with the Radius platform.
+ *
+ * @packageDocumentation
+ */
+// Re-export viem transport and client factories for convenience
+export { createPublicClient, createWalletClient, http } from 'viem';
+// Re-export viem account utilities
+export { privateKeyToAccount } from 'viem/accounts';
+// Actions
+export { sendTransactionBatch, } from './actions/index.js';
+// Chains
+export { MAX_GAS, radius, radiusTestnet } from './chains/index.js';
+// Decorators
+export { radiusWalletActions } from './decorators/index.js';
+// Errors
+export * from './errors/index.js';
+// Transport
+export * from './transport/index.js';
+//# sourceMappingURL=index.js.map

package/src/_esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,gEAAgE;AAChE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACpE,mCAAmC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,UAAU;AACV,OAAO,EAGN,oBAAoB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,aAAa;AACb,OAAO,EAA4B,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEtF,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,YAAY;AACZ,cAAc,sBAAsB,CAAC"}

package/src/_esm/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

package/src/_esm/transport/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Transport module for the Radius SDK.
+ * Provides HTTP request/response interceptors and middleware for
+ * JSON-RPC communication with Radius.
+ */
+export * from './interceptor.js';
+export * from './types.js';
+export * from './websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_esm/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/src/_esm/transport/index.js

@@ -0,0 +1,9 @@
+/**
+ * Transport module for the Radius SDK.
+ * Provides HTTP request/response interceptors and middleware for
+ * JSON-RPC communication with Radius.
+ */
+export * from './interceptor.js';
+export * from './types.js';
+export * from './websocket.js';
+//# sourceMappingURL=index.js.map

package/src/_esm/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/src/_esm/transport/interceptor.d.ts

@@ -0,0 +1,48 @@
+import { type Transport } from 'viem';
+import type { Interceptor, Logger, RequestHandler } from './types';
+/**
+ * A RequestHandler implementation that intercepts HTTP requests and responses.
+ * Provides request logging and response modification capabilities.
+ */
+export declare class InterceptingRequestHandler implements RequestHandler {
+    private readonly interceptor?;
+    private readonly logger?;
+    private readonly proxied;
+    /**
+     * Creates a new InterceptingRequestHandler.
+     * @param interceptor Optional function to intercept and modify responses
+     * @param logger Optional logging function to record requests and responses
+     * @param proxied Underlying RequestHandler implementation (defaults to fetch-based implementation)
+     */
+    constructor(interceptor?: Interceptor | undefined, logger?: Logger | undefined, proxied?: RequestHandler);
+    /**
+     * Sends a request and handles interception and logging of the response.
+     * @param request The HTTP request to send
+     * @returns The HTTP response, potentially modified by the interceptor
+     */
+    handle(request: Request): Promise<Response>;
+    /**
+     * Parse the body of a request, cloning the request to avoid modifying the original.
+     * @private
+     */
+    private parseRequestBody;
+}
+/**
+ * Options for creating an intercepting transport.
+ */
+export interface InterceptingTransportOptions {
+    /** The RPC URL to connect to */
+    url: string;
+    /** Optional function to intercept and modify responses */
+    interceptor?: Interceptor;
+    /** Optional logging function */
+    logger?: Logger;
+    /** Request timeout in milliseconds. Default: 10000 (10 seconds) */
+    timeout?: number;
+    /** Number of retry attempts. Default: 3 */
+    retryCount?: number;
+    /** Base delay between retries in milliseconds. Default: 150 */
+    retryDelay?: number;
+}
+export declare function createInterceptingTransport(options: InterceptingTransportOptions): Transport;
+//# sourceMappingURL=interceptor.d.ts.map

package/src/_esm/transport/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../transport/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnE;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,cAAc;IAQ/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IATzB;;;;;OAKG;gBAEe,WAAW,CAAC,EAAE,WAAW,YAAA,EACzB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,GAAE,cAA4C;IAGvE;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4CjD;;;OAGG;YACW,gBAAgB;CAY9B;AAsBD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AA4CD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,SAAS,CAyE5F"}

package/src/_esm/transport/interceptor.js

@@ -0,0 +1,209 @@
+import { custom, http } from 'viem';
+/**
+ * A RequestHandler implementation that intercepts HTTP requests and responses.
+ * Provides request logging and response modification capabilities.
+ */
+export class InterceptingRequestHandler {
+    interceptor;
+    logger;
+    proxied;
+    /**
+     * Creates a new InterceptingRequestHandler.
+     * @param interceptor Optional function to intercept and modify responses
+     * @param logger Optional logging function to record requests and responses
+     * @param proxied Underlying RequestHandler implementation (defaults to fetch-based implementation)
+     */
+    constructor(interceptor, logger, proxied = new DefaultRequestHandler()) {
+        this.interceptor = interceptor;
+        this.logger = logger;
+        this.proxied = proxied;
+    }
+    /**
+     * Sends a request and handles interception and logging of the response.
+     * @param request The HTTP request to send
+     * @returns The HTTP response, potentially modified by the interceptor
+     */
+    async handle(request) {
+        const reqBody = await this.parseRequestBody(request);
+        if (this.logger) {
+            this.logger('Request:', {
+                url: request.url,
+                method: request.method,
+                body: reqBody,
+            });
+        }
+        let response;
+        try {
+            response = await this.proxied.handle(request);
+            const body = await response.clone().text();
+            if (this.logger) {
+                this.logger('Response:', {
+                    status: response.status,
+                    body,
+                });
+            }
+            response = new Response(body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+            });
+        }
+        catch (error) {
+            if (this.logger) {
+                this.logger('Request failed', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            throw error;
+        }
+        if (this.interceptor) {
+            return this.interceptor(reqBody, response);
+        }
+        return response;
+    }
+    /**
+     * Parse the body of a request, cloning the request to avoid modifying the original.
+     * @private
+     */
+    async parseRequestBody(request) {
+        if (!request.body) {
+            return '';
+        }
+        try {
+            const clone = request.clone();
+            return await clone.text();
+        }
+        catch (error) {
+            throw new Error(`Failed to parse request body: ${error}`);
+        }
+    }
+}
+/**
+ * A simple implementation of RequestHandler that uses the Fetch API with timeout.
+ * @private
+ */
+class DefaultRequestHandler {
+    timeout;
+    constructor(timeout = 10000) {
+        this.timeout = timeout;
+    }
+    async handle(request) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(request, { signal: controller.signal });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Creates a viem-compatible transport that supports request interception and logging.
+ *
+ * When only logging is needed (no interceptor), this uses viem's native http() transport
+ * with `onFetchRequest`/`onFetchResponse` callbacks, which provides:
+ * - Built-in retry logic with exponential backoff
+ * - Timeout enforcement
+ * - Request batching support
+ *
+ * When response interception is needed, a custom transport is used with:
+ * - Timeout support via AbortController
+ * - Basic retry logic
+ *
+ * @param options Configuration options for the transport
+ * @returns A viem Transport that can be used with createPublicClient
+ *
+ * @example
+ * ```typescript
+ * // Logging only - uses viem's http() for best performance
+ * const transport = createInterceptingTransport({
+ *   url: 'https://rpc.testnet.radiustech.xyz',
+ *   logger: console.log,
+ * });
+ *
+ * // With response interception
+ * const transport = createInterceptingTransport({
+ *   url: 'https://rpc.testnet.radiustech.xyz',
+ *   interceptor: async (reqBody, response) => {
+ *     // Modify response if needed
+ *     return response;
+ *   },
+ * });
+ *
+ * const client = createPublicClient({
+ *   chain: radiusTestnet,
+ *   transport,
+ * });
+ * ```
+ */
+/** Counter for generating unique request IDs */
+let requestIdCounter = 0;
+export function createInterceptingTransport(options) {
+    const { url, interceptor, logger, timeout = 10000, retryCount = 3, retryDelay = 150 } = options;
+    // If no interceptor, use viem's native http() transport with callbacks
+    // This provides retry logic, timeout, and better performance
+    if (!interceptor) {
+        return http(url, {
+            timeout,
+            retryCount,
+            retryDelay,
+            onFetchRequest: logger
+                ? (request) => {
+                    logger('Request:', {
+                        url: request.url,
+                        method: request.method,
+                    });
+                }
+                : undefined,
+            onFetchResponse: logger
+                ? (response) => {
+                    logger('Response:', {
+                        status: response.status,
+                    });
+                }
+                : undefined,
+        });
+    }
+    // With interceptor, use custom transport that supports response modification
+    const defaultHandler = new DefaultRequestHandler(timeout);
+    const requestHandler = new InterceptingRequestHandler(interceptor, logger, defaultHandler);
+    const request = async ({ method, params }) => {
+        const body = JSON.stringify({
+            jsonrpc: '2.0',
+            id: ++requestIdCounter,
+            method,
+            params,
+        });
+        const httpRequest = new Request(url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+            },
+            body,
+        });
+        // Simple retry logic
+        let lastError;
+        for (let attempt = 0; attempt <= retryCount; attempt++) {
+            try {
+                const response = await requestHandler.handle(httpRequest.clone());
+                const result = await response.json();
+                if (result.error) {
+                    throw new Error(result.error.message || 'RPC Error');
+                }
+                return result.result;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < retryCount) {
+                    // Wait before retrying with exponential backoff
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay * 2 ** attempt));
+                }
+            }
+        }
+        throw lastError;
+    };
+    return custom({ request });
+}
+//# sourceMappingURL=interceptor.js.map

package/src/_esm/transport/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../transport/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,IAAI,EAAkB,MAAM,MAAM,CAAC;AAG3E;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAQpB;IACA;IACA;IATlB;;;;;OAKG;IACH,YACkB,WAAyB,EACzB,MAAe,EACf,UAA0B,IAAI,qBAAqB,EAAE;QAFrD,gBAAW,GAAX,WAAW,CAAc;QACzB,WAAM,GAAN,MAAM,CAAS;QACf,YAAO,GAAP,OAAO,CAA8C;IACpE,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE;gBACvB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YAE3C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;oBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,IAAI;iBACJ,CAAC,CAAC;YACJ,CAAC;YAED,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE;gBAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;aACzB,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;oBAC7B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC7D,CAAC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAAC,OAAgB;QAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACX,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9B,OAAO,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,qBAAqB;IACG;IAA7B,YAA6B,UAAkB,KAAK;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,OAAO,QAAQ,CAAC;QACjB,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;CACD;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,gDAAgD;AAChD,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAEzB,MAAM,UAAU,2BAA2B,CAAC,OAAqC;IAChF,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAEhG,uEAAuE;IACvE,6DAA6D;IAC7D,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,GAAG,EAAE;YAChB,OAAO;YACP,UAAU;YACV,UAAU;YACV,cAAc,EAAE,MAAM;gBACrB,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE;oBACZ,MAAM,CAAC,UAAU,EAAE;wBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;qBACtB,CAAC,CAAC;gBACJ,CAAC;gBACF,CAAC,CAAC,SAAS;YACZ,eAAe,EAAE,MAAM;gBACtB,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE;oBACb,MAAM,CAAC,WAAW,EAAE;wBACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;qBACvB,CAAC,CAAC;gBACJ,CAAC;gBACF,CAAC,CAAC,SAAS;SACZ,CAAC,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,IAAI,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAE3F,MAAM,OAAO,GAAqB,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,EAAE,gBAAgB;YACtB,MAAM;YACN,MAAM;SACN,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;aAClC;YACD,IAAI;SACJ,CAAC,CAAC;QAEH,qBAAqB;QACrB,IAAI,SAA4B,CAAC;QACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC;gBACJ,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAErC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC;gBACtD,CAAC;gBAED,OAAO,MAAM,CAAC,MAAM,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;oBAC1B,gDAAgD;oBAChD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAChF,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,SAAS,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/src/_esm/transport/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A logger function interface that matches the console.log function signature
+ * Used for logging JSON-RPC requests and responses
+ * @param message The log message to display
+ * @param data Optional structured data to include in the log
+ */
+export type Logger = (message: string, data?: Record<string, unknown>) => void;
+/**
+ * An interceptor function for modifying JSON-RPC HTTP requests and responses
+ * This allows for custom handling, validation, or manipulation of RPC calls
+ * @param reqBody The stringified JSON-RPC request body
+ * @param response The HTTP response from the JSON-RPC server
+ * @returns A potentially modified response or the original response
+ */
+export type Interceptor = (reqBody: string, response: Response) => Promise<Response>;
+/**
+ * An interface for making HTTP requests and receiving responses
+ * Handles the actual HTTP round-trip for JSON-RPC requests
+ */
+export interface RequestHandler {
+    /**
+     * Sends an HTTP request and returns the response
+     * @param request The HTTP request to send
+     * @returns A Promise that resolves to the HTTP response
+     * @throws Error if the request fails
+     */
+    handle(request: Request): Promise<Response>;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/_esm/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../transport/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5C"}

package/src/_esm/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/src/_esm/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../transport/types.ts"],"names":[],"mappings":""}