# @aifinpay/deployments 中文文档

规范地址：https://npmcn.com/package/%40aifinpay/deployments/

版本：2\.1\.5
npm 元数据更新时间：2026-11-02T00:13:46.061Z
中文译文更新时间：2026-11-06T10:26:50.278Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aifinpay/deployments
原文对照：https://npmcn.com/package/%40aifinpay/deployments/?lang=original
源码仓库：https://github.com/AiFinPay/sdk

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

- 包体积（解压后）：528 kB，57 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-16T15:07:32.284Z
- 最新版本发布：2026-11-02T00:13:45.840Z
- 近 30 天下载量：3481（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

AiFinPay SDK和代理护照身份和结算协议的合同部署登记册.

## 安装

```sh
npm install @aifinpay/deployments
```

也可以使用：`pnpm add @aifinpay/deployments`、`yarn add @aifinpay/deployments`、`bun add @aifinpay/deployments`

## README

# @aifinpay/部署

## 部署登记册和文物管理员

这个软件包提供了一个程序接口,用于查询AIFP的部署记录和合同文物(ABI/IDL).

### 快速启动

```typescript
import { AifinpayRegistry, ArtifactRegistry } from "@aifinpay/deployments";

// Load deployment registries
const evmRegistry = AifinpayRegistry.loadEvm("latest");      // or "1.4", "1.3", etc.
const solanaRegistry = AifinpayRegistry.loadSolana("latest");

// Load contract artifacts
const artifacts = ArtifactRegistry.load();

// Query deployments
const optimism = evmRegistry.getEvmDeployment(10);
const splitterAddr = evmRegistry.getSplitterAddress(10);
const stablecoins = evmRegistry.getStablecoins(10);

// Get supported chains
const chains = evmRegistry.getSupportedChains("enabled");
const networks = evmRegistry.getNetworkList();             // [{ chainId, name, settlementEnabled, testnet }]

// Export as markdown/json/csv
const markdown = evmRegistry.exportAsMarkdown("prod");
const json = evmRegistry.exportAsJson();
const csv = evmRegistry.exportAsCsv();

// Query artifacts
const abi = artifacts.getEvmAbi("B2BSplitterV14", "1.4");
const solanaIdl = artifacts.getSolanaIdl("mainnet");
const nearAbi = artifacts.getNearAbi("aifinpay-near-contract");
```

