@asyncswap/eth-rpc 0.4.2 → 0.4.3

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

@@ -1,55 +1,108 @@
 declare global {
-	export enum EthMethods {
-		// eth/transaction
-		eth_getTransactionByHash = "eth_getTransactionByHash",
-		eth_getTransactionByBlockHashAndIndex = "eth_getTransactionByBlockHashAndIndex",
-		eth_getTransactionReceipt = "eth_getTransactionReceipt",
+	export type EthMethodsSpec = {
+		eth_getTransactionByHash: {
+			params: [Hash32];
+			result: NotFound | TransactionInfo;
+		};
+		eth_getTransactionByBlockHashAndIndex: {
+			params: [Hash32, Uint];
+			result: NotFound | TransactionInfo;
+		};
+		eth_getTransactionReceipt: {
+			params: [Hash32];
+			result: NotFound | ReceiptInfo;
+		};
 		// eth/submit
-		eth_sendTransaction = "eth_sendTransaction",
-		eth_sendRawTransaction = "eth_sendRawTransaction",
+		eth_sendTransaction: { params: [GenericTransaction]; result: Hash32 };
+		eth_sendRawTransaction: { params: [Bytes]; result: Hash32 };
 		// eth/state
-		eth_getBalance = "eth_getBalance",
-		eth_getStorageAt = "eth_getStorageAt",
-		eth_getTransactionCount = "eth_getTransactionCount",
-		eth_getCode = "eth_getCode",
-		eth_getProof = "eth_getProof",
+		eth_getBalance: {
+			params: [Address, BlockNumberOrTagOrHash];
+			result: Uint;
+		};
+		eth_getStorageAt: {
+			params: [Address, Bytes32, BlockNumberOrTagOrHash];
+			result: Bytes;
+		};
+		eth_getTransactionCount: {
+			params: [Address, BlockNumberOrTagOrHash];
+			result: Uint;
+		};
+		eth_getCode: {
+			params: [Address, BlockNumberOrTagOrHash];
+			result: Bytes;
+		};
+		eth_getProof: {
+			params: [Address, Bytes32[], BlockNumberOrTagOrHash];
+			result: AccountProof;
+		};
 		// eth/sign
-		eth_sign = "eth_sign",
-		eth_signTransaction = "eth_signTransaction",
+		eth_sign: { params: [Address, Bytes]; result: Bytes65 };
+		eth_signTransaction: { params: [GenericTransaction]; result: Bytes };
 		// eth/filter
-		eth_newFilter = "eth_newFilter",
-		eth_newBlockFilter = "eth_newBlockFilter",
-		eth_newPendingTransactionFilter = "eth_newPendingTransactionFilter",
-		eth_uninstallFilter = "eth_uninstallFilter",
-		eth_getFilterChanges = "eth_getFilterChanges",
-		eth_getFilterLogs = "eth_getFilterLogs",
-		eth_getLogs = "eth_getLogs",
+		eth_newFilter: { params: [Filter]; result: Uint };
+		eth_newBlockFilter: { params: []; result: Uint };
+		eth_newPendingTransactionFilter: { params: []; result: Uint };
+		eth_uninstallFilter: { params: []; result: Uint };
+		eth_getFilterChanges: { params: []; result: FilterResults };
+		eth_getFilterLogs: { params: [Uint]; result: FilterResults };
+		eth_getLogs: { params: [Filter]; result: FilterResults };
 		// eth/feeMarket
-		eth_gasPrice = "eth_gasPrice",
-		eth_blobBaseFee = "eth_blobBaseFee",
-		eth_maxPriorityFeePerGas = "eth_maxPriorityFeePerGas",
-		eth_feeHistory = "eth_feeHistory",
+		eth_gasPrice: { params: []; result: Uint };
+		eth_blobBaseFee: { params: []; result: Uint };
+		eth_maxPriorityFeePerGas: { params: []; result: Uint };
+		eth_feeHistory: {
+			params: [Uint, BlockNumberOrTag, number[]];
+			result: FeeHistoryResults;
+		};
 		// eth/execute
-		eth_call = "eth_call",
-		eth_estimateGas = "eth_estimateGas",
-		eth_createAccessList = "eth_createAccessList",
-		eth_simulateV1 = "eth_simulateV1",
+		eth_call: {
+			params: [GenericTransaction, BlockNumberOrTagOrHash];
+			result: Bytes;
+		};
+		eth_estimateGas: {
+			params: [GenericTransaction, BlockNumberOrTag];
+			result: Uint;
+		};
+		eth_createAccessList: {
+			params: [GenericTransaction, BlockNumberOrTag];
+			result: AccessListResult;
+		};
+		eth_simulateV1: {
+			params: [EthSimulatePayload, BlockNumberOrTagOrHash];
+			result: EthSimulateResult;
+		};
 		// eth/client
-		eth_chainId = "eth_chainId",
-		eth_syncing = "eth_syncing",
-		eth_coinbase = "eth_coinbase",
-		eth_accounts = "eth_accounts",
-		eth_blockNumber = "eth_blockNumber",
-		net_version = "net_version",
+		eth_chainId: { params: []; result: Uint };
+		eth_syncing: { params: []; result: SyncingStatus };
+		eth_coinbase: { params: []; result: Address };
+		eth_accounts: { params: []; result: Addresses };
+		eth_blockNumber: { params: []; result: Uint };
+		net_version: { params: []; result: UintDecimal };
 		// eth/block
-		eth_getBlockByHash = "eth_getBlockByHash",
-		eth_getBlockByNumber = "eth_getBlockByNumber",
-		eth_getBlockTransactionCountByHash = "eth_getBlockTransactionCountByHash",
-		eth_getBlockTransactionCountByNumber = "eth_getBlockTransactionCountByNumber",
-		eth_getUncleCountByBlockHash = "eth_getUncleCountByBlockHash",
-		eth_getUncleCountByBlockNumber = "eth_getUncleCountByBlockNumber",
-		eth_getBlockReceipts = "eth_getBlockReceipts",
-	}
+		eth_getBlockByHash: { params: [Hash32, boolean]; result: NotFound | Block };
+		eth_getBlockByNumber: {
+			params: [BlockNumberOrTag, boolean];
+			result: NotFound | Block;
+		};
+		eth_getBlockTransactionCountByHash: {
+			params: [Hash32];
+			result: NotFound | Uint;
+		};
+		eth_getBlockTransactionCountByNumber: {
+			params: [BlockNumberOrTag];
+			result: NotFound | Uint;
+		};
+		eth_getUncleCountByBlockHash: { params: [Hash32]; result: NotFound | Uint };
+		eth_getUncleCountByBlockNumber: {
+			params: [BlockNumberOrTag];
+			result: NotFound | Uint;
+		};
+		eth_getBlockReceipts: {
+			params: [BlockNumberOrTagOrHash];
+			result: NotFound | ReceiptInfo[];
+		};
+	} & DebugMethods;
 }
 
 export { };

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

