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

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

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

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

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

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

- 包体积（解压后）：26.4 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@aurora-is-near/intents-swap-widget ^7\.29\.0
- 首次发布：2026-05-13T08:48:54.767Z
- 最新版本发布：2026-11-02T16:50:01.594Z
- 近 30 天下载量：6514（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：66（近 12 个月 66 个）

## 中文简介

Intents 互换部件的 EVM 连接器

## 安装

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

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

## README

# @aurora-is-near/intents-swap-widget-evm (英语)

[![npm](https://img.shields.io/npm/v/@aurora-is-near/intents-swap-widget-evm?color=bc9cf8)](https://www.npmjs.com/package/@aurora-is-near/intents-swap-widget-evm)

**EVM 链式适配器** 联 合 国 [意向交换部件](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget)。它允许用户互换 **从** EVM钱包(MetaMask, Rabby, WaletConnect,.),通过发送来源链上的存款交易.

## 我需要吗?

| 你的设置 | 安装这个? |
| --- | --- |
| [`intents-swap-widget-standalone`](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget-standalone) | 不,已经列入 |
| [`intents-swap-widget`](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) + 您自己的 EVM 钱包连接 | 对 |
| 仅限用户 **实收** 在EVM链上 | 不,目的地不需要适配器 |

没有它, EVM 交换失败 _"EVM转让不支持. 从@aurora-is- near/intents-swap-widget-evm 添加 EVM 插件.._没有 `providers.evm`他们失败了 _"... 添加EVM供应商..."_。 。 。 .

## 合适的话

```mermaid
flowchart TB
    W["Swap Widget<br/>(quote ready)"] -- "plugins.evm.makeTransfer()" --> A["<b>this adapter</b>"]
    A -- "switch chain + sign" --> WL["User's EVM wallet<br/>(providers.evm)"]
    WL -- "native / ERC-20 transfer" --> D["1Click deposit address"]
    D --> NI["NEAR Intents settles the swap"]
```

## 使用量

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

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

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

const { address, connect, disconnect } = useYourEvmWallet(); // wagmi, AppKit, Privy, …

<WidgetConfigProvider
  config={{
    apiKey: 'YOUR_STUDIO_API_KEY', // https://studio.aurora.dev
    connectedWallets: { default: address },
    providers: { evm: window.ethereum },
    plugins: { evm },
    onWalletSignin: connect,
    onWalletSignout: disconnect,
  }}>
  <Widget />
</WidgetConfigProvider>;
```

### `providers.evm`

| 接受值 | 示例 |
| --- | --- |
| 任意 [EIP-1193 (英语)](https://eips.ethereum.org/EIPS/eip-1193) 提供者 | `window.ethereum`, (中文(简体) ), `await connector.getProvider()` |
| 懒惰取出器 `() => Promise<EIP1193Provider>` | `() => wallet.getEthereumProvider()` |

## 它会做什么

| 步骤 | 行为 |
| --- | --- |
| 1\. 链条 | 电话 `wallet_switchEthereumChain` 如果钱包在不同的链上。 如果钱包不知道链条, 则出现明显的出错( 代码) `4902`(中文(简体) ) |
| 2\. 账户 | 使用钱包的第一个地址, 并在需要时请求访问 |
| 3a. 原生标志 | 发送 `value` 直接转入存款地址 |
| 3b. ERC-20 | 电话 `transfer(depositAddress, amount)` 契约合同 |
| 3c. Aurora(挪威虚拟链) | 电话 `withdrawToNear()` 将资金直接汇入NEAR的意向 |
| 4\. 结果 | 回返 `{ hash }`。然后部件跟踪交换状态 |

## 支持源链

以利亚 `eth` 基地 `base` 仲裁 `arb` BNB链 `bsc` 多边形 `pol` • 乐观 `op` · 雪崩 `avax` • 肠道硬化症 `gnosis` 贝拉链 `bera` • 修道院 `monad` • ADI `adi` 等离子体 `plasma` · 滚动 `scroll` X层 `xlayer` 罗宾链 `hood` · 奥罗拉 `aurora`

有源/去向支持的直播列表: QQ [支持链](https://docs.intents.aurora.dev/intents-swap/supported-chains)

## 出口

| 导出 | 类型 | 使用 |
| --- | --- | --- |
| `evm` | `EvmNetworkPlugin` | 通过它作为 `plugins.evm` |
| `makeTransfer(args, { provider })` | `Promise<{ hash }>` | 相同的逻辑, 可直接调用( 例如在自定义内) `makeTransfer` 部件道具) |
| `MakeTransferOptions` | 类型 | `{ provider: EvmProvider }` |

依赖性 : `viem`, (中文(简体) ), `ethers`。对等点 : `@aurora-is-near/intents-swap-widget`。 。 。 .

## 相关

|  |  |
| --- | --- |
| 🧩 [核心部件读取器](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) | 配置、事件、主题、交换方法 |
| 其他适配器 | [索拉纳](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget-solana) • 妇女 [斯特拉尔](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget-stellar) \* 将近地轨道纳入核心 |
| 🗂 [单曲朗读](https://github.com/aurora-is-near/intents-swap-widget#readme) | 所有软件包 |
| 👛 [钱包连接文件](https://docs.intents.aurora.dev/intents-swap/widget-configuration/wallet-connection) | 多链和枢密院的例子 |
| 🤖 [`llms.txt`](https://docs.intents.aurora.dev/llms.txt) | 机器可读文件索引 |

## 许可证

麻省理工学院

## 常见问题

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

Intents 互换部件的 EVM 连接器

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

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

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

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

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

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

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

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

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

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

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

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