# @fluent\.xyz/connect 中文文档 规范地址：https://npmcn.com/package/%40fluent.xyz/connect/ 版本：0\.8\.0 npm 元数据更新时间：2026-11-12T06:02:34.346Z 中文译文更新时间：2026-11-15T01:09:30.216Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40fluent.xyz/connect 原文对照：https://npmcn.com/package/%40fluent.xyz/connect/?lang=original 项目主页：https://github.com/fluentlabs-xyz/fluent-connect-sdk/tree/main/packages/connect 源码仓库：https://github.com/fluentlabs-xyz/fluent-connect-sdk ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.3 MB，32 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20 - 运行依赖：18 个 - peer 依赖：viem ^2\.0\.0，react \>=18\.0\.0，wagmi ^2\.0\.0，react-dom \>=18\.0\.0，@tanstack/react-query ^5\.0\.0 - 首次发布：2026-07-29T22:17:39.850Z - 最新版本发布：2026-11-12T06:02:33.990Z - 近 30 天下载量：5138（2026-10-15 至 2026-11-13，npm 官方下载统计） - 已发布版本数：32（近 12 个月 32 个） ## 中文简介 流畅的连接反应部件 — Privy 登录、 ZeroDev 智能账户、 批量操作和钱包 UI ## 安装 ```sh npm install @fluent.xyz/connect ``` 也可以使用：`pnpm add @fluent.xyz/connect`、`yarn add @fluent.xyz/connect`、`bun add @fluent.xyz/connect` ## README # `@fluent.xyz/connect` 一个反应部件和钩子,在流利上给出一个流利的ID智能账户:直接登录到一个 流利的ID或连接的外部钱包、账户余额和批量操作 毒气赞助处决。 仅用于React Apps(反应18或后期). ## 安装 ```bash pnpm add @fluent.xyz/connect @tanstack/react-query react react-dom viem wagmi ``` 五个对等者是同等者, 这样您的 App 和部件可以共享每个副本 。 你还需要 a 一个 `appId` (单位:千美元) `privyClientId` 从流利,您的页面来源允许直接登录, 并且,对于赞助的操作,App启用了赞助和认证符号: [文档/开始](https://npmcn.com/package/%40fluent.xyz/connect/docs/getting-started.md)。 。 。 . ## 快速启动 ```tsx import "@fluent.xyz/connect/styles.css"; import { FluentReviewRejectedError, FluentWidget, useFluentWidget, type FluentWidgetConfig, } from "@fluent.xyz/connect"; import { useState } from "react"; import { erc20Abi, parseUnits } from "viem"; const config: FluentWidgetConfig = { appId: "app_0123456789abcdef0123456789abcdef", privyClientId: "client-0123456789abcdef", network: "testnet", }; // Placeholders: your token's address and the recipient's. const TOKEN = "0x1111111111111111111111111111111111111111"; const RECIPIENT = "0x2222222222222222222222222222222222222222"; function App() { const { status, widget } = useFluentWidget(); const [message, setMessage] = useState(""); if (status !== "connected") return

Connect to continue.