@@ -1,24 +1,75 @@
 declare global {
-	export enum FlashbotsMethods {
-		eth_sendBundle = "eth_sendBundle",
-		mev_sendBundle = "mev_sendBundle",
-		eth_callBundle = "eth_callBundle",
-		eth_cancelBundle = "eth_cancelBundle",
-		mev_simBundle = "mev_simBundle",
-		eth_sendPrivateTransaction = "eth_sendPrivateTransaction",
-		eth_sendPrivateRawTransaction = "eth_sendPrivateRawTransaction",
-		eth_cancelPrivateTransaction = "eth_cancelPrivateTransaction",
+	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 = "flashbots_getFeeRefundTotalsByRecipient",
-		flashbots_getFeeRefundsByRecipient = "flashbots_getFeeRefundsByRecipient",
-		flashbots_getFeeRefundsByBlock = "flashbots_getFeeRefundsByBlock",
-		flashbots_getFeeRefundsByBundle = "flashbots_getFeeRefundsByBundle",
-		flashbots_setFeeRefundRecipient = "flashbots_setFeeRefundRecipient",
-		buildernet_getDelayedRefunds = "buildernet_getDelayedRefunds",
-		buildernet_getDelayedRefundTotalsByRecipient = "buildernet_getDelayedRefundTotalsByRecipient",
-		flashbots_getMevRefundTotalByRecipient = "flashbots_getMevRefundTotalByRecipient",
-		flashbots_getMevRefundTotalBySender = "flashbots_getMevRefundTotalBySender",
-	}
+		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",

package/CLAUDE.md

@@ -1,111 +0,0 @@
----
-description: Use Bun instead of Node.js, npm, pnpm, or vite.
-globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
-alwaysApply: false
----
-
-Default to using Bun instead of Node.js.
-
-- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
-- Use `bun test` instead of `jest` or `vitest`
-- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
-- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
-- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
-- Bun automatically loads .env, so don't use dotenv.
-
-## APIs
-
-- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
-- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
-- `Bun.redis` for Redis. Don't use `ioredis`.
-- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
-- `WebSocket` is built-in. Don't use `ws`.
-- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
-- Bun.$`ls` instead of execa.
-
-## Testing
-
-Use `bun test` to run tests.
-
-```ts#index.test.ts
-import { test, expect } from "bun:test";
-
-test("hello world", () => {
-  expect(1).toBe(1);
-});
-```
-
-## Frontend
-
-Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
-
-Server:
-
-```ts#index.ts
-import index from "./index.html"
-
-Bun.serve({
-  routes: {
-    "/": index,
-    "/api/users/:id": {
-      GET: (req) => {
-        return new Response(JSON.stringify({ id: req.params.id }));
-      },
-    },
-  },
-  // optional websocket support
-  websocket: {
-    open: (ws) => {
-      ws.send("Hello, world!");
-    },
-    message: (ws, message) => {
-      ws.send(message);
-    },
-    close: (ws) => {
-      // handle close
-    }
-  },
-  development: {
-    hmr: true,
-    console: true,
-  }
-})
-```
-
-HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
-
-```html#index.html
-<html>
-  <body>
-    <h1>Hello, world!</h1>
-    <script type="module" src="./frontend.tsx"></script>
-  </body>
-</html>
-```
-
-With the following `frontend.tsx`:
-
-```tsx#frontend.tsx
-import React from "react";
-
-// import .css files directly and it works
-import './index.css';
-
-import { createRoot } from "react-dom/client";
-
-const root = createRoot(document.body);
-
-export default function Frontend() {
-  return <h1>Hello, world!</h1>;
-}
-
-root.render(<Frontend />);
-```
-
-Then, run index.ts
-
-```sh
-bun --hot ./index.ts
-```
-
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.