@alchemy/common 0.0.0-alpha.0

package/dist/esm/transport/chainRegistry.js

@@ -0,0 +1,95 @@
+/**
+ * Internal registry mapping chain IDs to Alchemy RPC base URLs.
+ * This replaces the need for custom chain exports with embedded Alchemy URLs.
+ */
+export const ALCHEMY_RPC_MAPPING = {
+    // Ethereum networks
+    1: "https://eth-mainnet.g.alchemy.com/v2", // mainnet
+    11155111: "https://eth-sepolia.g.alchemy.com/v2", // sepolia
+    5: "https://eth-goerli.g.alchemy.com/v2", // goerli
+    // Arbitrum networks
+    42161: "https://arb-mainnet.g.alchemy.com/v2", // arbitrum
+    421613: "https://arb-goerli.g.alchemy.com/v2", // arbitrumGoerli
+    421614: "https://arb-sepolia.g.alchemy.com/v2", // arbitrumSepolia
+    // Optimism networks
+    10: "https://opt-mainnet.g.alchemy.com/v2", // optimism
+    420: "https://opt-goerli.g.alchemy.com/v2", // optimismGoerli
+    11155420: "https://opt-sepolia.g.alchemy.com/v2", // optimismSepolia
+    // Base networks
+    8453: "https://base-mainnet.g.alchemy.com/v2", // base
+    84531: "https://base-goerli.g.alchemy.com/v2", // baseGoerli
+    84532: "https://base-sepolia.g.alchemy.com/v2", // baseSepolia
+    // Polygon networks
+    137: "https://polygon-mainnet.g.alchemy.com/v2", // polygon
+    80001: "https://polygon-mumbai.g.alchemy.com/v2", // polygonMumbai
+    80002: "https://polygon-amoy.g.alchemy.com/v2", // polygonAmoy
+    // World Chain networks
+    480: "https://worldchain-mainnet.g.alchemy.com/v2", // worldChain
+    4801: "https://worldchain-sepolia.g.alchemy.com/v2", // worldChainSepolia
+    // Shape networks
+    360: "https://shape-mainnet.g.alchemy.com/v2", // shape
+    11011: "https://shape-sepolia.g.alchemy.com/v2", // shapeSepolia
+    // Unichain networks
+    130: "https://unichain-mainnet.g.alchemy.com/v2", // unichainMainnet
+    1301: "https://unichain-sepolia.g.alchemy.com/v2", // unichainSepolia
+    // Soneium networks
+    1868: "https://soneium-mainnet.g.alchemy.com/v2", // soneiumMainnet
+    1946: "https://soneium-minato.g.alchemy.com/v2", // soneiumMinato
+    // OPBNB networks
+    204: "https://opbnb-mainnet.g.alchemy.com/v2", // opbnbMainnet
+    5611: "https://opbnb-testnet.g.alchemy.com/v2", // opbnbTestnet
+    // BeraChain networks
+    80084: "https://berachain-bartio.g.alchemy.com/v2", // beraChainBartio
+    // Ink networks
+    57073: "https://ink-mainnet.g.alchemy.com/v2", // inkMainnet
+    763373: "https://ink-sepolia.g.alchemy.com/v2", // inkSepolia
+    // Monad networks
+    10143: "https://monad-testnet.g.alchemy.com/v2", // monadTestnet
+    // Openloot networks
+    905905: "https://openloot-sepolia.g.alchemy.com/v2", // openlootSepolia
+    // Gensyn networks
+    685685: "https://gensyn-testnet.g.alchemy.com/v2", // gensynTestnet
+    // Rise networks
+    11155931: "https://rise-testnet.g.alchemy.com/v2", // riseTestnet
+    // Story networks
+    1514: "https://story-mainnet.g.alchemy.com/v2", // storyMainnet
+    1315: "https://story-aeneid.g.alchemy.com/v2", // storyAeneid
+    // Celo networks
+    42220: "https://celo-mainnet.g.alchemy.com/v2", // celoMainnet
+    44787: "https://celo-alfajores.g.alchemy.com/v2", // celoAlfajores
+    // Tea networks
+    10218: "https://tea-sepolia.g.alchemy.com/v2", // teaSepolia
+};
+/**
+ * Gets the Alchemy RPC base URL for a given chain ID.
+ *
+ * @param {number} chainId The chain ID to lookup
+ * @returns {string | undefined} The Alchemy RPC base URL or undefined if not supported
+ *
+ * @example
+ * ```ts
+ * const rpcUrl = getAlchemyRpcUrl(1); // "https://eth-mainnet.g.alchemy.com/v2"
+ * const customUrl = getAlchemyRpcUrl(999); // undefined
+ * ```
+ */
+export function getAlchemyRpcUrl(chainId) {
+    return ALCHEMY_RPC_MAPPING[chainId];
+}
+/**
+ * Checks if a chain ID is supported by the Alchemy RPC registry.
+ *
+ * @param {number} chainId The chain ID to check
+ * @returns {boolean} True if the chain is supported, false otherwise
+ */
+export function isChainSupported(chainId) {
+    return chainId in ALCHEMY_RPC_MAPPING;
+}
+/**
+ * Gets all supported chain IDs from the registry.
+ *
+ * @returns {number[]} Array of supported chain IDs
+ */
+export function getSupportedChainIds() {
+    return Object.keys(ALCHEMY_RPC_MAPPING).map(Number);
+}
+//# sourceMappingURL=chainRegistry.js.map

