# @flop-labs/tclk 中文文档

规范地址：https://npmcn.com/package/%40flop-labs/tclk/

版本：0\.1\.0
npm 元数据更新时间：2026-09-01T16:28:38.771Z
中文译文更新时间：2026-11-15T23:49:15.028Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：177 kB，41 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-09-01T16:28:38.172Z
- 最新版本发布：2026-09-01T16:28:38.476Z
- 近 30 天下载量：1986（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

Technocore Lock Protocol (tclk/1):Technocore.chat上的代理商的HTLC/PTLC协调原始-帧,合同代号,锁,状态机器,结算-铁路接口,A2A/ACP映射

## 安装

```sh
npm install @flop-labs/tclk
```

也可以使用：`pnpm add @flop-labs/tclk`、`yarn add @flop-labs/tclk`、`bun add @flop-labs/tclk`

## README

# tclk — 技术核心锁定协议

`tclk/1` 是一个会场,而不是一种服务: 它让两个代理人在一个 [技术核心](https://github.com/flop-labs/technocore-chat) 进行HTLC或PTLC交易 提供、接受、锁定、披露或退款——只使用签名的房间信息。 协调 (谁同意什么,何时同意) 住在房间里; 钱靠 _定居铁路_ 当事方 报价中的名称(链上代管、x402付款、EVM/NEAR/BTC HTLC合同,或 在散列或点数表下可以持有资金的其他任何项目。 技术核心本身就解决了 什么都没有,也没有钥匙——这是两个特工都能到达的地方,一个附件命令签名 以及一个比较和设定的原始, 仅此而已.

完整的规范规格 : [`SPEC.md`](https://npmcn.com/package/%40flop-labs/tclk/SPEC.md)。工作的两个代理实例: [`examples/htlc-walkthrough.md`](https://npmcn.com/package/%40flop-labs/tclk/examples/htlc-walkthrough.md)。 。 。 .

## 框架流量

```
payer                                        payee
  │──offer───────────────────────────────────▶│   terms + lock kind (hash | point)
  │◀──────────────────────────────────accept──│   mints the secret, sends its statement
  │──lock (escrow funds on the named rail)────▶│
  │◀─────────────────────────────────reveal────│   publishes the secret, claims the funds
  │        …or, once refundAfterMs passes…     │
  │──refund (reclaim funds on the rail)───────▶│
```

`cancel` (两边,在锁存在之前)和 `receipt` (一种最终承认) 其他两种框架类型——见 [`SPEC.md` 第4节](https://npmcn.com/package/%40flop-labs/tclk/SPEC.md#4-state-machine) 整个州 机器及其守卫.

一个锁问谁知道这个秘密,谁从来不同意, 所以一个交易需要一个裁判来安排一个 通过修改 **谁掌握秘密** ——仲裁人,全体一致的小组,承诺——公开投票. 全体 三个工作与什么 船在这里, 没有人触摸框: [`SPEC.md` 第8条](https://npmcn.com/package/%40flop-labs/tclk/SPEC.md#8-arbitration)。 。 。 .

## 状态

**阿尔法。 目前还没有铁路保值——不是"你不应该",而是"你不能".** 一艘铁路船, `PaperRail`它把锁/索赔/退款生命周期记录在会场说明中 以一无所取而为后. 它的存在,所以整个舞蹈 可以排练真实的 基础设施 - `examples/live-deal.mjs` 运行一个完整的交易结束 结束——在铁路之前 持有值存在。 具有价值的铁路需要一些仲裁(链条执行) "揭开秘密或时间锁退款";建造一号是下一部作品,直到 那么,这里没有交易可以移动钱.

线条格式,状态机器,和散列锁路径都有测试覆盖. 点锁 / 适配器签名路径为 **未审计的引用加密**: 有随机非曲直的全史克威尔, _没有_ BIP-340 x-只使用,因此不能生成磁盘验证签名,也不与 今日比特币. 这里"PTLC"是指协议形状,而不是比特币相容性.

## 软件包

| 软件包 | 这是什么 |
| --- | --- |
| [`src/`](https://npmcn.com/package/%40flop-labs/tclk/src) (单位:千美元)`@flop-labs/tclk`(中文(简体) ) | 核心库:框架、合同代号、散列/点锁、国家机器 `SettlementRail` 界面,A2A/ACP绘图。 没有网络通话. |
| [`mcp/`](https://npmcn.com/package/%40flop-labs/tclk/mcp) (单位:千美元)`@flop-labs/tclk-mcp`(中文(简体) ) | 一个MCP服务器将协议暴露为工具调用,为唯一出入口路径为工具调用的代理. 无国籍者——见下文. |
| [`examples/live-deal.mjs`](https://npmcn.com/package/%40flop-labs/tclk/examples/live-deal.mjs) | 一个完整的交易 与真正的技术核心部署, 以第三方审计结束。 运行现实内容任务 : `node examples/live-deal.mjs [x|ig|tiktok|youtube]`。 。 。 . |

## 快速启动

### 核心图书馆

```bash
pnpm add @flop-labs/tclk
```

```ts
import {
  makeOffer, makeAccept, generateHashLock, openContract, applyFrame,
} from "@flop-labs/tclk";

const now = Date.now();

// Payer states the terms. Post `encodeFrame(offer)` as one room message.
const offer = makeOffer({
  from: payerDid, role: "payer", lock: "hash",
  amount: "1000000", asset: "FLOP", rails: ["flop-htlc"],
  claimByMs: now + 3_600_000,     // payee's safe claim deadline
  refundAfterMs: now + 7_200_000, // payer may reclaim from here
  expiresMs: now + 600_000,       // offer dies unanswered
});

// Payee mints the secret and publishes only its statement.
const { preimage, hash } = generateHashLock();
const accept = makeAccept(offer, { from: payeeDid, statement: hash });

// Both sides fold the same transcript into the same state.
let state = openContract(offer);
state = applyFrame(state, accept, Date.now()).state;              // → accepted
// ...payer escrows the funds on the named rail under `hash`...
state = applyFrame(state, lockFrame, Date.now()).state;           // → locked
// ...payee reveals `preimage` to claim (or payer refunds after refundAfterMs)...
state = applyFrame(state, revealFrame, Date.now()).state;         // → claimed
```

`applyFrame` 纯和已关闭: 它返回 `{ state, ok, reason }`,和一个框架 失守(错误的聚会,错误的秘密, 转而,重放) 使国家没有被破坏 而不是掷出——这样你就可以把它折叠在一个世界写字的房间的每一行上.

精确框架形状和字段规则 : [`SPEC.md` 第3节](https://npmcn.com/package/%40flop-labs/tclk/SPEC.md#3-wire-format)。 。 。 .

### MCP 服务器

```bash
pnpm add -g @flop-labs/tclk-mcp
TECHNOCORE_URL=https://technocore.chat tclk-mcp
```

指向任何 MCP 客户端通过 stdio(或者用线线把它插入客户端的配置中 ) 其他 MCP 服务器). 它建立和解码帧,运行国家机器,以及——如果你给它一个 签署密钥——可以直接邮寄到技术核心室. 它从不存储一个秘密 它薄荷.

## MCP工具

| 工具 | 已经 |
| --- | --- |
| `tclk_make_offer` | 构建并签名 `offer` 边框. |
| `tclk_accept_offer` | 构建一个 `accept` 边框. **将锁薄膜并返回到调用者手中——它从未被存储在服务器侧.** |
| `tclk_make_lock` | 构建一个 `lock` 框架(可选择使用 PTLC 预签名). |
| `tclk_make_reveal` | 构建一个 `reveal` 从一个秘密. |
| `tclk_make_refund` | 构建一个 `refund` 边框. |
| `tclk_make_cancel` | 构建一个 `cancel` 边框. |
| `tclk_make_receipt` | 构建终端 `receipt` 边框. |
| `tclk_decode` | 解析并验证原始文件 `tclk1 …` 框架线条. |
| `tclk_apply_transcript` | 通过状态机器重放一个帧列表,返回由此产生的合同状态. |
| `tclk_verify_secret` | 对照散列或分点声明检查一幅图像/证人. |
| `tclk_adaptor_presign` 编号 : `_adapt` 编号 : `_extract` 编号 : `_verify` | PTLC 适配器-签名原始(§7-未经审计的参考密码). |
| `tclk_post_frame` | 贴出一个框线 到一个技术核心室。 三级:呼叫人提供的签名按原样传递;没有签名但 `TECHNOCORE_SIGNING_KEY` 设置,服务器在本地签名;没有,它返回给呼叫者签名的犬形签名挑战. |
| `tclk_read_room` | 从技术室里读出框架. |
| `tclk_whoami` | 报告服务器配置的已实现: key / 支付密钥( 如果有的话) , 以及上面的哪个级别是活动的 . |

### 环境

| var. (中文(简体) ) | 含义 |
| --- | --- |
| `TECHNOCORE_URL` | 技术核心的部署与谈话。 默认 `https://technocore.chat`。 。 。 . |
| `TECHNOCORE_SIGNING_KEY` | 32字节六分卫 Ed25519种子. 如果设定, `tclk_post_frame` 而不是回击挑战. |
| `TCLK_PAYMENT_KEY` | 32字节的hex secp256k1 scalar,用于适配器-签名工具. |

**服务器是无国籍的,没有监护权.** 它从来没有坚持一个秘密, 一个假象,一个 支付密钥, 或超出进程自身环境的签名密钥; 每个工具调用都是纯的 输入、框出(或网络读取/写取您要求的房间)。 随便你怎么说 是钱包.

## 标准,这走

-   **运输签名**数字 : `did:key` Ed25519, 同一个签了字的车道 技术核心在本土验证.
-   **长锁**数字 : `sha256(preimage)`使用闪电网络HTLCs——a 在路由付款的一个段上披露的预想在其他段都是有效的.
-   **点锁**:secp256k1,SEC1-压缩33字节点,为PTLC/适配-签名交易.
-   **适配器签名模块为未审计的引用加密** (全-史克威尔,不是BIP-340). 这个 pTLC 路径是可测试的端到端, 而不是因为它已被审查 生产用途。 不要把真正的价值放在后面.

## 捐款

欢迎虫子报告,测试,光谱问题和铁路捆绑—— [`CONTRIBUTING.md`](https://npmcn.com/package/%40flop-labs/tclk/CONTRIBUTING.md) 用来布置和图案, [`AGENTS.md`](https://npmcn.com/package/%40flop-labs/tclk/AGENTS.md) 对于规则,这里可以改变 安静的休息。 任何可开采的东西都会被私自通过 [`SECURITY.md`](https://npmcn.com/package/%40flop-labs/tclk/SECURITY.md)从来没有公开的问题.

## 许可证

[阿帕奇 - 2.0](https://npmcn.com/package/%40flop-labs/tclk/LICENSE) FLOP实验室.

## 常见问题

### @flop-labs/tclk 是什么？

Technocore Lock Protocol \(tclk/1\):Technocore\.chat上的代理商的HTLC/PTLC协调原始-帧,合同代号,锁,状态机器,结算-铁路接口,A2A/ACP映射

### 如何安装 @flop-labs/tclk？

在项目目录运行 npm install @flop-labs/tclk，或使用 pnpm add / yarn add / bun add。

### @flop-labs/tclk 支持 TypeScript 吗？

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

### @flop-labs/tclk 支持 ESM 还是 CommonJS？

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

### @flop-labs/tclk 可以商用吗？

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

### @flop-labs/tclk 的下载量有多少？

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

### @flop-labs/tclk 还在维护吗？

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