见 [用户](https://npmcn.com/package/%40aifinpay/deployments/USAGE.md) 用于完整文档.

## 证据和可用性

使用 [登记册索引](https://npmcn.com/package/%40aifinpay/deployments/registry/splitter/INDEX.md) 选择实际 所需生态系统、版本、链条和路线的机器可读记录. 地址、程序ID、运行时间散列、治理和出处属于 这些记录,不复制表在这里.

登记查询读取了被包的元数据;它们不检查活链状态或 后端接收验证 。 定居点旗帜不是当前核查 结果。 遵循索引的运行时间/后端核查清单并获取 在声称可获得之前,有新的端到端证据。 从不推断激活 从导出.

* * *

## 登记册抓取器(遗产)

`src/grabber.ts` 从峡谷取出最新的部署记录 上游存放和生成每个生态系统的分块登记册文件:

-   EVM v1.4 : (中文(简体) ) `registry/splitter/evm/v1.4/deployments.json`
-   索拉纳 v1.4: `registry/splitter/solana/deployments.json`

```bash
cd deployments
npm ci --no-audit --no-fund
npm run build          # compile TypeScript
npm run registry:build # fetch upstream + write registry/*.json
npm test               # offline unit tests
```

## 书记官处布局

整个生态系统的分化文件是犬科文物. ABI和IDL (英语) 为需要原始合同的下游消费者保留子目录 文物:

```
registry/
├── splitter/                  # versioned registry with governance metadata
│   ├── evm/
│   │   ├── v1.4/deployments.json  # EVM v1.4 full contract suite
│   │   ├── v1.3/deployments.json  # EVM v1.3 route table
│   │   ├── v1.2/deployments.json  # EVM v1.2 legacy
│   │   └── v1.1/deployments.json  # EVM v1.1 legacy
│   ├── solana/deployments.json # Solana v1.4 program deployments
│   ├── casper/deployments.json # Casper deployments
│   ├── near/deployments.json   # Curated NEAR account/WASM snapshots
│   └── aptos/                  # Aptos deployment snapshots
│       ├── deployments.json
│       └── multisig-deployments.json
├── abi/
│   ├── aptos/       # Aptos splitter ABI snapshots
│   ├── evm/         # EVM ABI bundles (including the linted B2BSplitterV14 ABI)
│   └── tron/        # Tron ABI bundles when applicable
└── idl/
    ├── solana/      # Solana IDL (splitter-v14 mainnet/devnet)
    ├── aptos/       # Aptos IDL artifacts
    └── casper/      # Casper IDL artifacts
```

这个 [登记册索引](https://npmcn.com/package/%40aifinpay/deployments/registry/splitter/INDEX.md) 链接版本 JSON 记录 和接口指南,以及 [jSON 支付部署 司马](https://npmcn.com/package/%40aifinpay/deployments/src/reference/payment-deployments.schema.json) 描述他们 生态系统特有的记录形状。 产出选择在 [抓取器](https://npmcn.com/package/%40aifinpay/deployments/src/grabber.ts) 财务报告和审定财务报表 [构建 CLI](https://npmcn.com/package/%40aifinpay/deployments/src/build.ts);上游来源 存储在生成的 JSON 而不是这个 README.

Aptos 记录是被整理的软件包数据,而不是 `registry:build`见 [登记指南](https://npmcn.com/package/%40aifinpay/deployments/registry/splitter/aptos/README.md) 用于快照 来源和刷新指令.

NEAR部署记录是被整理的软件包数据,而不是抓取器输出或 方案部署搜索API。 NEAR ABI 文档可通过 `ArtifactRegistry`见 [NER 登记指南](https://npmcn.com/package/%40aifinpay/deployments/registry/splitter/near/README.md) 现场正常化 治理警告 更新指令.

## 出口

### 部署登记册

-   `AifinpayRegistry.loadEvm(version?)` ——加载EVM部署注册(默认:"latest"="1.4")
-   `AifinpayRegistry.loadSolana(version?)` – 加载索拉纳部署登记册(默认:"latest"="1.4")
-   `getEvmDeployment(chainId)` - O(1)通过链式ID查询
-   `getEvmByNetwork(network)` ——按网络名称查询
-   `getSplitterAddress(chainId)`, (中文(简体) ), `getTokenListAddress(chainId)`, (中文(简体) ), `getProfilesAddress(chainId)` - 合同地址
-   `getStablecoins(chainId)` - 稳定币列表
-   `isSettlementEnabled(chainId)` ——有记录的定居旗帜,不是活查
-   `getGovernanceSafe(env)` - 安全的多西格地址
-   `getProdDeployments()`, (中文(简体) ), `getTestnetDeployments()` ——过滤
-   `getSupportedChains(filter?)` ——获得支持链式ID列表(过滤器:"All" QQ"prod" QQ"testnet" QQ"被启用")
-   `getNetworkList(filter?)` 获得带有元数据的网络列表
-   `isChainSupported(chainId)` ——检查是否支持链条
-   `getChainIdByNetwork(network)` ——按名称获得链式ID
-   `getNetworkByChainId(chainId)` ——通过ID获得网络名称
-   `exportAsMarkdown(filter?)`, (中文(简体) ), `exportAsJson(filter?)`, (中文(简体) ), `exportAsCsv(filter?)` - 导出格式

### 人工制品登记处

-   `ArtifactRegistry.load()` - 装载所有ABI/IDL文物
-   `getEvmAbi(contractName, version?)` - EVM ABI (英语)
-   `getSolanaIdl(cluster)` 索拉纳·IDL(主网/德文网)
-   `getCasperIdl(network)` 卡斯珀IDL(主网/测试网)
-   `getAptosIdl(contractName, version?)` - 临时身份证
-   `getTronAbi(contractName, version?)` - Tron ABI (英语)
-   `getNearAbi(contractName, version?)` - NEAR ABI 文档
-   `getAllNearAbis()` - 所有已装入 NEAR ABI 文件

### 后遗症抢夺者(被掠夺)

-   `buildRegistry()` ——获取上游 EVM + Solana 记录(折旧:使用) `AifinpayRegistry.loadEvm()`(中文(简体) )
-   `writeSplitRegistries(registry, outDir)` ——写分块登记文件
-   `grabEvmDeployments()` 编号 : `grabSolanaDeployments()` - 抓住一条链子
-   `getEvmDeployment(registry, chainId)` 编号 : `getSolanaDeployment(registry, cluster)` - O(1) 求助者
-   `isEvmDeployment(d)` 编号 : `isSolanaDeployment(d)` - 类型警卫

### 类型

-   `DeploymentRegistry`, (中文(简体) ), `EcosystemRegistry`, (中文(简体) ), `Deployment`, (中文(简体) ), `EvmDeployment`, (中文(简体) ), `SolanaDeployment`, (中文(简体) ), `Stablecoin`
-   `EvmDeploymentRecord`, (中文(简体) ), `SolanaDeploymentRecord`, (中文(简体) ), `EvmAbiArtifact`, (中文(简体) ), `SolanaIdlArtifact`, (中文(简体) ), `NearAbiArtifact`

## 常见问题

### @aifinpay/deployments 是什么？

AiFinPay SDK和代理护照身份和结算协议的合同部署登记册\.

### 如何安装 @aifinpay/deployments？

在项目目录运行 npm install @aifinpay/deployments，或使用 pnpm add / yarn add / bun add。

### @aifinpay/deployments 支持 TypeScript 吗？

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

### @aifinpay/deployments 支持 ESM 还是 CommonJS？

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

### @aifinpay/deployments 可以商用吗？

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

### @aifinpay/deployments 的下载量有多少？

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

### @aifinpay/deployments 还在维护吗？

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