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

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

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

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

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

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

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

## 中文简介

Intents 互换部件的 Solana 适配器

## 安装

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

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

## README

# {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我..

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

**索拉纳链适配器** 联 合 国 [意向交换部件](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget)。它允许用户互换 **从** 索拉纳钱包(Phantom, Solflare, Privy,.)通过发送SOL或SPL-token存款交易.

## 我需要吗?

| 你的设置 | 安装这个? |
| --- | --- |
| [`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) + 您自己的 Solana 钱包连接 | 对 |
| 仅限用户 **实收** 关于索拉纳的报告 | 不,目的地不需要适配器 |

没有它,索拉纳交换失败了 _"索拉纳转让不支持. 加入来自@aurora-is-near/intents-swap-widget-solana的索拉纳插件....._没有 `providers.sol`他们失败了 _加入索拉纳供应商.._。 。 。 .

## 合适的话

```mermaid
flowchart TB
    W["Swap Widget<br/>(quote ready)"] -- "plugins.sol.makeTransfer()" --> A["<b>this adapter</b>"]
    A -- "build tx + signTransaction" --> WL["User's Solana wallet<br/>(providers.sol)"]
    WL -- "SOL / SPL 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-solana
```

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

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

const { publicKey, signMessage, signTransaction, connect, disconnect } =
  useYourSolanaWallet(); // e.g. @solana/wallet-adapter-react

<WidgetConfigProvider
  config={{
    apiKey: 'YOUR_STUDIO_API_KEY', // https://studio.aurora.dev
    alchemyApiKey: 'YOUR_ALCHEMY_KEY', // recommended in production, see RPC below
    connectedWallets: { default: publicKey?.toBase58() },
    providers: { sol: { publicKey, signMessage, signTransaction } },
    plugins: { sol },
    onWalletSignin: connect,
    onWalletSignout: disconnect,
  }}>
  <Widget />
</WidgetConfigProvider>;
```

### `providers.sol`

| 外地 | 类型 |
| --- | --- |
| `publicKey` | `PublicKey` (任何与 `toString()`(中文(简体) ) |
| `signMessage` | `(message: Uint8Array) => Promise<Uint8Array>` |
| `signTransaction` | `(tx: Transaction) => Promise<Transaction>` |

使用 **枢密院**它的钱包 API 有不同的形状, 所以它需要一个小的适配器 : @ @ @ info [枢密室实例](https://docs.intents.aurora.dev/intents-swap/widget-configuration/wallet-connection)。 。 。 .

## 它会做什么

| 步骤 | 行为 |
| --- | --- |
| 原生的太阳能 | `SystemProgram.transfer` 至存款地址 |
| SPL 符号 | `transfer` 在相关符号账户之间. **创建收件人 ATA** 如果它不存在的话 |
| 签名 | 以新鲜的块状结构 tx, `signTransaction` 然后通过钱包 `sendRawTransaction` (飞行前,3回) |
| 结果 | 回返 `{ hash }` (签名)。 部件然后跟踪交换状态 |

### 难民保护委员会

| 配置 | 用于转让的RPC |
| --- | --- |
| `alchemyApiKey` 设定 | `https://solana-mainnet.g.alchemy.com/v2/<key>` |
| 未设置 | `https://solana-rpc.publicnode.com` (公共和费率有限) |

## 出口

| 导出 | 类型 | 使用 |
| --- | --- | --- |
| `sol` | `SolanaNetworkPlugin` | 通过它作为 `plugins.sol` |
| `makeTransfer(args, options)` | `Promise<{ hash }>` | 相同的逻辑,可直接调用 |
| `MakeTransferOptions` | 类型 | `{ provider: SolanaProvider; rpcUrl?: string; alchemyApiKey?: string }` |

依赖性 : `@solana/web3.js`, (中文(简体) ), `@solana/spl-token`。对等点 : `@aurora-is-near/intents-swap-widget`。 。 。 .

## 相关

|  |  |
| --- | --- |
| 🧩 [核心部件读取器](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget) | 配置、事件、主题、交换方法 |
| 其他适配器 | [EVM( 视频)](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget-evm) • 妇女 [斯特拉尔](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/supported-chains) | 任何可以互换的东西 |
| 🤖 [`llms.txt`](https://docs.intents.aurora.dev/llms.txt) | 机器可读文件索引 |

## 许可证

麻省理工学院

## 常见问题

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

Intents 互换部件的 Solana 适配器

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

在项目目录运行 npm install @aurora-is-near/intents-swap-widget-solana，或使用 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-solana 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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