package/dist/esm/transport/chainRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainRegistry.js","sourceRoot":"","sources":["../../../src/transport/chainRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,oBAAoB;IACpB,CAAC,EAAE,sCAAsC,EAAE,UAAU;IACrD,QAAQ,EAAE,sCAAsC,EAAE,UAAU;IAC5D,CAAC,EAAE,qCAAqC,EAAE,SAAS;IAEnD,oBAAoB;IACpB,KAAK,EAAE,sCAAsC,EAAE,WAAW;IAC1D,MAAM,EAAE,qCAAqC,EAAE,iBAAiB;IAChE,MAAM,EAAE,sCAAsC,EAAE,kBAAkB;IAElE,oBAAoB;IACpB,EAAE,EAAE,sCAAsC,EAAE,WAAW;IACvD,GAAG,EAAE,qCAAqC,EAAE,iBAAiB;IAC7D,QAAQ,EAAE,sCAAsC,EAAE,kBAAkB;IAEpE,gBAAgB;IAChB,IAAI,EAAE,uCAAuC,EAAE,OAAO;IACtD,KAAK,EAAE,sCAAsC,EAAE,aAAa;IAC5D,KAAK,EAAE,uCAAuC,EAAE,cAAc;IAE9D,mBAAmB;IACnB,GAAG,EAAE,0CAA0C,EAAE,UAAU;IAC3D,KAAK,EAAE,yCAAyC,EAAE,gBAAgB;IAClE,KAAK,EAAE,uCAAuC,EAAE,cAAc;IAE9D,uBAAuB;IACvB,GAAG,EAAE,6CAA6C,EAAE,aAAa;IACjE,IAAI,EAAE,6CAA6C,EAAE,oBAAoB;IAEzE,iBAAiB;IACjB,GAAG,EAAE,wCAAwC,EAAE,QAAQ;IACvD,KAAK,EAAE,wCAAwC,EAAE,eAAe;IAEhE,oBAAoB;IACpB,GAAG,EAAE,2CAA2C,EAAE,kBAAkB;IACpE,IAAI,EAAE,2CAA2C,EAAE,kBAAkB;IAErE,mBAAmB;IACnB,IAAI,EAAE,0CAA0C,EAAE,iBAAiB;IACnE,IAAI,EAAE,yCAAyC,EAAE,gBAAgB;IAEjE,iBAAiB;IACjB,GAAG,EAAE,wCAAwC,EAAE,eAAe;IAC9D,IAAI,EAAE,wCAAwC,EAAE,eAAe;IAE/D,qBAAqB;IACrB,KAAK,EAAE,2CAA2C,EAAE,kBAAkB;IAEtE,eAAe;IACf,KAAK,EAAE,sCAAsC,EAAE,aAAa;IAC5D,MAAM,EAAE,sCAAsC,EAAE,aAAa;IAE7D,iBAAiB;IACjB,KAAK,EAAE,wCAAwC,EAAE,eAAe;IAEhE,oBAAoB;IACpB,MAAM,EAAE,2CAA2C,EAAE,kBAAkB;IAEvE,kBAAkB;IAClB,MAAM,EAAE,yCAAyC,EAAE,gBAAgB;IAEnE,gBAAgB;IAChB,QAAQ,EAAE,uCAAuC,EAAE,cAAc;IAEjE,iBAAiB;IACjB,IAAI,EAAE,wCAAwC,EAAE,eAAe;IAC/D,IAAI,EAAE,uCAAuC,EAAE,cAAc;IAE7D,gBAAgB;IAChB,KAAK,EAAE,uCAAuC,EAAE,cAAc;IAC9D,KAAK,EAAE,yCAAyC,EAAE,gBAAgB;IAElE,eAAe;IACf,KAAK,EAAE,sCAAsC,EAAE,aAAa;CAC7D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,IAAI,mBAAmB,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC","sourcesContent":["/**\n * Internal registry mapping chain IDs to Alchemy RPC base URLs.\n * This replaces the need for custom chain exports with embedded Alchemy URLs.\n */\nexport const ALCHEMY_RPC_MAPPING: Record<number, string> = {\n  // Ethereum networks\n  1: \"https://eth-mainnet.g.alchemy.com/v2\", // mainnet\n  11155111: \"https://eth-sepolia.g.alchemy.com/v2\", // sepolia\n  5: \"https://eth-goerli.g.alchemy.com/v2\", // goerli\n\n  // Arbitrum networks\n  42161: \"https://arb-mainnet.g.alchemy.com/v2\", // arbitrum\n  421613: \"https://arb-goerli.g.alchemy.com/v2\", // arbitrumGoerli\n  421614: \"https://arb-sepolia.g.alchemy.com/v2\", // arbitrumSepolia\n\n  // Optimism networks\n  10: \"https://opt-mainnet.g.alchemy.com/v2\", // optimism\n  420: \"https://opt-goerli.g.alchemy.com/v2\", // optimismGoerli\n  11155420: \"https://opt-sepolia.g.alchemy.com/v2\", // optimismSepolia\n\n  // Base networks\n  8453: \"https://base-mainnet.g.alchemy.com/v2\", // base\n  84531: \"https://base-goerli.g.alchemy.com/v2\", // baseGoerli\n  84532: \"https://base-sepolia.g.alchemy.com/v2\", // baseSepolia\n\n  // Polygon networks\n  137: \"https://polygon-mainnet.g.alchemy.com/v2\", // polygon\n  80001: \"https://polygon-mumbai.g.alchemy.com/v2\", // polygonMumbai\n  80002: \"https://polygon-amoy.g.alchemy.com/v2\", // polygonAmoy\n\n  // World Chain networks\n  480: \"https://worldchain-mainnet.g.alchemy.com/v2\", // worldChain\n  4801: \"https://worldchain-sepolia.g.alchemy.com/v2\", // worldChainSepolia\n\n  // Shape networks\n  360: \"https://shape-mainnet.g.alchemy.com/v2\", // shape\n  11011: \"https://shape-sepolia.g.alchemy.com/v2\", // shapeSepolia\n\n  // Unichain networks\n  130: \"https://unichain-mainnet.g.alchemy.com/v2\", // unichainMainnet\n  1301: \"https://unichain-sepolia.g.alchemy.com/v2\", // unichainSepolia\n\n  // Soneium networks\n  1868: \"https://soneium-mainnet.g.alchemy.com/v2\", // soneiumMainnet\n  1946: \"https://soneium-minato.g.alchemy.com/v2\", // soneiumMinato\n\n  // OPBNB networks\n  204: \"https://opbnb-mainnet.g.alchemy.com/v2\", // opbnbMainnet\n  5611: \"https://opbnb-testnet.g.alchemy.com/v2\", // opbnbTestnet\n\n  // BeraChain networks\n  80084: \"https://berachain-bartio.g.alchemy.com/v2\", // beraChainBartio\n\n  // Ink networks\n  57073: \"https://ink-mainnet.g.alchemy.com/v2\", // inkMainnet\n  763373: \"https://ink-sepolia.g.alchemy.com/v2\", // inkSepolia\n\n  // Monad networks\n  10143: \"https://monad-testnet.g.alchemy.com/v2\", // monadTestnet\n\n  // Openloot networks\n  905905: \"https://openloot-sepolia.g.alchemy.com/v2\", // openlootSepolia\n\n  // Gensyn networks\n  685685: \"https://gensyn-testnet.g.alchemy.com/v2\", // gensynTestnet\n\n  // Rise networks\n  11155931: \"https://rise-testnet.g.alchemy.com/v2\", // riseTestnet\n\n  // Story networks\n  1514: \"https://story-mainnet.g.alchemy.com/v2\", // storyMainnet\n  1315: \"https://story-aeneid.g.alchemy.com/v2\", // storyAeneid\n\n  // Celo networks\n  42220: \"https://celo-mainnet.g.alchemy.com/v2\", // celoMainnet\n  44787: \"https://celo-alfajores.g.alchemy.com/v2\", // celoAlfajores\n\n  // Tea networks\n  10218: \"https://tea-sepolia.g.alchemy.com/v2\", // teaSepolia\n};\n\n/**\n * Gets the Alchemy RPC base URL for a given chain ID.\n *\n * @param {number} chainId The chain ID to lookup\n * @returns {string | undefined} The Alchemy RPC base URL or undefined if not supported\n *\n * @example\n * ```ts\n * const rpcUrl = getAlchemyRpcUrl(1); // \"https://eth-mainnet.g.alchemy.com/v2\"\n * const customUrl = getAlchemyRpcUrl(999); // undefined\n * ```\n */\nexport function getAlchemyRpcUrl(chainId: number): string | undefined {\n  return ALCHEMY_RPC_MAPPING[chainId];\n}\n\n/**\n * Checks if a chain ID is supported by the Alchemy RPC registry.\n *\n * @param {number} chainId The chain ID to check\n * @returns {boolean} True if the chain is supported, false otherwise\n */\nexport function isChainSupported(chainId: number): boolean {\n  return chainId in ALCHEMY_RPC_MAPPING;\n}\n\n/**\n * Gets all supported chain IDs from the registry.\n *\n * @returns {number[]} Array of supported chain IDs\n */\nexport function getSupportedChainIds(): number[] {\n  return Object.keys(ALCHEMY_RPC_MAPPING).map(Number);\n}\n"]}

package/dist/esm/transport/connection.d.ts

@@ -0,0 +1,20 @@
+import type { Never } from "../utils/types";
+type AlchemyConnectionBaseConfig = {
+    proxyUrl: string;
+    apiKey?: never;
+    jwt?: never;
+} | {
+    proxyUrl?: never;
+    apiKey: string;
+    jwt?: never;
+} | {
+    proxyUrl?: never;
+    apiKey?: never;
+    jwt: string;
+};
+type AAOnlyChainConfig = {
+    alchemyConnection: AlchemyConnectionBaseConfig;
+    nodeRpcUrl: string;
+};
+export type AlchemyConnectionConfig = (AlchemyConnectionBaseConfig & Never<AAOnlyChainConfig>) | (AAOnlyChainConfig & Never<AlchemyConnectionBaseConfig>);
+export {};

package/dist/esm/transport/connection.js

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

package/dist/esm/transport/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/transport/connection.ts"],"names":[],"mappings":"","sourcesContent":["import type { Never } from \"../utils/types\";\n\n// TODO(v5): remove this file and use connectionSchema.ts instead once other packages are migrated over\ntype AlchemyConnectionBaseConfig =\n  // TODO(v5): is this really the best devex? can we do better?\n  // basic configuration for connecting to alchemy.\n  // proxyUrl is used when making calls to the developer backend.\n  | { proxyUrl: string; apiKey?: never; jwt?: never }\n  | { proxyUrl?: never; apiKey: string; jwt?: never }\n  | { proxyUrl?: never; apiKey?: never; jwt: string };\n\ntype AAOnlyChainConfig = {\n  alchemyConnection: AlchemyConnectionBaseConfig;\n  nodeRpcUrl: string;\n};\n\nexport type AlchemyConnectionConfig =\n  | (AlchemyConnectionBaseConfig & Never<AAOnlyChainConfig>)\n  | (AAOnlyChainConfig & Never<AlchemyConnectionBaseConfig>);\n"]}

