Ethers.js（JavaScript 库）

什么是 Ethers.js？

Ethers.js 是一个开源 JavaScript 和 TypeScript 库，可用于将应用、钱包、脚本和开发工具连接到 Ethereum 及其他基于 EVM 的区块链网络。

它为开发者提供可重复使用的函数，用于读取区块链数据、发送交易、管理账户、签署消息、与智能合约交互、解码事件日志，以及处理 Ethereum 数据格式。

开发者无需手动创建每个 JSON-RPC 请求，也不必为每次智能合约调用逐一编码，而可以使用 ethers.js 对象和方法处理大部分技术工作。

官方 ethers.js 文档将该库描述为用于与 Ethereum 区块链及其生态系统交互的完整且精简的工具。

Ethers.js 常用于去中心化应用前端、区块链后端服务、加密钱包、自动化监控系统、测试脚本、支付工具和智能合约部署流程。

该库不会运行自己的区块链，也不提供 Ethereum 共识机制。

它是在应用与 Ethereum 节点、钱包或兼容的 RPC 服务之间起作用的软件层。

Ethers.js 使用 TypeScript 编写，并内置类型声明，可帮助开发者在应用运行前发现某些错误。

该项目根据 MIT License 发布，并通过公开的 ethers.js 源代码仓库进行维护。

Ethers.js 当前版本是什么？

截至 2026 年 7 月 16 日，当前文档记录的版本为 ethers v6.17.0。

官方仓库显示，版本 6.17.0 于 2026 年 6 月 18 日发布。

也可以通过官方 ethers 软件包页面查看当前版本。

开发者安装该库前应核实当前版本，因为软件包更新可能包含错误修复、网络更新、安全改进和新协议支持。

项目通常应通过 package lock 文件锁定依赖版本，确保开发、测试和生产环境使用相同的软件包版本。

未经测试就自动安装未知的未来版本，可能引入破坏性行为或意外的依赖变更。

Ethers.js 有什么功能？

Ethers.js 提供了一系列用于与 Ethereum 式区块链系统交互的工具。

它可以通过 JSON-RPC、WebSocket 或浏览器钱包界面将应用连接到 Ethereum 节点。

它可以获取账户余额、区块、交易、费用数据、智能合约代码、事件日志和网络信息。

它可以创建和管理钱包、通过助记词派生账户、加密私钥，以及签署消息或交易。

它可以使用智能合约 ABI 对函数调用进行编码，并解码返回值。

它可以通过签名者提交会改变状态的交易，并等待这些交易获得区块确认。

它还可以估算 Gas、格式化加密货币单位、计算哈希、恢复签名地址，以及验证 Ethereum 地址。

这些功能让开发者能够专注于应用逻辑，无需从头重新构建底层区块链通信功能。

如何安装 Ethers.js？

Ethers.js 通常通过 npm 软件包系统安装，软件包名称为 ethers。

官方安装说明为 Node.js 项目提供了命令 npm install ethers。

安装后，开发者可以导入完整的 ethers 命名空间，也可以导入特定类和函数。

Version 6 支持现代 JavaScript 模块模式，开发者可以直接从主软件包导入许多函数。

选择性导入有助于打包工具仅纳入应用所需的代码。

浏览器应用也可以使用 ECMAScript 模块构建版本，但生产应用应遵循受控的依赖项和构建流程，而不是从未知来源加载未经验证的代码。

切勿仅因软件包名称相似就安装它，因为恶意软件包可能会仿冒热门加密库。

安装前应检查软件包名称、发布者信息、仓库、版本、完整性数据和依赖锁定文件。

Ethers.js 如何连接区块链

Ethers.js 通过 provider 与区块链基础设施通信。

Provider 是一种只读连接，允许应用请求区块链信息并模拟交易。

Provider 会向 Ethereum 节点或其他兼容的 RPC 端点发送请求。

常见请求包括查询 ETH 余额、获取区块、读取合约状态、估算 Gas、获取费用信息和搜索事件日志。

