@alchemy/aa-infra 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Alchemy Insights, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/esm/errors.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error thrown when an invalid hex value is encountered during fee estimation.
+ */
+export declare class InvalidHexValueError extends BaseError {
+    name: string;
+    constructor(value: unknown);
+}

package/dist/esm/errors.js

@@ -0,0 +1,16 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error thrown when an invalid hex value is encountered during fee estimation.
+ */
+export class InvalidHexValueError extends BaseError {
+    constructor(value) {
+        super(`Invalid hex value: ${value}`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidHexValueError"
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAGjD,YAAY,KAAc;QACxB,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QAH9B;;;;mBAAO,sBAAsB;WAAC;IAIvC,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error thrown when an invalid hex value is encountered during fee estimation.\n */\nexport class InvalidHexValueError extends BaseError {\n  override name = \"InvalidHexValueError\";\n\n  constructor(value: unknown) {\n    super(`Invalid hex value: ${value}`);\n  }\n}\n"]}

package/dist/esm/estimateFeesPerGas.d.ts

@@ -0,0 +1,37 @@
+import { type Client, type Transport, type Chain, type Account } from "viem";
+import type { UserOperationRequest, SmartAccount } from "viem/account-abstraction";
+import type { RundlerRpcSchema } from "./schema.js";
+export type RundlerClient<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = Client<transport, chain, account, RundlerRpcSchema>;
+/**
+ * A custom `estimateFeesPerGas` function for viem bundler clients to use `rundler_maxPriorityFeePerGas` for priority fee estimation.
+ *
+ * It fetches:
+ * 1. `baseFeePerGas` from the latest block.
+ * 2. `maxPriorityFeePerGas` via `rundler_maxPriorityFeePerGas`.
+ *
+ * It then returns `maxFeePerGas = baseFee * 1.5 + priority` (aligns with viem default).
+ *
+ * @param {RundlerClient} bundlerClient Bundler client with the rundler RPC method.
+ * @returns {Promise<{maxFeePerGas: bigint, maxPriorityFeePerGas: bigint}>} Estimated fee values.
+ *
+ * @example
+ * ```ts
+ * import { createBundlerClient } from "viem/account-abstraction";
+ * import { alchemyEstimateFeesPerGas } from "@alchemy/aa-infra";
+ *
+ * const bundler = createBundlerClient({
+ *   transport: http("<rundler-url>"),
+ *   userOperation: {
+ *     estimateFeesPerGas: alchemyEstimateFeesPerGas,
+ *   },
+ * });
+ * ```
+ */
+export declare function estimateFeesPerGas<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined>({ bundlerClient, account: _account, userOperation: _userOperation, }: {
+    bundlerClient: RundlerClient<TTransport, TChain, TAccount>;
+    account?: SmartAccount;
+    userOperation?: UserOperationRequest;
+}): Promise<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}>;

package/dist/esm/estimateFeesPerGas.js

@@ -0,0 +1,54 @@
+import { getBlock } from "viem/actions";
+import { isHex, hexToBigInt, } from "viem";
+import { bigIntMultiply } from "@alchemy/common";
+import { InvalidHexValueError } from "./errors.js";
+/**
+ * A custom `estimateFeesPerGas` function for viem bundler clients to use `rundler_maxPriorityFeePerGas` for priority fee estimation.
+ *
+ * It fetches:
+ * 1. `baseFeePerGas` from the latest block.
+ * 2. `maxPriorityFeePerGas` via `rundler_maxPriorityFeePerGas`.
+ *
+ * It then returns `maxFeePerGas = baseFee * 1.5 + priority` (aligns with viem default).
+ *
+ * @param {RundlerClient} bundlerClient Bundler client with the rundler RPC method.
+ * @returns {Promise<{maxFeePerGas: bigint, maxPriorityFeePerGas: bigint}>} Estimated fee values.
+ *
+ * @example
+ * ```ts
+ * import { createBundlerClient } from "viem/account-abstraction";
+ * import { alchemyEstimateFeesPerGas } from "@alchemy/aa-infra";
+ *
+ * const bundler = createBundlerClient({
+ *   transport: http("<rundler-url>"),
+ *   userOperation: {
+ *     estimateFeesPerGas: alchemyEstimateFeesPerGas,
+ *   },
+ * });
+ * ```
+ */
+export async function estimateFeesPerGas({ bundlerClient, account: _account, userOperation: _userOperation, }) {
+    const [block, maxPriorityFeePerGasHex] = await Promise.all([
+        getBlock(bundlerClient, { blockTag: "latest" }), // This is technically hitting the node rpc, not rundler.
+        bundlerClient.request({
+            method: "rundler_maxPriorityFeePerGas",
+            params: [],
+        }),
+    ]);
+    const baseFeePerGas = block.baseFeePerGas;
+    if (baseFeePerGas == null) {
+        throw new Error("baseFeePerGas is null");
+    }
+    if (maxPriorityFeePerGasHex == null) {
+        throw new Error("rundler_maxPriorityFeePerGas returned null or undefined");
+    }
+    if (!isHex(maxPriorityFeePerGasHex)) {
+        throw new InvalidHexValueError(maxPriorityFeePerGasHex);
+    }
+    const maxPriorityFeePerGas = hexToBigInt(maxPriorityFeePerGasHex);
+    return {
+        maxPriorityFeePerGas,
+        maxFeePerGas: bigIntMultiply(baseFeePerGas, 1.5) + maxPriorityFeePerGas,
+    };
+}
+//# sourceMappingURL=estimateFeesPerGas.js.map

package/dist/esm/estimateFeesPerGas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateFeesPerGas.js","sourceRoot":"","sources":["../../src/estimateFeesPerGas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAEL,KAAK,EAIL,WAAW,GACZ,MAAM,MAAM,CAAC;AAKd,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AASnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAItC,EACA,aAAa,EACb,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,cAAc,GAK9B;IAIC,MAAM,CAAC,KAAK,EAAE,uBAAuB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzD,QAAQ,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,yDAAyD;QAC1G,aAAa,CAAC,OAAO,CAAC;YACpB,MAAM,EAAE,8BAA8B;YACtC,MAAM,EAAE,EAAE;SACX,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IAC1C,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,uBAAuB,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,oBAAoB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAElE,OAAO;QACL,oBAAoB;QACpB,YAAY,EAAE,cAAc,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,oBAAoB;KACxE,CAAC;AACJ,CAAC","sourcesContent":["import { getBlock } from \"viem/actions\";\nimport {\n  type Client,\n  isHex,\n  type Transport,\n  type Chain,\n  type Account,\n  hexToBigInt,\n} from \"viem\";\nimport type {\n  UserOperationRequest,\n  SmartAccount,\n} from \"viem/account-abstraction\";\nimport { bigIntMultiply } from \"@alchemy/common\";\nimport type { RundlerRpcSchema } from \"./schema.js\";\nimport { InvalidHexValueError } from \"./errors.js\";\n\n// Extend client with Rundler rpc schema.\nexport type RundlerClient<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n> = Client<transport, chain, account, RundlerRpcSchema>;\n\n/**\n * A custom `estimateFeesPerGas` function for viem bundler clients to use `rundler_maxPriorityFeePerGas` for priority fee estimation.\n *\n * It fetches:\n * 1. `baseFeePerGas` from the latest block.\n * 2. `maxPriorityFeePerGas` via `rundler_maxPriorityFeePerGas`.\n *\n * It then returns `maxFeePerGas = baseFee * 1.5 + priority` (aligns with viem default).\n *\n * @param {RundlerClient} bundlerClient Bundler client with the rundler RPC method.\n * @returns {Promise<{maxFeePerGas: bigint, maxPriorityFeePerGas: bigint}>} Estimated fee values.\n *\n * @example\n * ```ts\n * import { createBundlerClient } from \"viem/account-abstraction\";\n * import { alchemyEstimateFeesPerGas } from \"@alchemy/aa-infra\";\n *\n * const bundler = createBundlerClient({\n *   transport: http(\"<rundler-url>\"),\n *   userOperation: {\n *     estimateFeesPerGas: alchemyEstimateFeesPerGas,\n *   },\n * });\n * ```\n */\nexport async function estimateFeesPerGas<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends Account | undefined = Account | undefined,\n>({\n  bundlerClient,\n  account: _account,\n  userOperation: _userOperation,\n}: {\n  bundlerClient: RundlerClient<TTransport, TChain, TAccount>;\n  account?: SmartAccount;\n  userOperation?: UserOperationRequest;\n}): Promise<{\n  maxFeePerGas: bigint;\n  maxPriorityFeePerGas: bigint;\n}> {\n  const [block, maxPriorityFeePerGasHex] = await Promise.all([\n    getBlock(bundlerClient, { blockTag: \"latest\" }), // This is technically hitting the node rpc, not rundler.\n    bundlerClient.request({\n      method: \"rundler_maxPriorityFeePerGas\",\n      params: [],\n    }),\n  ]);\n\n  const baseFeePerGas = block.baseFeePerGas;\n  if (baseFeePerGas == null) {\n    throw new Error(\"baseFeePerGas is null\");\n  }\n  if (maxPriorityFeePerGasHex == null) {\n    throw new Error(\"rundler_maxPriorityFeePerGas returned null or undefined\");\n  }\n  if (!isHex(maxPriorityFeePerGasHex)) {\n    throw new InvalidHexValueError(maxPriorityFeePerGasHex);\n  }\n  const maxPriorityFeePerGas = hexToBigInt(maxPriorityFeePerGasHex);\n\n  return {\n    maxPriorityFeePerGas,\n    maxFeePerGas: bigIntMultiply(baseFeePerGas, 1.5) + maxPriorityFeePerGas,\n  };\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export type * from "./schema.js";
+export type * from "./estimateFeesPerGas.js";
+export { estimateFeesPerGas } from "./estimateFeesPerGas.js";

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { estimateFeesPerGas } from "./estimateFeesPerGas.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["// schema\nexport type * from \"./schema.js\";\n\nexport type * from \"./estimateFeesPerGas.js\";\nexport { estimateFeesPerGas } from \"./estimateFeesPerGas.js\";\n"]}

package/dist/esm/logger.d.ts

@@ -0,0 +1,2 @@
+import type { DiagnosticsLogger } from "@alchemy/common";
+export declare const LOGGER: DiagnosticsLogger;

package/dist/esm/logger.js

@@ -0,0 +1,8 @@
+import { createLogger } from "@alchemy/common";
+import { VERSION } from "./version.js";
+export const LOGGER = createLogger({
+    package: "@alchemy/aa-infra",
+    version: VERSION,
+    namespace: "aa-infra",
+});
+//# sourceMappingURL=logger.js.map

package/dist/esm/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,MAAM,GAAsB,YAAY,CAAC;IACpD,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,UAAU;CACtB,CAAC,CAAC","sourcesContent":["import { createLogger } from \"@alchemy/common\";\nimport type { DiagnosticsLogger } from \"@alchemy/common\";\nimport { VERSION } from \"./version.js\";\n\nexport const LOGGER: DiagnosticsLogger = createLogger({\n  package: \"@alchemy/aa-infra\",\n  version: VERSION,\n  namespace: \"aa-infra\",\n});\n"]}

