@alchemy/common 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/actions/addBreadCrumb.d.ts

@@ -0,0 +1,14 @@
+import { type Client } from "viem";
+import { type AlchemyTransport } from "../transport/alchemy.js";
+/**
+ * TODO: need to figure out if there's a better way than this...
+ * This adds a tracing breadcrumb to the client during requests.
+ * It returns a basic client without the previously extended actions.
+ * That means you MUST use viem's `getAction` method within actions in case the action is being called from an action that attached a breadcrumb.
+ * That method works by taking a fallback, looking up the action on the client, if it finds it calls it, otherwise it calls the fallback.
+ *
+ * @param {Client<AlchemyTransport>} client a client using the alchemy transport
+ * @param {string} breadcrumb the breadcrumb to add to the tracing headers
+ * @returns {Client<AlchemyTransport>} a client with the transport updated to include the breadcrumb
+ */
+export declare function addBreadCrumb(client: Client<AlchemyTransport>, breadcrumb: string): Client<AlchemyTransport>;

package/dist/esm/actions/addBreadCrumb.js

@@ -0,0 +1,27 @@
+import { createClient } from "viem";
+import { headersUpdate } from "../tracing/updateHeaders.js";
+import { alchemyTransport, } from "../transport/alchemy.js";
+import { convertHeadersToObject } from "../utils/headers.js";
+/**
+ * TODO: need to figure out if there's a better way than this...
+ * This adds a tracing breadcrumb to the client during requests.
+ * It returns a basic client without the previously extended actions.
+ * That means you MUST use viem's `getAction` method within actions in case the action is being called from an action that attached a breadcrumb.
+ * That method works by taking a fallback, looking up the action on the client, if it finds it calls it, otherwise it calls the fallback.
+ *
+ * @param {Client<AlchemyTransport>} client a client using the alchemy transport
+ * @param {string} breadcrumb the breadcrumb to add to the tracing headers
+ * @returns {Client<AlchemyTransport>} a client with the transport updated to include the breadcrumb
+ */
+export function addBreadCrumb(client, breadcrumb) {
+    const oldConfig = client.transport.config;
+    const dynamicFetchOptions = client.transport.fetchOptions;
+    const newTransport = alchemyTransport({ ...oldConfig });
+    newTransport.updateHeaders(headersUpdate(breadcrumb)(convertHeadersToObject(dynamicFetchOptions?.headers)));
+    return createClient({
+        ...client,
+        transport: newTransport,
+        chain: client.chain,
+    });
+}
+//# sourceMappingURL=addBreadCrumb.js.map

package/dist/esm/actions/addBreadCrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addBreadCrumb.js","sourceRoot":"","sources":["../../../src/actions/addBreadCrumb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAgC,EAChC,UAAkB;IAElB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IAC1C,MAAM,mBAAmB,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;IAC1D,MAAM,YAAY,GAAG,gBAAgB,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACxD,YAAY,CAAC,aAAa,CACxB,aAAa,CAAC,UAAU,CAAC,CACvB,sBAAsB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CACrD,CACF,CAAC;IAEF,OAAO,YAAY,CAAC;QAClB,GAAG,MAAM;QACT,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { createClient, type Client } from \"viem\";\nimport { headersUpdate } from \"../tracing/updateHeaders.js\";\nimport {\n  alchemyTransport,\n  type AlchemyTransport,\n} from \"../transport/alchemy.js\";\nimport { convertHeadersToObject } from \"../utils/headers.js\";\n\n/**\n * TODO: need to figure out if there's a better way than this...\n * This adds a tracing breadcrumb to the client during requests.\n * It returns a basic client without the previously extended actions.\n * That means you MUST use viem's `getAction` method within actions in case the action is being called from an action that attached a breadcrumb.\n * That method works by taking a fallback, looking up the action on the client, if it finds it calls it, otherwise it calls the fallback.\n *\n * @param {Client<AlchemyTransport>} client a client using the alchemy transport\n * @param {string} breadcrumb the breadcrumb to add to the tracing headers\n * @returns {Client<AlchemyTransport>} a client with the transport updated to include the breadcrumb\n */\nexport function addBreadCrumb(\n  client: Client<AlchemyTransport>,\n  breadcrumb: string,\n): Client<AlchemyTransport> {\n  const oldConfig = client.transport.config;\n  const dynamicFetchOptions = client.transport.fetchOptions;\n  const newTransport = alchemyTransport({ ...oldConfig });\n  newTransport.updateHeaders(\n    headersUpdate(breadcrumb)(\n      convertHeadersToObject(dynamicFetchOptions?.headers),\n    ),\n  );\n\n  return createClient({\n    ...client,\n    transport: newTransport,\n    chain: client.chain,\n  });\n}\n"]}

