mcpField
P
pillar

pillar

github.com/aibtcdevその他11144 回インストール1 日前に更新
リポジトリ

pillar について

pillarは、Pillarスマートウォレットを操作するコマンドラインスキルです。sBTCやStacks資産、Zestポジションを管理するユーザー向けに、ブラウザー署名とローカル署名の両方を提供します。

主な機能

  1. 01ブラウザー連携とローカル署名
  2. 02sBTCの送金、入金、管理
  3. 03Zestへの供給とレバレッジポジション管理
  4. 04キー生成とスマートウォレット管理
  5. 05DCAパートナーと状況の確認

活用シーン

  1. 01ウォレットからsBTCを送金
  2. 02sBTCをZestに供給、またはポジション調整
  3. 03自動複利の設定とバックアップ管理者の追加
  4. 04STXのスタッキングとDCA招待の管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aibtcdev/skills --skill pillar

インストール後、Claude Code で/pillarを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

AGENT.md
pillar-direct.ts
pillar.ts

詳細

Pillar スキル

Pillar スマートウォレットの操作を、次の 2 つのモードで提供します。

  • pillar.ts — ブラウザへの引き継ぎモード。Pillar バックエンドで操作を作成し、署名するためにユーザーのブラウザで Pillar フロントエンドを開いた後、結果をポーリングします。pillarbtc.com にログインしている必要があります。
  • pillar-direct.ts — エージェント署名によるダイレクトモード。ローカルの secp256k1 署名鍵ペアを生成して管理します。SIP-018 構造化データにローカルで署名し、Pillar バックエンド API に直接送信します。ブラウザは不要で、ガス代はバックエンドが負担します。

pillar.ts — ブラウザへの引き継ぎモード

使用方法
bun run pillar/pillar.ts <subcommand> [options]
サブコマンド
connect

Pillar スマートウォレットに接続します。Pillar のウェブサイトを開き、ログイン済みの場合は自動的に接続して、ウォレットアドレスをローカルに保存します。

bun run pillar/pillar.ts connect
disconnect

Pillar から切断します。ローカルに保存されたウォレットセッションを消去します。

bun run pillar/pillar.ts disconnect
status

Pillar に接続されているか確認し、現在のウォレットアドレスを取得します。

bun run pillar/pillar.ts status
send

Pillar スマートウォレットから sBTC を送信します。署名のためにフロントエンドを開き、その後、確認を待ちます。

bun run pillar/pillar.ts send --to <recipient> --amount <sats> [--recipient-type bns|wallet|address]

オプション:

  • --to(必須)— 受取人:BNS 名、Pillar ウォレット名、または Stacks アドレス
  • --amount(必須)— サトシ単位の金額
  • --recipient-type(任意)— bns(デフォルト)、wallet、または address
fund

取引所への入金、BTC ウォレット、または sBTC ウォレットを通じて、Pillar スマートウォレットに資金を追加します。

bun run pillar/pillar.ts fund --method exchange|btc|sbtc [--amount <sats>]

オプション:

  • --method(必須)— exchange、btc、または sbtc
  • --amount(任意)— サトシ単位の金額
add-admin

復旧用のバックアップ管理者アドレスを、Pillar スマートウォレットに追加します。

bun run pillar/pillar.ts add-admin [--admin-address <SP...>]

オプション:

  • --admin-address(任意)— バックアップ管理者として追加する Stacks アドレス
supply

sBTC を Zest Protocol に供給して利回りを得ます。レバレッジはなく、清算リスクもありません。

bun run pillar/pillar.ts supply [--amount <sats>]

オプション:

  • --amount(任意)— サトシ単位の金額
auto-compound

Pillar ウォレットの自動複利運用を設定します。

bun run pillar/pillar.ts auto-compound [--min-sbtc <sats>] [--trigger <sats>]

オプション:

  • --min-sbtc(任意)— ウォレットに維持する sBTC の最小額(サトシ)
  • --trigger(任意)— 自動複利運用を開始する、最小額を超える金額(サトシ)
unwind

レバレッジを利用した sBTC ポジションを決済、または縮小します。

bun run pillar/pillar.ts unwind [--percentage <1-100>]

オプション:

  • --percentage(任意)— 解消するポジションの割合(1-100)
boost

レバレッジを利用した sBTC ポジションを作成、または増額します(最大 1.5x)。

