# @aeternity/aepp-sdk 中文文档

规范地址：https://npmcn.com/package/%40aeternity/aepp-sdk/

版本：15\.0\.1
npm 元数据更新时间：2026-10-21T13:52:24.192Z
中文译文更新时间：2026-11-05T22:26:52.503Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40aeternity/aepp-sdk
原文对照：https://npmcn.com/package/%40aeternity/aepp-sdk/?lang=original
项目主页：https://sdk.aeternity.io/
源码仓库：https://github.com/aeternity/aepp-sdk-js

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

- 包体积（解压后）：14.7 MB，411 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.19
- 运行依赖：31 个
- 首次发布：2018-03-27T15:31:19.123Z
- 最新版本发布：2026-10-01T17:36:56.204Z
- 近 30 天下载量：12387（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：114（近 12 个月 3 个）

## 中文简介

近端区块链的 SDK

## 安装

```sh
npm install @aeternity/aepp-sdk
```

也可以使用：`pnpm add @aeternity/aepp-sdk`、`yarn add @aeternity/aepp-sdk`、`bun add @aeternity/aepp-sdk`

## README

# [长期性](https://aeternity.com/)Java 脚本 SDK

[![main action](https://github.com/aeternity/aepp-sdk-js/actions/workflows/main.yml/badge.svg)](https://github.com/aeternity/aepp-sdk-js/actions/workflows/main.yml) [![codecov](https://codecov.io/gh/aeternity/aepp-sdk-js/branch/develop/graph/badge.svg?token=wON6gOciRP)](https://codecov.io/gh/aeternity/aepp-sdk-js) [![docs](https://github.com/aeternity/aepp-sdk-js/actions/workflows/docs.yml/badge.svg)](https://github.com/aeternity/aepp-sdk-js/actions/workflows/docs.yml) [![npm](https://img.shields.io/npm/v/@aeternity/aepp-sdk.svg)](https://www.npmjs.com/package/@aeternity/aepp-sdk) [![npm](https://img.shields.io/npm/l/@aeternity/aepp-sdk.svg)](https://www.npmjs.com/package/@aeternity/aepp-sdk)

JavaScript SDK 为革命者服务 [长期性](https://aeternity.com/) 区块链,瞄准 [æternity 节点](https://github.com/aeternity/aeternity) 执行。 Aepp -sdk是,我们.. [在 GitHub 上主机](https://github.com/aeternity/aepp-sdk-js)。 。 。 .

## 指南和实例

导言

-   [安装](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/README.md)
-   [快速启动](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/quick-start.md)

使用指南:

-   [阿恩斯语NAME](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/aens.md) (持续命名系统)
-   [合同](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/contracts.md)
-   [合同活动](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/contract-events.md)
-   [甲骨文类](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/oracles.md)
-   [支付福克斯](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/paying-for-tx.md) (金属交易)
-   [批量交易](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/batch-requests.md)
-   [处理错误](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/error-handling.md)
-   [低等对高等 API](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/low-vs-high-usage.md)
-   [输入的数据散列和签名](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/typed-data.md)
-   [使用类型脚本](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/typescript.md)
-   [JWT 习惯](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/jwt.md)
-   [交易选项](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/transaction-options.md)
-   [可能的地址长度范围](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/address-length.md)
-   钱包相互作用
    -   [将 æpp 连接到钱包](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/connect-aepp-to-wallet.md)
    -   [如何构建钱包](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/build-wallet.md)
    -   [编程硬件钱包](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/ledger-wallet.md)
    -   [MetalMask 的全天候快取](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/guides/metamask-snap.md)

还有 [实例](https://npmcn.com/package/%40aeternity/aepp-sdk/examples/README.md) 您可以直接使用和玩耍.

### [API 参考](https://sdk.aeternity.io/v14.1.0/api/)

## CLI - 命令行接口

快速测试 _全部_ 您可以从终端安装和使用 æternity 的块链特性 [国 际](https://github.com/aeternity/aepp-cli-js) 通过运行 :

1.  `npm i -g @aeternity/aepp-cli` 全球安装CLI
2.  `aecli --help` 以获取可能的命令列表

## 捐款

对于先进用途,为了加深对SDK的理解或促进其发展,建议改为: [贡献准则](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/contrib/README.md) 节.

## 更改日志

我们继续 [更改日志](https://npmcn.com/package/%40aeternity/aepp-sdk/docs/CHANGELOG.md) 最新进展.

## 常见问题

### @aeternity/aepp-sdk 是什么？

近端区块链的 SDK

### 如何安装 @aeternity/aepp-sdk？

在项目目录运行 npm install @aeternity/aepp-sdk，或使用 pnpm add / yarn add / bun add。

### @aeternity/aepp-sdk 支持 TypeScript 吗？

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

### @aeternity/aepp-sdk 支持 ESM 还是 CommonJS？

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

### @aeternity/aepp-sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aeternity/aepp-sdk 可以商用吗？

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

### @aeternity/aepp-sdk 的下载量有多少？

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

### @aeternity/aepp-sdk 还在维护吗？

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