; async function send() { const amount = parseUnits("1", 18); try { const result = await widget .createBatchOp({ calls: [{ to: TOKEN, abi: erc20Abi, method: "transfer", args: [RECIPIENT, amount] }], }) .execute(); setMessage("Sent: " + result.hash); } catch (error) { const dismissed = error instanceof FluentReviewRejectedError && error.code === "transaction_review_rejected"; setMessage(dismissed ? "You dismissed the Review." : "The operation failed."); } } return (

Your account: {widget.account.address}

{message}

); } export function Root() { return } />; } ``` `network` 需要且没有默认值:通过 `"testnet"` 或者说 `"mainnet"` 作为每个字节 部署. `execute()` 一旦包含批量操作,即可解决。 是否流利的身份证 操作显示部件的检讨取决于快速符号, `confirmation` 财务报告和审定财务报表 `quickSign.whitelistAddresses` (单位:千美元)[文件/概念](https://npmcn.com/package/%40fluent.xyz/connect/docs/concepts.md#prompt-mode-and-silent-mode)) (中文(简体) ). 当当事人拒绝部件检讨时(以快速模式为流利ID而发出),则拒绝 与 `FluentReviewRejectedError`,其 `code` 实值 `"transaction_review_rejected"`; 一个外部 钱包错误时, 钱包会自动拒绝 。 课和课上的分会 `code`,没有打开 讯息。 保持一个 `default` 任意分支 `switch` 代码或地位联盟: 释放可能增加一个值。 每个代码都列在 [文件/误差](https://npmcn.com/package/%40fluent.xyz/connect/docs/errors.md)。 。 。 . ## 文档 - [文档/开始](https://npmcn.com/package/%40fluent.xyz/connect/docs/getting-started.md): 要求流利,安装,网络, 挂起部件, 连接按钮, 读取账户 . - [文件/概念](https://npmcn.com/package/%40fluent.xyz/connect/docs/concepts.md):流利的ID、外部钱包、部件账户、部件 会议、审查、快签、赞助和其他条件. - [文件/配置](https://npmcn.com/package/%40fluent.xyz/connect/docs/configuration.md): 选项 `config` 和道具的标签 ``。 。 。 . - [文件/指南/交易](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/transactions.md):批量操作、天然气支付和 赞助. - [文件/指南/提案](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/sponsorship.md):按流量分列的赞助流量,读取 `sponsored`以及为何没有赞助行动. - [文件/指南/签名](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/signing.md):消息和打入的数据签名. - [文件/指南/后端-自动](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/backend-auth.md): 认证符并验证其内容 你的后门. - [文件/指南/链接-x.md](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/link-x.md): 链接一个 X 账户. - [文件/指南/框架](https://npmcn.com/package/%40fluent.xyz/connect/docs/guides/iframe.md): Iframe 桥用于您 App 嵌入的一页 . - [文件/误差](https://npmcn.com/package/%40fluent.xyz/connect/docs/errors.md): 每类错误和 `code`和如何在它们上分枝. - [文件/实验性.md](https://npmcn.com/package/%40fluent.xyz/connect/docs/experimental.md): 未成年人可能改变或去除什么 释放. - [文件/附录](https://npmcn.com/package/%40fluent.xyz/connect/docs/api.md):每个导出项的参考. - [文件/内部文件](https://npmcn.com/package/%40fluent.xyz/connect/docs/internal.md): 内部条目, `@fluent.xyz/connect/internal`,则 帮助部件的构建者, 承诺什么也没有. 从0.5升级: [文件/升级-0.5.md](https://npmcn.com/package/%40fluent.xyz/connect/docs/upgrading-0.5.md) ## 许可证 阿帕奇 - 2.0 ## 常见问题 ### @fluent\.xyz/connect 是什么？ 流畅的连接反应部件 — Privy 登录、 ZeroDev 智能账户、 批量操作和钱包 UI ### 如何安装 @fluent\.xyz/connect？ 在项目目录运行 npm install @fluent\.xyz/connect，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.0\.0）、react（\>=18\.0\.0）、wagmi（^2\.0\.0）、react-dom（\>=18\.0\.0）、@tanstack/react-query（^5\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @fluent\.xyz/connect 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @fluent\.xyz/connect 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @fluent\.xyz/connect 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @fluent\.xyz/connect 可以商用吗？ @fluent\.xyz/connect 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @fluent\.xyz/connect 的下载量有多少？ 根据 npm 官方下载统计，@fluent\.xyz/connect 在 2026/10/15 – 2026/11/13 这 30 天内被下载 5,138 次，日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @fluent\.xyz/connect 还在维护吗？ 最新版本 0\.8\.0 发布于 2026/11/12（3 天前）；至今共发布 32 个版本，其中过去 12 个月发布了 32 个；首次发布于 2026/07/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。