@alchemy/common 0.0.0-alpha.9 → 5.0.0-beta.2

package/src/transport/chainRegistry.ts

@@ -1,82 +1,134 @@
 /**
  * Internal registry mapping chain IDs to Alchemy RPC base URLs.
  * This replaces the need for custom chain exports with embedded Alchemy URLs.
+ *
+ * Auto-generated by the ws-tools CLI — do not manually edit.
  */
 export const ALCHEMY_RPC_MAPPING: Record<number, string> = {
-  // 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
+  // ANIME networks
+  6900: "https://anime-sepolia.g.alchemy.com/v2", // animeSepolia
+  69000: "https://anime-mainnet.g.alchemy.com/v2", // animeMainnet
+
+  // APECHAIN networks
+  33139: "https://apechain-mainnet.g.alchemy.com/v2", // apechainMainnet
+  33111: "https://apechain-curtis.g.alchemy.com/v2", // apechainCurtis
+
+  // ARB networks
+  421614: "https://arb-sepolia.g.alchemy.com/v2", // arbSepolia
+  42161: "https://arb-mainnet.g.alchemy.com/v2", // arbMainnet
+
+  // ARBNOVA networks
+  42170: "https://arbnova-mainnet.g.alchemy.com/v2", // arbnovaMainnet
+
+  // ARC networks
+  5042002: "https://arc-testnet.g.alchemy.com/v2", // arcTestnet
+
+  // BASE networks
+  8453: "https://base-mainnet.g.alchemy.com/v2", // baseMainnet
   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
+  // BERACHAIN networks
+  80094: "https://berachain-mainnet.g.alchemy.com/v2", // berachainMainnet
+  80069: "https://berachain-bepolia.g.alchemy.com/v2", // berachainBepolia
 
-  // World Chain networks
-  480: "https://worldchain-mainnet.g.alchemy.com/v2", // worldChain
-  4801: "https://worldchain-sepolia.g.alchemy.com/v2", // worldChainSepolia
+  // BNB networks
+  97: "https://bnb-testnet.g.alchemy.com/v2", // bnbTestnet
+  56: "https://bnb-mainnet.g.alchemy.com/v2", // bnbMainnet
 
-  // Shape networks
-  360: "https://shape-mainnet.g.alchemy.com/v2", // shape
-  11011: "https://shape-sepolia.g.alchemy.com/v2", // shapeSepolia
+  // CELO networks
+  11142220: "https://celo-sepolia.g.alchemy.com/v2", // celoSepolia
+  42220: "https://celo-mainnet.g.alchemy.com/v2", // celoMainnet
 
-  // Unichain networks
-  130: "https://unichain-mainnet.g.alchemy.com/v2", // unichainMainnet
-  1301: "https://unichain-sepolia.g.alchemy.com/v2", // unichainSepolia
+  // CLANKERMON networks
+  510525: "https://clankermon-mainnet.g.alchemy.com/v2", // clankermonMainnet
 
-  // Soneium networks
-  1868: "https://soneium-mainnet.g.alchemy.com/v2", // soneiumMainnet
-  1946: "https://soneium-minato.g.alchemy.com/v2", // soneiumMinato
+  // ETH networks
+  1: "https://eth-mainnet.g.alchemy.com/v2", // ethMainnet
+  11155111: "https://eth-sepolia.g.alchemy.com/v2", // ethSepolia
 
-  // OPBNB networks
-  204: "https://opbnb-mainnet.g.alchemy.com/v2", // opbnbMainnet
-  5611: "https://opbnb-testnet.g.alchemy.com/v2", // opbnbTestnet
+  // FRAX networks
+  252: "https://frax-mainnet.g.alchemy.com/v2", // fraxMainnet
 
-  // BeraChain networks
-  80084: "https://berachain-bartio.g.alchemy.com/v2", // beraChainBartio
+  // GENSYN networks
+  685685: "https://gensyn-testnet.g.alchemy.com/v2", // gensynTestnet
+
+  // HYPERLIQUID networks
+  999: "https://hyperliquid-mainnet.g.alchemy.com/v2", // hyperliquidMainnet
 
-  // Ink networks
+  // INK networks
   57073: "https://ink-mainnet.g.alchemy.com/v2", // inkMainnet
   763373: "https://ink-sepolia.g.alchemy.com/v2", // inkSepolia
 
-  // Monad networks
+  // MATIC networks
+  80002: "https://polygon-amoy.g.alchemy.com/v2", // maticAmoy
+  137: "https://polygon-mainnet.g.alchemy.com/v2", // maticMainnet
+
+  // MEGAETH networks
+  4326: "https://megaeth-mainnet.g.alchemy.com/v2", // megaethMainnet
+  6343: "https://megaeth-testnet.g.alchemy.com/v2", // megaethTestnet
+
+  // MONAD networks
   10143: "https://monad-testnet.g.alchemy.com/v2", // monadTestnet
+  143: "https://monad-mainnet.g.alchemy.com/v2", // monadMainnet
+
+  // MYTHOS networks
+  42018: "https://mythos-mainnet.g.alchemy.com/v2", // mythosMainnet
 
-  // Openloot networks
+  // OPBNB networks
+  5611: "https://opbnb-testnet.g.alchemy.com/v2", // opbnbTestnet
+  204: "https://opbnb-mainnet.g.alchemy.com/v2", // opbnbMainnet
+
+  // OPENLOOT networks
   905905: "https://openloot-sepolia.g.alchemy.com/v2", // openlootSepolia
 
-  // Gensyn networks
-  685685: "https://gensyn-testnet.g.alchemy.com/v2", // gensynTestnet
+  // OPT networks
+  10: "https://opt-mainnet.g.alchemy.com/v2", // optMainnet
+  11155420: "https://opt-sepolia.g.alchemy.com/v2", // optSepolia
 
-  // Rise networks
+  // PLASMA networks
+  9746: "https://plasma-testnet.g.alchemy.com/v2", // plasmaTestnet
+  9745: "https://plasma-mainnet.g.alchemy.com/v2", // plasmaMainnet
+
+  // POLYNOMIAL networks
+  8008: "https://polynomial-mainnet.g.alchemy.com/v2", // polynomialMainnet
+  80008: "https://polynomial-sepolia.g.alchemy.com/v2", // polynomialSepolia
+
+  // RISE networks
   11155931: "https://rise-testnet.g.alchemy.com/v2", // riseTestnet
 
-  // Story networks
+  // ROBINHOOD networks
+  46630: "https://robinhood-testnet.g.alchemy.com/v2", // robinhoodTestnet
+
+  // SHAPE networks
+  11011: "https://shape-sepolia.g.alchemy.com/v2", // shapeSepolia
+  360: "https://shape-mainnet.g.alchemy.com/v2", // shapeMainnet
+
+  // SONEIUM networks
+  1946: "https://soneium-minato.g.alchemy.com/v2", // soneiumMinato
+  1868: "https://soneium-mainnet.g.alchemy.com/v2", // soneiumMainnet
+
+  // STABLE networks
+  988: "https://stable-mainnet.g.alchemy.com/v2", // stableMainnet
+  2201: "https://stable-testnet.g.alchemy.com/v2", // stableTestnet
+
+  // 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
+  // UNICHAIN networks
+  1301: "https://unichain-sepolia.g.alchemy.com/v2", // unichainSepolia
+  130: "https://unichain-mainnet.g.alchemy.com/v2", // unichainMainnet
+
+  // WORLDCHAIN networks
+  4801: "https://worldchain-sepolia.g.alchemy.com/v2", // worldchainSepolia
+  480: "https://worldchain-mainnet.g.alchemy.com/v2", // worldchainMainnet
+
+  // WORLDMOBILECHAIN networks
+  869: "https://worldmobilechain-mainnet.g.alchemy.com/v2", // worldmobilechainMainnet
 
-  // Tea networks
-  10218: "https://tea-sepolia.g.alchemy.com/v2", // teaSepolia
+  // ZORA networks
+  7777777: "https://zora-mainnet.g.alchemy.com/v2", // zoraMainnet
+  999999999: "https://zora-sepolia.g.alchemy.com/v2", // zoraSepolia
 };
 
 /**
@@ -88,7 +140,6 @@ export const ALCHEMY_RPC_MAPPING: Record<number, string> = {
  * @example
  * ```ts
  * const rpcUrl = getAlchemyRpcUrl(1); // "https://eth-mainnet.g.alchemy.com/v2"
- * const customUrl = getAlchemyRpcUrl(999); // undefined
  * ```
  */
 export function getAlchemyRpcUrl(chainId: number): string | undefined {

package/src/utils/bigint.ts

@@ -1,3 +1,5 @@
+import { BaseError } from "../errors/BaseError.js";
+
 /**
  * BigNumberish represents values that can be converted to BigInt
  */
@@ -42,7 +44,7 @@ export const bigIntMultiply = (
   roundingMode: RoundingMode = RoundingMode.ROUND_UP,
 ) => {
   if (!isValidMultiplier({ multiplier })) {
-    throw new Error(
+    throw new BaseError(
       "bigIntMultiply requires a multiplier validated number as the second argument (max 4 decimal places)",
     );
   }
@@ -65,7 +67,7 @@ export const bigIntMultiply = (
  */
 export const bigIntMax = (...args: bigint[]): bigint => {
   if (!args.length) {
-    throw new Error("bigIntMax requires at least one argument");
+    throw new BaseError("bigIntMax requires at least one argument");
   }
 
   return args.reduce((m, c) => (m > c ? m : c));

package/src/version.ts

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

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

@@ -1,20 +0,0 @@
-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

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

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

@@ -1 +0,0 @@
-{"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/utils/createEip1193HandlerFactory.d.ts

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/types/transport/connection.d.ts

@@ -1,21 +0,0 @@
-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 {};
-//# sourceMappingURL=connection.d.ts.map

package/dist/types/transport/connection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/transport/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,KAAK,2BAA2B,GAI5B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACvB,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,CAAC,2BAA2B,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,GACxD,CAAC,iBAAiB,GAAG,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC"}

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

@@ -1,19 +0,0 @@
-/**
- * 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"]>;
-//# sourceMappingURL=createEip1193HandlerFactory.d.ts.map

package/dist/types/utils/createEip1193HandlerFactory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createEip1193HandlerFactory.d.ts","sourceRoot":"","sources":["../../../src/utils/createEip1193HandlerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAEpC,QAAQ,SAAS,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,EAAE,QAEJ,OAAO,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EACzC,QAAQ,CACN,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,YAAY,CAAC,KACjE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,YAAY,CAAC,CAAC,MAE3E,QAAQ,OAAO;YAFmC,OAAO;iBAMzD,CAAC"}

package/src/transport/connection.ts

@@ -1,19 +0,0 @@
-import type { Never } from "../utils/types";
-
-// TODO(v5): remove this file and use connectionSchema.ts instead once other packages are migrated over
-type AlchemyConnectionBaseConfig =
-  // TODO(v5): is this really the best devex? can we do better?
-  // basic configuration for connecting to alchemy.
-  // proxyUrl is used when making calls to the developer backend.
-  | { 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>);

package/src/utils/createEip1193HandlerFactory.ts

@@ -1,25 +0,0 @@
-/**
- * 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 =
-  <
-    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) => {
-    return handle(
-      params as Extract<TMethods[number], { Method: TMethod }>["Parameters"],
-    );
-  };