# @ember-finance/proof-of-reserves 中文文档

规范地址：https://npmcn.com/package/%40ember-finance/proof-of-reserves/

版本：0\.21\.0
npm 元数据更新时间：2026-11-09T19:29:29.518Z
中文译文更新时间：2026-11-14T02:39:09.922Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ember-finance/proof-of-reserves
原文对照：https://npmcn.com/package/%40ember-finance/proof-of-reserves/?lang=original
项目主页：https://github.com/fireflyprotocol/ember-mono#readme
源码仓库：https://github.com/fireflyprotocol/ember-mono

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

- 包体积（解压后）：400 kB，87 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：9 个
- 首次发布：2025-12-08T09:08:51.450Z
- 最新版本发布：2026-11-09T19:29:29.358Z
- 近 30 天下载量：2494（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

为Ember协议金库生成并核实储备报告证明

## 安装

```sh
npm install @ember-finance/proof-of-reserves
```

也可以使用：`pnpm add @ember-finance/proof-of-reserves`、`yarn add @ember-finance/proof-of-reserves`、`bun add @ember-finance/proof-of-reserves`

## README

# 防腐储备

TypeScript 库和用于生成和核实保留报告证明的 CLI 工具 ember协议金库.

## 安装

### 作为CLI工具(全球)

```bash
npm install -g ember-proof-of-reserves
# or
yarn global add ember-proof-of-reserves
```

### 作为图书馆

```bash
npm install ember-proof-of-reserves
# or
yarn add ember-proof-of-reserves
```

## 使用量

### CLI 使用量

1.  创建一个 `.env` 文件 :

```bash
BLOCKVISION_API_KEY=your_blockvision_key_here
DEBANK_API_KEY=your_debank_key_here
SERIALIZED_API_KEY=your_serialized_key_here
SUI_GRPC_URL=https://fullnode.mainnet.sui.io:443
SUI_GRPC_TOKEN=
LOG_LEVEL=info
```

2.  运行 CLI :

```bash
ember-por
```

报告将编成 `reports/` 目录.

### 图书馆的使用

```typescript
import { generateProofOfReservesReport, type VaultReport } from 'ember-proof-of-reserves';

async function main() {
  // Generate reports programmatically
  const reports = await generateProofOfReservesReport({
    basePath: 'https://vaults.api.sui-prod.bluefin.io',
    suiGrpcUrl: 'https://fullnode.mainnet.sui.io:443',
    outputDir: './my-reports'
  });

  console.log(`Generated ${reports.length} vault reports`);

  reports.forEach((report: VaultReport) => {
    console.log(`Vault: ${report.vaultName}`);
    console.log(`Health Ratio: ${report.vaultHealthRatio}`);
    console.log(`Total NAV: $${report.systemNavUsd}`);
  });
}

main();
```

## 环境变量

| 变量 | 需求 | 默认 | 说明 |
| --- | --- | --- | --- |
| `BLOCKVISION_API_KEY` | 对 | \- 说吧 | BlockVision (苏伊链数据) 的 API 密钥 |
| `DEBANK_API_KEY` | 对 | \- 说吧 | DeBank 的 API 密钥( EVM 链数据) |
| `SERIALIZED_API_KEY` | 对 | \- 说吧 | 序列化的 API 密钥( Solana 位和余额) |
| `SUI_GRPC_URL` | 没有 | `https://fullnode.mainnet.sui.io:443` | Sui gRPC 终点 |
| `SUI_GRPC_TOKEN` | 没有 | \- 说吧 | Sui gRPC 认证令牌,作为 `x-token` 标题 |
| `LOG_LEVEL` | 没有 | `info` | 日志级别( 跟踪、 调试、 信息、 警告、 错误、 致命) |
| `USE_BLUEFIN_PRICE_FEED` | 没有 | `false` | 使用 Bluefin 价格种子 |
| `BLOCKVISION_RATE_LIMIT_RPS` | 没有 | `1` | BlockVision API 的费率限制 |

## 捐款

1.  叉子存储器
2.  创建您的特性分支( E)`git checkout -b feature/amazing-feature`(中文(简体) )
3.  提交更改( E)`git commit -m 'Add some amazing feature'`(中文(简体) )
4.  推向分行(`git push origin feature/amazing-feature`(中文(简体) )
5.  打开拉请求

## 释放

这个包裹住在 [木质摩诺](https://github.com/fireflyprotocol/ember-mono) 时间 `typescript/library/ember-proof-of-reserves`弹出 `version` 内 `package.json`,合并, 然后运行 `./scripts/release.sh ember-proof-of-reserves` 从 repo 根(参见 `RELEASE.md`) (中文(简体) ). 它出版标签 `release-ember-proof-of-reserves-<N>`时 `N` 这是 下一个单发号; npm 版本来自 `package.json`。 。 。 . `.github/workflows/ember_proof_of_reserves_publish.yaml` 通过 npm OIDC 可信发布 发布; npm 授权该文件的准确名称, 因此它不能被重新命名 .

## 许可证

这个项目根据麻省理工学院许可证颁发——见 [自由主义](https://npmcn.com/package/%40ember-finance/proof-of-reserves/LICENSE) 文件为 细节.

## 支助

关于议题和问题清单:

-   GitHub 问题 : [https://github.com/fireflyprotocol/ember-mono/ 问题](https://github.com/fireflyprotocol/ember-mono/issues)
-   电子邮件 : [工程学@ bluefin.io](mailto:engineering@bluefin.io)

## 更改日志

见 [变动情况](https://npmcn.com/package/%40ember-finance/proof-of-reserves/CHANGELOG.md) 为更改列表.

## 常见问题

### @ember-finance/proof-of-reserves 是什么？

为Ember协议金库生成并核实储备报告证明

### 如何安装 @ember-finance/proof-of-reserves？

在项目目录运行 npm install @ember-finance/proof-of-reserves，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ember-por，可以用 npx ember-por 直接运行。

### @ember-finance/proof-of-reserves 支持 TypeScript 吗？

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

### @ember-finance/proof-of-reserves 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ember-finance/proof-of-reserves 需要什么版本的 Node\.js？

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

### @ember-finance/proof-of-reserves 可以商用吗？

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

### @ember-finance/proof-of-reserves 的下载量有多少？

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

### @ember-finance/proof-of-reserves 还在维护吗？

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