Provider 通常不包含私钥，也不能独立授权从用户账户发起交易。

官方 ethers.js provider 文档介绍了 provider 类及其支持的区块链操作。

可靠的生产应用应使用具备适当容量、可用性、归档访问、安全控制和速率限制的 RPC 连接。

公共或共享端点可用于测试，但在需求高峰期间可能变慢或不可用。

Ethers.js 中的 Provider 是什么？

Provider 是代表与 Ethereum 兼容网络之间连接的抽象。

无论底层节点连接或传输方式如何，它都能为开发者提供一致的 JavaScript 接口。

JSON-RPC provider 通过标准 JSON-RPC 请求与节点通信。

WebSocket provider 可以维持持久连接，适合接收新区块、待处理活动和事件通知。

浏览器 provider 会封装符合常见浏览器 provider 标准的钱包注入接口。

Fallback provider 可以组合多个数据源，并根据配置对响应进行比较或排序。

Provider 可以获取公开数据，但不应与授权账户操作的 signer 混为一谈。

什么是 BrowserProvider？

BrowserProvider 是 ethers.js v6 中常用的类，用于将 Web 应用连接到注入浏览器的 Ethereum provider。

注入的 provider 通常由钱包环境提供，用户可通过该环境批准账户访问和交易。

应用可以根据注入的接口创建 BrowserProvider，然后请求已获批准账户的 signer。

连接钱包并不会自动让应用获得访问钱包私钥的权限。

钱包通常会在自身受保护的环境中保管签名凭据，并要求用户批准每一项签名或交易请求。

应用应清楚说明请求账户访问权限的原因，并避免在用户了解操作内容前请求签名。

Ethers.js 中的 Signer 是什么？

Signer 是代表可授权消息和交易的 Ethereum 账户的抽象。

Signer 可以由私钥、助记词派生的钱包、硬件签名设备、浏览器钱包、智能账户或其他签名系统提供支持。

官方 Signer 接口文档说明，signer 代表一个区块链账户，并可支持私钥无法由应用直接访问的高级签名方案。

Signer 通常可以返回地址、签署消息、估算交易 Gas、填充交易字段，以及发送已授权交易。

可用操作取决于 signer 的实现方式。

连接到 provider 的 signer 可以在准备和提交交易时使用网络数据。

未连接的 signer 可能可以在本地签署数据，但未必能够广播生成的交易。

Ethers.js 中 Provider 与 Signer 的区别

Provider 用于读取区块链数据，而 signer 用于授权与账户相关的操作。

Provider 无需持有私钥，即可查询余额或模拟合约函数。

Signer 可以批准代币转账、部署合约或提交其他会改变状态的交易。

许多 ethers.js 对象连接到 provider 或 signer 后，行为会有所不同。

仅连接 provider 的合约通常只能执行只读操作。

同一合约连接到 signer 后，如果 signer 具备所需权限和资金，就可以准备并发送会改变状态的交易。

将 provider 与 signer 分开，有助于开发者避免把公开数据访问与敏感账户控制混在一起。

Ethers.js 中的钱包是什么？

ethers.js 的 Wallet 类是一种由私钥提供支持的 signer。

它可以派生 Ethereum 地址、签署消息和交易，并在连接到 provider 后发送交易。

钱包可以通过私钥创建、随机生成、从受支持的助记词恢复，或从加密的 JSON keystore 解密。

官方 ethers.js 钱包文档介绍了钱包创建、分层确定性钱包、加密 JSON 文件、助记词和签名函数。

服务端钱包可用于受控自动化，但在应用源代码中存放不受限制的私钥会带来严重安全风险。

私钥不得提交到源代码仓库、嵌入公开的浏览器构建包、打印到日志中，也不得通过普通消息分享。

生产环境的签名系统应根据所管理加密资产的规模，采取访问控制、加密密钥、权限限制、安全备份和交易监控等措施。

Ethers.js 会保管用户资金吗？

Ethers.js 不提供托管服务，也不会替用户持有加密货币。

它是一个软件库，可用于创建或交互签名对象和区块链账户。

