ethers-rs
id:gakonst/ethers-rs ·
· 目录记录
项目概述
ethers-rs是一套用Rust访问以太坊及兼容链的库,可用于JSON-RPC客户端、合约部署与交互、类型安全绑定生成、事件查询/订阅,以及Polygon、Avalanche、Optimism、Celo等扩展。作者已声明该库弃用并指向Alloy;本说明只整理文档中的历史能力,不把它当作仍在主推的新项目选择。
原项目介绍
忠实中文 / 作者自述整理
作者自称完整的Ethereum与Celo Rust库,但在显著位置通知已弃用,请改用alloy并阅读其文档。快速开始是在Cargo.toml加入ethers = "2.0"并use ethers::prelude::*。文档指向docs.rs与在线book,示例在/examples下用cargo run运行。对尚不支持EIP-2718类型交易的链需开启legacy特征;Optimism与Celo特征互斥。功能清单勾选了RPC客户端、合约交互与部署、abigen、事件流、ENS、多链、WebSocket/eth_subscribe、硬件钱包、Parity与Geth TxPool API;WASM/FFI与CLI未勾选,且无官方JS或FFI绑定计划。
短摘 / 原文
A complete Ethereum and Celo Rust library
出处:https://github.com/gakonst/ethers-rs/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
ethers-rs是一套用Rust访问以太坊及兼容链的库,可用于JSON-RPC客户端、合约部署与交互、类型安全绑定生成、事件查询/订阅,以及Polygon、Avalanche、Optimism、Celo等扩展。作者已声明该库弃用并指向Alloy;本说明只整理文档中的历史能力,不把它当作仍在主推的新项目选择。
谁会用
使用Rust编写EVM应用或工具的开发者;新项目应按作者指引评估Alloy,维护旧代码时才继续对照本库文档。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
Rust应用需要访问以太坊JSON-RPC、生成合约绑定或订阅事件,而不手写协议编解码。
文档化使用场景(编辑归纳)
在Cargo.toml加入ethers 2.0并按链启用特征后查阅API或示例。作者已弃用本库并指向Alloy,新项目应先评估替代。
主要能力与用途
作为Rust库提供以太坊JSON-RPC客户端,并可部署/交互合约、用abigen生成类型安全绑定、查询历史事件或把事件监控为Stream,同时把ENS当作一等能力。
通过特征开关支持WebSocket、IPC,以及用rustls或openssl连接HTTPS;对未支持EIP-2718类型交易的链需启用legacy。
文档说明Polygon/Mumbai与Avalanche/Fuji的abigen支持(建议配置相应浏览器API密钥),Optimism需optimism特征并处理Deposited交易的额外字段,Celo需celo特征以支持手续费币种等字段;optimism与celo互斥。
硬件钱包、Parity tracing等API、Geth TxPool已在清单中勾选;WASM应用可尝试编译,但没有官方JS/TS或FFI绑定计划,CLI也未完成。
如何使用 / 既有稿流程
历史文档场景:在Cargo.toml加入ethers 2.0(按需开启legacy/ws/ipc/optimism等特征)→在代码中prelude引入→查阅docs.rs或示例crate。新开发应先看Alloy。本研究不编译、不请求任何RPC或浏览器API密钥。
用法证据状态
documented_workflow_only_not_executed
公开限制
作者已弃用本库并推荐Alloy;不能把本README当作长期维护承诺。
在线book与各示例未逐个运行,具体API行为以原文和替代库为准。
硬件钱包与多链支持是清单勾选,本研究未验证。
许可快照为Apache-2.0,全文未读。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
Apache-2.0
discussion_zh
快照为Apache-2.0。全文未读。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
Rust应用需要访问以太坊JSON-RPC、生成合约绑定或订阅事件,而不手写协议编解码。
documented_use_case_zh
在Cargo.toml加入ethers 2.0并按链启用特征后查阅API或示例。作者已弃用本库并指向Alloy,新项目应先评估替代。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:58:55.917811+08:00
来源
https://github.com/gakonst/ethers-rs/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/gakonst/ethers-rs/README.md.phase037-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:58:39.554624+08:00", "sha256": "7ac6659d37d09cbbefb99f6f0744dd0a39a95865a99c6b999a4efbbf4f73fd20", "read_scope": "选读README的停更声明、快速开始、链支持、功能清单与WASM/FFI说明;不运行示例,不把已弃用库当现行首选", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/gakonst/ethers-rs
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": "Complete Ethereum & Celo library and wallet implementation in Rust. https://docs.rs/ethers", "topics": [ "celo", "ethereum", "rust", "web3" ], "record_sha256": "3c51b299594bad23e99bab7e798d0529b934cdf3c4ec559d4a66898af595f161", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读README的停更声明、快速开始、链支持、功能清单与WASM/FFI说明;不运行示例,不把已弃用库当现行首选",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "845bafa2a31a6d8137f4b3f1e4abbccb3ddec9044ced8cbe62521893beb4e6ef"
}