Vultisig
Vultisig é uma carteira MPC (Multi-Party Computation) que permite operações cripto seguras em mais de 36 blockchains. Diferente de carteiras tradicionais, as chaves privadas são divididas entre múltiplas partes usando criptografia threshold — não há uma única chave para roubar.
Por que Carteiras MPC para Agentes de IA
Carteiras tradicionais armazenam uma única chave privada ou frase semente. Se comprometida, todos os fundos são perdidos. MPC elimina esse risco:
- Sem ponto único de falha: Chaves são divididas entre partes usando compartilhamento secreto criptográfico
- Segurança threshold: Assinatura 2-de-2 ou N-de-M — comprometer uma parte não é suficiente
- Sem exposição de frase semente: Nenhum mnemônico armazenado em texto puro em qualquer lugar
- Amigável para automação: FastVault permite assinatura assistida por servidor instantânea para bots
- Confiança programável: Escolha velocidade (FastVault) ou segurança máxima (SecureVault)
- Trilha de auditoria: Toda assinatura requer coordenação explícita de múltiplas partes
Escolha Sua Interface
| Caso de Uso | Interface | Porquê |
|---|---|---|
| Chat de agente IA | CLI agent ask | Operações cripto em linguagem natural de uma só vez; use --session para múltiplas interações, --password para assinar |
| Scripts shell | CLI | Comandos diretos, script fácil |
| Bots de automação | CLI | Simples, pipe para jq, variáveis de ambiente |
| Operações pontuais | CLI | Rápido, sem necessidade de código |
| Aplicativos TypeScript/Node | SDK | API completa, segurança de tipos |
| Lógica de transação personalizada | SDK | signBytes, broadcastRawTx |
| Aplicativos Browser/React | SDK | Sistema de eventos, async/await |
| Fluxos de trabalho complexos | SDK | Controle programático |
Decisão Rápida
Use Agent Ask se: Você é um agente de codificação IA (Claude Code, Opencode, Cursor) que precisa realizar operações cripto via linguagem natural. Cada invocação é única; passe --session <id> para continuar uma conversa anterior. Operações de assinatura exigem --password.
Use CLI se: Você está escrevendo scripts shell, precisa de comandos rápidos ou quer saída JSON canalizada para outras ferramentas.
Use SDK se: Você está construindo uma aplicação TypeScript, precisa de controle programático ou deseja atualizações orientadas a eventos.
Tipos de Vault
| Tipo | Threshold | Assinatura | Melhor Para |
|---|---|---|---|
| FastVault | 2-de-2 (dispositivo + servidor) | Instantânea (~1-2s) | Agentes IA, bots, automação |
| SecureVault | N-de-M (configurável) | Coordenação multi-dispositivo | Equipes, ativos de alto valor |
Para agentes IA, FastVault é recomendado — assinatura instantânea sem coordenação multi-dispositivo.
Chains Suportados (36+)
Chains EVM (13)
Ethereum, Polygon, BSC, Arbitrum, Optimism, Base, Avalanche, Blast, Cronos, zkSync, Hyperliquid, Mantle, Sei
Chains UTXO (6)
Bitcoin, Litecoin, Dogecoin, Bitcoin Cash, Dash, Zcash
Chains Cosmos (10)
Cosmos, THORChain, MayaChain, Osmosis, dYdX, Kujira, Terra, Terra Classic, Noble, Akash
Outros Chains (7)
Solana, Sui, Polkadot, TON, Ripple, Tron, Cardano
Operações Principais
Tanto CLI quanto SDK suportam:
- Criar vaults: FastVault (instantâneo) ou SecureVault (multi-dispositivo)
- Importar/Exportar: Backup e restauração de vaults, importar de frase semente (BIP39)
- Endereços: Derivar endereços para qualquer chain
- Saldos: Verificar saldos nativos e de tokens
- Enviar: Transferir cripto para qualquer endereço
- Trocar: Swaps cross-chain via THORChain, mesma chain via 1inch e LiFi
- Assinar: Assinar transações ou bytes arbitrários
Capacidades exclusivas do SDK:
- Wrappers Compostos:
send(),swap(),signMessage(),portfolio(),allBalances()— chamadas únicas com valores legíveis e resolução automática de tokens (send/swapsuportam dryRun) - Descoberta de Tokens: Consultar tokens conhecidos, descobrir tokens em endereços
- Feed de Preços: Buscar preços de tokens via CoinGecko
- Varredura de Segurança: Varredura de sites, validação de transações, simulação de transações
- Compra de Cripto com Fiat: Comprar cripto via integração Banxa
- Assinatura Cosmos: SignAmino e SignDirect para dApps Cosmos
- Notificações Push: Registrar dispositivos, notificar membros do vault para assinatura, lidar com eventos push recebidos
- Sistema de Eventos: Atualizações reativas para saldos, assinatura e mais
Comece Agora
Início Rápido com CLI
npm install -g @vultisig/cli
# Criar vault (não interativo, --two-step pula prompt de OTP)
vultisig create fast --name "bot-wallet" --email "[email protected]" --password "SecurePass123!" --two-step -o json
# Retorna: {"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}
# Verificar com OTP de email
vultisig verify <vaultId> --code 123456 -o json
# Verificar saldos
vultisig balance -o json
→ Documentação Completa da CLI
Início Rápido com SDK
import { Vultisig, Chain } from '@vultisig/sdk'
const sdk = new Vultisig()
await sdk.initialize()
// Passo 1: Criar vault (retorna vaultId, envia OTP para email)
const vaultId = await sdk.createFastVault({
name: 'bot-wallet',
email: '[email protected]',
password: 'SecurePass123!'
})
// Passo 2: Verificar com código OTP do email
const vault = await sdk.verifyVault(vaultId, '123456')
// Passo 3: Usar o vault
const balance = await vault.balance(Chain.Ethereum)
// Enviar, trocar, assinar — chamadas únicas com valores legíveis
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')
→ Documentação Completa do SDK