资金仍由与相应地址关联的私钥、智能合约或外部钱包系统控制。

如果开发者使用 ethers.js 创建新钱包，开发者或用户就有责任妥善保护恢复数据。

丢失私钥或助记词可能导致相关加密资产永久无法访问。

私钥一旦泄露，他人就可能转走相关资产。

Ethers.js 如何与智能合约交互

Ethers.js 使用 Contract 类表示已部署的智能合约。

创建合约实例时，需要指定目标地址、ABI，以及可选的 provider 或 signer。

ABI 描述合约的外部函数、事件、错误和数据类型。

Ethers.js 会根据这些信息生成可调用的 JavaScript 方法，并解码区块链响应。

官方 Contract API 文档说明，连接的 runner（通常为 provider 或 signer）决定合约可以执行哪些操作。

只读合约调用可以读取代币余额、所有者地址、协议设置或其他公开数据。

会改变状态的调用可以转移代币、批准支出、存入抵押品、投票、领取奖励或执行其他由合约定义的操作。

通过 ethers.js 调用合约方法，并不能证明该合约安全。

开发者仍须核实合约地址、ABI、权限、网络、预期行为和安全假设。

什么是 ABI？

ABI 是 Application Binary Interface（应用程序二进制接口）的缩写。

它定义了外部软件如何与智能合约的可调用接口通信。

ABI 描述函数名称、输入类型、输出类型、事件结构、自定义错误和可变性规则。

Ethers.js 使用 ABI 将易读的 JavaScript 值转换为经过编码的交易数据。

它还会将返回的字节和事件日志解码为应用能够理解的值。

官方 ethers.js ABI 文档介绍了接口、片段、编码、解码、事件、错误和人类可读 ABI 格式。

ABI 不正确可能导致应用对错误的函数调用进行编码，或错误解码返回数据。

开发者应从经过验证的构建产物或可信项目来源获取 ABI。

什么是 Interface 类？

Interface 类以 ethers.js 可用于编码和解码的形式表示 ABI。

它可以对函数数据进行编码、解码函数结果、计算事件主题、解析交易输入，以及解释自定义合约错误。

当开发者需要底层控制，但不需要创建完整 Contract 对象时，这个类很有用。

Interface 还可以帮助监控工具识别交易尝试调用的合约函数。

已知正确事件定义时，它也可以解码日志。

解码信息应始终与正确的合约关联，因为不同合约可能使用相同的函数或事件签名。

读取智能合约数据

只读智能合约调用会使用当前区块链状态，但不会创建交易。

连接的节点会在本地执行该调用。由于调用通常不会写入区块链，因此一般不需要支付 Gas。

开发者可以使用 ethers.js 读取代币余额、授权额度、合约所有者、协议参数和存储记录等数据。

返回结果代表 provider 所使用区块的状态。

如果不同 RPC 端点同步到的区块高度不同，它们可能会在短时间内返回不同结果。

读取历史状态可能需要使用保留了指定旧状态的归档节点。

如果合约回滚、ABI 错误、地址中不存在预期代码，或 provider 缺少所需数据，只读调用也可能失败。

发送智能合约交易

会改变状态的合约方法需要 signer，因为必须由账户授权。

Ethers.js 会将方法及参数编码为交易数据，并要求 signer 授权该交易。

交易还可能包含原生加密货币金额、Gas 上限、费用设置、nonce 和 chain ID。

授权后，交易会通过连接的 provider 广播。

初始返回结果通常是交易响应，其中包含交易哈希和已提交的详细信息。

随后，开发者可以等待交易回执以及指定数量的确认。

交易提交后也不一定能成功，因为执行前区块链状态可能发生变化。

交易响应与回执

交易响应描述通过 provider 提交或发现的交易。

其中可以包含哈希、发送方、接收方、nonce、数据、金额、Gas 信息和网络相关字段。

交易被纳入区块后，即可获得交易回执。

回执会记录执行状态、Gas 用量、区块信息、合约创建结果和触发的事件日志。