package/dist/esm/transport/connectionSchema.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+/**
+ * Alchemy Connection Configuration Schema
+ *
+ * Provides three authentication options for connecting to Alchemy services:
+ *
+ * 1. **API Key**: Authenticate using your Alchemy API key
+ * 2. **JWT**: Authenticate using a JWT token
+ * 3. **URL**: Connect directly using a full RPC URL
+ *
+ * @example
+ * Using API Key (uses chain's Alchemy URL):
+ * ```ts
+ * { apiKey: 'abc123' }
+ * ```
+ *
+ * @example
+ * Using JWT (uses chain's Alchemy URL):
+ * ```ts
+ * { jwt: 'eyJhbGc...' }
+ * ```
+ *
+ * @example
+ * Using direct URL only:
+ * ```ts
+ * { url: 'https://eth-mainnet.g.alchemy.com/v2/your-key' }
+ * ```
+ *
+ * @example
+ * Using custom URL with API key:
+ * ```ts
+ * { url: 'https://custom-alchemy.com/v2', apiKey: 'abc123' }
+ * ```
+ *
+ * @example
+ * Using custom URL with JWT:
+ * ```ts
+ * { url: 'https://custom-alchemy.com/v2', jwt: 'eyJhbGc...' }
+ * ```
+ */
+/**
+ * Main connection configuration allowing flexible combinations.
+ * Can specify URL, auth method, or both together.
+ */
+export declare const AlchemyConnectionConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    /** API key for Alchemy authentication */
+    apiKey: z.ZodOptional<z.ZodString>;
+    /** JWT token for authentication */
+    jwt: z.ZodOptional<z.ZodString>;
+    /** Custom RPC URL (optional - defaults to chain's Alchemy URL) */
+    url: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}>, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}>, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}, {
+    apiKey?: string | undefined;
+    jwt?: string | undefined;
+    url?: string | undefined;
+}>;
+/**
+ * TypeScript type derived from the schema for external consumption.
+ * This provides clean type inference without exposing Zod implementation details.
+ */
+export type AlchemyConnectionConfig = z.infer<typeof AlchemyConnectionConfigSchema>;
+/**
+ * Validates an Alchemy connection configuration object.
+ *
+ * @param {unknown} config - The configuration object to validate
+ * @returns {AlchemyConnectionConfig} The validated configuration object
+ * @throws {ConnectionConfigError} If the configuration is invalid
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const config = validateAlchemyConnectionConfig({
+ *     apiKey: 'your-api-key'
+ *   });
+ *   // config is now typed as AlchemyConnectionConfig
+ * } catch (error) {
+ *   if (error instanceof ConnectionConfigError) {
+ *     console.error('Invalid config:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare function validateAlchemyConnectionConfig(config: unknown): AlchemyConnectionConfig;
+/**
+ * Type guard to check if a value is a valid Alchemy connection config.
+ *
+ * @param {unknown} value - The value to check for validity
+ * @returns {boolean} True if the value is a valid Alchemy connection config
+ *
+ * @example
+ * ```ts
+ * const maybeConfig: unknown = { apiKey: 'test' };
+ * if (isAlchemyConnectionConfig(maybeConfig)) {
+ *   // TypeScript knows maybeConfig is AlchemyConnectionConfig here
+ *   if (maybeConfig.apiKey) {
+ *     console.log('Using API key:', maybeConfig.apiKey);
+ *   }
+ *   if (maybeConfig.url) {
+ *     console.log('Using custom URL:', maybeConfig.url);
+ *   }
+ * }
+ * ```
+ */
+export declare function isAlchemyConnectionConfig(value: unknown): value is AlchemyConnectionConfig;

