# @fairmint/wrapped-assets-daml-js 中文文档

规范地址：https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/

版本：0\.0\.27
npm 元数据更新时间：2026-10-27T22:20:36.029Z
中文译文更新时间：2026-11-14T09:05:31.064Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40fairmint/wrapped-assets-daml-js
原文对照：https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/?lang=original
项目主页：https://github.com/Fairmint/canton-assets#readme
源码仓库：https://github.com/Fairmint/canton-assets

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

- 包体积（解压后）：290 kB，153 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@daml/types 3\.5\.2，@daml/ledger 2\.10\.4
- 首次发布：2026-08-11T22:41:36.493Z
- 最新版本发布：2026-10-27T22:20:35.846Z
- 近 30 天下载量：11688（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

SrappedAssets-v01 DAML合同与生成的JavaScript/TypeScript绑定(Canton Token Standard 控股,薄荷/燃烧,遵守执行,BurnOffer赎回).

## 安装

```sh
npm install @fairmint/wrapped-assets-daml-js
```

也可以使用：`pnpm add @fairmint/wrapped-assets-daml-js`、`yarn add @fairmint/wrapped-assets-daml-js`、`bun add @fairmint/wrapped-assets-daml-js`

## README

# 州资产

Apache-2.0 存储器 `WrappedAssets-v01` DAML 一揽子计划——储备后持有 执行Canton Token标准V1(持有、燃烧-薄荷、转移和分配接口), 转让代理履约执法(冻结/暂停)和追回. 控股需要不同的经营者和转移代理签名(双方授权).

已发布 npm 绑定 : **`@fairmint/wrapped-assets-daml-js`** (只生成JS/TS——不是 应用程序 SDK)。 第一个真正的释放是 `0.0.1` (npm占位符为: `0.0.0`) (中文(简体) ).

关于合同结构、赎回和票据暂停,见 [`docs/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/README.md)。 。 。 .

## 安装联署材料装订

```bash
npm install @fairmint/wrapped-assets-daml-js
```

同伴依赖性 : `@daml/types@3.5.2` 财务报告和审定财务报表 `@daml/ledger@2.10.4` (也列为运行时间) 方便的依赖性).

```ts
import { WRAPPED_ASSETS_TEMPLATES, WrappedAssets, Splice } from '@fairmint/wrapped-assets-daml-js';

console.log(WRAPPED_ASSETS_TEMPLATES.burnMintFactory);
```

最小薄荷-执行/释放或 `BurnOffer.Accept` 样本 : [`examples/mint-burn/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/examples/mint-burn/)。 。 。 .

## 登记册 SDK

上面产生的捆绑是DAR的机械翻译,里面没有意见. **[`@fairmint/wrapped-assets-sdk`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/packages/sdk/)** 是有观点的包装:它回答 Canton Network Token Standard的登记问题——票据、转让和分配 从三个分类账看 `RegistryLedger` 端口,所以 模板匹配, 十进制供应和暂停规则在一个地方而不是每个地方 为他们服务的服务器。 它作为第二个包从这个寄存器,单独版本.

SDK 从已公布的模板标识符、选择名称和选择参数形状取出 `@fairmint/wrapped-assets-daml-js@0.0.2` 束缚而不是重复,所以它跟踪准确 登记工厂、仪器暂停和遵守执行 包含。 呼叫者注入一个 `RegistryLedger` 或鸭型JSON API读取器(`getActiveContracts` + 键 `getEventsByContractId`) (中文(简体) ). 读取 CIP-56 结果,使用 `@fairmint/canton-node-sdk` (或另一个) 客户端)与此软件包 `CHOICES` 编号 : `TEMPLATE_IDS`。 。 。 .

## 版式

