# @aurora-is-near/intents-swap-widget-standalone 中文文档

规范地址：https://npmcn.com/package/%40aurora-is-near/intents-swap-widget-standalone/

版本：7\.29\.0
npm 元数据更新时间：2026-11-02T16:50:05.398Z
中文译文更新时间：2026-11-07T05:28:51.261Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aurora-is-near/intents-swap-widget-standalone
原文对照：https://npmcn.com/package/%40aurora-is-near/intents-swap-widget-standalone/?lang=original
项目主页：https://github.com/aurora-is-near/intents-swap-widget#readme
源码仓库：https://github.com/aurora-is-near/intents-swap-widget

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：781 kB，52 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：16 个
- peer 依赖：react \>=18\.2\.0，react-dom \>=18\.2\.0
- 首次发布：2026-02-12T22:20:33.593Z
- 最新版本发布：2026-11-02T16:50:05.038Z
- 近 30 天下载量：2453（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 122 个）

## 中文简介

Intents 互换部件的独立包装

## 安装

```sh
npm install @aurora-is-near/intents-swap-widget-standalone
```

也可以使用：`pnpm add @aurora-is-near/intents-swap-widget-standalone`、`yarn add @aurora-is-near/intents-swap-widget-standalone`、`bun add @aurora-is-near/intents-swap-widget-standalone`

## README

# @aurora-is-near/intents-swap-widget-独立