package/dist/esm/transport/connectionSchema.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { ConnectionConfigError } from "../errors/ConnectionConfigError.js";
+/**
+ * Alchemy Connection Configuration Schema
+ *
+ * Provides three authentication options for connecting to Alchemy services:
+ *
+ * 1. **API Key**: Authenticate using your Alchemy API key
+ * 2. **JWT**: Authenticate using a JWT token
+ * 3. **URL**: Connect directly using a full RPC URL
+ *
+ * @example
+ * Using API Key (uses chain's Alchemy URL):
+ * ```ts
+ * { apiKey: 'abc123' }
+ * ```
+ *
+ * @example
+ * Using JWT (uses chain's Alchemy URL):
+ * ```ts
+ * { jwt: 'eyJhbGc...' }
+ * ```
+ *
+ * @example
+ * Using direct URL only:
+ * ```ts
+ * { url: 'https://eth-mainnet.g.alchemy.com/v2/your-key' }
+ * ```
+ *
+ * @example
+ * Using custom URL with API key:
+ * ```ts
+ * { url: 'https://custom-alchemy.com/v2', apiKey: 'abc123' }
+ * ```
+ *
+ * @example
+ * Using custom URL with JWT:
+ * ```ts
+ * { url: 'https://custom-alchemy.com/v2', jwt: 'eyJhbGc...' }
+ * ```
+ */
+/**
+ * Main connection configuration allowing flexible combinations.
+ * Can specify URL, auth method, or both together.
+ */
+export const AlchemyConnectionConfigSchema = z
+    .object({
+    /** API key for Alchemy authentication */
+    apiKey: z.string().min(1, "API key cannot be empty").optional(),
+    /** JWT token for authentication */
+    jwt: z.string().min(1, "JWT cannot be empty").optional(),
+    /** Custom RPC URL (optional - defaults to chain's Alchemy URL) */
+    url: z.string().url("Invalid URL format").optional(),
+})
+    .strict()
+    .refine((data) => {
+    // Must have at least one field
+    return data.apiKey || data.jwt || data.url;
+}, {
+    message: "Must specify at least one of: apiKey, jwt, or url",
+})
+    .refine((data) => {
+    // Cannot have both apiKey and jwt
+    return !(data.apiKey && data.jwt);
+}, {
+    message: "Cannot specify both apiKey and jwt - choose only one authentication method",
+});
+/**
+ * Validates an Alchemy connection configuration object.
+ *
+ * @param {unknown} config - The configuration object to validate
+ * @returns {AlchemyConnectionConfig} The validated configuration object
+ * @throws {ConnectionConfigError} If the configuration is invalid
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const config = validateAlchemyConnectionConfig({
+ *     apiKey: 'your-api-key'
+ *   });
+ *   // config is now typed as AlchemyConnectionConfig
+ * } catch (error) {
+ *   if (error instanceof ConnectionConfigError) {
+ *     console.error('Invalid config:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export function validateAlchemyConnectionConfig(config) {
+    const result = AlchemyConnectionConfigSchema.safeParse(config);
+    if (!result.success) {
+        const firstError = result.error.issues[0];
+        const details = firstError?.message || "Invalid connection configuration";
+        throw new ConnectionConfigError(details);
+    }
+    return result.data;
+}
+/**
+ * Type guard to check if a value is a valid Alchemy connection config.
+ *
+ * @param {unknown} value - The value to check for validity
+ * @returns {boolean} True if the value is a valid Alchemy connection config
+ *
+ * @example
+ * ```ts
+ * const maybeConfig: unknown = { apiKey: 'test' };
+ * if (isAlchemyConnectionConfig(maybeConfig)) {
+ *   // TypeScript knows maybeConfig is AlchemyConnectionConfig here
+ *   if (maybeConfig.apiKey) {
+ *     console.log('Using API key:', maybeConfig.apiKey);
+ *   }
+ *   if (maybeConfig.url) {
+ *     console.log('Using custom URL:', maybeConfig.url);
+ *   }
+ * }
+ * ```
+ */
+export function isAlchemyConnectionConfig(value) {
+    return AlchemyConnectionConfigSchema.safeParse(value).success;
+}
+//# sourceMappingURL=connectionSchema.js.map

