@asyncswap/eth-rpc 0.4.5 → 0.4.8

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @asyncswap/eth-rpc
 
+## 0.4.8
+
+### Patch Changes
+
+- cad9042: minimal eth rpc client
+
+  - ported engine api to different package
+
+## 0.4.7
+
+### Patch Changes
+
+- ff4e035: fix base client proxy
+
+  ```ts
+  setHeaders(...) {
+      this.headers = ...
+      return this; // ❌ returns the *target*
+  }
+  ```
+
+  The correct fix: return the receiver / proxy, not this
+
+  You already have access to the proxy inside the get trap via receiver.
+
+  So you must bind methods so that they return the proxy.
+
+  - setHeaders() mutates the target
+  - returns receiver (the proxy)
+  - chaining continues in proxy-land
+  - RPC methods remain visible
+
+## 0.4.6
+
+### Patch Changes
+
+- 3d6ec6e: add clinet version spec
+
 ## 0.4.5
 
 ### Patch Changes

package/README.md

@@ -26,48 +26,9 @@ console.log("Balance:", balance);
 eth.eth_getTransactionCount("0x34", "safe");
 ```
 
-### Flashbots Client API
+## References
 
-```ts
-import { FlashbotsClient } from "@asyncswap/eth-rpc";
-
-const rpc = "https://relay.flashbots.net";
-const client = new FlashbotsClient(rpc);
-```
-
-### Engine API Client
-
-```typescript
-import { EngineExecutionClient } from '@asyncswap/eth-rpc';
-
-const engineUrl = 'https://localhost:8551';
-const engine = new EngineExecutionClient(engineUrl, process.env.JWT_TOKEN!);
-const payload = await engine.engine_getPayloadV1("0x1");
-
-console.log(payload);
-
-import { FlashbotsClient } from '@asyncswap/eth-rpc';
-
-const rpc = 'https://relay.flashbots.net';
-const client = new FlashbotsClient(rpc);
-```
-
-## Error Handling
-
-All methods return typed responses. Handle errors appropriately:
-
-```typescript
-try {
-  const balance = await client.eth_getBalance(address, 'latest');
-  console.log('Balance:', balance);
-} catch (error) {
-  console.error('RPC Error:', error);
-}
-```
-
-## Type Safety
-
-Full TypeScript support with comprehensive type definitions for all RPC methods and responses.
+- [ethereum/execution-apis](https://github.com/ethereum/execution-apis)
 
 ## Dependencies
 

package/example.ts

@@ -8,36 +8,3 @@ const balance = await eth.eth_getBalance(
 );
 console.log("Balance:", balance);
 eth.eth_getTransactionCount("0x34", "safe");
-
-import { EngineExecutionClient } from "./src";
-
-const engineUrl = "https://localhost:8551";
-const engine = new EngineExecutionClient(engineUrl, process.env.JWT_TOKEN!);
-const payload = await engine.engine_getPayloadV1("0x1");
-
-console.log(payload);
-
-import { FlashbotsClient } from "./src";
-
-const rpc = "https://relay.flashbots.net";
-const client = new FlashbotsClient(rpc);
-const body = client.rpc.buildRequest("eth_sendBundle", [
-	{
-		txs: ["0x123abc", "0x456def..."],
-		blockNumber: "0xb63dcd",
-		minTimestamp: 0,
-		maxTimestamp: 1615920932,
-	} as EthSendBundleParams,
-]);
-// const signature = wallet.sign(body)
-// const signature = wallet.address
-client
-	.setHeaders({
-		"X-Flashbots-Signature": `0x<sender>:0x<signature>`,
-	})
-	.eth_sendBundle({
-		txs: ["0x123abc...", "0x456def..."],
-		blockNumber: "0xb63dcd",
-		minTimestamp: 0,
-		maxTimestamp: 1615920932,
-	});

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@asyncswap/eth-rpc",
 	"description": "A library for ethereum execution clients apis.",
 	"author": "Meek Msaki",
-	"version": "0.4.5",
+	"version": "0.4.8",
 	"license": "MIT",
 	"type": "module",
 	"main": "dist/index.js",

package/src/base.ts

@@ -14,12 +14,27 @@ export abstract class BaseClient<MethodsSpec extends RpcSpecBase> {
 		this.rpc = new JsonRpcClient(url);
 
 		return new Proxy(this, {
-			get: (_: this, prop: string | symbol) => {
+			get: (target: this, prop: string | symbol, receiver) => {
+				// let real properties / methods through
+				if (prop in target) {
+					const value = Reflect.get(target, prop, receiver);
+					if (typeof value === "function") {
+						return (...args: any[]) => {
+							const result = value.apply(target, args);
+							// if method returns target, return proxy instead
+							return result === target ? receiver : result;
+						};
+					}
+					return value;
+				}
+				// dynamic rpc
 				if (typeof prop !== "string") return undefined;
 
 				const method = prop as keyof MethodsSpec;
 
-				return (...params: MethodsSpec[typeof method]["params"]) =>
+				return (
+					...params: MethodsSpec[typeof method]["params"]
+				): MethodsSpec[typeof method]["result"] =>
 					this.rpc.call(this.rpc.buildRequest(method, params), this.headers);
 			},
 		});

package/src/eth-api.ts

@@ -7,7 +7,7 @@ export class ExecutionClient extends BaseClient<EthMethodsSpec> {
 }
 
 export type EthRpcMethods<
-	T extends Record<string, { params: unknown[]; result: unknown }>,
+	T extends Record<string, { params: readonly unknown[]; result: unknown }>,
 > = {
 		[K in keyof T]: (...params: T[K]["params"]) => Promise<T[K]["result"]>;
 	};

package/src/index.ts

@@ -1,4 +1,2 @@
 export * from "./base";
-export * from "./engine-api";
 export * from "./eth-api";
-export * from "./mev-api";

package/src/engine-api.ts

@@ -1,19 +0,0 @@
-import { BaseClient } from "./base";
-
-export class EngineExecutionClient extends BaseClient<EngineMethodsSpec> {
-	constructor(url: string, jwt_token: string) {
-		super(url);
-		this.headers = {
-			Authorization: `Bearer ${jwt_token}`,
-		};
-	}
-}
-
-export type EngineRpcMethods<
-	T extends Record<string, { params: unknown[]; result: unknown }>,
-> = {
-		[K in keyof T]: (...params: T[K]["params"]) => Promise<T[K]["result"]>;
-	};
-
-export interface EngineExecutionClient
-	extends EngineRpcMethods<EngineMethodsSpec> { }

package/src/mev-api.ts

@@ -1,17 +0,0 @@
-import { BaseClient } from "./base";
-
-export class FlashbotsClient extends BaseClient<FlashbotsMethodsSpec> {
-	constructor(url: string) {
-		super(url);
-	}
-
-	// "X-Flashbots-Signature": `${sender}:${signature}`,
-}
-
-export type FlashbotsRpcMethods<
-	T extends Record<string, { params: unknown[]; result: unknown }>,
-> = {
-		[M in keyof T]: (...params: T[M]["params"]) => Promise<T[M]["result"]>;
-	};
-export interface FlashbotsClient
-	extends FlashbotsRpcMethods<FlashbotsMethodsSpec> { }

package/src/types/engine/blob.d.ts

@@ -1,12 +0,0 @@
-declare global {
-	export interface BlobAndProofV1 {
-		blob: Bytes;
-		proof: Bytes48;
-	}
-	export interface BlobAndProofV2 {
-		blob: Bytes;
-		proofs: Bytes48[];
-	}
-}
-
-export { };

package/src/types/engine/forkchoice.d.ts

@@ -1,32 +0,0 @@
-declare global {
-	// forkchoice
-	export interface ForkchoiceStateV1 {
-		headBlockHash: Hash32;
-		safeBlockHash: Hash32;
-		finalizedBlockHash: Hash32;
-	}
-	export interface ForkchoiceUpdatedResponseV1 {
-		payloadStatus: RestrictedPayloadStatusV1;
-		payloadId?: Bytes8;
-	}
-	export interface PayloadAttributesV1 {
-		timestamp: Uint64;
-		prevRandao: Bytes32;
-		suggestedFeeRecipient: Address;
-	}
-	export interface PayloadAttributesV2 {
-		timestamp: Uint64;
-		prevRandao: Bytes32;
-		suggestedFeeRecipient: Address;
-		withdrawals: WithdrawalV1[];
-	}
-	export interface PayloadAttributesV3 {
-		timestamp: Uint64;
-		prevRandao: Bytes32;
-		suggestedFeeRecipient: Address;
-		withdrawals: WithdrawalV1[];
-		parentBeaconBlockRoot: Hash32;
-	}
-}
-
-export { };

package/src/types/engine/methods.d.ts

@@ -1,124 +0,0 @@
-declare global {
-	export type EngineMethodsSpec = {
-		eth_blockNumber: { params: []; result: Uint };
-		eth_call: {
-			params: [GenericTransaction, BlockNumberOrTagOrHash];
-			result: Bytes;
-		};
-		eth_chainId: { params: []; result: Uint };
-		eth_getCode: { params: [Address, BlockNumberOrTagOrHash]; result: Bytes };
-		eth_getBlockByHash: { params: [Hash32, boolean]; result: NotFound | Block };
-		eth_getBlockByNumber: {
-			params: [BlockNumberOrTag, boolean];
-			result: NotFound | Block;
-		};
-		eth_getLogs: { params: [Filter]; result: FilterResults };
-		eth_sendRawTransaction: { params: [Bytes]; result: Hash32 };
-		eth_syncing: { params: []; result: SyncingStatus };
-		// engine/blob
-		engine_getBlobsV1: { params: [Hash32[]]; result: BlobAndProofV1[] };
-		engine_getBlobsV2: { params: [Hash32[]]; result: BlobAndProofV2[] };
-		engine_getBlobsV3: {
-			params: [Hash32[]];
-			result: Array<BlobAndProofV2[] | null> | null;
-		};
-		// engine/capabilities
-		engine_exchangeCapabilities: { params: [string[]]; result: string[] };
-		// engine/forkchoice
-		engine_forkchoiceUpdatedV1: {
-			params: [ForkchoiceStateV1, PayloadAttributesV1];
-			result: ForkchoiceUpdatedResponseV1;
-		};
-		engine_forkchoiceUpdatedV2: {
-			params: [ForkchoiceStateV1, PayloadAttributesV2];
-			result: ForkchoiceUpdatedResponseV1;
-		};
-		engine_forkchoiceUpdatedV3: {
-			params: [ForkchoiceStateV1, PayloadAttributesV3];
-			result: ForkchoiceUpdatedResponseV1;
-		};
-		// engine/payload
-		engine_newPayloadV1: {
-			params: [ExecutionPayloadV1];
-			result: PayloadStatusV1;
-		};
-		engine_newPayloadV2: {
-			params: [ExecutionPayloadV1 | ExecutionPayloadV2];
-			result: PayloadStatusNoInvalidBlockHash;
-		};
-		engine_newPayloadV3: {
-			params: [ExecutionPayloadV3, Hash32[], Hash32];
-			result: PayloadStatusNoInvalidBlockHash;
-		};
-		engine_newPayloadV4: {
-			params: [ExecutionPayloadV3, Hash32[], Hash32, Bytes[]];
-			result: PayloadStatusNoInvalidBlockHash;
-		};
-		engine_getPayloadV1: { params: [Bytes8]; result: ExecutionPayloadV1 };
-		engine_getPayloadV2: {
-			params: [Bytes8];
-			result: {
-				executionPayload: ExecutionPayloadV1 | ExecutionPayloadV2;
-				blockValue: Uint256;
-			};
-		};
-		engine_getPayloadV3: {
-			params: [Bytes8];
-			result: {
-				executionPayload: ExecutionPayloadV3;
-				blockValue: Uint256;
-				blobsBundle: BlobsBundleV1;
-				shouldOverrideBuilder: boolean;
-			};
-		};
-		engine_getPayloadV4: {
-			params: [Bytes8];
-			result: {
-				executionPayload: ExecutionPayloadV3;
-				blockValue: Uint256;
-				blobsBundle: BlobsBundleV1;
-				shouldOverrideBuilder: boolean;
-				executionRequests: Bytes[];
-			};
-		};
-		engine_getPayloadV5: {
-			params: [Bytes8];
-			result: {
-				executionPayload: ExecutionPayloadV3;
-				blockValue: Uint256;
-				blobsBundle: BlobsBundleV2;
-				shouldOverrideBuilder: boolean;
-				executionRequests: Bytes[];
-			};
-		};
-		engine_getPayloadBodiesByHashV1: {
-			params: [Hash32[]];
-			result: ExecutionPayloadBodyV1[];
-		};
-		engine_getPayloadBodiesByRangeV1: {
-			params: [Uint64, Uint64];
-			result: ExecutionPayloadBodyV1[];
-		};
-		engine_newPayloadV5: {
-			params: [ExecutionPayloadV4, Hash32[], Hash32, Bytes[]];
-			result: PayloadStatusNoInvalidBlockHash;
-		};
-		engine_getPayloadV6: {
-			params: [Bytes8];
-			result: {
-				executionPayload: ExecutionPayloadV4;
-				blockValue: Uint256;
-				blobsBundle: BlobsBundleV2;
-				shouldOverrideBuilder: boolean;
-				executionRequests: Bytes[];
-			};
-		};
-		// engine/transition-configuration
-		engine_exchangeTransitionConfigurationV1: {
-			params: [TransitionConfigurationV1];
-			result: TransitionConfigurationV1;
-		};
-	};
-}
-
-export { };

package/src/types/engine/payload.d.ts

@@ -1,121 +0,0 @@
-declare global {
-	export enum PAYLOAD_STATUS {
-		VALID = "VALID",
-		INVALID = "INVALID",
-		SYNCING = "SYNCING",
-		ACCEPTED = "ACCEPTED",
-		INVALID_BLOCK_HASH = "INVALID_BLOCK_HASH",
-	}
-	export interface PayloadStatusV1 {
-		status: PAYLOAD_STATUS;
-		latestValidHash?: Hash32;
-		validationError?: string;
-	}
-	export interface RestrictedPayloadStatusV1 {
-		status:
-		| PAYLOAD_STATUS.VALID
-		| PAYLOAD_STATUS.INVALID
-		| PAYLOAD_STATUS.SYNCING;
-		latestValidHash: Hash32;
-		validationError: string;
-	}
-	export interface PayloadStatusNoInvalidBlockHash {
-		status: Exclude<PAYLOAD_STATUS, PAYLOAD_STATUS.INVALID_BLOCK_HASH>;
-		latestValidHash: Hash32;
-		validationError: string;
-	}
-	export interface ExecutionPayloadV1 {
-		parentHash: Hash32;
-		feeRecipient: Address;
-		stateRoot: Bytes32;
-		receiptsRoot: Bytes32;
-		logsBloom: Bytes256;
-		prevRandao: Bytes32;
-		blockNumber: Uint64;
-		gasLimit: Uint64;
-		gasUsed: Uint64;
-		timestamp: Uint64;
-		extraData: Bytes32;
-		baseFeePerGas: Uint64;
-		blockHash: Hash32;
-		transactions: Bytes[];
-	}
-	export interface WithdrawalV1 {
-		index: Uint64;
-		validatorIndex: Uint64;
-		address: Address;
-		amount: Uint64;
-	}
-	export interface ExecutionPayloadV2 {
-		parentHash: Hash32;
-		feeRecipient: Address;
-		stateRoot: Bytes32;
-		receiptsRoot: Bytes32;
-		logsBloom: Bytes256;
-		prevRandao: Bytes32;
-		blockNumber: Uint64;
-		gasLimit: Uint64;
-		gasUsed: Uint64;
-		timestamp: Uint64;
-		extraData: Bytes32;
-		baseFeePerGas: Uint64;
-		blockHash: Hash32;
-		transactions: Bytes[];
-		withdrawals: WithdrawalV1[];
-	}
-	export interface ExecutionPayloadV3 {
-		parentHash: Hash32;
-		feeRecipient: Address;
-		stateRoot: Bytes32;
-		receiptsRoot: Bytes32;
-		logsBloom: Bytes256;
-		prevRandao: Bytes32;
-		blockNumber: Uint64;
-		gasLimit: Uint64;
-		gasUsed: Uint64;
-		timestamp: Uint64;
-		extraData: Bytes32;
-		baseFeePerGas: Uint64;
-		blockHash: Hash32;
-		transactions: Bytes[];
-		withdrawals: WithdrawalV1[];
-		blobGasUsed: Uint64;
-		excessBlobGas: Uint64;
-	}
-	export interface ExecutionPayloadV4 {
-		parentHash: Hash32;
-		feeRecipient: Address;
-		stateRoot: Bytes32;
-		receiptsRoot: Bytes32;
-		logsBloom: Bytes256;
-		prevRandao: Bytes32;
-		blockNumber: Uint64;
-		gasLimit: Uint64;
-		gasUsed: Uint64;
-		timestamp: Uint64;
-		extraData: Bytes32;
-		baseFeePerGas: Uint64;
-		blockHash: Hash32;
-		transactions: Bytes[];
-		withdrawals: WithdrawalV1[];
-		blobGasUsed: Uint64;
-		excessBlobGas: Uint64;
-		blockAccessList: Bytes;
-	}
-	export interface ExecutionPayloadBodyV1 {
-		transactions: Bytes[];
-		withdrawals?: WithdrawalV1[];
-	}
-	export interface BlobsBundleV1 {
-		commitments: Bytes48[];
-		proofs: Bytes48[];
-		blobs: Bytes[];
-	}
-	export interface BlobsBundleV2 {
-		commitments: Bytes48[];
-		proofs: Bytes48[];
-		blobs: Bytes[];
-	}
-}
-
-export { };

package/src/types/engine/transition-configuration.d.ts

@@ -1,10 +0,0 @@
-declare global {
-	// engine types
-	export interface TransitionConfigurationV1 {
-		terminalTotalDifficulty: Uint256;
-		terminalBlockHash: Hash32;
-		terminalBlockNumber: Uint64;
-	}
-}
-
-export { };

package/src/types/mev/methods.d.ts

@@ -1,87 +0,0 @@
-declare global {
-	export type FlashbotsMethodsSpec = {
-		eth_sendBundle: {
-			params: [EthSendBundleParams];
-			result: EthSendBundleResult;
-		};
-		eth_callBundle: {
-			params: [EthCallBundleParams];
-			result: EthCallBundleResult;
-		};
-		mev_sendBundle: {
-			params: [MevSendBundleParams];
-			result: MevSendBundleResult;
-		};
-		mev_simBundle: {
-			params: [MevSimBundleParams, { parentBlock: Hash32 }];
-			result: MevSimBundleResult;
-		};
-		eth_cancelBundle: {
-			params: [EthCancelBundleParams];
-			result: EthCancelBundleResult;
-		};
-		eth_sendPrivateTransaction: {
-			params: [EthSendPrivateTransactionParams];
-			result: EthSendPrivateTransactionResult;
-		};
-		eth_sendPrivateRawTransaction: {
-			params: [EthSendPrivateRawTransactionParams];
-			result: EthSendPrivateRawTransactionResult;
-		};
-		eth_cancelPrivateTransaction: {
-			params: [EthCancelPrivateTransactioParams];
-			result: EthCancelPrivateTransactionResult;
-		};
-
-		flashbots_getFeeRefundTotalsByRecipient: {
-			params: GetFeeRefundTotalsByRecipientParams[];
-			result: GetFeeRefundTotalsByRecipientResult;
-		};
-		flashbots_getFeeRefundsByRecipient: {
-			params: [GetFeeRefundsByRecipientParams];
-			result: GetFeeRefundsByRecipientResult;
-		};
-		flashbots_getFeeRefundsByBlock: {
-			params: [GetFeeRefundsByBlockParams];
-			result: GetFeeRefundsByBlockResult;
-		};
-		flashbots_getFeeRefundsByBundle: {
-			params: [GetFeeRefundsByBundleParams];
-			result: GetFeeRefundsByBundleResult;
-		};
-		flashbots_setFeeRefundRecipient: {
-			params: [Address, Address];
-			result: { from: Address; to: Address };
-		};
-		buildernet_getDelayedRefunds: {
-			params: [GetDelayedRefundsParams];
-			result: GetDelayedRefundsResult;
-		};
-		buildernet_getDelayedRefundTotalsByRecipient: {
-			params: [GetDelayedRefundTotalsByRecipientParams];
-			result: GetDelayedRefundTotalsByRecipientResult;
-		};
-		flashbots_getMevRefundTotalByRecipient: {
-			params: [Address];
-			result: { total: Hex };
-		};
-		flashbots_getMevRefundTotalBySender: {
-			params: [Address];
-			result: { total: Hex };
-		};
-	} & EthMethodsSpec;
-
-	export enum BuilderNetMethods {
-		eth_sendBundle = "eth_sendBundle",
-		eth_sendRawTransaction = "eth_sendRawTransaction",
-		buildernet_getFeeRefundTotalsByRecipient = "buildernet_getFeeRefundTotalsByRecipient",
-		buildernet_getFeeRefundsByRecipient = "buildernet_getFeeRefundsByRecipient",
-		buildernet_getFeeRefundsByBlock = "buildernet_getFeeRefundsByBlock",
-		buildernet_getFeeRefundsByBundle = "buildernet_getFeeRefundsByBundle",
-		buildernet_setFeeRefundRecipient = "buildernet_setFeeRefundRecipient",
-		buildernet_getDelayedRefunds = "buildernet_getDelayedRefunds",
-		buildernet_getDelayedRefundTotalsByRecipient = "buildernet_getDelayedRefundTotalsByRecipient",
-	}
-}
-
-export { };

package/src/types/mev/types.d.ts

@@ -1,231 +0,0 @@
-declare global {
-	export type GetDelayedRefundTotalsByRecipientParams = {
-		recipient: Address;
-		blockRangeFrom?: Hex;
-		blockRangeTo?: Hex;
-	};
-	export type GetDelayedRefundTotalsByRecipientResult = {
-		pending: Hex;
-		received: Hex;
-		indexedUpTo: Hex;
-	};
-
-	export type GetDelayedRefundsParams = {
-		recipient: Address;
-		blockRangeFrom?: Hex;
-		blockRangeTo?: Hex;
-		cursor?: Hex;
-		hash?: Hash32;
-	};
-	export type GetDelayedRefundsResult = {
-		refunds: Refund[];
-		nextCursor: Hex;
-		indexedUpTo: Hex;
-	};
-	export type GetFeeRefundsByBlockParams = {
-		block_number: Hex;
-	};
-	export type GetFeeRefundsByBlockResult = unknown;
-	export type GetFeeRefundsByBundleParams = {
-		bundle_hash: Hex;
-	};
-	export type GetFeeRefundsByBundleResult = unknown;
-	export type GetFeeRefundsByRecipientParams = {
-		recipient: Address;
-		cursor?: Hex;
-	};
-	export type Refund = {
-		hash: Hex;
-		amount: Hex;
-		blockNumber: Hex;
-		status: "pending" | "received";
-		recipient: Address;
-	};
-	export type GetFeeRefundsByRecipientResult = {
-		refunds: Refund[];
-		cursor: string;
-	};
-	export type GetFeeRefundTotalsByRecipientParams = {
-		recipient: Address;
-	};
-	export type GetFeeRefundTotalsByRecipientResult = {
-		pending: Hex;
-		received: Hex;
-		maxBlockNumber: Hex;
-	};
-	export type EthCancelPrivateTransactioParams = {
-		txHash: Hex;
-	};
-	export type EthCancelPrivateTransactionResult = boolean;
-
-	export type EthSendPrivateRawTransactionParams = {
-		// String, raw signed transaction
-		tx: Hex;
-		preferences?: {
-			// Sends transactions to all registered block builders, sets MEV-Share revenue share to 50%
-			fast: boolean;
-			privacy?: {
-				hints?: BundleHints;
-				builders?: Builders[];
-			};
-			validity?: {
-				refund?: Array<{ address: Address; percent: number }>;
-			};
-		};
-	};
-	export type EthSendPrivateRawTransactionResult = Hash32;
-
-	export type EthSendPrivateTransactionParams = {
-		tx: Hex;
-		maxBlockNumber: Hex;
-		preferences?: {
-			// Sends transactions to all registered block builders, sets MEV-Share revenue share to 50%
-			fast: boolean;
-			privacy?: {
-				hints?: BundleHints;
-				builders?: Builders[];
-			};
-			validity?: {
-				refund?: Array<{ address: Address; percent: number }>;
-			};
-		};
-	};
-	export type EthSendPrivateTransactionResult = Hash32;
-	export type EthCancelBundleParams = {
-		replacementUuid: string;
-	};
-	export type EthCancelBundleResult = unknown;
-
-	export type EthSendBundleParams = {
-		txs: Hex[];
-		blockNumber: Hex | "0x" | null; // 0x | null or missing field for next block only
-		// Replacing: send bundle with same replacementUuid to override previous one
-		// Canceling: send bundle with same replacementUuid and empty list of transactions to cancel
-		replacementUuid?: string;
-		revertingTxHashes?: Hex[];
-		minBlockNumber?: Hex;
-		maxBlockNumber?: Hex;
-		minFlashblockNumber?: Hex;
-		maxFlashblockNumber?: Hex;
-		minTimestamp?: number;
-		maxTimestamp?: number;
-		builders?: Builders[];
-	};
-	export type EthCallBundleParams = {
-		txs: Hex[];
-		blockNumber: Hex;
-		stateBlockNumber: string | "latest";
-		timestamp: number;
-	};
-	export type MevSendBundleParams = {
-		version: "v0.1";
-		inclusion: Inclusion;
-		body: BundleBody;
-		validity?: BundleValidity;
-		privacy?: BundlePrivacy;
-	};
-	export type MevSimBundleParams = {
-		version: "beta-1";
-		inclusion: Inclusion;
-		body: BundleBody;
-		validity: BundleValidity;
-		privacy?: BundlePrivacy;
-		metadata?: BundleMetadata;
-		simOptions?: BundleSimOptions;
-	};
-	export type Inclusion = {
-		block: string;
-		maxBlock?: string;
-	};
-	export type BundleBody = Array<
-		| { hash: string } // tx hash
-		| { tx: string; canRevert: boolean } // signed tx
-		| { bundle: MevSendBundleParams[] }
-	>;
-	export type BundleValidity = {
-		refund?: Array<{ bodyIdx: number; percent: number }>;
-		refundConfig?: Array<{ address: string; percent: number }>;
-	};
-	export type BundlePrivacy = {
-		hints?: BundleHints[];
-		builders?: Builders[];
-	};
-	export type BundleMetadata = { originId?: string };
-	export type BundleSimOptions = {
-		parentBlock?: number | string; // Block used for simulation state. Defaults to latest block.
-		blockNumber?: number; // default = parentBlock.number + 1
-		coinbase?: string; // default = parentBlock.coinbase
-		timestamp?: number; // default = parentBlock.timestamp + 12
-		gasLimit?: number; // default = parentBlock.gasLimit
-		baseFee?: bigint; // default = parentBlock.baseFeePerGas
-		timeout?: number; // default = 5 (defined in seconds)
-	};
-	export type EthSendBundleResult = { bundleHash: Hex; smart: boolean };
-	export type MevSendBundleResult = { bundleHash: Hex };
-	export type BundleHints =
-		| "calldata"
-		| "contract_address"
-		| "logs"
-		| "function_selector"
-		| "hash"
-		| "tx_hash";
-
-	export type EthCallBundleResult = {
-		bundleGasPrice: Uint;
-		bundleHash: Hash32;
-		coinbaseDiff: Uint;
-		ethSentToCoinbase: Uint;
-		gasFees: Uint;
-		results: Array<{
-			coinbaseDiff: Uint;
-			ethSentToCoinbase: Uint;
-			fromAddress: Address;
-			gasFees: Uint;
-			gasPrice: Uint;
-			gasUsed: number;
-			toAddress: Address;
-			txHash: Hash32;
-			value: Hex;
-		}>;
-		stateBlockNumber: number;
-		totalGasUsed: number;
-	};
-	export type MevSimBundleResult = {
-		success: boolean;
-		error?: string;
-		stateBlock: Hex;
-		mevGasPrice: Hex;
-		profit: Hex;
-		refundableValue: Hex;
-		gasUsed: Hex;
-		logs?: Array<{
-			txLogs?: Log[];
-			bundleLogs?: MevSimBundleResult[];
-		}>;
-	};
-	export type Builders =
-		| "default"
-		| "flashbots"
-		| "f1b.io"
-		| "rsync"
-		| "beaverbuild.org"
-		| "builder0x69"
-		| "Titan"
-		| "EigenPhi"
-		| "boba-builder"
-		| "Gambit"
-		| "payload"
-		| "Loki"
-		| "BuildAI"
-		| "JetBuilder"
-		| "tbuilder"
-		| "penguinbuild"
-		| "bobthebuilder"
-		| "BTCS"
-		| "bloXroute"
-		| "Blockbeelder"
-		| "Quasar"
-		| "Eureka";
-}
-
-export { };