voltaire-effect 0.2.23 → 0.2.25

package/src/services/Provider/Streaming.ts

@@ -1,30 +0,0 @@
-/**
- * @fileoverview Live implementation of StreamingService using ProviderService.
- *
- * @module Streaming
- * @since 0.3.0
- */
-
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import { ProviderService } from "./ProviderService.js";
-import { StreamingService } from "./StreamingService.js";
-
-/**
- * Live implementation of the Streaming layer.
- *
- * @since 0.3.0
- */
-export const Streaming: Layer.Layer<StreamingService, never, ProviderService> =
-	Layer.effect(
-		StreamingService,
-		Effect.gen(function* () {
-			const provider = yield* ProviderService;
-			return {
-				watchBlocks: provider.watchBlocks,
-				backfillBlocks: provider.backfillBlocks,
-				subscribe: provider.subscribe,
-				unsubscribe: provider.unsubscribe,
-			};
-		}),
-	);

package/src/services/Provider/StreamingService.ts

@@ -1,58 +0,0 @@
-/**
- * @fileoverview Streaming service definition for streaming JSON-RPC calls.
- *
- * @module StreamingService
- * @since 0.3.0
- */
-
-import type {
-	BackfillOptions,
-	BlockInclude,
-	BlockStreamEvent,
-	BlocksEvent,
-	WatchOptions,
-} from "@tevm/voltaire/block";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Stream from "effect/Stream";
-import type {
-	BackfillBlocksError,
-	SubscribeError,
-	UnsubscribeError,
-	WatchBlocksError,
-} from "./ProviderService.js";
-
-/**
- * Shape of the Streaming service.
- *
- * @since 0.3.0
- */
-export type StreamingShape = {
-	/** Watch for new blocks with reorg detection */
-	readonly watchBlocks: <TInclude extends BlockInclude = "header">(
-		options?: WatchOptions<TInclude>,
-	) => Stream.Stream<BlockStreamEvent<TInclude>, WatchBlocksError>;
-	/** Backfill historical blocks */
-	readonly backfillBlocks: <TInclude extends BlockInclude = "header">(
-		options: BackfillOptions<TInclude>,
-	) => Stream.Stream<BlocksEvent<TInclude>, BackfillBlocksError>;
-	/** Subscribes to JSON-RPC streams (eth_subscribe) */
-	readonly subscribe?: (
-		subscription: string,
-		params?: readonly unknown[],
-	) => Effect.Effect<`0x${string}`, SubscribeError>;
-	/** Unsubscribes from JSON-RPC streams (eth_unsubscribe) */
-	readonly unsubscribe?: (
-		subscriptionId: `0x${string}`,
-	) => Effect.Effect<boolean, UnsubscribeError>;
-};
-
-/**
- * Streaming service for block streams and subscriptions.
- *
- * @since 0.3.0
- */
-export class StreamingService extends Context.Tag("StreamingService")<
-	StreamingService,
-	StreamingShape
->() {}

package/src/services/Provider/Transaction.ts

@@ -1,39 +0,0 @@
-/**
- * @fileoverview Live implementation of TransactionService using ProviderService.
- *
- * @module Transaction
- * @since 0.3.0
- */
-
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import { ProviderService } from "./ProviderService.js";
-import { TransactionService } from "./TransactionService.js";
-
-/**
- * Live implementation of the Transaction layer.
- *
- * @since 0.3.0
- */
-export const Transaction: Layer.Layer<
-	TransactionService,
-	never,
-	ProviderService
-> = Layer.effect(
-	TransactionService,
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return {
-			getTransaction: provider.getTransaction,
-			getTransactionReceipt: provider.getTransactionReceipt,
-			getTransactionByBlockHashAndIndex:
-				provider.getTransactionByBlockHashAndIndex,
-			getTransactionByBlockNumberAndIndex:
-				provider.getTransactionByBlockNumberAndIndex,
-			sendRawTransaction: provider.sendRawTransaction,
-			sendTransaction: provider.sendTransaction,
-			waitForTransactionReceipt: provider.waitForTransactionReceipt,
-			getTransactionConfirmations: provider.getTransactionConfirmations,
-		};
-	}),
-);

