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 编号 : _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:keyEd25519, 同一个签了字的车道 技术核心在本土验证. - 长锁数字 :
sha256(preimage)使用闪电网络HTLCs——a 在路由付款的一个段上披露的预想在其他段都是有效的. - 点锁:secp256k1,SEC1-压缩33字节点,为PTLC/适配-签名交易.
- 适配器签名模块为未审计的引用加密 (全-史克威尔,不是BIP-340). 这个 pTLC 路径是可测试的端到端, 而不是因为它已被审查 生产用途。 不要把真正的价值放在后面.
捐款
欢迎虫子报告,测试,光谱问题和铁路捆绑—— CONTRIBUTING.md
用来布置和图案, AGENTS.md 对于规则,这里可以改变
安静的休息。 任何可开采的东西都会被私自通过
SECURITY.md从来没有公开的问题.
许可证
阿帕奇 - 2.0 FLOP实验室.