package/dist/esm/chains.d.ts

@@ -0,0 +1,234 @@
+export declare const fraxtalSepolia: {
+    blockExplorers?: {
+        [key: string]: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+        default: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+    } | undefined | undefined;
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 2523;
+    name: "Fraxtal Sepolia";
+    nativeCurrency: {
+        readonly name: "Frax Ether";
+        readonly symbol: "frxETH";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.testnet-sepolia.frax.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const openlootSepolia: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Block Explorer";
+            readonly url: "https://openloot-sepolia.explorer.alchemy.com";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 905905;
+    name: "Openloot Sepolia";
+    nativeCurrency: {
+        readonly name: "Openloot";
+        readonly symbol: "OL";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://openloot-sepolia.g.alchemy.com/v2"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const gensynTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Block Explorer";
+            readonly url: "https://gensyn-testnet.explorer.alchemy.com";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 685685;
+    name: "Gensyn Testnet";
+    nativeCurrency: {
+        readonly name: "eth";
+        readonly symbol: "eth";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://gensyn-testnet.g.alchemy.com/v2"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const riseTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Block Explorer";
+            readonly url: "https://explorer.testnet.riselabs.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 11155931;
+    name: "Rise Testnet";
+    nativeCurrency: {
+        readonly name: "eth";
+        readonly symbol: "eth";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rise-testnet.g.alchemy.com/v2"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const storyMainnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Block Explorer";
+            readonly url: "https://www.storyscan.io";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 1514;
+    name: "Story Mainnet";
+    nativeCurrency: {
+        readonly name: "IP";
+        readonly symbol: "IP";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://story-mainnet.g.alchemy.com/v2"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const teaSepolia: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Block Explorer";
+            readonly url: "https://sepolia.tea.xyz/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        erc6492Verifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 10218;
+    name: "Tea Sepolia";
+    nativeCurrency: {
+        readonly name: "TEA";
+        readonly symbol: "TEA";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://tea-sepolia.g.alchemy.com/v2"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};

package/dist/esm/chains.js

@@ -0,0 +1,113 @@
+/**
+ * Custom chain definitions for Alchemy SDK.
+ *
+ * This module provides chain definitions for networks not yet available in viem.
+ * For standard networks (Ethereum, Arbitrum, Base, etc.), import directly from "viem/chains".
+ * All chains work automatically with alchemyTransport via the internal registry lookup.
+ *
+ * @example
+ * ```typescript
+ * // Standard chains - import from viem
+ * import { sepolia, arbitrum, base } from "viem/chains";
+ *
+ * // Custom chains - import from here
+ * import { worldChain, unichainMainnet } from "@alchemy/common/chains";
+ * ```
+ */
+import { defineChain } from "viem";
+export const fraxtalSepolia = defineChain({
+    id: 2523,
+    name: "Fraxtal Sepolia",
+    nativeCurrency: { name: "Frax Ether", symbol: "frxETH", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://rpc.testnet-sepolia.frax.com"],
+        },
+    },
+    testnet: true,
+});
+export const openlootSepolia = defineChain({
+    id: 905905,
+    name: "Openloot Sepolia",
+    nativeCurrency: { name: "Openloot", symbol: "OL", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://openloot-sepolia.g.alchemy.com/v2"],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: "Block Explorer",
+            url: "https://openloot-sepolia.explorer.alchemy.com",
+        },
+    },
+    testnet: true,
+});
+export const gensynTestnet = defineChain({
+    id: 685685,
+    name: "Gensyn Testnet",
+    nativeCurrency: { name: "eth", symbol: "eth", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://gensyn-testnet.g.alchemy.com/v2"],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: "Block Explorer",
+            url: "https://gensyn-testnet.explorer.alchemy.com",
+        },
+    },
+    testnet: true,
+});
+export const riseTestnet = defineChain({
+    id: 11155931,
+    name: "Rise Testnet",
+    nativeCurrency: { name: "eth", symbol: "eth", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://rise-testnet.g.alchemy.com/v2"],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: "Block Explorer",
+            url: "https://explorer.testnet.riselabs.xyz",
+        },
+    },
+    testnet: true,
+});
+export const storyMainnet = defineChain({
+    id: 1514,
+    name: "Story Mainnet",
+    nativeCurrency: { name: "IP", symbol: "IP", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://story-mainnet.g.alchemy.com/v2"],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: "Block Explorer",
+            url: "https://www.storyscan.io",
+        },
+    },
+});
+export const teaSepolia = defineChain({
+    id: 10218,
+    name: "Tea Sepolia",
+    nativeCurrency: { name: "TEA", symbol: "TEA", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://tea-sepolia.g.alchemy.com/v2"],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: "Block Explorer",
+            url: "https://sepolia.tea.xyz/",
+        },
+    },
+    testnet: true,
+});
+//# sourceMappingURL=chains.js.map

package/dist/esm/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../src/chains.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom chain definitions for Alchemy SDK.\n *\n * This module provides chain definitions for networks not yet available in viem.\n * For standard networks (Ethereum, Arbitrum, Base, etc.), import directly from \"viem/chains\".\n * All chains work automatically with alchemyTransport via the internal registry lookup.\n *\n * @example\n * ```typescript\n * // Standard chains - import from viem\n * import { sepolia, arbitrum, base } from \"viem/chains\";\n *\n * // Custom chains - import from here\n * import { worldChain, unichainMainnet } from \"@alchemy/common/chains\";\n * ```\n */\nimport { defineChain } from \"viem\";\n\nexport const fraxtalSepolia = defineChain({\n  id: 2523,\n  name: \"Fraxtal Sepolia\",\n  nativeCurrency: { name: \"Frax Ether\", symbol: \"frxETH\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.testnet-sepolia.frax.com\"],\n    },\n  },\n  testnet: true,\n});\n\nexport const openlootSepolia = defineChain({\n  id: 905905,\n  name: \"Openloot Sepolia\",\n  nativeCurrency: { name: \"Openloot\", symbol: \"OL\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://openloot-sepolia.g.alchemy.com/v2\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Block Explorer\",\n      url: \"https://openloot-sepolia.explorer.alchemy.com\",\n    },\n  },\n  testnet: true,\n});\n\nexport const gensynTestnet = defineChain({\n  id: 685685,\n  name: \"Gensyn Testnet\",\n  nativeCurrency: { name: \"eth\", symbol: \"eth\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://gensyn-testnet.g.alchemy.com/v2\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Block Explorer\",\n      url: \"https://gensyn-testnet.explorer.alchemy.com\",\n    },\n  },\n  testnet: true,\n});\n\nexport const riseTestnet = defineChain({\n  id: 11155931,\n  name: \"Rise Testnet\",\n  nativeCurrency: { name: \"eth\", symbol: \"eth\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://rise-testnet.g.alchemy.com/v2\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Block Explorer\",\n      url: \"https://explorer.testnet.riselabs.xyz\",\n    },\n  },\n  testnet: true,\n});\n\nexport const storyMainnet = defineChain({\n  id: 1514,\n  name: \"Story Mainnet\",\n  nativeCurrency: { name: \"IP\", symbol: \"IP\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://story-mainnet.g.alchemy.com/v2\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Block Explorer\",\n      url: \"https://www.storyscan.io\",\n    },\n  },\n});\n\nexport const teaSepolia = defineChain({\n  id: 10218,\n  name: \"Tea Sepolia\",\n  nativeCurrency: { name: \"TEA\", symbol: \"TEA\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://tea-sepolia.g.alchemy.com/v2\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Block Explorer\",\n      url: \"https://sepolia.tea.xyz/\",\n    },\n  },\n  testnet: true,\n});\n"]}