package/src/services/Provider/TransactionService.ts

@@ -1,83 +0,0 @@
-/**
- * @fileoverview Transaction service definition for transaction-related JSON-RPC calls.
- *
- * @module TransactionService
- * @since 0.3.0
- */
-
-import type { HexType } from "@tevm/voltaire/Hex";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type {
-	BlockTag,
-	GetTransactionByBlockHashAndIndexError,
-	GetTransactionByBlockNumberAndIndexError,
-	GetTransactionConfirmationsError,
-	GetTransactionError,
-	GetTransactionReceiptError,
-	HashInput,
-	ReceiptType,
-	RpcTransactionRequest,
-	SendRawTransactionError,
-	SendTransactionError,
-	TransactionIndexInput,
-	TransactionType,
-	WaitForTransactionReceiptError,
-} from "./ProviderService.js";
-
-/**
- * Shape of the Transaction service.
- *
- * @since 0.3.0
- */
-export type TransactionShape = {
-	/** Gets a transaction by hash */
-	readonly getTransaction: (
-		hash: HashInput,
-	) => Effect.Effect<TransactionType, GetTransactionError>;
-	/** Gets a transaction receipt */
-	readonly getTransactionReceipt: (
-		hash: HashInput,
-	) => Effect.Effect<ReceiptType, GetTransactionReceiptError>;
-	/** Gets a transaction by block hash and index (if supported) */
-	readonly getTransactionByBlockHashAndIndex?: (
-		blockHash: HashInput,
-		index: TransactionIndexInput,
-	) => Effect.Effect<TransactionType, GetTransactionByBlockHashAndIndexError>;
-	/** Gets a transaction by block number/tag and index (if supported) */
-	readonly getTransactionByBlockNumberAndIndex?: (
-		blockTag: BlockTag | bigint,
-		index: TransactionIndexInput,
-	) => Effect.Effect<TransactionType, GetTransactionByBlockNumberAndIndexError>;
-	/** Sends a signed raw transaction */
-	readonly sendRawTransaction: (
-		signedTx: HexType | `0x${string}`,
-	) => Effect.Effect<`0x${string}`, SendRawTransactionError>;
-	/** Sends a transaction via unlocked JSON-RPC account (if supported) */
-	readonly sendTransaction?: (
-		tx: RpcTransactionRequest,
-	) => Effect.Effect<`0x${string}`, SendTransactionError>;
-	/** Waits for a transaction to be confirmed */
-	readonly waitForTransactionReceipt: (
-		hash: HashInput,
-		opts?: {
-			confirmations?: number;
-			timeout?: number;
-			pollingInterval?: number;
-		},
-	) => Effect.Effect<ReceiptType, WaitForTransactionReceiptError>;
-	/** Gets the number of confirmations for a transaction */
-	readonly getTransactionConfirmations: (
-		hash: HashInput,
-	) => Effect.Effect<bigint, GetTransactionConfirmationsError>;
-};
-
-/**
- * Transaction service for transaction-related JSON-RPC operations.
- *
- * @since 0.3.0
- */
-export class TransactionService extends Context.Tag("TransactionService")<
-	TransactionService,
-	TransactionShape
->() {}

package/src/services/Provider/filters.ts