package/dist/esm/transport/connectionSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionSchema.js","sourceRoot":"","sources":["../../../src/transport/connectionSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,yCAAyC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAC/D,mCAAmC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACxD,kEAAkE;IAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,+BAA+B;IAC/B,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;AAC7C,CAAC,EACD;IACE,OAAO,EAAE,mDAAmD;CAC7D,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,kCAAkC;IAClC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC,EACD;IACE,OAAO,EACL,4EAA4E;CAC/E,CACF,CAAC;AAUJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAAe;IAEf,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE/D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,kCAAkC,CAAC;QAC1E,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc;IAEd,OAAO,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAChE,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { ConnectionConfigError } from \"../errors/ConnectionConfigError.js\";\n\n/**\n * Alchemy Connection Configuration Schema\n *\n * Provides three authentication options for connecting to Alchemy services:\n *\n * 1. **API Key**: Authenticate using your Alchemy API key\n * 2. **JWT**: Authenticate using a JWT token\n * 3. **URL**: Connect directly using a full RPC URL\n *\n * @example\n * Using API Key (uses chain's Alchemy URL):\n * ```ts\n * { apiKey: 'abc123' }\n * ```\n *\n * @example\n * Using JWT (uses chain's Alchemy URL):\n * ```ts\n * { jwt: 'eyJhbGc...' }\n * ```\n *\n * @example\n * Using direct URL only:\n * ```ts\n * { url: 'https://eth-mainnet.g.alchemy.com/v2/your-key' }\n * ```\n *\n * @example\n * Using custom URL with API key:\n * ```ts\n * { url: 'https://custom-alchemy.com/v2', apiKey: 'abc123' }\n * ```\n *\n * @example\n * Using custom URL with JWT:\n * ```ts\n * { url: 'https://custom-alchemy.com/v2', jwt: 'eyJhbGc...' }\n * ```\n */\n\n/**\n * Main connection configuration allowing flexible combinations.\n * Can specify URL, auth method, or both together.\n */\nexport const AlchemyConnectionConfigSchema = z\n  .object({\n    /** API key for Alchemy authentication */\n    apiKey: z.string().min(1, \"API key cannot be empty\").optional(),\n    /** JWT token for authentication */\n    jwt: z.string().min(1, \"JWT cannot be empty\").optional(),\n    /** Custom RPC URL (optional - defaults to chain's Alchemy URL) */\n    url: z.string().url(\"Invalid URL format\").optional(),\n  })\n  .strict()\n  .refine(\n    (data) => {\n      // Must have at least one field\n      return data.apiKey || data.jwt || data.url;\n    },\n    {\n      message: \"Must specify at least one of: apiKey, jwt, or url\",\n    },\n  )\n  .refine(\n    (data) => {\n      // Cannot have both apiKey and jwt\n      return !(data.apiKey && data.jwt);\n    },\n    {\n      message:\n        \"Cannot specify both apiKey and jwt - choose only one authentication method\",\n    },\n  );\n\n/**\n * TypeScript type derived from the schema for external consumption.\n * This provides clean type inference without exposing Zod implementation details.\n */\nexport type AlchemyConnectionConfig = z.infer<\n  typeof AlchemyConnectionConfigSchema\n>;\n\n/**\n * Validates an Alchemy connection configuration object.\n *\n * @param {unknown} config - The configuration object to validate\n * @returns {AlchemyConnectionConfig} The validated configuration object\n * @throws {ConnectionConfigError} If the configuration is invalid\n *\n * @example\n * ```ts\n * try {\n *   const config = validateAlchemyConnectionConfig({\n *     apiKey: 'your-api-key'\n *   });\n *   // config is now typed as AlchemyConnectionConfig\n * } catch (error) {\n *   if (error instanceof ConnectionConfigError) {\n *     console.error('Invalid config:', error.message);\n *   }\n * }\n * ```\n */\nexport function validateAlchemyConnectionConfig(\n  config: unknown,\n): AlchemyConnectionConfig {\n  const result = AlchemyConnectionConfigSchema.safeParse(config);\n\n  if (!result.success) {\n    const firstError = result.error.issues[0];\n    const details = firstError?.message || \"Invalid connection configuration\";\n    throw new ConnectionConfigError(details);\n  }\n\n  return result.data;\n}\n\n/**\n * Type guard to check if a value is a valid Alchemy connection config.\n *\n * @param {unknown} value - The value to check for validity\n * @returns {boolean} True if the value is a valid Alchemy connection config\n *\n * @example\n * ```ts\n * const maybeConfig: unknown = { apiKey: 'test' };\n * if (isAlchemyConnectionConfig(maybeConfig)) {\n *   // TypeScript knows maybeConfig is AlchemyConnectionConfig here\n *   if (maybeConfig.apiKey) {\n *     console.log('Using API key:', maybeConfig.apiKey);\n *   }\n *   if (maybeConfig.url) {\n *     console.log('Using custom URL:', maybeConfig.url);\n *   }\n * }\n * ```\n */\nexport function isAlchemyConnectionConfig(\n  value: unknown,\n): value is AlchemyConnectionConfig {\n  return AlchemyConnectionConfigSchema.safeParse(value).success;\n}\n"]}

