Communitygithub.com

vultisig/vultisig-sdk

適用於 AI 代理的 MPC 錢包。支援 36 條以上區塊鏈的安全多鏈加密操作,採用門檻簽章技術。根據使用情境可選擇 CLI(shell 命令)或 SDK(TypeScript)。

vultisig-sdk 是什麼?

Vultisig 是一個基於 MPC(多方計算)的錢包解決方案,專為 AI 代理與自動化場景設計,可在 36 條以上區塊鏈上執行安全的加密貨幣操作。與傳統錢包不同,Vultisig 使用門檻密碼學將私鑰拆分至多個參與方,消除單點故障風險。支援兩種金庫類型:適用於 AI 代理與機器人、簽章速度約 1-2 秒的 FastVault(2-of-2),以及適用於團隊與高價值資產、需多設備協調的 SecureVault(N-of-M)。操作介面包羅萬象:AI 代理可透過自然語言驅動的 CLI `agent ask` 指令執行一次性加密操作;開發者則可在 TypeScript 應用程式中使用 SDK 進行程式化控制,支援複合操作(發送、兌換、簽章、投資組合)、代幣探索、價格預言機、安全掃描及法幣入金等功能。Vultisig 支援超過 36 條區塊鏈,包含 EVM 鏈(以太坊、Polygon、BSC 等)、UTXO 鏈(比特幣、萊特幣等)、Cosmos 生態鏈(Cosmos、THORChain 等)以及其他鏈(Solana、Sui 等),為開發者提供一個安全、可程式化的多鏈資產管理方案。

相容平台✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/vultisig/vultisig-sdk/tree/HEAD/skills

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Vultisig

Vultisig 是一個 MPC(多方計算)錢包,可在 36 條以上區塊鏈上執行安全的加密貨幣操作。與傳統錢包不同,私鑰採用門檻密碼學拆分至多個參與方——不存在單一金鑰可被盜取。

為何 AI 代理需要 MPC 錢包

傳統錢包儲存單一私鑰或助記詞。一旦遭入侵,所有資金將損失殆盡。MPC 消除了此風險:

  • 無單點故障:透過密碼學秘密共享,金鑰拆分至多個參與方
  • 門檻安全:2-of-2 或 N-of-M 簽章——單一參與方被入侵不足以構成威脅
  • 無助記詞暴露:任何地方都不以明文儲存助記詞
  • 適合自動化:FastVault 為機器人提供即時伺服器輔助簽章
  • 可程式化信任:選擇速度(FastVault)或最高安全性(SecureVault)
  • 審計追蹤:所有簽章都需要明確的多方協調

選擇您的介面

使用情境介面原因
AI 代理對話CLI agent ask一次性自然語言加密操作;使用 --session 進行多輪對話,--password 進行簽章
Shell 腳本CLI直接命令,易於編寫腳本
自動化機器人CLI簡單,可 pipe 至 jq,使用環境變數
一次性操作CLI快速,無需編寫程式碼
TypeScript/Node 應用SDK完整 API,型別安全
自訂交易邏輯SDKsignBytes, broadcastRawTx
瀏覽器/React 應用SDK事件系統,async/await
複雜工作流程SDK程式化控制

快速決策

若您符合以下情況,請使用 Agent Ask:您是 AI 編碼代理(Claude Code、Opencode、Cursor),需要透過自然語言執行加密操作。每次呼叫為一次性操作;傳遞 --session <id> 可續接先前的對話。簽章操作需要 --password。

若您符合以下情況,請使用 CLI:您正在編寫 shell 腳本、需要快速命令,或希望將 JSON 輸出 pipe 至其他工具。

若您符合以下情況,請使用 SDK:您正在建置 TypeScript 應用、需要程式化控制,或希望使用事件驅動更新。

金庫類型

類型門檻簽章最適合
FastVault2-of-2(裝置 + 伺服器)即時(約 1-2 秒)AI 代理、機器人、自動化
SecureVaultN-of-M(可配置)多設備協調團隊、高價值資產

對於 AI 代理,建議使用 FastVault——無需多設備協調即可即時簽章。

支援的區塊鏈(36 條以上)

EVM 鏈(13 條)

Ethereum、Polygon、BSC、Arbitrum、Optimism、Base、Avalanche、Blast、Cronos、zkSync、Hyperliquid、Mantle、Sei

UTXO 鏈(6 條)

Bitcoin、Litecoin、Dogecoin、Bitcoin Cash、Dash、Zcash

Cosmos 鏈(10 條)

Cosmos、THORChain、MayaChain、Osmosis、dYdX、Kujira、Terra、Terra Classic、Noble、Akash

其他鏈(7 條)

Solana、Sui、Polkadot、TON、Ripple、Tron、Cardano

核心操作

CLI 與 SDK 皆支援:

  • 建立金庫:FastVault(即時)或 SecureVault(多設備)
  • 匯入/匯出:備份與還原金庫,從助記詞(BIP39)匯入
  • 地址:為任何鏈推導地址
  • 餘額:查詢原生與代幣餘額
  • 發送:轉帳加密貨幣至任意地址
  • 兌換:透過 THORChain 進行跨鏈兌換,透過 1inch 和 LiFi 進行同鏈兌換
  • 簽章:簽署交易或任意位元組

SDK 專有功能:

  • 複合包裝器:send()、swap()、signMessage()、portfolio()、allBalances()——單次呼叫操作,支援人類可讀金額與自動代幣解析(send/swap 支援 dryRun)
  • 代幣探索:查詢已知代幣、探索地址中的代幣
  • 價格預言機:透過 CoinGecko 獲取代幣價格
  • 安全掃描:網站掃描、交易驗證、交易模擬
  • 法幣入金:透過 Banxa 整合購買加密貨幣
  • Cosmos 簽章:為 Cosmos dApp 提供 SignAmino 與 SignDirect
  • 推播通知:註冊裝置、通知金庫成員進行簽章、處理傳入的推播事件
  • 事件系統:餘額、簽章等的響應式更新

快速入門

CLI 快速入門

npm install -g @vultisig/cli

# 建立金庫(非互動模式,--two-step 跳過 OTP 提示)
vultisig create fast --name "bot-wallet" --email "[email protected]" --password "SecurePass123!" --two-step -o json
# 回傳:{"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}

# 使用電子郵件 OTP 驗證
vultisig verify <vaultId> --code 123456 -o json

# 檢查餘額
vultisig balance -o json

→ 完整 CLI 文件

SDK 快速入門

import { Vultisig, Chain } from '@vultisig/sdk'

const sdk = new Vultisig()
await sdk.initialize()

// 步驟 1:建立金庫(回傳 vaultId,傳送 OTP 至電子郵件)
const vaultId = await sdk.createFastVault({
  name: 'bot-wallet',
  email: '[email protected]',
  password: 'SecurePass123!'
})

// 步驟 2:使用電子郵件 OTP 驗證
const vault = await sdk.verifyVault(vaultId, '123456')

// 步驟 3:使用金庫
const balance = await vault.balance(Chain.Ethereum)

// 發送、兌換、簽章——單次呼叫,使用人類可讀金額
await vault.send({ chain: Chain.Ethereum, to: '0x...', amount: '0.1' })
await vault.swap({ fromChain: Chain.Ethereum, fromSymbol: 'ETH', toChain: Chain.Bitcoin, toSymbol: 'BTC', amount: '0.5' })
const { signature } = await vault.signMessage('Login to MyDapp')
const portfolio = await vault.portfolio('usd')

→ 完整 SDK 文件

資源

相關技能