区块链Web3【免费下载链接】web3.jsCollection of comprehensive TypeScript libraries for Interaction with the Ethereum JSON RPC API and utility functions.项目地址https://gitcode.com/gh_mirrors/we/web3.js点击查看免费下载导读web3-core是 web3.js 4.x 的核心基础包它不直接面向最终用户却为上层所有子包web3-eth、web3-eth-contract、web3-eth-accounts等提供了配置管理、请求管理、订阅管理、批处理请求与事件模型等基础设施。本文以 web3-core CHANGELOG 的演进脉络为主线结合 web3-core 源码系统梳理该包从 4.0.1-alpha 到 4.7.1 的关键变更你将掌握Web3Config全部配置项的默认值与语义、插件注册机制registerPlugin/Web3PluginBase、Web3Subscription订阅生命周期的最佳实践、EIP-1193/EIP-1474 兼容策略以及升级时需要注意的破坏性变更从而在升级 web3.js 或为上层封装库适配web3-core时少走弯路。一、web3-core 在 web3.js 4.x 中的定位从 package.json 可以看到web3-core的自我定位是 Web3 core tools for sub-packages. This is an internal package.其入口 src/index.ts 集中导出了以下核心模块web3_config.ts—— 全局配置类Web3Configweb3_context.ts—— 上下文类Web3ContextWeb3 各包共享的环境web3_request_manager.ts—— 请求管理器Web3RequestManagerweb3_subscription_manager.ts—— 订阅管理器Web3SubscriptionManagerweb3_subscriptions.ts—— 订阅基类Web3Subscriptionweb3_batch_request.ts—— 批量请求Web3BatchRequestweb3_promi_event.ts/web3_event_emitter.ts—— 事件与 PromiEvent 基础设施formatters.ts/utils.ts/types.ts—— 格式化与工具函数CHANGELOG 中每一阶段的变更几乎都可以在上述模块中找到对应的实现落点。下文按版本演进顺序将 changelog 中的每一条关键变更与源码一一对照展开。二、4.0.1-alpha → 4.0.1从插件基类到错误内联的奠基阶段2.1 插件系统雏形registerPlugin与两个插件基类在 4.0.1-alpha.1 中web3-core首次引入了插件化能力registerPlugin方法加入Web3Context导出抽象类Web3PluginBase与Web3EthPluginBase其底层实现在 web3_context.tsregisterPlugin会检查插件命名空间是否已被占用冲突时抛出ExistingPluginNamespaceError随后将插件通过link(this)与当前上下文绑定再挂载到上下文字段上。这一设计让插件能共享宿主上下文中的requestManager、config等能力是后续 4.5.0 已有包可通过 context 暴露给插件#7088功能的基础。2.2 类型收紧API泛型默认值从any变为unknown同版本中Web3ContextObject与Web3ContextInitOptions的API泛型默认值由any收紧为unknown。从 web3_context.ts 可以看到这两个类型如今都以API extends Web3APISpec unknown声明。这意味着未显式指定 API 类型时TypeScript 会强制要求更严格的使用方式是类型安全提升的第一步。2.3 配置一致性校验defaultHardfork/defaultChain与defaultCommon联动CHANGELOG 提到新增了当defaultHardfork与defaultCommon.hardfork不一致时以及当defaultChain与defaultCommon.basechain不一致时的校验。对应实现位于 web3_config.ts 的defaultChain/defaultHardforksetter以及 defaultCommon setter一旦配置冲突会抛出ConfigChainMismatchError或ConfigHardforkMismatchError定义于web3-errors包避免生成自相矛盾的交易上下文。2.4 实验性功能开关enableExperimentalFeaturesenableExperimentalFeatures是 4.0.1-alpha.1 新增的配置变量。查看 Web3ConfigOptions 定义它目前包含两个开关useSubscriptionWhenCheckingBlockTimeout检查区块超时时使用订阅而非轮询默认falseuseRpcCallSpecification启用 EIP-1474 定义的 RPC 异常码默认false该配置随后在 4.0.1-rc.0 中与useRpcCallSpecification结合使用并在 4.0.1-rc.1 中被Web3RequestManager的构造参数消费见 web3_request_manager.ts。2.5 EIP-838execution reverted与ContractExecutionError4.0.1-alpha.1 的另一项重要错误处理变更当响应错误为execution reverted时Web3RequestManager会抛出ContractExecutionError并把响应错误作为innerError传入该innerError会在web3-eth-contract中按 EIP-838 通过 ABI 解码 revert 原因。从 web3_request_manager.ts 的导入列表可以看到ContractExecutionError已从web3-errors引入属于请求层统一错误归一化的一部分。2.6 EIP-1193 与 block tag 扩展4.0.1-alpha.2 修复了EIP1193Provider类request方法与 EIP-1193 规范的兼容性#5591。4.0.1-rc.0 为 PoS 网络新增了safe与finalized两种 block tag#5823。Web3Config.defaultBlock的文档注释web3_config.ts已明确列出earliest、latest、pending、finalized、safe五种取值及其语义其中safe与finalized专门服务于 PoS 网络的最终性语义。三、4.0.1-rc.1 → 4.0.1构建体系与破坏性变更集中爆发3.1 混合构建ESM CJS4.0.1-rc.1 引入 ESM 与 CJS 混合构建#5904并发布源码#5956。从 package.json 的exports字段可见当前产物布局require指向./lib/commonjs/index.jsimport指向./lib/esm/index.js类型声明位于./lib/types/index.d.ts构建脚本build:cjs/build:esm会分别在产物目录写入{type: commonjs}/{type: module}标记保证双模块体系能正确解析。3.2 交易对象格式化data替换为input同版本中若交易对象带有data属性txInputOptionsFormatter会将其替换为input#5915。这一变更统一了交易对象的字段语义配合后续 4.2.0 的contractDataInputFill一起构成了data/input 字段如何填充的完整策略。3.3 移除 IPC 内置依赖与 Node polyfill4.0.1-rc.1 移除了对 Nodenet、fs模块的 polyfill 需求#5978并声明 IPC 路径不再作为内置 provider —— 如需 IPC 需自行安装web3-providers-ipc并手动实例化 provider。这一点在 web3_request_manager.ts 中得到印证availableProviders仅内置HttpProvider与WebsocketProvider两个构造器IPC 仅保留为 package.json 中的optionalDependencies。浏览器端友好的同时也让依赖面更可控。3.4 配置访问方式config公开化4.0.1-rc.1 移除了Web3Config的getConfig方法改为直接访问公开字段config#5950。在 web3_config.ts 中可以看到config是public属性其中集中列出了所有配置项的默认值这是理解全包默认行为的第一手资料详见本文第四节。3.5 订阅 messageListener 错误参数移除订阅的messageListener由.on(data)或.on(message)触发中不再携带 error 参数#6082以正确支持所有 provider。这暗示 4.x 的订阅错误应通过独立的error事件通道处理详见第五节CommonSubscriptionEvents的error事件。3.6 Uint8Array 取代 Buffer4.0.1-rc.2 用Uint8Array全面替换Buffer#6004这是 4.x 为浏览器与多运行环境Node/Deno/浏览器统一二进制类型表示的关键决策。上层包与用户代码中直接依赖 Buffer API 的部分如.toString(hex)需要相应调整。四、Web3Config 配置体系全景4.0.1 → 4.7.1Web3Config是web3-core中最常被引用的类其默认值全部集中在 web3_config.ts 的config属性中。下表汇总了 CHANGELOG 各版本引入或变更的配置项并结合源码给出默认值与语义配置项默认值引入/变更版本语义handleRevertfalse4.0.1-alpha.1 起为sendTransaction/call/合约方法调用返回 revert 原因字符串注意目前仅sendTransaction支持sendSignedTransaction不支持defaultAccountundefined内置作为默认from属性defaultBlocklatest4.0.1-rc.0 扩展支持earliest/latest/pending/finalized/safetransactionSendTimeout750 * 1000ms内置等待节点返回交易结果超时后交易可能仍在 pending建议主动核查transactionBlockTimeout50块内置基于 socket 连接等待首个确认的区块数上限transactionConfirmationBlocks24内置交易被认定已确认所需的区块数transactionPollingInterval1000ms内置HTTP 连接下轮询交易回执的间隔setter 会同步联动transactionReceiptPollingInterval与transactionConfirmationPollingIntervaltransactionPollingTimeout750 * 1000ms内置HTTP 连接下等待回执的超时blockHeaderTimeout10s内置socket 连接下等待newBlockHeaders事件后再回退到轮询的时限maxListenersWarningThreshold1004.5.1 修复事件监听器数量警告阈值setConfig时若传入数值会同步调用setMaxListenerWarningThresholdcontractDataInputFilldata4.3.2 前为input4.2.0 引入4.3.2 改默认合约方法编码后填充data/input/both影响合约的send/call/estimateGasdefaultChainmainnet4.0.1-alpha.1 校验默认链与defaultCommon.baseChain冲突时报ConfigChainMismatchErrordefaultHardforklondon4.0.1-alpha.1 校验默认硬分叉chainstart→london等与defaultCommon.hardfork冲突时报ConfigHardforkMismatchErrordefaultTransactionType0x24.3.0 前为0x04.3.0 变更默认交易类型改为 EIP-1559 类型 2defaultMaxPriorityFeePerGastoHex(2500000000)内置EIP-1559 默认矿工小费enableExperimentalFeatures两个开关均为false4.0.1-alpha.1 引入useSubscriptionWhenCheckingBlockTimeout/useRpcCallSpecificationEIP-1474defaultReturnFormatDEFAULT_RETURN_FORMAT4.4.0 引入配置默认返回格式如{ number: bigint }等DataFormatignoreGasPricingfalse4.7.0 引入为true时不自动填充gasPrice/maxPriorityFeePerGas/maxFeePerGas交由钱包处理customTransactionSchemaundefined4.6.0 引入自定义交易 JSON Schema用于扩展交易校验transactionBuilder/transactionTypeParserundefined4.0.1-rc.1 类型收紧自定义交易构建器与类型解析器4.0.1-rc.1 起两者统一使用Transaction类型作为交易对象类型4.1 配置变更的事件机制所有配置项的 setter 都会调用私有方法_triggerConfigChangeweb3_config.ts向外发出Web3ConfigEvent.CONFIG_CHANGE事件载荷为{ name, oldValue, newValue }。这一机制是Web3Context.use()与Web3Context.link()同步子上下文配置的关键见 web3_context.ts也让 4.3.1 修复的setConfig未同步到其他 web3 包#6555问题有了明确的实现支撑。4.2 4.3.0 的默认交易类型迁移注意4.3.0 将defaultTransactionType从0x0改为0x2#6282。这意味着 4.3.0 起未显式指定交易类型的调用默认走 EIP-1559type 2路径依赖 type 0 旧行为的代码需要显式设置defaultTransactionType: 0x0。同版本还允许 formatter 解析较大的 base fee#6456并将事件发射器统一为web3-utils导出的、兼容 Node 与浏览器的EventEmitter#6398同时修复了 Class extends value undefined is not a constructor#6371这一跨环境类继承问题。五、订阅系统演进从构造方式到生命周期修复4.0.2 → 4.1.0订阅是web3-core中最活跃的演进领域CHANGELOG 在 4.0.2、4.0.3、4.1.0 三个版本中密集修复了多个关键问题5.1 4.0.2Web3Subscription构造函数支持 SubscriptionManager4.0.2 起Web3Subscription构造函数接受SubscriptionManager作为替代方案原先接受RequestManager的方式被标记为 deprecated#6210。源码中保留了两种重载见 web3_subscriptions.ts传入requestManager时会内部构造一个Web3SubscriptionManager(requestManager, {}, true)以兼容旧用法。同版本还修复了批量请求中单个请求报错导致整体失败的问题#6164订阅多个链上事件时每个已注册事件的监听器都被重复触发的问题#6210取消订阅后Web3SubscriptionManager中仍残留订阅 id 的问题#6210每创建一个订阅对象都会额外触发一次 provider 调用的问题#62105.2 4.0.3暴露subscriptionManagerprotected getterWeb3Subscription新增protected get subscriptionManagerweb3_subscriptions.ts允许自定义订阅类内部直接访问订阅管理器#6285为编写复杂自定义订阅提供了通道。5.3 4.1.0订阅结果处理重构4.1.0 对订阅基类做了结构性优化#6262_processSubscriptionResult与_processSubscriptionError的实现下沉到基类并改为public新增可选 protected 方法formatSubscriptionResult自定义格式化只需覆写该方法无需再重写_processSubscriptionResultWeb3Subscription的泛型参数不再需要显式传入CommonSubscriptionEvents 前缀修复了 4.x 订阅不触发connected事件的问题#6252从 web3_subscriptions.ts 可见CommonSubscriptionEvents包含三个标准事件data每次数据到达、error订阅错误、connected成功连接后返回订阅 id。订阅流程的底层实现为sendSubscriptionRequest()eth_subscribe调用后 emitconnected与subscribe()委托给subscriptionManager.addSubscription取消与重订阅则对应unsubscribe()/resubscribe()。六、请求管理器与批量请求的稳定性修复6.1 4.1.1send方法错误内联4.1.1 修复了使用 request manager 的send方法时 RPC 错误未作为 inner error 传递的问题#6300。这与 4.0.1-alpha.1 的ContractExecutionError.innerError机制一脉相承错误链中的innerError是上层如web3-eth-contract解码 revert 原因的基础。6.2 4.4.0RequestManagerMiddleware接口变更4.4.0 调整了RequestManagerMiddleware接口#7003该接口允许在请求发出前/响应返回后插入自定义逻辑。若你基于该接口实现了自定义中间件例如在 web3-plugin-example 中可见的示例升级到 4.4.0 时需要同步适配新签名。6.3 批量请求的内部实现Web3BatchRequestweb3_batch_request.ts在内部用Map维护请求 id 到Web3DeferredPromise的映射add()为每个请求创建独立 promiseexecute()通过requestManager.sendBatch一次性发送默认超时DEFAULT_BATCH_REQUEST_TIMEOUT 1000ms超时或失败时会统一中止全部请求OperationTimeoutError→_abortAllRequests。4.0.2 修复的单个请求报错不应拖垮整个批次正是围绕_processBatchRequest的异常隔离逻辑展开。七、插件体系与上下文共享的后续完善4.5.0 → 4.7.14.5.0当已有包被加入 web3 时可通过 context 暴露给插件#7088进一步打通Web3Context的共享能力。4.5.1修复setConfig()对setMaxListenerWarningThreshold的处理#5079。4.6.0新增customTransactionSchema配置#7227支持通过自定义 JSON Schema 扩展交易对象的校验规则。4.7.0新增ignoreGasPricing配置#7320当为true时跳过gasPrice估算交易对象中的gasPrice/maxPriorityFeePerGas/maxFeePerGas不会被自动填充 —— 适合由外部钱包统一管理 gas 定价的场景。4.7.1TypeScript 从 4 升级到 5#7272构建产物与类型声明随之更新开发与编译侧均需升级到 TypeScript 5.x。此外web3-core在 4.1.0 还加入了web3.extend函数的最小支持允许以官方扩展机制为 Web3 实例增加自定义能力配合 web3-plugin-example 中的custom_rpc_methods.ts、transaction_middleware.ts等示例可以快速上手扩展开发。八、升级与适配检查清单综合 CHANGELOG 全量变更从 4.0.x 升级到 4.7.x 时建议逐项核对二进制类型将代码中依赖 NodeBuffer的路径替换为Uint8Array4.0.1-rc.2 起。默认交易类型确认业务是否依赖 type 0 交易若是需显式设置defaultTransactionType: 0x04.3.0 起默认0x2。合约字段填充contractDataInputFill默认值已从input变为data4.3.2涉及合约方法编码字段data/input的取用逻辑需核对。配置读取使用config公开属性取代已移除的getConfig()4.0.1-rc.1 起。IPC provider如需 IPC请安装web3-providers-ipc并自行实例化4.0.1-rc.1 起不再内置。订阅构造优先传入SubscriptionManagerRequestManager构造方式已废弃4.0.2 起自定义订阅格式化请覆写formatSubscriptionResult4.1.0 起。订阅错误监听messageListener不再携带 error 参数统一通过.on(error)处理4.0.1-rc.1 起。中间件接口核对自定义RequestManagerMiddleware是否适配 4.4.0 的接口变更。RPC 异常码如需 EIP-1474 异常码开启enableExperimentalFeatures.useRpcCallSpecification。构建工具链升级到 TypeScript 54.7.1 起并确认 ESM/CJS 双产物lib/esm、lib/commonjs与exports映射满足你的打包器要求。结语从 web3-core CHANGELOG 的版本轨迹可以看出web3-core的演进始终围绕三条主线展开配置体系的标准化与校验完备化Web3Config从基础项到contractDataInputFill、defaultReturnFormat、ignoreGasPricing的持续扩展、订阅与请求基础设施的健壮性修复批量请求隔离、订阅去重、生命周期事件修复、以及跨环境兼容性的统一Uint8Array、混合构建、浏览器友好 EventEmitter。对于上层使用者而言web3_config.ts 的默认值表是排查交易与配置问题的最佳起点对于扩展开发者而言web3_context.ts 的registerPlugin/use/link三者构成了上下文共享的完整闭环。理解这些底层契约才能在升级 web3.js 或构建自己的封装库时做到心中有数。赞分享区块链Web3【免费下载链接】web3.jsCollection of comprehensive TypeScript libraries for Interaction with the Ethereum JSON RPC API and utility functions.项目地址https://gitcode.com/gh_mirrors/we/web3.js点击查看免费下载相关推荐web3.js 4.x 订阅 API 迁移指南从 web3.eth.subscribe 到基于事件的订阅模型web3.js 4.x 订阅 API 迁移指南从 web3.eth.subscribe 到基于事件的订阅模型 本篇指南聚焦 web3.js 从 1.x 升级到区块链Web3web3.js 错误体系演进全解析从 web3-errors 包 CHANGELOG 看以太坊错误处理的架构设计web3.js 错误体系演进全解析从 web3 errors 包 CHANGELOG 看以太坊错误处理的架构设计 web3 errors 是 web3.js区块链Web3Web3.js核心模块深度解析从Web3-Core到Web3-EthWeb3.js核心模块深度解析从Web3 Core到Web3 Eth 本文深度解析了Web3.js的四个核心模块Web3 Core作为基础架构提供请求管理和区块链Web3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考