package/dist/esm/errors/AccountNotFoundError.d.ts

@@ -0,0 +1,10 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an account could not be found to execute a specific action. It extends the `BaseError` class.
+ */
+export declare class AccountNotFoundError extends BaseError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating that an account could not be found to execute the specified action.
+     */ constructor();
+}

package/dist/esm/errors/AccountNotFoundError.js

@@ -0,0 +1,19 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an account could not be found to execute a specific action. It extends the `BaseError` class.
+ */
+export class AccountNotFoundError extends BaseError {
+    // TODO: extend this further using docs path as well
+    /**
+     * Constructor for initializing an error message indicating that an account could not be found to execute the specified action.
+     */ constructor() {
+        super("Could not find an Account to execute with this Action.");
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "AccountNotFoundError"
+        });
+    }
+}
+//# sourceMappingURL=AccountNotFoundError.js.map

package/dist/esm/errors/AccountNotFoundError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountNotFoundError.js","sourceRoot":"","sources":["../../../src/errors/AccountNotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAGjD,oDAAoD;IAEpD;;OAEG,CAAC;QACF,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAPzD;;;;mBAAO,sBAAsB;WAAC;IAQvC,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * This error is thrown when an account could not be found to execute a specific action. It extends the `BaseError` class.\n */\nexport class AccountNotFoundError extends BaseError {\n  override name = \"AccountNotFoundError\";\n\n  // TODO: extend this further using docs path as well\n\n  /**\n   * Constructor for initializing an error message indicating that an account could not be found to execute the specified action.\n   */ constructor() {\n    super(\"Could not find an Account to execute with this Action.\");\n  }\n}\n"]}