bun run pillar/pillar.ts boost [--amount <sats>]

オプション:

  • --amount(任意)— 増額するサトシ単位の金額
position

Pillar ウォレットの残高と Zest ポジションを表示します。ブラウザでポジションページを開きます。

bun run pillar/pillar.ts position
create-wallet

新しい Pillar スマートウォレットを作成します。登録を完了するために Pillar のウェブサイトを開きます。

bun run pillar/pillar.ts create-wallet [--referral <wallet-address>]

オプション:

  • --referral(任意)— 紹介元のウォレットアドレス
invite

友人を招待するための Pillar 紹介リンクを取得します。

bun run pillar/pillar.ts invite
dca-invite

メールアドレスまたはウォレットアドレスを使って、DCA パートナーを招待します。

bun run pillar/pillar.ts dca-invite --partner <email-or-address>

オプション:

  • --partner(必須)— パートナーのメールアドレスまたは Stacks ウォレットアドレス
dca-partners

DCA パートナーと週ごとの状況を表示します。

bun run pillar/pillar.ts dca-partners
dca-leaderboard

DCA の連続記録リーダーボードを表示します。

bun run pillar/pillar.ts dca-leaderboard
dca-status

DCA スケジュールの状況を確認します。

bun run pillar/pillar.ts dca-status

pillar-direct.ts — エージェント署名によるダイレクトモード

使用方法
bun run pillar/pillar-direct.ts <subcommand> [options]

すべてのダイレクト操作はメインネット専用です。ガス代は Pillar バックエンドが負担します。

鍵管理サブコマンド
key-generate

新しい secp256k1 署名鍵ペアを生成します。圧縮公開鍵を返します。

bun run pillar/pillar-direct.ts key-generate [--smart-wallet <contract-id>]

オプション:

  • --smart-wallet(任意)— スマートウォレットのコントラクト ID(デフォルト:"pending")
key-unlock

自動生成されたパスワードを使って署名鍵のロックを解除します。

bun run pillar/pillar-direct.ts key-unlock [--key-id <id>]

オプション:

  • --key-id(任意)— ロックを解除する鍵 ID(省略時は保存されている最初の鍵のロックを解除します)
key-lock

署名鍵をロックし、メモリ上の機密データを消去します。

bun run pillar/pillar-direct.ts key-lock
key-info

署名鍵の情報(公開鍵、スマートウォレット、ロック状態、保存されているすべての鍵)を表示します。

bun run pillar/pillar-direct.ts key-info
ダイレクト操作サブコマンド
direct-boost

レバレッジをかけた sBTC ポジションを作成または増額します(最大 1.5 倍)。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-boost --sbtc-amount <sats> --aeusdc-to-borrow <amount> --min-sbtc-from-swap <sats>

オプション:

  • --sbtc-amount(必須)— 担保として提供する sBTC の数量(sats)
  • --aeusdc-to-borrow(必須)— 借り入れる aeUSDC の数量(小数点以下 6 桁)
  • --min-sbtc-from-swap(必須)— スワップで得る sBTC の最小数量(sats、スリッページ保護)
direct-unwind

レバレッジをかけた sBTC ポジションを閉じるか、縮小します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-unwind --sbtc-to-swap <sats> --sbtc-to-withdraw <sats> --min-aeusdc-from-swap <amount>

オプション:

  • --sbtc-to-swap(必須)— 返済のために aeUSDC にスワップする sBTC(sats)
  • --sbtc-to-withdraw(必須)— 返済後に引き出す sBTC(sats)
  • --min-aeusdc-from-swap(必須)— スワップで得る aeUSDC の最小数量(小数点以下 6 桁、スリッページ保護)
direct-supply

sBTC を Zest に預けて利回りを得ます。レバレッジはなく、清算リスクもありません。エージェント署名で実行します。

bun run pillar/pillar-direct.ts direct-supply --sbtc-amount <sats>

オプション:

  • --sbtc-amount(必須)— 預ける sBTC の数量(sats)
direct-send

Pillar スマートウォレットから sBTC を送信します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-send --to <recipient> --amount <sats> [--recipient-type bns|wallet|address]

オプション:

  • --to(必須)— 受取人:BNS 名、Pillar ウォレット名、または Stacks アドレス
  • --amount(必須)— 数量(satoshis)
  • --recipient-type(任意)— bns(デフォルト)、wallet、または address
direct-auto-compound