应用在将交易视为成功之前，应检查回执状态。

交易哈希只能证明存在一个交易标识符，并不能证明请求的合约操作已成功完成。

Provider 的 waitForTransaction 方法可以等待交易被纳入区块以及指定数量的确认。

Ethers.js 中的 Gas 估算

Ethers.js 可以请求 provider 估算交易预计消耗的 Gas。

节点会根据当前区块链状态模拟拟议交易。

如果模拟交易会回滚，估算可能失败。

官方 provider 文档提醒，Gas 估算只是尽力计算，因为区块链状态会持续变化。

即使交易在估算时能够成功，之后余额、授权额度、价格、合约存储或其他条件发生变化，也可能导致交易失败。

在适当情况下，开发者可以增加合理的缓冲空间，但设置极高的 Gas 上限并不能修复无效的合约逻辑。

用户通常只需为实际消耗的 Gas 付费，而不是支付 Gas 上限中未使用的部分。

处理 ETH 和代币单位

Ethereum 和代币的数值以最小单位的整数形式存储。

ETH 通常以 wei 为内部计量单位，1 ETH 等于 10 的 18 次方 wei。

Ethers.js 提供 parseEther、formatEther、parseUnits 和 formatUnits 等工具函数。

这些函数可将易读的小数数字符串转换为区块链整数值，也可将整数值转换回易读文本。

官方 ethers.js 单位换算文档介绍了如何安全转换小数值。

开发者应避免使用普通 JavaScript 浮点运算处理精确代币余额，因为舍入误差可能导致交易金额错误。

应从正确的合约确认代币实际的 decimals 值，而不要根据代币符号推断。

Ethers.js v6 中的 BigInt

Ethers.js v6 在许多大整数值的处理中使用 JavaScript BigInt。

ETH 数量、Gas 值、nonce 和合约整数可能超出 JavaScript 普通安全数值范围。

官方 v5 到 v6 迁移指南说明，许多操作已从早期的 BigNumber 类改为使用原生 ES2020 BigInt 类型。

BigInt 使用整数运算，不能直接与普通 JavaScript Number 值混合运算。

它也无法表示小数代币金额，除非先将金额转换为代币的最小整数单位。

迁移旧代码时，开发者应检查算术运算、比较、序列化、用户界面格式化和数据库存储。

地址工具

Ethers.js 提供用于验证、规范化、比较和创建 Ethereum 地址的函数。

校验和地址采用大小写混合的字符格式，有助于发现部分输入错误。

getAddress 工具可以规范化有效地址，并拒绝某些校验和格式无效的地址。

地址在技术上有效，并不能证明它属于预期用户或合约。

应用应将地址与可信来源进行比对，并在敏感确认操作中避免只显示缩短后的地址。

攻击者可以创建一个首尾字符相似的不同地址。

名称解析

Ethers.js 可以通过连接的 provider 将受支持的 Ethereum 命名记录解析为地址。

如果某个地址设置了受支持的主名称，Ethers.js 也可以执行反向查询。

易读名称可以提升易用性，但在进行大额转账前，应用仍应显示解析后的地址，或确保用户可以查看该地址。

名称记录可能会随时间变化，同一个名称在其他网络上也可能解析为不同结果。

应用应妥善处理无法解析的名称和无效记录，而不能在未提示用户的情况下将资金发送到意外地址。

使用 Ethers.js 签署消息

Ethers.js 可以签署易读消息，并恢复与有效签名关联的地址。

消息签名可用于账户身份验证、控制权证明、投票、权限管理和链下授权。

官方 ethers.js 签名指南建议在可能的情况下使用易读内容，让用户了解自己批准的内容。

并非所有情况下签名都会直接转移资金，但有些签名可能授权之后的区块链操作。

在相关情况下，应用应包含域名、用途、nonce、有效期和链上下文。

用户不应仅仅因为请求没有显示 Gas 费用，就签署内容不明确的消息。

EIP-712 类型化数据