@@ -1,91 +0,0 @@
-/**
- * @fileoverview Filter-based subscription helpers for ProviderService.
- *
- * @module Provider/filters
- * @since 0.0.1
- */
-
-import * as Effect from "effect/Effect";
-import {
-	type CreateBlockFilterError,
-	type CreateEventFilterError,
-	type CreatePendingTransactionFilterError,
-	type EventFilter,
-	type FilterChanges,
-	type FilterId,
-	type GetFilterChangesError,
-	type GetFilterLogsError,
-	type LogType,
-	ProviderService,
-	type UninstallFilterError,
-} from "./ProviderService.js";
-
-/**
- * Creates an event log filter via eth_newFilter.
- */
-export const createEventFilter = (
-	filter?: EventFilter,
-): Effect.Effect<FilterId, CreateEventFilterError, ProviderService> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.createEventFilter(filter);
-	});
-
-/**
- * Creates a new block filter via eth_newBlockFilter.
- */
-export const createBlockFilter = (): Effect.Effect<
-	FilterId,
-	CreateBlockFilterError,
-	ProviderService
-> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.createBlockFilter();
-	});
-
-/**
- * Creates a pending transaction filter via eth_newPendingTransactionFilter.
- */
-export const createPendingTransactionFilter = (): Effect.Effect<
-	FilterId,
-	CreatePendingTransactionFilterError,
-	ProviderService
-> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.createPendingTransactionFilter();
-	});
-
-/**
- * Gets changes since last poll for a filter via eth_getFilterChanges.
- */
-export const getFilterChanges = (
-	filterId: FilterId,
-): Effect.Effect<FilterChanges, GetFilterChangesError, ProviderService> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.getFilterChanges(filterId);
-	});
-
-/**
- * Gets all logs for a filter via eth_getFilterLogs.
- */
-export const getFilterLogs = (
-	filterId: FilterId,
-): Effect.Effect<LogType[], GetFilterLogsError, ProviderService> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.getFilterLogs(filterId);
-	});
-
-/**
- * Uninstalls a filter via eth_uninstallFilter.
- */
-export const uninstallFilter = (
-	filterId: FilterId,
-): Effect.Effect<boolean, UninstallFilterError, ProviderService> =>
-	Effect.gen(function* () {
-		const provider = yield* ProviderService;
-		return yield* provider.uninstallFilter(filterId);
-	});

package/src/services/Provider/getBlobBaseFee.ts