package/dist/esm/errors/BaseError.d.ts

@@ -0,0 +1,23 @@
+import { BaseError as ViemBaseError } from "viem";
+type BaseErrorParameters = {
+    docsPath?: string;
+    docsSlug?: string;
+    metaMessages?: string[];
+} & ({
+    cause?: never;
+    details?: string;
+} | {
+    cause: BaseError | Error;
+    details?: never;
+});
+/**
+ * A custom error class that extends from `ViemBaseError`. This class allows for error messages to include links to relevant documentation based on provided `docsPath` and `docsSlug` parameters.
+ * This is based on on viem's BaseError type (obviously from the import and extend)
+ * we want the errors here to point to our docs if we supply a docsPath though
+ */
+export declare class BaseError extends ViemBaseError {
+    name: string;
+    version: string;
+    constructor(shortMessage: string, args?: BaseErrorParameters);
+}
+export {};

package/dist/esm/errors/BaseError.js

@@ -0,0 +1,40 @@
+import { BaseError as ViemBaseError } from "viem";
+import { VERSION } from "../version.js";
+/**
+ * A custom error class that extends from `ViemBaseError`. This class allows for error messages to include links to relevant documentation based on provided `docsPath` and `docsSlug` parameters.
+ * This is based on on viem's BaseError type (obviously from the import and extend)
+ * we want the errors here to point to our docs if we supply a docsPath though
+ */
+export class BaseError extends ViemBaseError {
+    constructor(shortMessage, args = {}) {
+        super(shortMessage, args);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "AlchemySDKError"
+        });
+        Object.defineProperty(this, "version", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: VERSION
+        });
+        const docsPath = args.cause instanceof BaseError
+            ? args.cause.docsPath || args.docsPath
+            : args.docsPath;
+        this.message = [
+            shortMessage || "An error occurred.",
+            "",
+            ...(args.metaMessages ? [...args.metaMessages, ""] : []),
+            ...(docsPath
+                ? [
+                    `Docs: https://www.alchemy.com/docs/wallets${docsPath}${args.docsSlug ? `#${args.docsSlug}` : ""}`,
+                ]
+                : []),
+            ...(this.details ? [`Details: ${this.details}`] : []),
+            `Version: ${this.version}`,
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=BaseError.js.map

package/dist/esm/errors/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.js","sourceRoot":"","sources":["../../../src/errors/BaseError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAiBxC;;;;GAIG;AACH,MAAM,OAAO,SAAU,SAAQ,aAAa;IAI1C,YAAY,YAAoB,EAAE,OAA4B,EAAE;QAC9D,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAJnB;;;;mBAAO,iBAAiB;WAAC;QACzB;;;;mBAAU,OAAO;WAAC;QAKzB,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,YAAY,SAAS;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;YACtC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QAEpB,IAAI,CAAC,OAAO,GAAG;YACb,YAAY,IAAI,oBAAoB;YACpC,EAAE;YACF,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,QAAQ;gBACV,CAAC,CAAC;oBACE,6CAA6C,QAAQ,GACnD,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EACxC,EAAE;iBACH;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,YAAY,IAAI,CAAC,OAAO,EAAE;SAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF","sourcesContent":["import { BaseError as ViemBaseError } from \"viem\";\nimport { VERSION } from \"../version.js\";\n\ntype BaseErrorParameters = {\n  docsPath?: string;\n  docsSlug?: string;\n  metaMessages?: string[];\n} & (\n  | {\n      cause?: never;\n      details?: string;\n    }\n  | {\n      cause: BaseError | Error;\n      details?: never;\n    }\n);\n\n/**\n * A custom error class that extends from `ViemBaseError`. This class allows for error messages to include links to relevant documentation based on provided `docsPath` and `docsSlug` parameters.\n * This is based on on viem's BaseError type (obviously from the import and extend)\n * we want the errors here to point to our docs if we supply a docsPath though\n */\nexport class BaseError extends ViemBaseError {\n  override name = \"AlchemySDKError\";\n  override version = VERSION;\n\n  constructor(shortMessage: string, args: BaseErrorParameters = {}) {\n    super(shortMessage, args);\n\n    const docsPath =\n      args.cause instanceof BaseError\n        ? args.cause.docsPath || args.docsPath\n        : args.docsPath;\n\n    this.message = [\n      shortMessage || \"An error occurred.\",\n      \"\",\n      ...(args.metaMessages ? [...args.metaMessages, \"\"] : []),\n      ...(docsPath\n        ? [\n            `Docs: https://www.alchemy.com/docs/wallets${docsPath}${\n              args.docsSlug ? `#${args.docsSlug}` : \"\"\n            }`,\n          ]\n        : []),\n      ...(this.details ? [`Details: ${this.details}`] : []),\n      `Version: ${this.version}`,\n    ].join(\"\\n\");\n  }\n}\n"]}

