安装 fuelsFuel Network TypeScript SDK 的安装、工具链配套与验证指南【免费下载链接】fuels-tsFuel Network Typescript SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-tsfuels是 Fuel Network 官方 TypeScript SDK 的统一发行包当前版本为 0.103.0见 packages/fuels/package.json。本文以官方入门指南中的 installation.md 为骨架结合本仓库的实际源码与配置完整讲解在浏览器、Node.js 项目中通过 bun / pnpm / npm 安装fuels的前置条件、操作命令、安装产物与版本校验方法。读完本文你将能正确选择与工具链配套的 SDK 版本完成安装并顺利进入「连接网络」的下一步开发流程。安装前必须理解的两件事fuels是什么以及它依赖什么在敲下任何安装命令之前先明确两个关键前提它们决定了后续所有操作的成败。fuels是一个聚合了 SDK 与 CLI 的统一依赖与逐个引入fuel-ts/*底层模块不同官方推荐的入口是只安装一个名为fuels的包。查看 packages/fuels/package.json 可以看到它的设计类型与入口同时提供 CJSdist/index.js、ESMdist/index.mjs与类型声明dist/index.d.ts并声明了./cli、./test-utils、./cli-utils等子路径导出命令行工具bin字段将fuels命令映射到fuels.js安装后即可在项目中直接运行 fuels CLI用于类型生成、本地节点等任务运行时要求engines字段明确要求 Node.js 版本为^20.0.0 || ^22.0.0 || ^24.0.0packages/fuels/package.json低于 Node 20 的环境将无法满足其运行约束依赖聚合内部聚合了fuel-ts/account、fuel-ts/abi-coder、fuel-ts/contract、fuel-ts/program、fuel-ts/script等全套fuel-ts/*工作区包见其dependencies字段对使用者屏蔽了包间版本编排细节。也就是说一次fuels安装即可获得合约交互、钱包账户、类型生成typegen与测试工具等完整能力。SDK 与 Fuel Toolchain 必须配套使用官方安装文档的开篇要求是在使用本库之前必须先安装 Fuel Toolchain。本仓库自身即是这一配套关系的具体体现仓库通过 packages/versions/src/index.ts 统一维护三者的版本来源并明确注释FUELS来自packages/fuels/package.jsonFUEL_CORE来自internal/fuel-core/VERSIONFORC来自internal/forc/VERSION。从当前仓库看fuels 0.103.0所配套的工具链版本为ForcSway 编译器与工具链0.68.7见 internal/forc/VERSION与fuel-coreFuel 节点0.47.1见 internal/fuel-core/VERSION。仓库还内置了 internal/forc 与 internal/fuel-core 两个工具包含lib/install.js等安装脚本用于在 CI 与开发环境中拉取与 SDK 配套的二进制。packages/versions/src/lib/checkFuelCoreVersionCompatibility.ts 中实现了对系统内 fuel-core 版本与 SDK 内置支持版本的兼容性比对逻辑说明「版本必须匹配」不是口头约定而是 SDK 运行时会主动校验的约束。因此安装fuels前请先在本机准备好与目标 SDK 版本配套的 Forc 与 fuel-core版本不一致时后续的类型生成、合约部署与链交互都可能出现预期外的失败。前置检查Node 版本与工具链就绪确认在执行安装命令前建议先完成两项检查它们都能在当前仓库中找到对应的事实依据# 1. 检查 Node.js 版本是否满足 fuels 的 engines 约束^20 || ^22 || ^24 node -v # 2. 确认工具链二进制可用 forc --version fuel-core --version关于第 2 步补充说明仓库的版本对比与校验逻辑分布在 packages/versions/src/cli.ts将系统内的 forc/fuel-core 版本与 SDK 支持版本进行对比展示以及 packages/versions/src/lib/compareSystemVersions.ts比较系统版本与内置版本的大小/相等关系中。这从源码层面印证了安装成功不等于环境可用工具链版本与fuels版本是否匹配是决定后续开发能否顺利的关键因素。在项目中安装fuels确认前置条件无误后进入项目目录并执行安装。官方文档针对三种主流包管理器分别给出了命令。考虑到 SDK 需要与工具链强配套文档中的版本号都是精确固定的示例中的{{fuels}}占位符会被渲染为当前发布版本即仓库中fuels包的版本0.103.0使用 bunbun add fuels0.103.0使用 pnpmpnpm add fuels0.103.0使用 npmnpm install fuels0.103.0 --save说明{{fuels}}这个动态占位符的取值逻辑可以在文档基础设施中找到证据——apps/docs/src/versions.data.ts 从fuel-ts/versions读取versions并导出forc、fuels、fuelCore三个字段安装页正是用其中的fuels字段动态填充版本号。因此你在阅读本仓库 docs 时看到的fuelsx.y.z与 packages/fuels/package.json 中version字段保持同步。三个命令的差异仅在于包管理器本身--save对 npm 而言是默认行为写出来用于显式声明依赖会写入package.json的dependenciesbun 与 pnpm 默认即写入依赖清单。按精确版本安装的原因在于fuels SDK 的 ABI 编码、类型生成与脚本执行逻辑都受 Forc/fuel-core 版本影响精确锁定版本有助于复现同一套开发环境。安装后你得到了什么SDK、CLI 与子路径导出安装完成后fuels会为你提供三类可直接使用的能力这些都可以从 packages/fuels/package.json 的exports字段得到印证使用方式导出/入口典型用途主入口fuelsimport { Provider } from fuelsProvider、Wallet、合约工厂、脚本与断言等 SDK 核心 APICLIfuelsbin映射到fuels.js生成类型typegen、启动本地节点、执行测试等命令行任务测试工具fuels/test-utils测试辅助launchNode 等对应 packages/fuels/src/test-utils.ts 的实现CLI 工具fuels/cli-utils、fuels/cli供工具链复用或深度定制 CLI 行为主入口默认导出的核心 API 包括Provider、Wallet、ContractFactory、Script、Predicate等。SDK 源码位于 packages/fuels/src/index.ts它负责把上述各能力统一对外暴露CLI 相关命令分布在 packages/fuels/src/cli 目录下。需要按需精简打包时也可直接依赖底层fuel-ts/*各包但日常开发推荐始终以fuels单一依赖为主避免自行维护版本矩阵。验证安装用一段最小代码确认环境可用安装完成后可以运行一个最小冒烟测试确认 SDK 可被正确加载。官方入门文档在安装步骤之后紧接着的「连接网络」示例connecting-to-the-network.md给出了可直接复制的验证代码其完整片段见 snippets/connecting-to-the-network.tsimport { Provider } from fuels; const NETWORK_URL https://mainnet.fuel.network/v1/graphql; const provider new Provider(NETWORK_URL); const baseAssetId await provider.getBaseAssetId(); const chainId await provider.getChainId(); const gasConfig await provider.getGasConfig(); console.log(chainId, chainId); console.log(baseAssetId, baseAssetId); console.log(gasConfig, gasConfig);如果这段代码能成功打印出链 ID、基础资产 ID 与 gas 配置说明fuels安装正确、网络可达且运行时与远端节点版本协商正常若在早期即报出版本兼容性错误请回到上文的工具链版本配套检查逐一核对 forc 与 fuel-core 版本。安装之后的官方推荐路线fuels的安装只是起点。官方「快速开始」系列见 getting-started 索引为初次使用者规划了一条循序渐进的学习路径安装完成后建议按顺序继续连接网络使用Provider连接主网/测试网掌握官方 RPC 地址与如何运行本地节点运行本地 Fuel 节点在开发与测试阶段通过本地节点获得即时反馈无需依赖公共网络React 示例在 React 应用中接入 SDK 的完整前端示例CDN 用法不需要打包器的场景下如何通过 CDN 直接引入后续步骤类型生成、合约部署、钱包等进阶主题的入口。在仓库中每个 demo 应用如 apps/demo-fuels、apps/demo-react-vite、apps/demo-bun-fuels都提供了可直接运行的完整工程其package.json与fuels.config.ts是理解「安装 配置 运行」三者如何衔接的真实范本templates 目录下还有官方脚手架模板供新项目起步参考。小结安装fuels的本质是一次「环境对齐」而非简单的依赖下载先确保 Node.js 满足^20 || ^22 || ^24的 engines 约束再安装与目标 SDK 版本配套的 Fuel ToolchainForc 0.68.7 / fuel-core 0.47.1 为当前fuels0.103.0仓库内配套版本最后通过 bun/pnpm/npm 精确安装fuels包。完成这三个步骤并跑通上述最小连接示例后你就可以放心地进入合约类型生成、链交互与 DApp 开发阶段了。【免费下载链接】fuels-tsFuel Network Typescript SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-ts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考