import { RpcRequestError } from '../../errors/request.js' import { UrlRequiredError, type UrlRequiredErrorType, } from '../../errors/transport.js' import type { ErrorType } from '../../errors/utils.js' import { createBatchScheduler } from '../../utils/promise/createBatchScheduler.js' import { type HttpOptions, type RpcRequest, rpc } from '../../utils/rpc.js' import { type CreateTransportErrorType, type Transport, type TransportConfig, createTransport, } from './createTransport.js' export type BatchOptions = { /** The maximum number of JSON-RPC requests to send in a batch. @default 1_000 */ batchSize?: number /** The maximum number of milliseconds to wait before sending a batch. @default 0 */ wait?: number } export type HttpTransportConfig = { /** * Whether to enable Batch JSON-RPC. * @link https://www.jsonrpc.org/specification#batch */ batch?: boolean | BatchOptions /** * Request configuration to pass to `fetch`. * @link https://developer.mozilla.org/en-US/docs/Web/API/fetch */ fetchOptions?: HttpOptions['fetchOptions'] /** The key of the HTTP transport. */ key?: TransportConfig['key'] /** The name of the HTTP transport. */ name?: TransportConfig['name'] /** The max number of times to retry. */ retryCount?: TransportConfig['retryCount'] /** The base delay (in ms) between retries. */ retryDelay?: TransportConfig['retryDelay'] /** The timeout (in ms) for the HTTP request. Default: 10_000 */ timeout?: TransportConfig['timeout'] } export type HttpTransport = Transport< 'http', { url?: string } > export type HttpTransportErrorType = | CreateTransportErrorType | UrlRequiredErrorType | ErrorType /** * @description Creates a HTTP transport that connects to a JSON-RPC API. */ export function http( /** URL of the JSON-RPC API. Defaults to the chain's public RPC URL. */ url?: string, config: HttpTransportConfig = {}, ): HttpTransport { const { batch, fetchOptions, key = 'http', name = 'HTTP JSON-RPC', retryDelay, } = config return ({ chain, retryCount: retryCount_, timeout: timeout_ }) => { const { batchSize = 1000, wait = 0 } = typeof batch === 'object' ? batch : {} const retryCount = config.retryCount ?? retryCount_ const timeout = timeout_ ?? config.timeout ?? 10_000 const url_ = url || chain?.rpcUrls.default.http[0] if (!url_) throw new UrlRequiredError() return createTransport( { key, name, async request({ method, params }) { const body = { method, params } const { schedule } = createBatchScheduler({ id: `${url}`, wait, shouldSplitBatch(requests) { return requests.length > batchSize }, fn: (body: RpcRequest[]) => rpc.http(url_, { body, fetchOptions, timeout, }), }) const fn = async (body: RpcRequest) => batch ? schedule(body) : [await rpc.http(url_, { body, fetchOptions, timeout })] const [{ error, result }] = await fn(body) if (error) throw new RpcRequestError({ body, error, url: url_, }) return result }, retryCount, retryDelay, timeout, type: 'http', }, { url, }, ) } }