Communitygithub.com

vultisig/vultisig-sdk

Carteira MPC para agentes de IA. Operações cripto seguras multi-chain com assinatura threshold em mais de 36 blockchains. Roteia para CLI (comandos shell) ou SDK (TypeScript) conforme seu caso de uso.

O que é vultisig-sdk?

Este skill fornece uma carteira MPC (Multi-Party Computation) que permite que agentes de IA realizem operações cripto seguras em mais de 36 blockchains sem expor uma chave privada única. Diferente de carteiras tradicionais, as chaves são divididas entre múltiplas partes usando criptografia threshold, eliminando o ponto único de falha. O skill suporta dois modos de interface: CLI (para comandos diretos em shell, automação e agentes de chat via `agent ask`) e SDK TypeScript (para controle programático, segurança de tipos e fluxos reativos). Para agentes de IA, o FastVault é recomendado pois permite assinatura instantânea sem coordenação multi-dispositivo, ideal para bots e automação. As operações principais incluem criação de vaults, verificação de saldos, envio, swap cross-chain via THORChain/1inch/LiFi e assinatura de transações ou bytes arbitrários. O SDK oferece capacidades adicionais como descoberta de tokens, preços via CoinGecko, varredura de segurança e sistema de eventos para atualizações reativas.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 UsoInterfacePorquê
Chat de agente IACLI agent askOperações cripto em linguagem natural de uma só vez; use --session para múltiplas interações, --password para assinar
Scripts shellCLIComandos diretos, script fácil
Bots de automaçãoCLISimples, pipe para jq, variáveis de ambiente
Operações pontuaisCLIRápido, sem necessidade de código
Aplicativos TypeScript/NodeSDKAPI completa, segurança de tipos
Lógica de transação personalizadaSDKsignBytes, broadcastRawTx
Aplicativos Browser/ReactSDKSistema de eventos, async/await
Fluxos de trabalho complexosSDKControle 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

TipoThresholdAssinaturaMelhor Para
FastVault2-de-2 (dispositivo + servidor)Instantânea (~1-2s)Agentes IA, bots, automação
SecureVaultN-de-M (configurável)Coordenação multi-dispositivoEquipes, 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/swap suportam 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

Recursos

Habilidades Relacionadas