# @aptos-labs/wallet-adapter-core 中文文档

规范地址：https://npmcn.com/package/%40aptos-labs/wallet-adapter-core/

版本：8\.5\.1
npm 元数据更新时间：2026-03-28T07:35:31.803Z
中文译文更新时间：2026-11-06T13:02:44.452Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aptos-labs/wallet-adapter-core
原文对照：https://npmcn.com/package/%40aptos-labs/wallet-adapter-core/?lang=original
项目主页：https://github.com/aptos-labs/aptos-wallet-adapter
源码仓库：https://github.com/aptos-labs/aptos-wallet-adapter

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

- 包体积（解压后）：840 kB，46 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：@aptos-labs/ts-sdk ^5\.1\.1
- 首次发布：2022-12-07T01:51:03.240Z
- 最新版本发布：2026-03-28T07:35:31.527Z
- 近 30 天下载量：57407（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：164（近 12 个月 28 个）

## 中文简介

Aptos 钱包适应器核心

## 安装

```sh
npm install @aptos-labs/wallet-adapter-core
```

也可以使用：`pnpm add @aptos-labs/wallet-adapter-core`、`yarn add @aptos-labs/wallet-adapter-core`、`bun add @aptos-labs/wallet-adapter-core`

## README

# @ aptos- labs/ wallet- 适应器- 核心

Aptos钱包适配器的核心功能. 这个软件包为钱包管理,状态处理,以及与Aptos块链上AIP-62相容钱包的互动提供了基础.

## 概览

钱包调整器-核心软件包处理器:

-   **钱包检测**: 自动检测安装在浏览器中的 AIP- 62 标准兼容钱包
-   **连接管理**: 连接、 断开和管理钱包会话
-   **交易签名**: 签署信件、交易并提交交易到网络
-   **网络管理**: 处理网络变化和多网络支持
-   **事件系统**: 订阅钱包、账户和网络更改事件
-   **州管理层**: 连接钱包、账户和网络信息的集中状态

## 安装

```bash
npm install @aptos-labs/wallet-adapter-core
# or
pnpm add @aptos-labs/wallet-adapter-core
# or
yarn add @aptos-labs/wallet-adapter-core
```

**同伴依赖关系 :**

```bash
npm install @aptos-labs/ts-sdk
```

## 使用量

### 基本设置

```ts
import { WalletCore } from "@aptos-labs/wallet-adapter-core";
import { Network } from "@aptos-labs/ts-sdk";

// Create wallet core instance
const walletCore = new WalletCore(
  [], // Optional: array of wallet names to opt-in (empty = all wallets)
  { network: Network.MAINNET }, // Optional: dapp configuration
  false, // Optional: disable telemetry (default: false)
  ["Petra Web"] // Optional: wallets to hide from display
);

// Get available wallets
const wallets = walletCore.wallets;
const notDetectedWallets = walletCore.notDetectedWallets;
```

### 连接到钱包

```ts
// Connect to a wallet by name
await walletCore.connect("Petra");

// Check connection status
if (walletCore.isConnected()) {
  console.log("Connected account:", walletCore.account);
  console.log("Connected network:", walletCore.network);
}
```

### 签名信件

```ts
const signedMessage = await walletCore.signMessage({
  message: "Hello, Aptos!",
  nonce: "random-nonce-123",
});

console.log("Signature:", signedMessage.signature);
console.log("Full message:", signedMessage.fullMessage);
```

### 签名和提交交易

```ts
const result = await walletCore.signAndSubmitTransaction({
  data: {
    function: "0x1::aptos_account::transfer",
    typeArguments: [],
    functionArguments: [recipientAddress, amount],
  },
});

console.log("Transaction hash:", result.hash);
```

### 倾听事件

```ts
// Account change event
walletCore.on("accountChange", (account) => {
  console.log("Account changed:", account);
});

// Network change event
walletCore.on("networkChange", (network) => {
  console.log("Network changed:", network);
});

// Disconnect event
walletCore.on("disconnect", () => {
  console.log("Wallet disconnected");
});
```

### 断开连接

```ts
await walletCore.disconnect();
```

## API 参考

### 钱包库

管理钱包状态和交互的主要类 .

#### 构造器

```ts
new WalletCore(
  optInWallets?: ReadonlyArray<AvailableWallets>,
  dappConfig?: DappConfig,
  disableTelemetry?: boolean,
  hideWallets?: ReadonlyArray<AvailableWallets>
)
```

#### 属性

| 财产 | 类型 | 说明 |
| --- | --- | --- |
| `wallet` | `AptosWallet | null` | 目前连接的钱包 |
| `account` | `AccountInfo | null` | 目前连接的账户 |
| `network` | `NetworkInfo | null` | 目前连接的网络 |
| `wallets` | `ReadonlyArray<AptosWallet>` | 检测到的钱包列表 |
| `hiddenWallets` | `ReadonlyArray<AdapterWallet>` | 隐藏钱包列表 |
| `notDetectedWallets` | `ReadonlyArray<AdapterNotDetectedWallet>` | 未发现钱包列表 |

#### 方法

| 方法 | 说明 |
| --- | --- |
| `connect(walletName)` | 连接到钱包 |
| `disconnect()` | 从当前钱包断开连接 |
| `signMessage(input)` | 签名信件 |
| `signTransaction(args)` | 签名交易 |
| `signAndSubmitTransaction(input)` | 签名并提交交易 |
| `changeNetwork(network)` | 请求更改网络 |
| `signIn(args)` | 与 SIWA (用相片签名) 签名 |
| `isConnected()` | 检查钱包是否连接 |

#### 活动

| 活动 | 有效载荷 | 说明 |
| --- | --- | --- |
| `connect` | `AccountInfo` | 钱包连接时退出 |
| `disconnect` | \- 说吧 | 钱包断开时退出 |
| `accountChange` | `AccountInfo` | 账户变动时汇出 |
| `networkChange` | `NetworkInfo` | 网络改变时发送 |

## 达普配置

钱包适配器的配置选项 :

```ts
interface DappConfig {
  network: Network;
  transactionSubmitter?: TransactionSubmitter;
  aptosApiKeys?: Partial<Record<Network, string>>;
  aptosConnectDappId?: string;
  aptosConnect?: AptosConnectWalletConfig;
  crossChainWallets?: boolean;
}
```

## 相关软件包

-   [`@aptos-labs/wallet-adapter-react`](https://npmcn.com/package/%40aptos-labs/wallet-adapter-react) - 反应钩和上下文提供者
-   [`@aptos-labs/ts-sdk`](https://github.com/aptos-labs/aptos-ts-sdk) - Aptos 类型脚本 SDK

## 许可证

阿帕奇 - 2.0

## 常见问题

### @aptos-labs/wallet-adapter-core 是什么？

Aptos 钱包适应器核心

### 如何安装 @aptos-labs/wallet-adapter-core？

在项目目录运行 npm install @aptos-labs/wallet-adapter-core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@aptos-labs/ts-sdk（^5\.1\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aptos-labs/wallet-adapter-core 支持 TypeScript 吗？

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

### @aptos-labs/wallet-adapter-core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @aptos-labs/wallet-adapter-core 可以商用吗？

@aptos-labs/wallet-adapter-core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aptos-labs/wallet-adapter-core 的下载量有多少？

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

### @aptos-labs/wallet-adapter-core 还在维护吗？

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