@aifinpay/deployments

中文文档
2.1.5发布于 2026/11/02MITTypeScriptES Module零依赖近 30 天下载 3481

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

中文使用文档
文档目录10 节
  1. 部署登记册和文物管理员
  2. 快速启动
  3. 证据和可用性
  4. 登记册抓取器(遗产)
  5. 书记官处布局
  6. 出口
  7. 部署登记册
  8. 人工制品登记处
  9. 后遗症抢夺者(被掠夺)
  10. 类型

@aifinpay/部署

部署登记册和文物管理员

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

快速启动

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");

见 用户 用于完整文档.

证据和可用性

使用 登记册索引 选择实际 所需生态系统、版本、链条和路线的机器可读记录. 地址、程序ID、运行时间散列、治理和出处属于 这些记录,不复制表在这里.

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


登记册抓取器(遗产)

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

  • EVM v1.4 : (中文(简体) ) registry/splitter/evm/v1.4/deployments.json
  • 索拉纳 v1.4: registry/splitter/solana/deployments.json
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

这个 登记册索引 链接版本 JSON 记录 和接口指南,以及 jSON 支付部署 司马 描述他们 生态系统特有的记录形状。 产出选择在 抓取器 财务报告和审定财务报表 构建 CLI;上游来源 存储在生成的 JSON 而不是这个 README.

Aptos 记录是被整理的软件包数据,而不是 registry:build见 登记指南 用于快照 来源和刷新指令.

NEAR部署记录是被整理的软件包数据,而不是抓取器输出或 方案部署搜索API。 NEAR ABI 文档可通过 ArtifactRegistry见 NER 登记指南 现场正常化 治理警告 更新指令.

出口

部署登记册

  • 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 共发布 9 个版本,首次发布于 2026/09/16;过去 12 个月发布了 9 个版本。

版本发布日期距今
2.1.5latest2026/11/025 天前
2.1.42026/11/016 天前
2.1.32026/10/317 天前
2.1.12026/10/317 天前
2.1.02026/10/2019 天前
1.1.42026/10/0929 天前

关于 @aifinpay/deployments 的常见问题

@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 和提交记录判断。