pillar について
pillarは、Pillarスマートウォレットを操作するコマンドラインスキルです。sBTCやStacks資産、Zestポジションを管理するユーザー向けに、ブラウザー署名とローカル署名の両方を提供します。
主な機能
- 01ブラウザー連携とローカル署名
- 02sBTCの送金、入金、管理
- 03Zestへの供給とレバレッジポジション管理
- 04キー生成とスマートウォレット管理
- 05DCAパートナーと状況の確認
活用シーン
- 01ウォレットからsBTCを送金
- 02sBTCをZestに供給、またはポジション調整
- 03自動複利の設定とバックアップ管理者の追加
- 04STXのスタッキングとDCA招待の管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aibtcdev/ skills --skill pillarインストール後、Claude Code で/pillarを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
AGENT.mdpillar-direct.tspillar.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/に保存されます