@asyncswap/eth-rpc 0.4.6 → 0.4.9

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @asyncswap/eth-rpc
 
+## 0.4.9
+
+### Patch Changes
+
+- e9fc1df: remove biome dep
+- Updated dependencies [e9fc1df]
+  - @asyncswap/jsonrpc@0.4.8
+
+## 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

package/README.md

@@ -26,58 +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);
-const bundle = {
- txs: ["0x123abc", "0x456def..."] as Hex[],
-
- blockNumber: "0xb63dcd" as Hex,
- minTimestamp: 0,
- maxTimestamp: 1615920932,
-};
-const body = client.rpc.buildRequest("eth_sendBundle", [bundle]);
-// const signature = wallet.sign(body)
-// const sender = wallet.address
-client
- .setHeaders({
-  "X-Flashbots-Signature": `0x<sender>:0x<signature>`,
- })
- .eth_sendBundle(bundle);
-```
-
-### 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);
-```
-
-## 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,35 +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
-	.setHeaders({
-		Authorization: `Bearer <jwt-token>`,
-	})
-	.engine_getPayloadV1("0x1");
-
-console.log(payload);
-
-import { FlashbotsClient } from "./src";
-
-const rpc = "https://relay.flashbots.net";
-const client = new FlashbotsClient(rpc);
-const bundle = {
-	txs: ["0x123abc", "0x456def..."] as Hex[],
-
-	blockNumber: "0xb63dcd" as Hex,
-	minTimestamp: 0,
-	maxTimestamp: 1615920932,
-};
-const body = client.rpc.buildRequest("eth_sendBundle", [bundle]);
-// const signature = wallet.sign(body)
-// const sender = wallet.address
-client
-	.setHeaders({
-		"X-Flashbots-Signature": `0x<sender>:0x<signature>`,
-	})
-	.eth_sendBundle(bundle);

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.6",
+	"version": "0.4.9",
 	"license": "MIT",
 	"type": "module",
 	"main": "dist/index.js",
@@ -34,13 +34,12 @@
 		"format": "bun biome format --write"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.3.11",
 		"@types/bun": "latest"
 	},
 	"peerDependencies": {
 		"typescript": "^5"
 	},
 	"dependencies": {
-		"@asyncswap/jsonrpc": "^0.4.7"
+		"@asyncswap/jsonrpc": "^0.4.8"
 	}
 }

package/src/base.ts

@@ -14,7 +14,20 @@ 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;

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/tsconfig.json

@@ -1,9 +1,7 @@
 {
 	"compilerOptions": {
 		// Environment setup & latest features
-		"lib": [
-			"ESNext"
-		],
+		"lib": ["ESNext"],
 		"target": "ESNext",
 		"module": "Preserve",
 		"moduleDetection": "force",
@@ -30,11 +28,6 @@
 		"noUnusedParameters": false,
 		"noPropertyAccessFromIndexSignature": false
 	},
-	"include": [
-		"src/**/*",
-		"global.d.ts"
-	],
-	"exclude": [
-		"example.ts"
-	]
+	"include": ["src/**/*", "global.d.ts"],
+	"exclude": ["example.ts"]
 }

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/identification.d.ts

@@ -1,24 +0,0 @@
-declare global {
-	export type ClientVersionV1 = {
-		code: ClientCode;
-		name: string;
-		varsion: string;
-		commit: string;
-	};
-	export type ClientCode =
-		| "BU" // besu
-		| "EJ" // ethereumJs
-		| "EG" // erigon
-		| "GE" // go-ethereum
-		| "GR" // gradine
-		| "LH" // lighthouse
-		| "LS" // lodestar
-		| "NM" // nethermind
-		| "NB" // nimbus
-		| "TE" // thin-execution
-		| "TK" // teku
-		| "PM" // prysm
-		| "RH"; // reth
-}
-
-export { };

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

@@ -1,130 +0,0 @@
-declare global {
-	export type EngineMethodsSpec = {
-		// identification
-		engine_getClientVersionV1: {
-			params: [ClientVersionV1];
-			result: ClientVersionV1[];
-		};
-		// share methods
-		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 { };