自動複利を設定します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-auto-compound --enabled true|false --min-sbtc <sats> --trigger <sats>

オプション:

  • --enabled(必須)— 自動複利を有効化(true)または無効化(false)
  • --min-sbtc(必須)— ウォレットに残す sBTC の最小数量(sats)
  • --trigger(必須)— 自動複利を実行する、最小数量を超える分の数量(sats)
direct-position

Pillar スマートウォレットの残高と Zest ポジションを表示します。署名は不要です。

bun run pillar/pillar-direct.ts direct-position
direct-withdraw-collateral

Zest から sBTC 担保を引き出します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-withdraw-collateral --sbtc-amount <sats>

オプション:

  • --sbtc-amount(必須)— 引き出す sBTC の数量(sats)
direct-add-admin

バックアップ管理者アドレスを追加します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-add-admin --new-admin <SP...>

オプション:

  • --new-admin(必須)— バックアップ管理者として追加する Stacks アドレス
direct-create-wallet

エージェントによる直接操作用の新しい Pillar スマートウォレットを作成します。キーペアを生成してロックを解除し、デプロイします。

bun run pillar/pillar-direct.ts direct-create-wallet --wallet-name <name> [--referred-by <contract-id>]

オプション:

  • --wallet-name(必須)— ウォレット名(3〜20 文字、小文字、数字、ハイフン)
  • --referred-by(任意)— 紹介元ウォレットのコントラクトアドレス
DCA サブコマンド
direct-dca-invite

DCA パートナーを招待します。署名キーセッションのウォレットアドレスを使用します。

bun run pillar/pillar-direct.ts direct-dca-invite --partner <email-or-address>

オプション:

  • --partner(必須)— パートナーのメールアドレスまたは Stacks ウォレットアドレス
direct-dca-partners

DCA パートナーと週間ステータスを表示します。

bun run pillar/pillar-direct.ts direct-dca-partners
direct-dca-leaderboard

DCA 連続記録のリーダーボードを表示します。

bun run pillar/pillar-direct.ts direct-dca-leaderboard
direct-dca-status

DCA のスケジュール状況を確認します。

bun run pillar/pillar-direct.ts direct-dca-status
ユーティリティのサブコマンド
direct-quote

実行前にブーストの見積もり(レバレッジ、LTV、スワップの詳細)を取得します。

bun run pillar/pillar-direct.ts direct-quote --sbtc-amount <sats>

オプション:

  • --sbtc-amount(必須)— ブーストする sBTC の数量(sats)
direct-resolve-recipient

送信前に受取人(BNS 名、ウォレット名、またはアドレス)を解決します。

bun run pillar/pillar-direct.ts direct-resolve-recipient --to <recipient> [--recipient-type bns|wallet|address]

オプション:

  • --to(必須)— 解決する受取人
  • --recipient-type(任意)— bns(デフォルト)、wallet、または address
スタッキングのサブコマンド
direct-stack-stx

Fast Pool または Stacking DAO を通じて STX をスタックします。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-stack-stx --stx-amount <microStx> --pool fast-pool|stacking-dao

オプション:

  • --stx-amount(必須)— STX の数量(micro-STX、1 STX = 1,000,000)
  • --pool(必須)— fast-pool または stacking-dao
direct-revoke-fast-pool

Fast Pool の STX 委任を取り消します。エージェント署名で実行でき、ブラウザーは不要です。

bun run pillar/pillar-direct.ts direct-revoke-fast-pool
direct-stacking-status

スタッキング状況を確認します。署名は不要です。オンチェーンデータを読み取ります。

bun run pillar/pillar-direct.ts direct-stacking-status

注記

  • ブラウザーハンドオフモードを使用するには、まず pillar.ts connect で接続する必要があります
  • ダイレクトモードでは署名キーが必要です。direct-create-wallet で作成するか、既存のウォレットには key-generate を使用してください
  • ダイレクトモードの操作はメインネットでのみ実行できます
  • Pillar バックエンドは、ダイレクトモードのすべてのトランザクションのガス代を負担します
  • ブラウザーハンドオフのポーリングタイムアウトはデフォルトで5分です(PILLAR_POLL_TIMEOUT_MS 環境変数で変更できます)
  • セッションは ~/.aibtc/pillar-session.json に保存されます。署名キーは ~/.aibtc/signing-keys/ に保存されます

コメント