EIP-712 定义了一种结构化签名格式，可让钱包显示类型化字段，而不是难以阅读的字节序列。

Ethers.js 可以对受支持的类型化数据进行编码、签名、哈希和验证。

类型化数据可用于代币许可、市场订单、治理操作、账户授权和其他链下批准。

域数据可以包含名称、版本、chain ID 和验证合约，以降低重放风险。

开发者必须正确构建域和类型；缺失字段或链上下文错误都可能削弱保护。

签署结构化数据前，用户应检查请求中的 spender、金额、有效期、合约和网络。

事件日志与合约监听器

Ethers.js 可以查询历史智能合约事件日志，也可以监听新事件。

合约事件通过 ABI 定义，并会在成功执行时写入交易回执。

开发者可以针对地址或代币标识符等选定事件参数创建筛选条件。

实时监听器可以在转账、存款、交易、投票或其他合约操作发生时更新界面。

应用不应只依赖实时连接，因为 WebSocket 中断可能导致错过通知。

可靠的索引器应按区块范围核对事件、存储区块哈希、防止重复处理，并处理区块链重组。

事件被触发并不能证明触发事件的合约可信，因为任何合约都可以生成常见的事件签名。

哈希与加密工具

Ethers.js 内含用于数据哈希、计算函数选择器、处理签名、派生地址和处理 Ethereum 编码格式的工具。

常见操作包括 Keccak-256 哈希、消息哈希、打包编码、RLP 编码和签名恢复。

官方 ethers.js 哈希文档介绍了用于消息、类型化数据、名称、标识符和授权数据的辅助函数。

使用加密 API 时，应遵循相关 Ethereum 标准，不要随意组合使用。

签署错误的哈希格式可能导致签名不兼容或产生安全漏洞。

如果相同数据可能在其他上下文中重复使用，开发者应采用域分离。

使用 Ethers.js 部署合约

Ethers.js 提供 ContractFactory，用于部署智能合约。

创建工厂时需要使用合约字节码、ABI 和 signer。

部署交易可以包含构造函数参数和可选的原生加密货币金额。

交易提交后，开发者应等待其被纳入区块，再认定合约已部署到预测地址。

应将已部署地址与 chain ID、编译器设置、源代码版本、构造函数参数和部署交易哈希一并保存。

部署成功并不能证明合约安全、初始化正确，或由预期的管理员控制。

生产环境合约在管理有价值资产前，应经过测试和适当的安全审查。

Ethers.js 在浏览器应用中的使用

浏览器端去中心化应用可以使用 ethers.js 将用户界面连接到钱包和区块链 provider。

应用可以显示余额、请求切换网络、读取合约、估算交易，并请求钱包签署已获批准的操作。

私钥应留在钱包中，不应复制到前端代码。

用户或攻击者通常可以检查所有交付到浏览器的代码。

不得将 API 密钥等秘密信息或高权限签名凭据嵌入公开的应用构建包。

界面应清楚显示交易详情，并妥善处理钱包拒绝、网络不匹配、RPC 故障、待处理交易、回滚和账户变更。

Ethers.js 在服务端应用中的使用

服务端可以使用 ethers.js 监控区块链数据、提交受控交易、生成报告、验证签名，以及运行后端加密货币工作流程。

服务端应用可以直接连接 RPC 节点，也可以使用托管端点。

需要签署交易的后端必须保护签名凭据，防止开发者、日志、备份、构建系统和未经授权的进程访问。

高价值系统应考虑隔离式签名基础设施、交易策略、提现限额、审批流程和紧急控制措施。

当多个进程使用同一账户发送交易时，服务端还应仔细管理交易 nonce。

重复或冲突地使用 nonce，可能导致交易相互替换或一直处于待处理状态。

Ethers.js 与兼容 EVM 的网络

Ethers.js 可以连接许多提供 Ethereum 式 JSON-RPC 接口的 EVM 兼容网络。

应用必须为所选网络提供正确的 RPC 端点、chain ID、原生 Gas 资产信息和合约地址。

同一个钱包地址在不同链上的余额和交易历史可能不同。

