菜单
Trade RGB assets on Bitcoin Lightning using the KaleidoSwap protocol. Use when quoting a swap, executing an atomic swap, placing a REST order, checking order status, or managing open orders. Requires kaleidoswap-mcp and wdk-wallet-rln-mcp.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/kaleidoswap/kaleido-agent --skill kaleidoswap命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | kaleidoswap |
| description | Trade RGB assets on Bitcoin Lightning using the KaleidoSwap protocol. Use when quoting a swap, executing an atomic swap, placing a REST order, checking order status, or managing open orders. Requires kaleidoswap-mcp and wdk-wallet-rln-mcp. |
| license | Apache-2.0 |
| metadata | {"author":"kaleidoswap","version":"1.1","networks":"bitcoin-lightning, rgb"} |
KaleidoSwap is a non-custodial DEX for RGB assets on Bitcoin Lightning Network. Trades are settled via atomic HTLC swaps or REST deposit-based orders.
asset_id (BTC or rgb:...). Discover via kaleidoswap_get_assets() — never hard-code IDs.kaleidoswap_get_pairs() to find trading pairs and their routes (each route has from_layer/to_layer). Always use layer values from here.get_quote tool: pass display units (human-readable):
0.001 = 100,000 sats). Internally msat (precision=11).65.0 USDT with precision=6, 1.0 XAUT with precision=9).atomic_init: use amount_raw from the quote response directly.raw / 10^precision.kaleidoswap_get_pairs()
→ [{
base: { ticker, precision },
quote: { ticker, precision },
routes: [{ from_layer, to_layer }] ← use these layer values
}]
kaleidoswap_get_assets()
→ [{ ticker, asset_id, precision, name }] ← resolve asset_id by ticker
Example — swap BTC→USDT on Lightning:
base.ticker="BTC" and quote.ticker="USDT"{ from_layer: "BTC_LN", to_layer: "RGB_LN" }USDT asset_id from assets listkaleidoswap_get_quote({
from_asset_id: "BTC",
from_layer: "BTC_LN",
from_amount: 0.001, // display BTC (= 100,000 sats = 100M msat internally)
to_asset_id: "<USDT_ID>",
to_layer: "RGB_LN"
})
→ {
rfq_id, expires_at,
from_asset: { ticker, layer, amount_raw, amount_display },
to_asset: { ticker, layer, amount_raw, amount_display },
price
}
Show the user: amount in → amount out → effective rate. Ask confirmation before executing.
1. kaleidoswap_atomic_init({
rfq_id,
from_asset_id,
from_amount_raw, // = quote.from_asset.amount_raw
to_asset_id,
to_amount_raw // = quote.to_asset.amount_raw
})
→ { swapstring, payment_hash }
2. wdk_atomic_taker({ swapstring })
→ {} (whitelist HTLC on RLN node — MUST happen before execute)
3. wdk_get_node_info()
→ { pubkey } (needed as taker_pubkey)
4. kaleidoswap_atomic_execute({
swapstring, taker_pubkey: pubkey, payment_hash
})
→ { status, message }
5. kaleidoswap_atomic_status({ payment_hash })
→ { swap: { status: "Waiting"|"Pending"|"Succeeded"|"Expired"|"Failed" } }
Poll every 2s until terminal state.
If Succeeded → done. If Expired/Failed → fall back to REST.
BTC → RGB (e.g. BTC → USDT):
1. wdk_create_rgb_invoice({ asset_id: <USDT_ID> }) → rgb_invoice
2. kaleidoswap_place_order({
from_asset_id, to_asset_id, from_layer, to_layer, from_amount,
receiver_address: rgb_invoice, receiver_address_format: "RGB_INVOICE"
}) → { order_id, deposit_address: { address: bolt11 } }
3. wdk_pay_invoice({ invoice: bolt11 })
4. Poll kaleidoswap_get_order_status({ order_id }) until "FILLED"
RGB → BTC (e.g. USDT → BTC):
1. wdk_create_ln_invoice({ amount_msat }) → bolt11
2. kaleidoswap_place_order({ ..., receiver_address: bolt11, receiver_address_format: "BOLT11" })
→ { order_id, deposit_address: { address: rgb_invoice } }
3. wdk_send_asset({ asset_id, recipient_id: rgb_invoice, amount: display_amount })
4. Poll kaleidoswap_get_order_status({ order_id }) until "FILLED"
Order states: OPEN → PENDING_PAYMENT → PAID → EXECUTING → FILLED | EXPIRED | FAILED
kaleidoswap_get_pairs() gives valid layers and min amounts.rfq_id.get_pairs() before quoting.rfq_id has expired.