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

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

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

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

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

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

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

## 中文简介

Intents 互换部件的 Starr 连接器

## 安装

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

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

## README

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

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

**Stellar 链式适配器** 联 合 国 [意向交换部件](https://github.com/aurora-is-near/intents-swap-widget/tree/main/packages/intents-swap-widget)。它允许用户互换 **从** Stellar钱包(Freighter,xBall,Stellar Wallets Kit,.)通过发送XLM或USDC到存款地址,并加载他们的Stellar余额.

## 我需要吗?

| 你的设置 | 安装这个? |
| --- | --- |
| [`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) + 您自己的 Stellar 钱包连接 | 对 |
| 仅限用户 **实收** 在斯特拉尔 | 不,目的地不需要适配器 |

没有它,Stellar交换失败了 _"星际转移不支持. 从@aurora-is-near/intents-swap-widget-stellar 添加 Stellar 插件..."_没有 `providers.stellar`他们失败了 _"... 添加一个Stellar供应商..."_。 。 。 .

## 合适的话

```mermaid
flowchart TB
    W["Swap Widget<br/>(quote ready)"] -- "plugins.stellar.makeTransfer()" --> A["<b>this adapter</b>"]
    A -- "build tx with memo + sign XDR" --> WL["User's Stellar wallet<br/>(providers.stellar)"]
    WL -- "XLM / USDC payment" --> 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-stellar
```

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

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

const wallet = useYourStellarWallet(); // e.g. Stellar Wallets Kit

<WidgetConfigProvider
  config={{
    apiKey: 'YOUR_STUDIO_API_KEY', // https://studio.aurora.dev
    connectedWallets: { default: wallet.address },
    providers: {
      stellar: {
        publicKey: wallet.address, // G… address
        signMessage: wallet.signMessage,
        signTransaction: wallet.signTransaction,
      },
    },
    plugins: { stellar },
    onWalletSignin: wallet.connect,
    onWalletSignout: wallet.disconnect,
  }}>
  <Widget />
</WidgetConfigProvider>;
```

### `providers.stellar`

| 外地 | 类型 |
| --- | --- |
| `publicKey` | `string` (G. 地址) (中文(简体) ) |
| `signMessage` | `(message: string) => Promise<{ signedMessage, signerAddress }>` |
| `signTransaction` | `(xdr: string, opts?: { networkPassphrase, address }) => Promise<string | { signedTxXdr }>` |

Stellar Wallets Kit 签名(2 args)和 单参数 Floder API 的工作。 适配器检测到它得到的哪个自动倒回.

## 它会做什么

| 能力 | 行为 |
| --- | --- |
| `makeTransfer` | 构建一个 Stellar **主网** 支付款项 **XLM 图像** 或者说 **USDC 美洲金融共同体** (环绕) **备忘** 从引文。 需要备忘录,适配器处理文本,ID和散列格式. 钱包签名, 然后适配器提交 |
| `getNativeBalances` | 直接从索洛班RPC读取 XLM 和 USDC (信托) 余额 |
| `decodePublicKey` | 将 G 地址转换为原始字节 。 部件使用此来获取用户的意向账户 |
| 难民保护委员会 | 尝试 `sorobanrpc.stellar.org`,然后安克,然后诺迪斯 |

## 出口

| 导出 | 类型 | 使用 |
| --- | --- | --- |
| `stellar` | `StellarNetworkPlugin` | 通过它作为 `plugins.stellar` |
| `makeTransfer(args, { provider })` | `Promise<{ hash }>` | 可直接调用的传输逻辑 |
| `MakeTransferOptions` | 类型 | `{ provider: StellarProvider }` |

依赖性 : `@stellar/stellar-sdk`, (中文(简体) ), `axios`。对等点 : `@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-solana) \* 将近地轨道纳入核心 |
| 🗂 [单曲朗读](https://github.com/aurora-is-near/intents-swap-widget#readme) | 所有软件包 |
| 👛 [钱包连接文件](https://docs.intents.aurora.dev/intents-swap/widget-configuration/wallet-connection) | 斯特拉尔和多链实例 |
| 📖 [支持链](https://docs.intents.aurora.dev/intents-swap/supported-chains) | 任何可以互换的东西 |
| 🤖 [`llms.txt`](https://docs.intents.aurora.dev/llms.txt) | 机器可读文件索引 |

## 许可证

麻省理工学院

## 常见问题

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

Intents 互换部件的 Starr 连接器

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

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

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

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

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

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

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

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

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

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

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