[![npm](https://img.shields.io/npm/v/@aurora-is-near/intents-swap-widget-standalone?color=bc9cf8)](https://www.npmjs.com/package/@aurora-is-near/intents-swap-widget-standalone) [![Widget Studio](https://img.shields.io/badge/Widget%20Studio-get%20API%20key-bc9cf8)](https://studio.aurora.dev/)

这个 [意向交换部件](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) **钱包连接**。这是在 React app 中添加跨链互换的最快方式:不需要钱包库、提供者设置或连接按钮.

> \[TIP\] 你的应用 **已连接钱包**,或者你需要帮助 **顿**使用核心 [`@aurora-is-near/intents-swap-widget`](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) 与 [链式适配器](https://npmcn.com/package/%40aurora-is-near/intents-swap-widget-standalone/#readme-how-it-relates-to-the-other-packages) 换句话说.

## 快开始

**1\. 联合国.** 获取 API 密钥 **[部件工作室](https://studio.aurora.dev/)**。也可以在那里设计部件并复制现成片段.

**2\. 联合国.** 安装 :

```bash
npm install @aurora-is-near/intents-swap-widget-standalone
```

**3个.** 显示 :

```tsx
import '@aurora-is-near/intents-swap-widget/styles.css'; // installed as a dependency

import {
  Widget,
  WidgetConfigProvider,
} from '@aurora-is-near/intents-swap-widget-standalone';

export function Swap() {
  return (
    <WidgetConfigProvider config={{ apiKey: 'YOUR_STUDIO_API_KEY' }}>
      <Widget />
    </WidgetConfigProvider>
  );
}
```

部件现在变成自己的 **连接钱包** 按钮和一个用于连接和断开的配置按钮.

## 包括什么

| 钱包家庭 | 通过连接 | 钱包 |
| --- | --- | :-: |
| **EVM( 视频)** | [重下应用程序](https://docs.reown.com/appkit/overview) | MetaMask、Coinbase、信托和50+ 通过钱包连接 |
| **索拉纳** | 重下应用程序 | 幽灵、索夫拉尔、钱包连接 |
| **没有** | [近距离连接](https://www.npmjs.com/package/@hot-labs/near-connect) | HOT,Meteor, MyNearWallet, NEAR Mobile, . 诺克·莫比尔, |
| **斯特拉尔** | [斯特拉尔钱包套装](https://stellarwalletskit.dev/) | 货车,xBull,.. |

**钱包模式中的 EVM 网络 :** 伊特鲁姆,Arbitrum, Base, BSC, Polygon, Optimism, Avalanche, Gnosis, Berachain, Monad, Plasma, Scroll, X 地层, ADI, Robinhood Chain, Aurora.

用户仍然可以互换 **改为** 任意 [支持链](https://docs.intents.aurora.dev/intents-swap/supported-chains),包括连锁链 他们没有钱包.

## 与其他一揽子方案的关系

```mermaid
flowchart LR
    SA["<b>intents-swap-widget-standalone</b><br/>wallet modal + wiring"] --> CORE["<b>intents-swap-widget</b><br/>UI, quotes, state"]
    SA --> EVM[intents-swap-widget-evm]
    SA --> SOL[intents-swap-widget-solana]
    SA --> XLM[intents-swap-widget-stellar]
    EVM -. plugin .-> CORE
    SOL -. plugin .-> CORE
    XLM -. plugin .-> CORE
```

这个包 **再出口所有东西** 从核心包。 唯一的区别是 `WidgetConfigProvider`,在这里连接钱包并填充这些配置密钥:

| 自动设定( 不通过) | 数值 |
| --- | --- |
| `connectedWallets` | 用户连接的钱包地址 |
| `providers` | EVM / Solana / Stellar / NEAR 签名人 |
| `plugins` | `evm`, (中文(简体) ), `sol`, (中文(简体) ), `stellar` 适配器 |
| `onWalletSignin` 编号 : `onWalletSignout` | 打开钱包选择器/ 断开 |
| `showProfileButton` | `true` |

所有其他选项与核心套件相同: `apiKey`, (中文(简体) ), `appFees`,允许的标志和锁链, `confidentialMode`, (中文(简体) ), `theme`, (中文(简体) ), `localisation`,, , , , , , , ,

```tsx
<WidgetConfigProvider
  config={{
    apiKey: 'YOUR_STUDIO_API_KEY',
    allowedChainsList: ['eth', 'base', 'sol', 'near'],
    defaultTargetToken: { symbol: 'USDC', blockchain: 'base' },
    appFees: [{ recipient: 'your-app.near', fee: 20 }],
  }}
  theme={{ colorScheme: 'dark', accentColor: '#bc9cf8', stylePreset: 'bold' }}>
  <Widget />
</WidgetConfigProvider>
```

完全选项参考 : [部件配置](https://docs.intents.aurora.dev/intents-swap/widget-configuration/get-started) • 妇女 [他们](https://docs.intents.aurora.dev/intents-swap/widget-configuration/theming) • 妇女 [本地化](https://docs.intents.aurora.dev/intents-swap/widget-configuration/localisation)

## 额外出口

| 导出 | 用它来 |
| --- | --- |
| `AppKitProvider` | 独立提供者使用的低级 AppKit 上下文 |
| `useAppKitWallet()` | 读取 `{ address, isConnected, isConnecting, connect, disconnect }` 应用程序连接 |
| `useAppKitProviders()` | 生下来 `{ evm, sol }` 钱包提供者 |

## 独立还是核心?

|  | 独立( 此) | 核心+适配器 |
| --- | --- | :-: |
| 钱包代码行 | 0 个 | 您写入连接流 |
| TON 钱包 | ❌ | ✅ |
| 自定义钱包模式 | ❌ | ✅ |
| 套装 | 所有链式SDK | 只安装适配器 |

## 解决问题

| 症状 | 修补 |
| --- | --- |
| 复制 `@reown/*`, (中文(简体) ), `@solana/*` 或者说 `valtio` 版本 | 用绳子绑住 `resolutions` 编号 : `overrides` (单位:千美元)[列表](https://docs.intents.aurora.dev/intents-swap/widget-configuration/troubleshooting)(中文(简体) ) |
| `connectedWallets` 我通过了,被忽略了 | 期望:独立使用自己的连接. 使用核心软件包 |
| 无样式 | 导入 `@aurora-is-near/intents-swap-widget/styles.css`,然后将您的 CSS 重置到 `@layer base` |

## 链接

|  |  |
| --- | --- |
| 🧩 [核心部件读取器](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) | 配置、事件、主题、子路径出口、交换如何运作 |
| 🗂 [单曲朗读](https://github.com/aurora-is-near/intents-swap-widget#readme) | 所有软件包和开发 |
| 👛 [钱包连接文件](https://docs.intents.aurora.dev/intents-swap/widget-configuration/wallet-connection) | 内建对外钱包 |
| 🛠 [部件工作室](https://studio.aurora.dev/) | API 密钥、 费用、 视觉配置、 外出代码 |
| 🤖 [`llms.txt`](https://docs.intents.aurora.dev/llms.txt) | 机器可读文件索引 |

## 许可证

麻省理工学院

## 常见问题

### @aurora-is-near/intents-swap-widget-standalone 是什么？

Intents 互换部件的独立包装

### 如何安装 @aurora-is-near/intents-swap-widget-standalone？

在项目目录运行 npm install @aurora-is-near/intents-swap-widget-standalone，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.2\.0）、react-dom（\>=18\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aurora-is-near/intents-swap-widget-standalone 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aurora-is-near/intents-swap-widget-standalone 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aurora-is-near/intents-swap-widget-standalone 可以商用吗？

@aurora-is-near/intents-swap-widget-standalone 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aurora-is-near/intents-swap-widget-standalone 的下载量有多少？

根据 npm 官方下载统计，@aurora-is-near/intents-swap-widget-standalone 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,453 次，日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aurora-is-near/intents-swap-widget-standalone 还在维护吗？

最新版本 7\.29\.0 发布于 2026/11/03（5 天前）；至今共发布 122 个版本，其中过去 12 个月发布了 122 个；首次发布于 2026/02/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。