@flop-labs/tclk

中文文档
0.1.0发布于 2026/09/02Apache-2.0TypeScriptES Module近 30 天下载 1986

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

中文使用文档
文档目录11 节
  1. 框架流量
  2. 状态
  3. 软件包
  4. 快速启动
  5. 核心图书馆
  6. MCP 服务器
  7. MCP工具
  8. 环境
  9. 标准,这走
  10. 捐款
  11. 许可证

tclk — 技术核心锁定协议

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

完整的规范规格 : SPEC.md。工作的两个代理实例: 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节 整个州 机器及其守卫.

一个锁问谁知道这个秘密,谁从来不同意, 所以一个交易需要一个裁判来安排一个 通过修改 谁掌握秘密 ——仲裁人,全体一致的小组,承诺——公开投票. 全体 三个工作与什么 船在这里, 没有人触摸框: SPEC.md 第8条。 。 。 .

状态

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

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

软件包

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

快速启动

核心图书馆

pnpm add @flop-labs/tclk
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节。 。 。 .

MCP 服务器

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 编号 : _verifyPTLC 适配器-签名原始(§7-未经审计的参考密码).
tclk_post_frame贴出一个框线 到一个技术核心室。 三级:呼叫人提供的签名按原样传递;没有签名但 TECHNOCORE_SIGNING_KEY 设置,服务器在本地签名;没有,它返回给呼叫者签名的犬形签名挑战.
tclk_read_room从技术室里读出框架.
tclk_whoami报告服务器配置的已实现: key / 支付密钥( 如果有的话) , 以及上面的哪个级别是活动的 .

环境

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

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

标准,这走

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

捐款

欢迎虫子报告,测试,光谱问题和铁路捆绑—— CONTRIBUTING.md 用来布置和图案, AGENTS.md 对于规则,这里可以改变 安静的休息。 任何可开采的东西都会被私自通过 SECURITY.md从来没有公开的问题.

许可证

阿帕奇 - 2.0 FLOP实验室.

版本与发布记录

@flop-labs/tclk 共发布 1 个版本,首次发布于 2026/09/02;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.1.0latest2026/09/022 个月前

关于 @flop-labs/tclk 的常见问题

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