package/dist/esm/errors/ChainNotFoundError.d.ts

@@ -0,0 +1,11 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Chain Not Found" error, typically thrown when no chain is supplied to the client.
+ */
+export declare class ChainNotFoundError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     */
+    constructor();
+}

package/dist/esm/errors/ChainNotFoundError.js

@@ -0,0 +1,19 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Chain Not Found" error, typically thrown when no chain is supplied to the client.
+ */
+export class ChainNotFoundError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     */
+    constructor() {
+        super("No chain supplied to the client");
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "ChainNotFoundError"
+        });
+    }
+}
+//# sourceMappingURL=ChainNotFoundError.js.map

package/dist/esm/errors/ChainNotFoundError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainNotFoundError.js","sourceRoot":"","sources":["../../../src/errors/ChainNotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAG/C;;OAEG;IACH;QACE,KAAK,CAAC,iCAAiC,CAAC,CAAC;QANlC;;;;mBAAO,oBAAoB;WAAC;IAOrC,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * Error class representing a \"Chain Not Found\" error, typically thrown when no chain is supplied to the client.\n */\nexport class ChainNotFoundError extends BaseError {\n  override name = \"ChainNotFoundError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.\n   */\n  constructor() {\n    super(\"No chain supplied to the client\");\n  }\n}\n"]}

package/dist/esm/errors/ConnectionConfigError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class for connection configuration validation failures.
+ */
+export declare class ConnectionConfigError extends BaseError {
+    name: string;
+    /**
+     * Creates a new ConnectionConfigError with details about the validation failure.
+     *
+     * @param {string} [details] Optional details about the specific validation failure
+     */
+    constructor(details?: string);
+}

package/dist/esm/errors/ConnectionConfigError.js

@@ -0,0 +1,25 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class for connection configuration validation failures.
+ */
+export class ConnectionConfigError extends BaseError {
+    // TODO: extend this further using docs path as well for debugging connection-related problems
+    /**
+     * Creates a new ConnectionConfigError with details about the validation failure.
+     *
+     * @param {string} [details] Optional details about the specific validation failure
+     */
+    constructor(details) {
+        const message = details
+            ? `Invalid Alchemy connection configuration: ${details}`
+            : "Invalid Alchemy connection configuration";
+        super(message);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "ConnectionConfigError"
+        });
+    }
+}
+//# sourceMappingURL=ConnectionConfigError.js.map

package/dist/esm/errors/ConnectionConfigError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionConfigError.js","sourceRoot":"","sources":["../../../src/errors/ConnectionConfigError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAGlD,8FAA8F;IAE9F;;;;OAIG;IACH,YAAY,OAAgB;QAC1B,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,6CAA6C,OAAO,EAAE;YACxD,CAAC,CAAC,0CAA0C,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QAbR;;;;mBAAO,uBAAuB;WAAC;IAcxC,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * Error class for connection configuration validation failures.\n */\nexport class ConnectionConfigError extends BaseError {\n  override name = \"ConnectionConfigError\";\n\n  // TODO: extend this further using docs path as well for debugging connection-related problems\n\n  /**\n   * Creates a new ConnectionConfigError with details about the validation failure.\n   *\n   * @param {string} [details] Optional details about the specific validation failure\n   */\n  constructor(details?: string) {\n    const message = details\n      ? `Invalid Alchemy connection configuration: ${details}`\n      : \"Invalid Alchemy connection configuration\";\n    super(message);\n  }\n}\n"]}

package/dist/esm/errors/FetchError.d.ts

@@ -0,0 +1,15 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Fetch Error" error, typically thrown when a fetch request fails.
+ */
+export declare class FetchError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     *
+     * @param {string} route - The route that failed to fetch.
+     * @param {string} method - The HTTP method that was used.
+     * @param {Error} cause - The cause of the error.
+     */
+    constructor(route: string, method: string, cause?: Error);
+}