vultisig

name	vultisig
description	MPC wallet for AI agents. Secure multi-chain crypto operations with threshold signing across 36+ blockchains. Routes to CLI (shell commands) or SDK (TypeScript) based on your use case.
version	1.0.0
author	Vultisig
repository	https://github.com/vultisig/vultisig-sdk
metadata	{"openclaw":{"emoji":"🔐","homepage":"https://github.com/vultisig/vultisig-sdk"}}
tags	["crypto","wallet","mpc","blockchain","defi","bitcoin","ethereum","solana","polygon","arbitrum","optimism","base","avalanche","bsc","litecoin","dogecoin","cosmos","thorchain","mayachain","osmosis","dydx","kujira","sui","polkadot","ton","ripple","tron","cardano","zcash","dash","blast","cronos","zksync","hyperliquid","mantle","sei","terra","noble","akash","bitcoin-cash"]

Vultisig

Vultisig is an MPC (Multi-Party Computation) wallet that enables secure crypto operations across 36+ blockchains. Unlike traditional wallets, private keys are split across multiple parties using threshold cryptography - there's no single key to steal.

Why MPC Wallets for AI Agents

Traditional wallets store a single private key or seed phrase. If compromised, all funds are lost. MPC eliminates this risk:

• No single point of failure: Keys are split across parties using cryptographic secret sharing
• Threshold security: 2-of-2 or N-of-M signing - compromising one party isn't enough
• No seed phrase exposure: No mnemonic stored in plaintext anywhere
• Automation-friendly: FastVault enables instant server-assisted signing for bots
• Programmable trust: Choose speed (FastVault) or maximum security (SecureVault)
• Audit trail: All signing requires explicit multi-party coordination

Choose Your Interface

Use Case	Interface	Why
AI agent chat	CLI agent ask	One-shot natural language crypto ops; use --session for multi-turn, --password for signing
Shell scripts	CLI	Direct commands, easy scripting
Automation bots	CLI	Simple, pipes to jq, env vars
One-off operations	CLI	Quick, no code needed
TypeScript/Node apps	SDK	Full API, type safety
Custom transaction logic	SDK	signBytes, broadcastRawTx
Browser/React apps	SDK	Event system, async/await
Complex workflows	SDK	Programmatic control

Quick Decision

Use Agent Ask if: You're an AI coding agent (Claude Code, Opencode, Cursor) that needs to perform crypto operations via natural language. Each invocation is one-shot; pass --session <id> to continue a prior conversation. Signing operations require --password.

Use CLI if: You're writing shell scripts, need quick commands, or want JSON output piped to other tools.

Use SDK if: You're building a TypeScript application, need programmatic control, or want event-driven updates.

Vault Types

Type	Threshold	Signing	Best For
FastVault	2-of-2 (device + server)	Instant (~1-2s)	AI agents, bots, automation
SecureVault	N-of-M (configurable)	Multi-device coordination	Teams, high-value assets

For AI agents, FastVault is recommended - instant signing without multi-device coordination.

Supported Chains (36+)

EVM Chains (13)

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

UTXO Chains (6)

Bitcoin, Litecoin, Dogecoin, Bitcoin Cash, Dash, Zcash

Cosmos Chains (10)

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

Other Chains (7)

Solana, Sui, Polkadot, TON, Ripple, Tron, Cardano

Core Operations

Both CLI and SDK support:

• Create vaults: FastVault (instant) or SecureVault (multi-device)
• Import/Export: Backup and restore vaults, import from seedphrase (BIP39)
• Addresses: Derive addresses for any chain
• Balances: Check native and token balances
• Send: Transfer crypto to any address
• Swap: Cross-chain swaps via THORChain, same-chain via 1inch and LiFi
• Sign: Sign transactions or arbitrary bytes

SDK-only capabilities:

• Compound Wrappers: send(), swap(), signMessage(), portfolio(), allBalances() — single-call operations with human-readable amounts and auto token resolution (send/swap support dryRun)
• Token Discovery: Look up known tokens, discover tokens at addresses
• Price Feeds: Fetch token prices via CoinGecko
• Security Scanning: Site scanning, transaction validation, transaction simulation
• Fiat On-Ramp: Buy crypto via Banxa integration
• Cosmos Signing: SignAmino and SignDirect for Cosmos dApps
• Push Notifications: Register devices, notify vault members for signing, handle incoming push events
• Event System: Reactive updates for balances, signing, and more

Get Started

CLI Quick Start

npm install -g @vultisig/cli

# Create vault (non-interactive, --two-step skips OTP prompt)
vultisig create fast --name "bot-wallet" --email "[e-mail]" --password "SecurePass123!" --two-step -o json
# Returns: {"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}

# Verify with email OTP
vultisig verify <vaultId> --code 123456 -o json

# Check balances
vultisig balance -o json

→ Full CLI Documentation

SDK Quick Start

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

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

// Step 1: Create vault (returns vaultId, sends OTP to email)
const vaultId = await sdk.createFastVault({
  name: 'bot-wallet',
  email: '[e-mail]',
  password: 'SecurePass123!'
})

// Step 2: Verify with email OTP code
const vault = await sdk.verifyVault(vaultId, '123456')

// Step 3: Use the vault
const balance = await vault.balance(Chain.Ethereum)

// Send, swap, sign — single calls with human-readable amounts
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')

→ Full SDK Documentation

Resources

• GitHub Repository
• CLI Documentation
• SDK Documentation