package/dist/esm/utils/assertNever.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Asserts that a value is never.
+ *
+ * @param {never} _x - The value to assert.
+ * @param {string} msg - The message to throw if the value is not never.
+ * @returns {never} Always throws an error.
+ */
+export declare const assertNever: (_x: never, msg: string) => never;

package/dist/esm/utils/assertNever.js

@@ -0,0 +1,12 @@
+import { BaseError } from "../errors/BaseError.js";
+/**
+ * Asserts that a value is never.
+ *
+ * @param {never} _x - The value to assert.
+ * @param {string} msg - The message to throw if the value is not never.
+ * @returns {never} Always throws an error.
+ */
+export const assertNever = (_x, msg) => {
+    throw new BaseError(msg);
+};
+//# sourceMappingURL=assertNever.js.map

package/dist/esm/utils/assertNever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.js","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAS,EAAE,GAAW,EAAS,EAAE;IAC3D,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC","sourcesContent":["import { BaseError } from \"../errors/BaseError.js\";\n\n/**\n * Asserts that a value is never.\n *\n * @param {never} _x - The value to assert.\n * @param {string} msg - The message to throw if the value is not never.\n * @returns {never} Always throws an error.\n */\nexport const assertNever = (_x: never, msg: string): never => {\n  throw new BaseError(msg);\n};\n"]}

package/dist/esm/utils/bigint.d.ts

@@ -0,0 +1,24 @@
+/**
+ * BigNumberish represents values that can be converted to BigInt
+ */
+export type BigNumberish = string | number | bigint;
+/**
+ * Multiplier configuration for bigint multiplication
+ */
+export type Multiplier = {
+    multiplier: number;
+};
+export declare enum RoundingMode {
+    ROUND_DOWN = 0,
+    ROUND_UP = 1
+}
+/**
+ * Given a bigint and a number (which can be a float), returns the bigint value.
+ * Note: this function has loss and will round down to the nearest integer.
+ *
+ * @param {BigNumberish} base - the number to be multiplied
+ * @param {number} multiplier - the amount to multiply by
+ * @param {RoundingMode} roundingMode - the rounding mode to use when calculating the percent. defaults to ROUND_UP
+ * @returns {bigint} the bigint value of the multiplication with the number rounded by the rounding mode
+ */
+export declare const bigIntMultiply: (base: BigNumberish, multiplier: Multiplier["multiplier"], roundingMode?: RoundingMode) => bigint;

package/dist/esm/utils/bigint.js

@@ -0,0 +1,37 @@
+export var RoundingMode;
+(function (RoundingMode) {
+    RoundingMode[RoundingMode["ROUND_DOWN"] = 0] = "ROUND_DOWN";
+    RoundingMode[RoundingMode["ROUND_UP"] = 1] = "ROUND_UP";
+})(RoundingMode || (RoundingMode = {}));
+/**
+ * Validates if a multiplier has acceptable precision (max 4 decimal places)
+ *
+ * @param {Multiplier} multiplier - the multiplier to validate
+ * @returns {boolean} true if valid, false otherwise
+ */
+function isValidMultiplier(multiplier) {
+    const decimalPlaces = multiplier.multiplier.toString().split(".")[1]?.length ?? 0;
+    return decimalPlaces <= 4;
+}
+/**
+ * Given a bigint and a number (which can be a float), returns the bigint value.
+ * Note: this function has loss and will round down to the nearest integer.
+ *
+ * @param {BigNumberish} base - the number to be multiplied
+ * @param {number} multiplier - the amount to multiply by
+ * @param {RoundingMode} roundingMode - the rounding mode to use when calculating the percent. defaults to ROUND_UP
+ * @returns {bigint} the bigint value of the multiplication with the number rounded by the rounding mode
+ */
+export const bigIntMultiply = (base, multiplier, roundingMode = RoundingMode.ROUND_UP) => {
+    if (!isValidMultiplier({ multiplier })) {
+        throw new Error("bigIntMultiply requires a multiplier validated number as the second argument (max 4 decimal places)");
+    }
+    // Get decimal places of b. Max decimal places is defined by the validation above.
+    const decimalPlaces = multiplier.toString().split(".")[1]?.length ?? 0;
+    const result = BigInt(base) * BigInt(Math.round(multiplier * 10 ** decimalPlaces));
+    return roundingMode === RoundingMode.ROUND_UP &&
+        result % BigInt(10 ** decimalPlaces) > 0
+        ? result / BigInt(10 ** decimalPlaces) + 1n
+        : result / BigInt(10 ** decimalPlaces);
+};
+//# sourceMappingURL=bigint.js.map