部署在某个网络特定地址上的合约，在另一个网络上可能不存在，也可能包含不同代码。

兼容 EVM 并不意味着 Gas 行为、交易类型、最终性、RPC 扩展或智能合约执行细节完全相同。

每种网络集成都应单独测试。

Ethers.js v5 到 v6 的主要变化

与版本 5 相比，Ethers.js v6 在架构和 API 方面进行了重大调整。

迁移指南将更多使用现代 ES6 功能列为核心变化之一。

许多整数操作从早期的 BigNumber 类改为使用原生 BigInt。

合约对象使用 JavaScript Proxy 行为动态解析方法。

许多类和工具现在移至主软件包导出，不再通过旧版嵌套命名空间访问。

此前的 Web3Provider 类被 BrowserProvider 取代，用于封装常见的浏览器注入式 provider。

交易、签名、合约、provider 和工具 API 也进行了命名和结构调整。

升级现有 v5 代码时，不能只更改软件包版本。

应遵循官方 ethers.js v6 迁移指南，并对应用进行全面重新测试。

Ethers.js v5 仍受支持吗？

ethers.js 安全政策指出，大部分维护工作都集中在最新的主版本上。

该政策还说明，版本 5 仍会收到安全更新，而更早的主版本分支已不再受支持。

维护 v5 应用的开发者应安装可用的最新 v5 安全版本，并评估迁移到 v6 的计划。

即使仍有关键安全补丁可用，长期使用旧版本分支也可能带来兼容性和维护风险。

当前支持信息发布于官方 ethers.js 安全政策中。

使用 Ethers.js 时的安全风险

Ethers.js 可以帮助应用与区块链系统交互，但无法让不安全的应用逻辑变得安全。

开发者即使正确使用该库，也可能调用恶意智能合约或签署有害交易。

chain ID、合约地址、ABI、小数位数、Gas 假设或签名域错误，都可能导致资金损失。

受攻击的 RPC 端点可能返回虚假或不完整数据、延迟交易，或隐瞒相关区块链活动。

受攻击的依赖项或构建流程可能在代码交付给用户前改变应用行为。

私钥泄露后，攻击者可能绕过所有用户界面保护措施。

安全保障需要依靠安全的密钥管理、可信依赖项、合约验证、输入检查、交易模拟、监控和独立测试。

私钥安全

切勿将私钥放入浏览器源代码或提交到代码仓库。

不得将私钥直接写入公开配置文件、支持工单、屏幕截图或应用日志。

环境变量有助于降低意外泄露的风险，但并不能构成完整的安全体系。

能够访问进程环境、部署平台、服务器内存或构建配置的人员，仍可能获得访问权限。

生产系统应将签名权限与普通应用访问权限分开。

怀疑密钥遭到泄露时应轮换密钥，但轮换密钥需要将控制权转移到新的区块链地址，或更新已授权的合约角色。

依赖项与供应链安全

开发者应仅从真实的软件包来源安装 ethers.js。

拼写错误的软件包可能包含恶意代码，用于窃取私钥或更改交易目的地。

软件包锁定文件和完整性检查有助于确保自动安装使用经过审查的依赖项版本。

应通过官方仓库和软件包记录关注安全更新通知。

生产应用在部署前应测试依赖项升级。

应移除未使用的软件包和脚本，因为每项依赖都会增加潜在攻击面。

RPC Provider 风险

RPC provider 为 ethers.js 应用提供所需的区块链信息。

如果 provider 不可用，应用可能无法加载余额或提交交易。

如果 provider 延迟，应用显示的信息可能已经过时。

恶意端点可能试图歪曲链上状态、Gas 估算或交易状态。

处理重要财务决策的应用可以比较多个独立节点的响应，或运行自己的节点基础设施。

请求签名前应验证 provider 返回的 chain ID。

在适当情况下，provider 连接应使用加密传输和受控凭据。

交易模拟与错误处理

Ethers.js 可以在发送交易前模拟调用并估算 Gas。

