让开源，少一点语言距离。
npm包中文文档

@alchemy/common

中文文档
5.3.0发布于 2026/10/06MITTypeScriptES Module近 30 天下载 13.3万

A collection of interfaces and utilities to be used by other Alchemy packages

原始使用文档
中文原文
文档目录4 节
  1. Installation
  2. Key Exports
  3. Usage
  4. License

@alchemy/common

This is a low-level package that is consumed by other Alchemy packages.

Installation

npm install @alchemy/common viem

Key Exports

  • alchemyTransport - viem-compatible HTTP transport for Alchemy APIs (supports API key, JWT, or direct URL auth)
  • Chain registry - getAlchemyRpcUrl, isChainSupported, getSupportedChainIds
  • Custom chain definitions (via @alchemy/common/chains) - chains not yet in viem
  • AlchemyRestClient - typed REST client for non-JSON-RPC Alchemy APIs
  • Error classes - BaseError, ChainNotFoundError, AccountNotFoundError, ConnectionConfigError, etc.
  • Logging - createLogger, setGlobalLoggerConfig, LogLevel
  • Utilities - bigIntMultiply, bigIntMax, lowerAddress, assertNever

Usage

import { alchemyTransport } from "@alchemy/common";
import { sepolia } from "viem/chains";
import { createPublicClient } from "viem";

const client = createPublicClient({
  chain: sepolia,
  transport: alchemyTransport({ apiKey: "YOUR_API_KEY" }),
});

License

MIT

版本与发布记录

@alchemy/common 共发布 71 个版本，首次发布于 2025/11/25；过去 12 个月发布了 71 个版本。

版本发布日期距今
5.3.0latest2026/10/061 个月前
5.2.72026/09/231 个月前
5.2.62026/09/161 个月前
5.2.52026/09/151 个月前
5.2.02026/08/182 个月前
5.1.12026/08/132 个月前

其他发布通道：alpha → 0.0.0-alpha.23。

关于 @alchemy/common 的常见问题

@alchemy/common 是什么？

A collection of interfaces and utilities to be used by other Alchemy packages

如何安装 @alchemy/common？

在项目目录运行 npm install @alchemy/common，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2.45.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@alchemy/common 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@alchemy/common 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@alchemy/common 可以商用吗？

@alchemy/common 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@alchemy/common 的下载量有多少？

根据 npm 官方下载统计，@alchemy/common 在 2026/10/06 – 2026/11/04 这 30 天内被下载 133,083 次，日均约 4,436 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@alchemy/common 还在维护吗？

最新版本 5.3.0 发布于 2026/10/06（1 个月前）；至今共发布 71 个版本，其中过去 12 个月发布了 71 个；首次发布于 2025/11/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。