package/dist/esm/utils/bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.js","sourceRoot":"","sources":["../../../src/utils/bigint.ts"],"names":[],"mappings":"AAYA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,2DAAc,CAAA;IACd,uDAAY,CAAA;AACd,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,UAAsB;IAC/C,MAAM,aAAa,GACjB,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC9D,OAAO,aAAa,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAkB,EAClB,UAAoC,EACpC,eAA6B,YAAY,CAAC,QAAQ,EAClD,EAAE;IACF,IAAI,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,kFAAkF;IAClF,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACvE,MAAM,MAAM,GACV,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC;IACtE,OAAO,YAAY,KAAK,YAAY,CAAC,QAAQ;QAC3C,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC,GAAG,CAAC;QACxC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC,GAAG,EAAE;QAC3C,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC;AAC3C,CAAC,CAAC","sourcesContent":["/**\n * BigNumberish represents values that can be converted to BigInt\n */\nexport type BigNumberish = string | number | bigint;\n\n/**\n * Multiplier configuration for bigint multiplication\n */\nexport type Multiplier = {\n  multiplier: number;\n};\n\nexport enum RoundingMode {\n  ROUND_DOWN = 0,\n  ROUND_UP = 1,\n}\n\n/**\n * Validates if a multiplier has acceptable precision (max 4 decimal places)\n *\n * @param {Multiplier} multiplier - the multiplier to validate\n * @returns {boolean} true if valid, false otherwise\n */\nfunction isValidMultiplier(multiplier: Multiplier): boolean {\n  const decimalPlaces =\n    multiplier.multiplier.toString().split(\".\")[1]?.length ?? 0;\n  return decimalPlaces <= 4;\n}\n\n/**\n * Given a bigint and a number (which can be a float), returns the bigint value.\n * Note: this function has loss and will round down to the nearest integer.\n *\n * @param {BigNumberish} base - the number to be multiplied\n * @param {number} multiplier - the amount to multiply by\n * @param {RoundingMode} roundingMode - the rounding mode to use when calculating the percent. defaults to ROUND_UP\n * @returns {bigint} the bigint value of the multiplication with the number rounded by the rounding mode\n */\nexport const bigIntMultiply = (\n  base: BigNumberish,\n  multiplier: Multiplier[\"multiplier\"],\n  roundingMode: RoundingMode = RoundingMode.ROUND_UP,\n) => {\n  if (!isValidMultiplier({ multiplier })) {\n    throw new Error(\n      \"bigIntMultiply requires a multiplier validated number as the second argument (max 4 decimal places)\",\n    );\n  }\n\n  // Get decimal places of b. Max decimal places is defined by the validation above.\n  const decimalPlaces = multiplier.toString().split(\".\")[1]?.length ?? 0;\n  const result =\n    BigInt(base) * BigInt(Math.round(multiplier * 10 ** decimalPlaces));\n  return roundingMode === RoundingMode.ROUND_UP &&\n    result % BigInt(10 ** decimalPlaces) > 0\n    ? result / BigInt(10 ** decimalPlaces) + 1n\n    : result / BigInt(10 ** decimalPlaces);\n};\n"]}

package/dist/esm/utils/createEip1193HandlerFactory.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Creates a typed handler factory for EIP1193 request methods.
+ * This helps with Viem's typing within custom EIP1193 request functions by
+ * automatically casting input params and ensuring the result matches what is required.
+ *
+ * @returns {(params: unknown) => unknown} A function that creates a handler factory for specific methods
+ */
+export declare const createEip1193HandlerFactory: <TMethods extends readonly {
+    Method: string;
+    Parameters?: unknown;
+    ReturnType?: unknown;
+}[]>() => <TMethod extends TMethods[number]["Method"]>(handle: (params: Extract<TMethods[number], {
+    Method: TMethod;
+}>["Parameters"]) => Promise<Extract<TMethods[number], {
+    Method: TMethod;
+}>["ReturnType"]>) => (params: unknown) => Promise<Extract<TMethods[number], {
+    Method: TMethod;
+}>["ReturnType"]>;

package/dist/esm/utils/createEip1193HandlerFactory.js

@@ -0,0 +1,11 @@
+/**
+ * Creates a typed handler factory for EIP1193 request methods.
+ * This helps with Viem's typing within custom EIP1193 request functions by
+ * automatically casting input params and ensuring the result matches what is required.
+ *
+ * @returns {(params: unknown) => unknown} A function that creates a handler factory for specific methods
+ */
+export const createEip1193HandlerFactory = () => (handle) => (params) => {
+    return handle(params);
+};
+//# sourceMappingURL=createEip1193HandlerFactory.js.map

package/dist/esm/utils/createEip1193HandlerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEip1193HandlerFactory.js","sourceRoot":"","sources":["../../../src/utils/createEip1193HandlerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,GAMI,EAAE,CACN,CACE,MAE0E,EAC1E,EAAE,CACJ,CAAC,MAAe,EAAE,EAAE;IAClB,OAAO,MAAM,CACX,MAAsE,CACvE,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * Creates a typed handler factory for EIP1193 request methods.\n * This helps with Viem's typing within custom EIP1193 request functions by\n * automatically casting input params and ensuring the result matches what is required.\n *\n * @returns {(params: unknown) => unknown} A function that creates a handler factory for specific methods\n */\nexport const createEip1193HandlerFactory =\n  <\n    TMethods extends readonly {\n      Method: string;\n      Parameters?: unknown;\n      ReturnType?: unknown;\n    }[],\n  >() =>\n  <TMethod extends TMethods[number][\"Method\"]>(\n    handle: (\n      params: Extract<TMethods[number], { Method: TMethod }>[\"Parameters\"],\n    ) => Promise<Extract<TMethods[number], { Method: TMethod }>[\"ReturnType\"]>,\n  ) =>\n  (params: unknown) => {\n    return handle(\n      params as Extract<TMethods[number], { Method: TMethod }>[\"Parameters\"],\n    );\n  };\n"]}

package/dist/esm/utils/headers.d.ts