模拟可以发现许多可能导致回滚的问题，但无法保证未来一定成功。

模拟与实际执行之间，区块链状态可能发生变化。

在可能的情况下，应用应解码合约错误，并向用户提供有用说明。

应用应区分钱包拒绝、RPC 故障、资金不足、Gas 估算失败、交易被替换、执行回滚和确认超时。

笼统的错误提示可能导致用户不必要地重复交易，或在不了解原问题的情况下签署其他操作。

Ethers.js 的优势

Ethers.js 提供精简的接口，涵盖许多常见的 Ethereum 开发任务。

将 provider 和 signer 分离，有助于划分清晰的安全边界。

Contract 类减少了智能合约交互中手动进行 ABI 编码的工作量。

内置 TypeScript 声明可改善编辑器支持，并能发现部分参数使用错误。

该库将钱包、签名、地址、单位、哈希、交易和事件工具整合在一个软件包中。

它是开源项目，并有丰富的文档和测试支持。

其面向 EVM 的设计让它适用于许多兼容的区块链环境。

Ethers.js 的局限

Ethers.js 不会运行 Ethereum 节点，因此仍需访问区块链基础设施。

它不会审计智能合约，也无法保证某个地址可信。

它无法自动保护应用不谨慎保管的私钥。

它无法撤销已确认的区块链交易。

它无法保证 Gas 估算、模拟结果或 RPC 响应始终准确。

它不能取代开发者对 Ethereum 账户、交易、Gas、签名、ABI、事件日志和智能合约权限的理解。

开发者还须分别管理用户界面安全、数据库、后端访问、部署、监控和监管要求。

Ethers.js 交易流程示例

假设某去中心化应用允许用户转账一种受支持的代币。

应用首先创建一个连接到所选网络的 provider。

应用确认 chain ID，并通过钱包界面请求访问用户批准的账户。

应用使用经过验证的代币地址和 ABI 创建 signer 与 Contract 实例。

应用读取代币的小数位数和用户余额。

使用 parseUnits 将易读的转账金额转换为代币的最小整数单位。

应用请求合约方法估算 Gas，并准备交易。

钱包向用户显示接收方、合约、网络、金额和费用信息，供其审批。

用户签署后，signer 通过 provider 广播交易。

应用收到交易响应并显示交易哈希。

应用等待交易回执并检查执行是否成功。

随后，应用刷新代币余额并记录已确认的交易。

该流程展示了 provider、signer、合约、ABI、单位转换、Gas 估算和交易回执如何在 ethers.js 中协同工作。

Ethers.js 常见错误

常见错误之一是在前端 JavaScript 中嵌入私钥。

另一个错误是使用未经验证的合约地址或 ABI。

第三个错误是混用普通 Number 值和 BigInt 值。

第四个错误是在收到成功回执前，就把已提交交易当作已确认交易。

第五个错误是认为 Gas 估算成功就能保证交易成功执行。

第六个错误是使用浮点运算处理代币金额。

第七个错误是连接钱包或签署类型化数据时忽略 chain ID。

第八个错误是未处理交易替换、交易被丢弃或区块链重组。

第九个错误是升级 ethers.js v5 到 v6 时没有检查破坏性 API 变更。

第十个错误是仅因为软件包、RPC 端点或智能合约使用熟悉的名称就盲目信任它们。

常见问题

ethers.js 有什么用途？

Ethers.js 用于构建 JavaScript 和 TypeScript 应用，以读取区块链数据、管理钱包、签署消息、发送交易和与 Ethereum 智能合约交互。

ethers.js 是加密货币吗？

不是。Ethers.js 是一个软件库，没有官方加密货币或投资代币。

ethers.js 是钱包吗？

Ethers.js 包含钱包类和签名工具，但该库本身不是托管钱包服务。

ethers.js 的最新版本是什么？

截至 2026 年 7 月 16 日，最新文档记录的版本为 ethers v6.17.0，于 2026 年 6 月 18 日发布。

ethers.js 可以连接到 Ethereum 吗？

