Communitygithub.com

vultisig/vultisig-sdk

AI 代理的 MPC 钱包。支持 36+ 区块链的安全多链加密操作,使用阈值签名。根据用例路由到 CLI(Shell 命令)或 SDK(TypeScript)。

vultisig-sdk 是什么?

Vultisig 是一个基于多方计算(MPC)的钱包,专为 AI 代理设计,支持超过 36 条区块链的安全加密操作。与传统钱包不同,它使用阈值密码学将私钥分割到多个参与方,消除了单点故障风险。该工具提供 FastVault(2 选 2,快速签名约 1-2 秒)和 SecureVault(N 选 M,可配置阈值)两种金库类型,推荐 AI 代理使用 FastVault 实现即时签名。Vultisig 支持 CLI 和 SDK 两种接口:CLI 适合单次自然语言操作、Shell 脚本和自动化;SDK 适合 TypeScript 应用,提供 send、swap、signMessage、portfolio 等复合封装方法,以及代币发现、价格查询、安全扫描、法币入口等功能。它支持 EVM、UTXO、Cosmos 生态及 Solana、Sui、Polkadot 等主流区块链,核心操作包括创建金库、导入导出、地址推导、余额查询、发送、跨链交换和签名。开发者可以通过 npm 安装 CLI 或 SDK 快速集成。

兼容平台✓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选2 或 N选M 签名——仅攻破一方是不够的
  • 无助记词暴露:任何地方都不以明文形式存储助记词
  • 适合自动化:FastVault 支持即时服务端辅助签名,适用于机器人
  • 可编程信任:选择速度(FastVault)或最高安全性(SecureVault)
  • 审计追踪:所有签名都需要显式的多方协调

选择你的接口

使用场景接口原因
AI 代理聊天CLI agent ask一次性自然语言加密操作;使用 --session 进行多轮对话,--password 用于签名
Shell 脚本CLI直接命令,易于脚本化
自动化机器人CLI简单,可管道到 jq,环境变量
一次性操作CLI快速,无需编码
TypeScript/Node 应用SDK完整 API,类型安全
自定义交易逻辑SDKsignBytes, broadcastRawTx
浏览器/React 应用SDK事件系统,async/await
复杂工作流SDK程序化控制

快速决策

如果你是需要通过自然语言执行加密操作的 AI 编码代理(Claude Code、Opencode、Cursor),请使用 Agent Ask。每次调用都是一次性的;通过 --session <id> 继续之前的对话。签名操作需要 --password。

如果你在编写 Shell 脚本、需要快速命令或希望将 JSON 输出管道到其他工具,请使用 CLI。

如果你在构建 TypeScript 应用、需要程序化控制或希望实现事件驱动更新,请使用 SDK。

金库类型

类型阈值签名最佳用途
FastVault2选2(设备 + 服务器)即时(约1-2秒)AI 代理、机器人、自动化
SecureVaultN选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 文档

资源

相关技能