@harmoniclabs/uplc

中文文档
2.0.7发布于 2026/08/05Apache-2.0TypeScriptCommonJS近 30 天下载 7万

CI

原始使用文档
文档目录5 节
  1. Install
  2. Getting started
  3. parse serialized UPLC
  4. parse textual UPLC
  5. compile UPLC to flat bytes

@harmoniclabs/uplc

CI

Typescript/Javascript representation of UPLC (Untyped PLutus Core).

Install

npm install @harmoniclabs/uplc

Getting started

parse serialized UPLC

parse and print uplc form flat hex (@harmoniclabs/uint8array-utils works in every js runtime)

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)
]
    
*/

parse textual UPLC

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

compile UPLC to flat bytes

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 共发布 19 个版本,首次发布于 2023/05/01;过去 12 个月发布了 8 个版本。

版本发布日期距今
2.0.7latest2026/08/053 个月前
2.0.62026/03/178 个月前
2.0.52026/03/138 个月前
2.0.42026/03/138 个月前
2.0.32026/03/128 个月前
2.0.22026/03/128 个月前

关于 @harmoniclabs/uplc 的常见问题

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