package/dist/esm/schema.d.ts

@@ -0,0 +1,8 @@
+import type { Hex } from "viem";
+type RundlerMaxPriorityFeePerGasSchema = {
+    Method: "rundler_maxPriorityFeePerGas";
+    Parameters: [];
+    ReturnType: Hex;
+};
+export type RundlerRpcSchema = [RundlerMaxPriorityFeePerGasSchema];
+export {};

package/dist/esm/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/esm/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"","sourcesContent":["import type { Hex } from \"viem\";\n\ntype RundlerMaxPriorityFeePerGasSchema = {\n  Method: \"rundler_maxPriorityFeePerGas\";\n  Parameters: [];\n  ReturnType: Hex;\n};\n\nexport type RundlerRpcSchema = [RundlerMaxPriorityFeePerGasSchema];\n"]}

package/dist/esm/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.0.0";

package/dist/esm/version.js

@@ -0,0 +1,4 @@
+// This file is autogenerated by inject-version.ts. Any changes will be
+// overwritten on commit!
+export const VERSION = "0.0.0";
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"0.0.0\";\n"]}

package/dist/types/errors.d.ts

@@ -0,0 +1,9 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error thrown when an invalid hex value is encountered during fee estimation.
+ */
+export declare class InvalidHexValueError extends BaseError {
+    name: string;
+    constructor(value: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACxC,IAAI,SAA0B;gBAE3B,KAAK,EAAE,OAAO;CAG3B"}

package/dist/types/estimateFeesPerGas.d.ts

@@ -0,0 +1,38 @@
+import { type Client, type Transport, type Chain, type Account } from "viem";
+import type { UserOperationRequest, SmartAccount } from "viem/account-abstraction";
+import type { RundlerRpcSchema } from "./schema.js";
+export type RundlerClient<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = Client<transport, chain, account, RundlerRpcSchema>;
+/**
+ * A custom `estimateFeesPerGas` function for viem bundler clients to use `rundler_maxPriorityFeePerGas` for priority fee estimation.
+ *
+ * It fetches:
+ * 1. `baseFeePerGas` from the latest block.
+ * 2. `maxPriorityFeePerGas` via `rundler_maxPriorityFeePerGas`.
+ *
+ * It then returns `maxFeePerGas = baseFee * 1.5 + priority` (aligns with viem default).
+ *
+ * @param {RundlerClient} bundlerClient Bundler client with the rundler RPC method.
+ * @returns {Promise<{maxFeePerGas: bigint, maxPriorityFeePerGas: bigint}>} Estimated fee values.
+ *
+ * @example
+ * ```ts
+ * import { createBundlerClient } from "viem/account-abstraction";
+ * import { alchemyEstimateFeesPerGas } from "@alchemy/aa-infra";
+ *
+ * const bundler = createBundlerClient({
+ *   transport: http("<rundler-url>"),
+ *   userOperation: {
+ *     estimateFeesPerGas: alchemyEstimateFeesPerGas,
+ *   },
+ * });
+ * ```
+ */
+export declare function estimateFeesPerGas<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined>({ bundlerClient, account: _account, userOperation: _userOperation, }: {
+    bundlerClient: RundlerClient<TTransport, TChain, TAccount>;
+    account?: SmartAccount;
+    userOperation?: UserOperationRequest;
+}): Promise<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}>;
+//# sourceMappingURL=estimateFeesPerGas.d.ts.map

package/dist/types/estimateFeesPerGas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateFeesPerGas.d.ts","sourceRoot":"","sources":["../../src/estimateFeesPerGas.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,MAAM,EAEX,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,OAAO,EAEb,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,MAAM,aAAa,CACvB,SAAS,SAAS,SAAS,GAAG,SAAS,EACvC,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACnD,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,IACvD,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAC1D,EACA,aAAa,EACb,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,cAAc,GAC9B,EAAE;IACD,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC,GAAG,OAAO,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,CAyBD"}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export type * from "./schema.js";
+export type * from "./estimateFeesPerGas.js";
+export { estimateFeesPerGas } from "./estimateFeesPerGas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,aAAa,CAAC;AAEjC,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/logger.d.ts

@@ -0,0 +1,3 @@
+import type { DiagnosticsLogger } from "@alchemy/common";
+export declare const LOGGER: DiagnosticsLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,eAAO,MAAM,MAAM,EAAE,iBAInB,CAAC"}

package/dist/types/schema.d.ts

@@ -0,0 +1,9 @@
+import type { Hex } from "viem";
+type RundlerMaxPriorityFeePerGasSchema = {
+    Method: "rundler_maxPriorityFeePerGas";
+    Parameters: [];
+    ReturnType: Hex;
+};
+export type RundlerRpcSchema = [RundlerMaxPriorityFeePerGasSchema];
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,KAAK,iCAAiC,GAAG;IACvC,MAAM,EAAE,8BAA8B,CAAC;IACvC,UAAU,EAAE,EAAE,CAAC;IACf,UAAU,EAAE,GAAG,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,iCAAiC,CAAC,CAAC"}

package/dist/types/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@alchemy/aa-infra",
+  "version": "0.0.0-alpha.0",
+  "description": "Alchemy Account Abstraction Infrastructure",
+  "author": "Alchemy",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "typings": "./dist/types/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src/**/*.ts",
+    "!dist/**/*.tsbuildinfo",
+    "!vitest.config.ts",
+    "!.env",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "!src/__tests__/**/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "prebuild": "tsx ./inject-version.ts",
+    "build": "yarn clean && yarn build:esm && yarn build:types",
+    "build:esm": "tsc --project tsconfig.build.json --outDir ./dist/esm",
+    "build:types": "tsc --project tsconfig.build.json --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
+    "fern:gen": "node ../../doc-gen/dist/esm/cli.js generate --in ./src/index.ts --out ../../docs/pages/reference/alchemy/aa-infra",
+    "clean": "rm -rf ./dist",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "devDependencies": {
+    "typescript-template": "*"
+  },
+  "dependencies": {
+    "@alchemy/common": "0.0.0-alpha.0",
+    "viem": "^2.32.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alchemyplatform/aa-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/alchemyplatform/aa-sdk/issues"
+  },
+  "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
+  "gitHead": "c0301f7bb5f4499fe35b5850293be6170057fae6"
+}

