关于 styx
Styx skill 通过流动性池将 Bitcoin 主网 BTC 转换为 Stacks 二层的 sBTC，使用 `@faktoryfun/styx-sdk`。面向需要管理存款、签名广播交易并追踪状态的 Agent。
主要功能
- 01查询池流动性与配置
- 02创建存款预留并准备交易
- 03本地签名并广播 Bitcoin 交易
- 04按存款 ID 或交易 ID 查询状态
- 05查看 Stacks 地址的存款历史
适用场景
- 01检查池容量后发起 BTC 存款
- 02跟踪存款确认及 sBTC 铸造状态
- 03查询地址过往存款记录
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/styx确认已加载。
附带文件AGENT.mdstyx.ts
详细介绍
Styx 技能
通过 FaktoryFun 的 Styx 协议，以无需信任的方式将 BTC 转换为 sBTC。Agent 在 L1 上存入 BTC，并通过托管流动性池在 Stacks L2 上获得 sBTC。使用 @faktoryfun/styx-sdk。
工作原理
- 检查池流动性 —
pool-status显示池中可用的 sBTC - 创建存款预留 —
deposit预留池流动性并返回存款 ID - 构建并签名交易 — SDK 提供 UTXO 和存款地址；Agent 使用
@scure/btc-signer在本地构建并签名 - 广播 — 已签名的交易会广播到 mempool.space
- 跟踪状态 —
status会持续跟踪存款，直至确认
池
| 池 ID | 类型 | 最低存款额 | 最高存款额 | 兑换类型 |
|---|---|---|---|---|
main | 传统型 | 10,000 sats | 300,000 sats | sbtc, usda, pepe |
aibtc | AI BTC | 10,000 sats | 1,000,000 sats | sbtc, aibtc |
子命令
pool-status
bun run styx/styx.ts pool-status [--pool main|aibtc]
返回 realAvailable、estimatedAvailable（BTC）和 lastUpdated。
pools
bun run styx/styx.ts pools
列出所有可用池及其配置和启用状态。
fees
bun run styx/styx.ts fees
返回当前 Bitcoin 网络费用估算值（低／中／高，单位为 sat/vB）。
price
bun run styx/styx.ts price
返回当前 BTC 对 USD 的价格。
deposit
bun run styx/styx.ts deposit --amount <sats> --stx-receiver <addr> --btc-sender <addr> [--pool main|aibtc] [--fee low|medium|high]
完整的无头存款流程：创建预留、准备 PSBT、使用钱包密钥签名、广播到 mempool.space，并更新存款状态。需要已解锁的钱包。
status
bun run styx/styx.ts status --id <deposit-id>
bun run styx/styx.ts status --txid <btc-txid>
按存款 ID 或 Bitcoin 交易 ID 检查存款状态。
history
bun run styx/styx.ts history --address <stx-addr>
获取 Stacks 地址的存款历史记录。
存款状态
initiated— 已创建存款记录并预留流动性broadcast— Bitcoin 交易已广播到内存池processing— 已获得至少 1 次 BTC 确认confirmed— 已达到所需确认数，sBTC 已铸造refund-requested— 用户已请求退款canceled— 存款已取消，流动性已释放
说明
- 存款前务必检查
pool-status，确认流动性充足 - 广播后更新存款状态至关重要，可确保池的账目准确
- 最低存款额：10,000 sats（0.0001 BTC）。最高存款额因池而异。
- SDK 使用为 Styx 后端预先配置的 API 密钥
评论
支持 Markdown