@asyncswap/eth-rpc 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @asyncswap/eth-rpc
 
+## 0.4.5
+
+### Patch Changes
+
+- 0d1be5d: upgrade with parameter typing
+- Updated dependencies [882f94f]
+  - @asyncswap/jsonrpc@0.4.7
+
+## 0.4.4
+
+### Patch Changes
+
+- b2b631f: deprecated `EthExecutionClien` use `ExecutionClient`
+- Updated dependencies [f7d28d9]
+  - @asyncswap/jsonrpc@0.4.4
+
 ## 0.4.3
 
 ### Patch Changes

package/README.md

@@ -13,10 +13,10 @@ bun add @asyncswap/eth-rpc
 ### Execution API Client
 
 ```typescript
-import { EthExecutionClient } from '@asyncswap/eth-rpc';
+import { ExecutionClient } from '@asyncswap/eth-rpc';
 
 const url = 'http://localhost:8545'
-const eth = new EthExecutionClient(url);
+const eth = new ExecutionClient(url);
 
 const balance = await eth.eth_getBalance(
   "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
@@ -42,7 +42,7 @@ import { EngineExecutionClient } from '@asyncswap/eth-rpc';
 
 const engineUrl = 'https://localhost:8551';
 const engine = new EngineExecutionClient(engineUrl, process.env.JWT_TOKEN!);
-const payload = engine.engine_getPayloadV1("0x1");
+const payload = await engine.engine_getPayloadV1("0x1");
 
 console.log(payload);
 

package/example.ts

@@ -1,8 +1,7 @@
-import { EthExecutionClient } from "./src";
+import { ExecutionClient } from "./src";
 
 const url = "http://localhost:8545";
-const eth = new EthExecutionClient(url);
-
+const eth = new ExecutionClient(url);
 const balance = await eth.eth_getBalance(
 	"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
 	"latest",
@@ -14,7 +13,7 @@ import { EngineExecutionClient } from "./src";
 
 const engineUrl = "https://localhost:8551";
 const engine = new EngineExecutionClient(engineUrl, process.env.JWT_TOKEN!);
-const payload = engine.engine_getPayloadV1("0x1");
+const payload = await engine.engine_getPayloadV1("0x1");
 
 console.log(payload);
 
@@ -22,5 +21,23 @@ import { FlashbotsClient } from "./src";
 
 const rpc = "https://relay.flashbots.net";
 const client = new FlashbotsClient(rpc);
-const body = client.rpc.buildRequest("eth_sendBundle", []);
-client.eth_accounts();
+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.3",
+	"version": "0.4.5",
 	"license": "MIT",
 	"type": "module",
 	"main": "dist/index.js",
@@ -41,6 +41,6 @@
 		"typescript": "^5"
 	},
 	"dependencies": {
-		"@asyncswap/jsonrpc": "^0.4.3"
+		"@asyncswap/jsonrpc": "^0.4.7"
 	}
 }

package/src/base.ts

@@ -0,0 +1,34 @@
+import { JsonRpcClient } from "@asyncswap/jsonrpc";
+
+export type RpcMethodSpec = {
+	params: readonly unknown[];
+	result: unknown;
+};
+export type RpcSpecBase = Record<string, RpcMethodSpec>;
+
+export abstract class BaseClient<MethodsSpec extends RpcSpecBase> {
+	rpc: JsonRpcClient<MethodsSpec>;
+	protected headers: Record<string, string> = {};
+
+	constructor(url: string) {
+		this.rpc = new JsonRpcClient(url);
+
+		return new Proxy(this, {
+			get: (_: this, prop: string | symbol) => {
+				if (typeof prop !== "string") return undefined;
+
+				const method = prop as keyof MethodsSpec;
+
+				return (...params: MethodsSpec[typeof method]["params"]) =>
+					this.rpc.call(this.rpc.buildRequest(method, params), this.headers);
+			},
+		});
+	}
+
+	setHeaders(headers: Record<string, string>) {
+		this.headers = {
+			...headers,
+		};
+		return this;
+	}
+}

package/src/engine-api.ts

@@ -1,37 +1,19 @@
-import { JsonRpcClient } from "@asyncswap/jsonrpc";
-
-export type EngineRpcMethods<
-	T extends Record<string, { params: unknown[]; result: unknown }>,
-> = {
-		[K in keyof T]: (...params: T[K]["params"]) => Promise<T[K]["result"]>;
-	};
-
-export class EngineExecutionClient {
-	rpc: JsonRpcClient;
-	headers: Record<string, string>;
+import { BaseClient } from "./base";
 
+export class EngineExecutionClient extends BaseClient<EngineMethodsSpec> {
 	constructor(url: string, jwt_token: string) {
+		super(url);
 		this.headers = {
 			Authorization: `Bearer ${jwt_token}`,
 		};
-		this.rpc = new JsonRpcClient(url);
-
-		return new Proxy(this, {
-			get: (_, method: string) => {
-				return (...params: unknown[]) =>
-					this.rpc.call(this.rpc.buildRequest(method, params), this.headers);
-			},
-		});
-	}
-
-	setHeaders(headers: Record<string, string>) {
-		this.headers = {
-			...this.headers,
-			...headers,
-		};
-		return this;
 	}
 }
 
+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/eth-api.ts

@@ -1,4 +1,10 @@
-import { JsonRpcClient } from "@asyncswap/jsonrpc";
+import { BaseClient } from "./base";
+
+export class ExecutionClient extends BaseClient<EthMethodsSpec> {
+	constructor(url: string) {
+		super(url);
+	}
+}
 
 export type EthRpcMethods<
 	T extends Record<string, { params: unknown[]; result: unknown }>,
@@ -6,28 +12,10 @@ export type EthRpcMethods<
 		[K in keyof T]: (...params: T[K]["params"]) => Promise<T[K]["result"]>;
 	};
 
-export class EthExecutionClient {
-	rpc: JsonRpcClient;
-	headers: Record<string, string> = {};
-
-	constructor(url: string) {
-		this.rpc = new JsonRpcClient(url);
-
-		return new Proxy(this, {
-			get: (_, method: string) => {
-				return (...params: unknown[]) =>
-					this.rpc.call(this.rpc.buildRequest(method, params), this.headers);
-			},
-		});
-	}
-
-	setAuth(headers: Record<string, string>) {
-		this.headers = {
-			...this.headers,
-			...headers,
-		};
-		return this;
-	}
-}
+export interface ExecutionClient extends EthRpcMethods<EthMethodsSpec> { }
 
-export interface EthExecutionClient extends EthRpcMethods<EthMethodsSpec> { }
+/**
+ * @deprecated Use `ExecutionClient` instead.
+ * This method will be removed in v0.5.0.
+ */
+export class EthExecutionClient extends ExecutionClient { }

package/src/index.ts

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

package/src/mev-api.ts

@@ -1,28 +1,17 @@
-import { JsonRpcClient } from "@asyncswap/jsonrpc";
-
-export type FlashbotsRpcMethods<
-	T extends Record<string, { params: unknown[]; result: unknown }>,
-> = {
-		[M in keyof T]: (...params: T[M]["params"]) => Promise<T[M]["result"]>;
-	};
-
-export class FlashbotsClient {
-	rpc: JsonRpcClient;
-	private headers: Record<string, string> = {};
+import { BaseClient } from "./base";
 
+export class FlashbotsClient extends BaseClient<FlashbotsMethodsSpec> {
 	constructor(url: string) {
-		this.rpc = new JsonRpcClient(url);
-
-		return new Proxy(this, {
-			get: (_, method: string) => {
-				return (...params: unknown[]) =>
-					this.rpc.call(this.rpc.buildRequest(method, params), this.headers);
-			},
-		});
+		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> { }