package/src/errors.ts

@@ -0,0 +1,12 @@
+import { BaseError } from "@alchemy/common";
+
+/**
+ * Error thrown when an invalid hex value is encountered during fee estimation.
+ */
+export class InvalidHexValueError extends BaseError {
+  override name = "InvalidHexValueError";
+
+  constructor(value: unknown) {
+    super(`Invalid hex value: ${value}`);
+  }
+}

package/src/estimateFeesPerGas.ts

@@ -0,0 +1,90 @@
+import { getBlock } from "viem/actions";
+import {
+  type Client,
+  isHex,
+  type Transport,
+  type Chain,
+  type Account,
+  hexToBigInt,
+} from "viem";
+import type {
+  UserOperationRequest,
+  SmartAccount,
+} from "viem/account-abstraction";
+import { bigIntMultiply } from "@alchemy/common";
+import type { RundlerRpcSchema } from "./schema.js";
+import { InvalidHexValueError } from "./errors.js";
+
+// Extend client with Rundler rpc schema.
+export type RundlerClient<
+  transport extends Transport = Transport,
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+> = Client<transport, chain, account, RundlerRpcSchema>;
+
+/**
+ * A custom `estimateFeesPerGas` function for viem bundler clients to use `rundler_maxPriorityFeePerGas` for priority fee estimation.
+ *
+ * It fetches:
+ * 1. `baseFeePerGas` from the latest block.
+ * 2. `maxPriorityFeePerGas` via `rundler_maxPriorityFeePerGas`.
+ *
+ * It then returns `maxFeePerGas = baseFee * 1.5 + priority` (aligns with viem default).
+ *
+ * @param {RundlerClient} bundlerClient Bundler client with the rundler RPC method.
+ * @returns {Promise<{maxFeePerGas: bigint, maxPriorityFeePerGas: bigint}>} Estimated fee values.
+ *
+ * @example
+ * ```ts
+ * import { createBundlerClient } from "viem/account-abstraction";
+ * import { alchemyEstimateFeesPerGas } from "@alchemy/aa-infra";
+ *
+ * const bundler = createBundlerClient({
+ *   transport: http("<rundler-url>"),
+ *   userOperation: {
+ *     estimateFeesPerGas: alchemyEstimateFeesPerGas,
+ *   },
+ * });
+ * ```
+ */
+export async function estimateFeesPerGas<
+  TTransport extends Transport = Transport,
+  TChain extends Chain | undefined = Chain | undefined,
+  TAccount extends Account | undefined = Account | undefined,
+>({
+  bundlerClient,
+  account: _account,
+  userOperation: _userOperation,
+}: {
+  bundlerClient: RundlerClient<TTransport, TChain, TAccount>;
+  account?: SmartAccount;
+  userOperation?: UserOperationRequest;
+}): Promise<{
+  maxFeePerGas: bigint;
+  maxPriorityFeePerGas: bigint;
+}> {
+  const [block, maxPriorityFeePerGasHex] = await Promise.all([
+    getBlock(bundlerClient, { blockTag: "latest" }), // This is technically hitting the node rpc, not rundler.
+    bundlerClient.request({
+      method: "rundler_maxPriorityFeePerGas",
+      params: [],
+    }),
+  ]);
+
+  const baseFeePerGas = block.baseFeePerGas;
+  if (baseFeePerGas == null) {
+    throw new Error("baseFeePerGas is null");
+  }
+  if (maxPriorityFeePerGasHex == null) {
+    throw new Error("rundler_maxPriorityFeePerGas returned null or undefined");
+  }
+  if (!isHex(maxPriorityFeePerGasHex)) {
+    throw new InvalidHexValueError(maxPriorityFeePerGasHex);
+  }
+  const maxPriorityFeePerGas = hexToBigInt(maxPriorityFeePerGasHex);
+
+  return {
+    maxPriorityFeePerGas,
+    maxFeePerGas: bigIntMultiply(baseFeePerGas, 1.5) + maxPriorityFeePerGas,
+  };
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// schema
+export type * from "./schema.js";
+
+export type * from "./estimateFeesPerGas.js";
+export { estimateFeesPerGas } from "./estimateFeesPerGas.js";

package/src/logger.ts

@@ -0,0 +1,9 @@
+import { createLogger } from "@alchemy/common";
+import type { DiagnosticsLogger } from "@alchemy/common";
+import { VERSION } from "./version.js";
+
+export const LOGGER: DiagnosticsLogger = createLogger({
+  package: "@alchemy/aa-infra",
+  version: VERSION,
+  namespace: "aa-infra",
+});

package/src/schema.ts

@@ -0,0 +1,9 @@
+import type { Hex } from "viem";
+
+type RundlerMaxPriorityFeePerGasSchema = {
+  Method: "rundler_maxPriorityFeePerGas";
+  Parameters: [];
+  ReturnType: Hex;
+};
+
+export type RundlerRpcSchema = [RundlerMaxPriorityFeePerGasSchema];

package/src/version.ts

@@ -0,0 +1,3 @@
+// This file is autogenerated by inject-version.ts. Any changes will be
+// overwritten on commit!
+export const VERSION = "0.0.0";