可以。Ethers.js 通过 provider 连接到 Ethereum，provider 会与 Ethereum 节点或兼容的 RPC 端点通信。

ethers.js 可以用于其他 EVM 链吗？

可以，它可用于许多提供 Ethereum 式 JSON-RPC 接口的 EVM 兼容网络。

Provider 与 signer 有什么区别？

Provider 读取公开的区块链数据，而 signer 为账户授权消息和会改变状态的交易。

ethers.js 中的 Contract 对象是什么？

Contract 对象将合约地址、ABI 和 provider 或 signer 组合起来，为已部署的智能合约提供可调用的 JavaScript 方法。

ethers.js 需要 ABI 吗？

通常需要 ABI，才能便捷地对命名的智能合约函数、事件和错误进行编码与解码。

ethers.js 会存储私钥吗？

该库可以创建在应用内存中包含签名凭据的钱包对象，但密钥的存储和保护仍由开发者负责。

在浏览器应用中放置私钥安全吗？

不安全。用户、攻击者、扩展程序或受攻击的脚本都可能检查并窃取浏览器代码中的私钥。

只读合约调用需要支付 Gas 吗？

通过 provider 执行的只读调用通常由节点模拟，不会产生链上费用。

为什么 ethers.js 使用 BigInt？

BigInt 支持加密货币余额、Gas 值、nonce 和智能合约数据所需的大整数，避免普通 JavaScript 数字的精度损失。

ethers.js 可以估算 Gas 吗？

可以，它可以向节点请求 Gas 估算，但估算基于当前状态，不能保证未来交易成功。

ethers.js 可以撤销交易吗？

不可以。Ethers.js 可以提交交易，但无法撤销已经确认的区块链状态变更。

ethers.js 可以监听智能合约事件吗？

可以。它可以通过合适的 provider 查询历史日志并订阅新的合约事件。

ethers.js v5 到 v6 有哪些变化？

Version 6 引入了原生 BigInt、现代 JavaScript 功能、调整后的导入方式、更新的 provider 类、基于 Proxy 的合约方法，以及多项 API 变更。

ethers.js 是开源的吗？

是的，ethers.js 根据 MIT License 向公众开放。

ethers.js 有官方代币吗？

没有。官方项目说明 ethers 没有代币。

开发者应在哪里报告 ethers.js 安全问题？

开发者应遵循官方 ethers.js 安全政策中的私下漏洞报告说明，而不是公开披露尚未修复的问题。

结论

Ethers.js 是一个 JavaScript 和 TypeScript 库，为加密货币开发者提供了结构化方式，以便与 Ethereum 和 EVM 兼容区块链网络交互。

它提供用于读取区块链数据的 provider、用于授权账户操作的 signer、用于管理签名凭据的钱包，以及用于与智能合约交互的 Contract 对象。

它还提供 ABI 编码、事件解码、消息签名、类型化数据、地址、哈希、Gas 估算、交易回执和加密货币单位转换等工具。

当前主版本为 ethers.js v6，该版本使用 BigInt 和基于 Proxy 的合约方法等现代 JavaScript 功能。

截至 2026 年 7 月 16 日，最新文档记录的版本为 ethers v6.17.0。

Ethers.js 可以简化区块链开发，但无法消除私钥泄露、恶意合约、地址错误、不可靠 RPC 端点、依赖项遭到入侵或交易不可撤销等风险。

开发者应验证软件包来源、锁定依赖版本、保护签名凭据、确认 chain ID、核实合约地址、使用正确 ABI，并测试每种交易流程。

应用还应妥善处理模拟失败、钱包拒绝、RPC 中断、待处理交易、交易替换、回滚、确认和区块链重组。

在谨慎的安全实践下使用时，ethers.js 能为构建钱包、加密货币支付系统、去中心化应用、分析工具、监控服务和智能合约自动化提供强大基础。

了解 ethers.js 有助于开发者将 JavaScript 应用连接到区块链系统，同时避免将该库误认为钱包服务、区块链网络或加密货币。