@@ -1,170 +0,0 @@
-/**
- * @fileoverview EIP-4844 blob base fee helpers.
- *
- * @module Provider/getBlobBaseFee
- * @since 0.0.1
- */
-
-import {
-	GAS_PER_BLOB,
-	InvalidBlobCountError,
-	MAX_PER_TRANSACTION,
-} from "@tevm/voltaire/Blob";
-import { BlobBaseFee } from "@tevm/voltaire/FeeMarket";
-import * as Effect from "effect/Effect";
-import { TransportError } from "../Transport/TransportError.js";
-import { TransportService } from "../Transport/TransportService.js";
-import {
-	type BlockType,
-	type GetBlobBaseFeeError,
-	ProviderNotFoundError,
-	ProviderResponseError,
-} from "./ProviderService.js";
-
-const METHOD_NOT_FOUND = -32601;
-
-const parseHexToBigInt = (
-	method: string,
-	hex: string,
-): Effect.Effect<bigint, ProviderResponseError> =>
-	Effect.try({
-		try: () => BigInt(hex),
-		catch: (error) =>
-			new ProviderResponseError(
-				{ method, response: hex },
-				`Invalid hex response from RPC: ${hex}`,
-				{ cause: error instanceof Error ? error : undefined },
-			),
-	});
-
-const blobBaseFeeFromBlock = (
-	block: BlockType,
-): Effect.Effect<bigint, ProviderResponseError> => {
-	if (block.excessBlobGas === undefined || block.excessBlobGas === null) {
-		return Effect.fail(
-			new ProviderResponseError(
-				{ method: "eth_getBlockByNumber", blockNumber: block.number },
-				"Blob base fee not available for pre-Dencun blocks",
-			),
-		);
-	}
-
-	return parseHexToBigInt("eth_getBlockByNumber", block.excessBlobGas).pipe(
-		Effect.map((excessBlobGas) => BlobBaseFee(excessBlobGas)),
-	);
-};
-
-/**
- * Estimates blob gas usage for a given blob count.
- *
- * @param blobCount - Number of blobs
- * @returns Blob gas used (bigint)
- * @throws {InvalidBlobCountError} When blob count is negative or exceeds maximum
- *
- * @example
- * ```typescript
- * const blobGas = estimateBlobGas(3) // 393216n
- * ```
- */
-export const estimateBlobGas = (blobCount: number | bigint): bigint => {
-	const count = typeof blobCount === "bigint" ? blobCount : BigInt(blobCount);
-	const maxBlobs = BigInt(MAX_PER_TRANSACTION);
-
-	if (count < 0n || count > maxBlobs) {
-		throw new InvalidBlobCountError(
-			`Invalid blob count: ${blobCount} (max ${MAX_PER_TRANSACTION})`,
-			{
-				value: blobCount,
-				expected: `0-${MAX_PER_TRANSACTION} blobs`,
-			},
-		);
-	}
-
-	return count * BigInt(GAS_PER_BLOB);
-};
-
-/**
- * Calculates total blob fee from base fee and blob gas used.
- *
- * @param baseFee - Blob base fee (wei per blob gas)
- * @param blobGasUsed - Total blob gas used
- * @returns Total blob gas fee (wei)
- */
-export const calculateBlobGasPrice = (
-	baseFee: bigint,
-	blobGasUsed: bigint,
-): bigint => baseFee * blobGasUsed;
-
-/**
- * Gets the current blob base fee (EIP-4844).
- *
- * @description
- * Attempts to call `eth_blobBaseFee` and falls back to calculating the base
- * fee from the latest block's `excessBlobGas` if the RPC method is unavailable.
- *
- * @returns Effect yielding the blob base fee as bigint
- *
- * @example
- * ```typescript
- * const fee = yield* getBlobBaseFee()
- * ```
- */
-export const getBlobBaseFee = (): Effect.Effect<
-	bigint,
-	GetBlobBaseFeeError,
-	TransportService
-> =>
-	Effect.gen(function* () {
-		const transport = yield* TransportService;
-
-		const request = <T>(
-			method: string,
-			params?: unknown[],
-		): Effect.Effect<T, TransportError> =>
-			transport.request<T>(method, params).pipe(
-				Effect.mapError(
-					(error) =>
-						new TransportError(error.input, error.message, {
-							cause: error,
-							context: { method, params },
-						}),
-				),
-			);
-
-		const fromRpc: Effect.Effect<
-			bigint,
-			TransportError | ProviderResponseError
-		> = request<string>("eth_blobBaseFee").pipe(
-			Effect.flatMap((hex) => parseHexToBigInt("eth_blobBaseFee", hex)),
-		);
-
-		const fromBlock: Effect.Effect<
-			bigint,
-			TransportError | ProviderResponseError | ProviderNotFoundError
-		> = request<BlockType | null>("eth_getBlockByNumber", [
-			"latest",
-			false,
-		]).pipe(
-			Effect.flatMap((block) =>
-				block
-					? blobBaseFeeFromBlock(block)
-					: Effect.fail<ProviderResponseError | ProviderNotFoundError>(
-							new ProviderNotFoundError(
-								{ method: "eth_getBlockByNumber", params: ["latest", false] },
-								"Block not found",
-								{ resource: "block" },
-							),
-						),
-			),
-		);
-
-		const result: Effect.Effect<bigint, GetBlobBaseFeeError> = fromRpc.pipe(
-			Effect.catchTag(
-				"TransportError",
-				(error): Effect.Effect<bigint, GetBlobBaseFeeError> =>
-					error.code === METHOD_NOT_FOUND ? fromBlock : Effect.fail(error),
-			),
-		);
-
-		return yield* result;
-	});