jingswap について
jingswapは、Stacks上でsBTCと見積もりトークンを交換するブラインド一括オークション向けのコマンドラインスキルです。STXとUSDCxの市場に対応し、情報照会から入金、取消、決済まで行えます。
主な機能
- 01オークション周期の状態と履歴の確認
- 02入金者とユーザー入金の確認
- 03決済詳細とユーザー活動の確認
- 04PythとDEX価格の照会
- 05トークンの入金と取消
- 06周期の終了、決済、取消
活用シーン
- 01現在のオークション段階と最低額の確認
- 02周期ごとのユーザー入金の確認
- 03sBTCとSTXまたはUSDCxの交換への参加
- 04価格確認とオークション周期の決済
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aibtcdev/ skills --skill jingswapインストール後、Claude Code で/jingswapを入力して読み込まれたか確認します。
同梱ファイルAGENT.mdjingswap.ts
詳細
Jingswap スキル
Stacks 上で sBTC とクォートトークンを交換するためのブラインド一括オークションです。利用可能なマーケットは 2 つです。
| マーケット | コントラクト | クォートトークン |
|---|---|---|
sbtc-stx(デフォルト) | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-stx-jing | STX |
sbtc-usdcx | SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.sbtc-usdcx-jing | USDCx |
各オークションサイクルには、入金、バッファー、決済の 3 つのフェーズがあります。どちらの側にも入金することで誰でも参加でき、誰でもクローズ/決済/キャンセルへの遷移を実行できます。
使用方法
bun run jingswap/jingswap.ts <subcommand> [--market <pair>] [options]
すべてのコマンドで --market sbtc-stx(デフォルト)または --market sbtc-usdcx を指定できます。
サブコマンド
cycle-state
現在のオークションサイクルの状態(フェーズ、経過ブロック数、合計額、最小額)を取得します。
bun run jingswap/jingswap.ts cycle-state --market sbtc-usdcx
depositors
サイクルのクォートトークンおよび sBTC の入金者を取得します。
bun run jingswap/jingswap.ts depositors --cycle <number> --market sbtc-stx
user-deposit
サイクルにおけるユーザーの入金額を取得します。
bun run jingswap/jingswap.ts user-deposit --cycle <number> --address <stx_address>
settlement
完了したサイクルの決済詳細を取得します。
bun run jingswap/jingswap.ts settlement --cycle <number>
cycles-history
すべてのオークションサイクルの全履歴を取得します。
bun run jingswap/jingswap.ts cycles-history --market sbtc-usdcx
user-activity
ユーザーのオークションアクティビティ(入金、キャンセル、約定、繰り越し)を取得します。
bun run jingswap/jingswap.ts user-activity --address <stx_address> --market sbtc-usdcx
prices
オラクルと DEX の価格(Pyth、XYK プール、DLMM)を取得します。
bun run jingswap/jingswap.ts prices
deposit-stx
クォートトークン(マーケットに応じて STX または USDCx)を現在のオークションサイクルに入金します。入金フェーズ中のみ実行できます。
bun run jingswap/jingswap.ts deposit-stx --amount 10 --market sbtc-usdcx
deposit-sbtc
sBTC(サトシ単位)を現在のオークションサイクルに入金します。入金フェーズ中のみ実行できます。
bun run jingswap/jingswap.ts deposit-sbtc --amount 10000 --market sbtc-usdcx
cancel-stx
クォートトークンの入金をキャンセルして返金を受け取ります。入金フェーズ中のみ実行できます。
bun run jingswap/jingswap.ts cancel-stx --market sbtc-usdcx
cancel-sbtc
sBTC の入金をキャンセルして返金を受け取ります。入金フェーズ中のみ実行できます。
bun run jingswap/jingswap.ts cancel-sbtc
close-deposits
入金フェーズを終了します(最低 150 ブロックが経過し、両方の側が最小額を超えている必要があります)。
bun run jingswap/jingswap.ts close-deposits --market sbtc-usdcx
settle
保存済みの Pyth 価格を使用して決済します(無料)。価格が古いため通常は失敗します。settle-with-refresh の使用を推奨します。
bun run jingswap/jingswap.ts settle
settle-with-refresh
最新の Pyth VAA を使用して決済します(約 2 uSTX)。推奨される決済方法です。
bun run jingswap/jingswap.ts settle-with-refresh --market sbtc-usdcx
cancel-cycle
530 ブロック(約 17.5 分)経過後も決済に失敗した場合にサイクルをキャンセルします。入金は次のサイクルに繰り越されます。
bun run jingswap/jingswap.ts cancel-cycle
注意事項
- Stacks のブロック生成間隔は平均約 2 秒です(Nakamoto)。
- 入金フェーズ:クローズ前に最低 150 ブロック(約 5 分)が必要です。
- バッファーフェーズ:クローズ後 30 ブロック(約 1 分)です。
- キャンセルのしきい値:クローズから 530 ブロック(約 17.5 分)です。
distributeイベントには、スワップの収益と未スワップ残額が表示されます(返金されず、次のサイクルに繰り越されます)。- ポストコンディション:入金では Deny モードを使用し、キャンセル/決済/サイクルのキャンセルでは Allow モードを使用します。
- USDCx はステーブルコイン(約 1 ドル)です。
SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx、アセットusdcx-token、小数点以下 6 桁。