# @harmoniclabs/uplc 中文文档

规范地址：https://npmcn.com/package/%40harmoniclabs/uplc/

版本：2\.0\.7
npm 元数据更新时间：2026-08-05T13:19:07.734Z
中文译文更新时间：2026-11-17T09:57:25.756Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40harmoniclabs/uplc
原文对照：https://npmcn.com/package/%40harmoniclabs/uplc/?lang=original
项目主页：https://github.com/HarmonicLabs/uplc#readme
源码仓库：https://github.com/HarmonicLabs/uplc

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

- 包体积（解压后）：237 kB，85 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@harmoniclabs/cbor ^2\.0\.2，@harmoniclabs/crypto ^0\.3\.1，@harmoniclabs/plutus-data ^2\.0\.1
- 首次发布：2023-05-01T12:57:53.104Z
- 最新版本发布：2026-08-05T13:19:07.589Z
- 近 30 天下载量：69706（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 8 个）

## 中文简介

[![CI](https://github.com/HarmonicLabs/uplc/actions/workflows/ci.yml/badge.svg)](https://github.com/HarmonicLabs/uplc/actions/workflows/ci.yml)

## 安装

```sh
npm install @harmoniclabs/uplc
```

也可以使用：`pnpm add @harmoniclabs/uplc`、`yarn add @harmoniclabs/uplc`、`bun add @harmoniclabs/uplc`

## README

# @ 谐波板/上方

[![CI](https://github.com/HarmonicLabs/uplc/actions/workflows/ci.yml/badge.svg)](https://github.com/HarmonicLabs/uplc/actions/workflows/ci.yml)

Typescript/Javascript 代表UPLC(未键入的PLutus Core).

## 安装

```bash
npm install @harmoniclabs/uplc
```

## 开始

### 解析序列化 UPLC

剖析并打印出上方的平面六进制( e)[`@harmoniclabs/uint8array-utils`](https://github.com/HarmonicLabs/uint8array-utils) 在每次运行中工作)

```ts
import { fromHex } from "@harmoniclabs/uint8array-utils";
import { parseUPLC, prettyUPLC } from "@harmoniclabs/uplc";

const serialized: Uint8Array = fromHex( "0100003233700900219b8248050005200801" );

const program = parseUPLC( serialized, "flat" );

console.log(
    prettyUPLC(
        program.body, // UPLCTerm 
        4 // indentation spaces
    )
);
/*
expected output:

[
    (lam a 
        [
            [
                (builtin addInteger) 
                (con integer 2)
            ] 
            [
                [
                    (builtin multiplyInteger) 
                    (con integer 10)
                ] 
                a
            ]
        ]
    ) 
    (con integer 4)
]
    
*/
```

### 解析文字 UPLC

```ts
import { parseUPLCText, prettyUPLC } from "@harmoniclabs/uplc";

const uplc_source = `
[
    (lam a 
        [
            [
                (builtin addInteger) 
                (con integer 2)
            ] 
            [
                [
                    (builtin multiplyInteger) 
                    (con integer 10)
                ] 
                a
            ]
        ]
    ) 
    (con integer 4)
]`;

const uplc = parseUPLCText( uplc_source );

// expected output: true
console.log(
    prettyUPLC( uplc, 4 ) === uplc_source
);
```

### 编译 UPLC 为平方字节

```ts
import { toHex } from "@harmoniclabs/uint8array-utils";
import { Application, Builtin, UPLCConst, compileUPLC, UPLCProgram } from "@harmoniclabs/uplc";

const body = new Application(
    new Application(
        Builtin.addInteger,
        UPLCConst.int( 2 )
    ),
    UPLCConst.int( 2 )
);

const compiled = compileUPLC(
    new UPLCProgram(
        [1,0,0],
        body
    )
).toBuffer().buffer;

console.log( toHex( compiled ) );// expected output: "01000033700900224009"
```

## 常见问题

### 如何安装 @harmoniclabs/uplc？

在项目目录运行 npm install @harmoniclabs/uplc，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@harmoniclabs/cbor（^2\.0\.2）、@harmoniclabs/crypto（^0\.3\.1）、@harmoniclabs/plutus-data（^2\.0\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @harmoniclabs/uplc 支持 TypeScript 吗？

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

### @harmoniclabs/uplc 支持 ESM 还是 CommonJS？

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

### @harmoniclabs/uplc 可以商用吗？

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

### @harmoniclabs/uplc 的下载量有多少？

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

### @harmoniclabs/uplc 还在维护吗？

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

