@ryanrfox/sdk 0.0.2 → 2.0.3

package/src/_types/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/_types/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/_types/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/_types/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/_types/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/_types/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/_types/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/_types/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/_types/transport/websocket.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WebSocket transport for Radius SDK.
+ * Provides a wrapper around viem's WebSocket transport with Radius-specific configuration.
+ */
+import { type Chain, type Transport } from 'viem';
+/**
+ * Configuration for creating a WebSocket transport.
+ */
+export interface WebSocketTransportConfig {
+    /** The WebSocket URL (defaults to chain's WebSocket RPC URL) */
+    url?: string;
+    /** Maximum number of reconnection attempts (defaults to 3) */
+    reconnectAttempts?: number;
+    /** Reconnection delay in milliseconds (defaults to 1000) */
+    reconnectDelay?: number;
+    /** Keep-alive interval in milliseconds (optional) */
+    keepAlive?: number;
+}
+/**
+ * Creates a WebSocket transport for use with Radius clients.
+ * Uses viem's webSocket transport under the hood with Radius-specific defaults.
+ *
+ * @param chain - The chain configuration (used to determine default WebSocket URL)
+ * @param config - Optional configuration for the WebSocket transport
+ * @returns A viem Transport configured for WebSocket connections
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient } from 'viem';
+ * import { createWebSocketTransport } from '@radiustechsystems/sdk/transport';
+ * import { radiusTestnet } from '@radiustechsystems/sdk/chains';
+ *
+ * const transport = createWebSocketTransport(radiusTestnet, {
+ *   reconnectAttempts: 5,
+ *   reconnectDelay: 2000,
+ * });
+ *
+ * const client = createPublicClient({
+ *   chain: radiusTestnet,
+ *   transport,
+ * });
+ * ```
+ *
+ * @remarks
+ * - The default WebSocket URL is derived from the chain configuration
+ * - For Radius Testnet, the default is: wss://rpc.testnet.radiustech.xyz
+ * - WebSocket connections are automatically managed by viem
+ * - Subscriptions are cleaned up automatically on disconnect
+ */
+export declare function createWebSocketTransport(chain: Chain, config?: WebSocketTransportConfig): Transport;
+//# sourceMappingURL=websocket.d.ts.map

package/src/_types/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../transport/websocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAa,MAAM,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,wBAAwB,GAC/B,SAAS,CAiCX"}