@@ -0,0 +1,7 @@
+export type WithAlchemyHeadersParams = {
+    headers?: HeadersInit;
+    apiKey?: string;
+    jwt?: string;
+};
+export declare function withAlchemyHeaders({ headers, apiKey, jwt, }: WithAlchemyHeadersParams): Record<string, string>;
+export declare function convertHeadersToObject(headers?: HeadersInit): Record<string, string>;

package/dist/esm/utils/headers.js

@@ -0,0 +1,29 @@
+import { VERSION } from "../version.js";
+export function withAlchemyHeaders({ headers, apiKey, jwt, }) {
+    const bearerToken = jwt ?? apiKey;
+    return {
+        ...convertHeadersToObject(headers),
+        "Alchemy-AA-Sdk-Version": VERSION,
+        ...(bearerToken ? { Authorization: `Bearer ${bearerToken}` } : {}),
+    };
+}
+export function convertHeadersToObject(headers) {
+    if (!headers) {
+        return {};
+    }
+    if (headers instanceof Headers) {
+        const headersObject = {};
+        headers.forEach((value, key) => {
+            headersObject[key] = value;
+        });
+        return headersObject;
+    }
+    if (Array.isArray(headers)) {
+        return headers.reduce((acc, header) => {
+            acc[header[0]] = header[1];
+            return acc;
+        }, {});
+    }
+    return headers;
+}
+//# sourceMappingURL=headers.js.map

package/dist/esm/utils/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../../src/utils/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAQxC,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,MAAM,EACN,GAAG,GACsB;IACzB,MAAM,WAAW,GAAG,GAAG,IAAI,MAAM,CAAC;IAClC,OAAO;QACL,GAAG,sBAAsB,CAAC,OAAO,CAAC;QAClC,wBAAwB,EAAE,OAAO;QACjC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAqB;IAErB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,EAA4B,CAAC;QACnD,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACd,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3B,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA4B,CAC7B,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { VERSION } from \"../version.js\";\n\nexport type WithAlchemyHeadersParams = {\n  headers?: HeadersInit;\n  apiKey?: string;\n  jwt?: string;\n};\n\nexport function withAlchemyHeaders({\n  headers,\n  apiKey,\n  jwt,\n}: WithAlchemyHeadersParams): Record<string, string> {\n  const bearerToken = jwt ?? apiKey;\n  return {\n    ...convertHeadersToObject(headers),\n    \"Alchemy-AA-Sdk-Version\": VERSION,\n    ...(bearerToken ? { Authorization: `Bearer ${bearerToken}` } : {}),\n  };\n}\n\nexport function convertHeadersToObject(\n  headers?: HeadersInit,\n): Record<string, string> {\n  if (!headers) {\n    return {};\n  }\n\n  if (headers instanceof Headers) {\n    const headersObject = {} as Record<string, string>;\n    headers.forEach((value, key) => {\n      headersObject[key] = value;\n    });\n    return headersObject;\n  }\n\n  if (Array.isArray(headers)) {\n    return headers.reduce(\n      (acc, header) => {\n        acc[header[0]] = header[1];\n        return acc;\n      },\n      {} as Record<string, string>,\n    );\n  }\n\n  return headers;\n}\n"]}

package/dist/esm/utils/lowerAddress.d.ts

@@ -0,0 +1,8 @@
+import { type Address } from "viem";
+/**
+ * Lowercase an address
+ *
+ * @param {Address} addr - The address to lowercase
+ * @returns {Address} The lowercase address
+ */
+export declare const lowerAddress: (addr: Address) => Address;

package/dist/esm/utils/lowerAddress.js

@@ -0,0 +1,9 @@
+import {} from "viem";
+/**
+ * Lowercase an address
+ *
+ * @param {Address} addr - The address to lowercase
+ * @returns {Address} The lowercase address
+ */
+export const lowerAddress = (addr) => addr.toLowerCase();
+//# sourceMappingURL=lowerAddress.js.map

package/dist/esm/utils/lowerAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowerAddress.js","sourceRoot":"","sources":["../../../src/utils/lowerAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,MAAM,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAW,EAAE,CACrD,IAAI,CAAC,WAAW,EAAa,CAAC","sourcesContent":["import { type Address } from \"viem\";\n\n/**\n * Lowercase an address\n *\n * @param {Address} addr - The address to lowercase\n * @returns {Address} The lowercase address\n */\nexport const lowerAddress = (addr: Address): Address =>\n  addr.toLowerCase() as Address;\n"]}

package/dist/esm/utils/raise.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from "viem";
+/**
+ * Raises an error.
+ *
+ * @param {string | BaseError} err - The error to raise.
+ * @returns {never} Always throws an error.
+ */
+export declare const raise: (err: string | BaseError) => never;

package/dist/esm/utils/raise.js

@@ -0,0 +1,14 @@
+import { BaseError } from "viem";
+/**
+ * Raises an error.
+ *
+ * @param {string | BaseError} err - The error to raise.
+ * @returns {never} Always throws an error.
+ */
+export const raise = (err) => {
+    if (typeof err === "string") {
+        throw new BaseError(err);
+    }
+    throw err;
+};
+//# sourceMappingURL=raise.js.map

package/dist/esm/utils/raise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raise.js","sourceRoot":"","sources":["../../../src/utils/raise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAuB,EAAS,EAAE;IACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,GAAG,CAAC;AACZ,CAAC,CAAC","sourcesContent":["import { BaseError } from \"viem\";\n\n/**\n * Raises an error.\n *\n * @param {string | BaseError} err - The error to raise.\n * @returns {never} Always throws an error.\n */\nexport const raise = (err: string | BaseError): never => {\n  if (typeof err === \"string\") {\n    throw new BaseError(err);\n  }\n  throw err;\n};\n"]}