-   [`docs/contract-overview.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/contract-overview.md) - 结构模板/选择图 工作流程图
-   [`docs/redeem.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/redeem.md) - 业主通过 `BurnOffer`
-   [`docs/instrument-pause.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/instrument-pause.md) - 暂停门和复原道
-   [`docs/cns-register.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/cns-register.md) - 南澳大利亚/南澳大利亚 `registryUrls` 干燥和调度
-   [`docs/csol.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/csol.md) ——公开cSOL文书页大纲(征求意见稿)
-   [`docs/csol-hosting.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/csol-hosting.md) - GitHub 页面 / `csol.canton.fairmint.com` 设置
-   [`docs/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/docs/README.md) ——文件索引
-   [`site/csol/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/site/csol/) ——静态Vite + 反应 cSOL 的公共页面
-   [`WrappedAssets-v01/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/WrappedAssets-v01/) - Token标准V1合同
-   [`Test/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/Test/) - 模拟Daml脚本测试
-   [`test/localnet/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/test/localnet/) ——活体引导器融合测试
-   [`examples/mint-burn/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/examples/mint-burn/) - 联合来文装订样本
-   [`packages/sdk/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/packages/sdk/) —— 说 `@fairmint/wrapped-assets-sdk`,登记SDK
-   [`dars/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/dars/) - 备份的DARs(`dars.lock` (为正直起见)
-   [`generated/`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/generated/) ——构建/代码输出(不是手版)
-   [`multi-package.yaml`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/multi-package.yaml) ——活套件图

## 构建和测试

```bash
npm install
npx canton-dev-tools install-dpm-sdks
export PATH="$HOME/.dpm/bin:$PATH"

npm run lint
npm run build
npm test
npm run codegen
npm run verify-package
npm run typecheck:sample
```

`npm test` 两个套房: `test:daml` ( Daml 脚本, 需要) `dpm`) 那么,(笑声) `test:sdk` (单位:千美元)`node:test` 结束 `packages/sdk`不需要Java或Daml SDK。 CI把他们作为单独的工作来经营.

`npm run build` 通过包件默认值获取被绑定的 Splice 接口 DARs `@fairmint/canton-dev-tools` 在编译之前 `dpm`. 本地网络运行时间 Splice/ quickstart pins 也住在那个包裹里 可选的转基因 `splice-dars.json` 当 需要帮助.

通用 DAML- JS 代码( 常规 DAML )`codegen-js`, (中文(简体) ), `bundle-dependencies`, (中文(简体) ), `create-root-index`包裹盖章, 倒塌 - 明显,准备 - 释放) `@fairmint/canton-dev-tools`套装和 合并已发布 `lib/` (包括 `WRAPPED_ASSETS_TEMPLATES`在 repo-root 中配置 `daml-js-bundle.json`。这种回购保留特定产品的核查清单和样品.

发表于 `main` 使用 GitHub 动作 OIDC 信任的出版(`publish.yml`页:1 `NPM_TOKEN` 在出版步骤上.

## 地方网一体化

直播测试 上传已建 DAR 和烟雾 `WrappedAssetsBurnMintFactory` 在州地方网络上 (需要鼠标; 第一次开始~10–15分钟):

```bash
npm run build
npm run localnet:verify
```

本地网络生命周期和DAML 软件包工具来自 [`@fairmint/canton-dev-tools`](https://github.com/Fairmint/canton-dev-tools)。这repo的套房 声称在 [`test/localnet/README.md`](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/test/localnet/README.md)。 。 。 .

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://npmcn.com/package/%40fairmint/wrapped-assets-daml-js/LICENSE)。 。 。 .

## 常见问题

### @fairmint/wrapped-assets-daml-js 是什么？

SrappedAssets-v01 DAML合同与生成的JavaScript/TypeScript绑定\(Canton Token Standard 控股,薄荷/燃烧,遵守执行,BurnOffer赎回\)\.

### 如何安装 @fairmint/wrapped-assets-daml-js？

在项目目录运行 npm install @fairmint/wrapped-assets-daml-js，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@daml/types（3\.5\.2）、@daml/ledger（2\.10\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fairmint/wrapped-assets-daml-js 支持 TypeScript 吗？

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

### @fairmint/wrapped-assets-daml-js 支持 ESM 还是 CommonJS？

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

### @fairmint/wrapped-assets-daml-js 可以商用吗？

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

### @fairmint/wrapped-assets-daml-js 的下载量有多少？

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

### @fairmint/wrapped-assets-daml-js 还在维护吗？

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

