pillar

Pillar 技能

提供两种模式的 Pillar 智能钱包操作：

• pillar.ts — 浏览器接力模式。在 Pillar 后端创建操作，在用户的浏览器中打开 Pillar 前端以供签名，然后轮询结果。要求用户已登录 pillarbtc.com。
• pillar-direct.ts — Agent 本地签名直连模式。生成并管理本地 secp256k1 签名密钥对。在本地签署 SIP-018 结构化数据，并直接提交到 Pillar 后端 API。无需浏览器；由后端赞助 Gas。

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 — Agent 本地签名直连模式

用法

bun run pillar/pillar-direct.ts <subcommand> [options]

所有直连操作仅支持主网。Gas 由 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 倍）。由 Agent 签名，无需浏览器。

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 仓位。由 Agent 签名，无需浏览器。

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

向 Zest 提供 sBTC 以赚取收益。无杠杆，无清算风险。由 Agent 签名。

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

选项：

• --sbtc-amount（必填）— 要提供的 sBTC 数量，单位为 sats

direct-send

从你的 Pillar 智能钱包发送 sBTC。由 Agent 签名，无需浏览器。

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

选项：

• --to（必填）— 收款方：BNS 名称、Pillar 钱包名称或 Stacks 地址
• --amount（必填）— 金额，单位为 satoshi
• --recipient-type（可选）— bns（默认）、wallet 或 address

direct-auto-compound

配置自动复投。由 Agent 签名，无需浏览器。

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 抵押品。由 Agent 签名，无需浏览器。

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

选项：

• --sbtc-amount（必填）— 要提取的 sBTC 数量，单位为 sats

direct-add-admin

添加备用管理员地址。由 Agent 签名，无需浏览器。

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

选项：

• --new-admin（必填）— 要添加为备用管理员的 Stacks 地址

direct-create-wallet

为 Agent 直接操作创建新的 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

在执行前获取 boost 报价（杠杆、LTV、兑换详情）。

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

选项：

• --sbtc-amount（必填）— 要用于 boost 的 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

Stacking 子命令

direct-stack-stx

通过 Fast Pool 或 Stacking DAO 进行 STX 堆叠。由 Agent 签名，无需浏览器。

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 委托。由 Agent 签名，无需浏览器。

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 后端为所有直接模式交易支付 Gas 费
• 浏览器移交模式的轮询超时时间默认为 5 分钟（可通过 PILLAR_POLL_TIMEOUT_MS 环境变量覆盖）
• 会话存储在 ~/.aibtc/pillar-session.json；签名密钥存储在 ~/.aibtc/signing-keys/