Communitygithub.com

vultisig/vultisig-sdk

Monedero MPC para agentes de IA. Operaciones criptográficas seguras en múltiples cadenas con firma por umbral en más de 36 blockchains. Se enruta a CLI (comandos de shell) o SDK (TypeScript) según tu caso de uso.

¿Qué es vultisig-sdk?

Vultisig es un monedero MPC (Multi-Party Computation) que permite a agentes de IA realizar operaciones criptográficas seguras en más de 36 blockchains sin exponer una única clave privada. Utiliza criptografía de umbral para dividir las claves entre múltiples partes, eliminando el punto único de fallo típico de los monederos tradicionales. Soporta dos interfaces: la CLI (ideal para agentes de chat como Claude Code, Cursor o Codex) y el SDK de TypeScript (para aplicaciones que requieren control programático, tipado fuerte y actualizaciones basadas en eventos). Entre sus características principales se incluyen la creación de bóvedas FastVault (firma instantánea con asistencia del servidor) o SecureVault (coordinación multi-dispositivo), envío de transacciones, intercambios cross-chain a través de THORChain, firma de mensajes arbitrarios y consulta de balances y precios. Es especialmente útil para automatizar procesos financieros en blockchains como Ethereum, Bitcoin, Solana, Cosmos y muchas más.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Vultisig

Vultisig es un monedero MPC (Multi-Party Computation) que permite operaciones criptográficas seguras en más de 36 blockchains. A diferencia de los monederos tradicionales, las claves privadas se dividen entre múltiples partes mediante criptografía de umbral: no existe una única clave que pueda ser robada.

Por qué monederos MPC para agentes de IA

Los monederos tradicionales almacenan una única clave privada o frase semilla. Si se ven comprometidos, todos los fondos se pierden. MPC elimina este riesgo:

  • Sin punto único de fallo: Las claves se dividen entre partes usando compartición secreta criptográfica
  • Seguridad por umbral: Firma 2-de-2 o N-de-M: comprometer una parte no es suficiente
  • Sin exposición de frase semilla: No se almacena ningún mnemónico en texto plano
  • Amigable para automatización: FastVault permite firma asistida por servidor instantánea para bots
  • Confianza programable: Elige velocidad (FastVault) o máxima seguridad (SecureVault)
  • Registro de auditoría: Toda firma requiere coordinación explícita entre múltiples partes

Elige tu interfaz

Caso de usoInterfazPor qué
Chat de agente de IACLI agent askOperaciones criptográficas en lenguaje natural de una sola invocación; usa --session para múltiples turnos, --password para firmar
Scripts de shellCLIComandos directos, fácil scripting
Bots de automatizaciónCLISimple, se conecta con jq, variables de entorno
Operaciones puntualesCLIRápido, sin necesidad de código
Aplicaciones TypeScript/NodeSDKAPI completa, seguridad de tipos
Lógica de transacciones personalizadaSDKsignBytes, broadcastRawTx
Aplicaciones en navegador/ReactSDKSistema de eventos, async/await
Flujos de trabajo complejosSDKControl programático

Decisión rápida

Usa Agent Ask si: Eres un agente de codificación de IA (Claude Code, Opencode, Cursor) que necesita realizar operaciones criptográficas mediante lenguaje natural. Cada invocación es única; pasa --session <id> para continuar una conversación anterior. Las operaciones de firma requieren --password.

Usa CLI si: Estás escribiendo scripts de shell, necesitas comandos rápidos o deseas salida JSON para otras herramientas.

Usa SDK si: Estás construyendo una aplicación TypeScript, necesitas control programático o deseas actualizaciones basadas en eventos.

Tipos de bóveda

TipoUmbralFirmaMejor para
FastVault2-de-2 (dispositivo + servidor)Instantánea (~1-2s)Agentes de IA, bots, automatización
SecureVaultN-de-M (configurable)Coordinación multi-dispositivoEquipos, activos de alto valor

Para agentes de IA, se recomienda FastVault - firma instantánea sin coordinación multi-dispositivo.

Cadenas compatibles (36+)

Cadenas EVM (13)

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

Cadenas UTXO (6)

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

Cadenas Cosmos (10)

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

Otras cadenas (7)

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

Operaciones principales

Tanto CLI como SDK soportan:

  • Crear bóvedas: FastVault (instantánea) o SecureVault (multi-dispositivo)
  • Importar/Exportar: Copia de seguridad y restauración de bóvedas, importar desde frase semilla (BIP39)
  • Direcciones: Derivar direcciones para cualquier cadena
  • Saldos: Consultar saldos nativos y de tokens
  • Enviar: Transferir cripto a cualquier dirección
  • Intercambiar: Intercambios cross-chain vía THORChain, misma cadena vía 1inch y LiFi
  • Firmar: Firmar transacciones o bytes arbitrarios

Capacidades solo del SDK:

  • Wrappers compuestos: send(), swap(), signMessage(), portfolio(), allBalances() — operaciones de una sola llamada con cantidades legibles y resolución automática de tokens (send/swap soportan dryRun)
  • Descubrimiento de tokens: Buscar tokens conocidos, descubrir tokens en direcciones
  • Fuentes de precios: Obtener precios de tokens vía CoinGecko
  • Escaneo de seguridad: Escaneo de sitios, validación de transacciones, simulación de transacciones
  • Compra con moneda fiduciaria: Comprar cripto vía integración con Banxa
  • Firma Cosmos: SignAmino y SignDirect para dApps de Cosmos
  • Notificaciones push: Registrar dispositivos, notificar a miembros de la bóveda para firmar, manejar eventos push entrantes
  • Sistema de eventos: Actualizaciones reactivas para saldos, firma y más

Comenzar

Inicio rápido con CLI

npm install -g @vultisig/cli

# Crear bóveda (no interactivo, --two-step omite el aviso OTP)
vultisig create fast --name "bot-wallet" --email "[email protected]" --password "SecurePass123!" --two-step -o json
# Devuelve: {"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}

# Verificar con OTP de correo electrónico
vultisig verify <vaultId> --code 123456 -o json

# Consultar saldos
vultisig balance -o json

→ Documentación completa de CLI

Inicio rápido con SDK

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

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

// Paso 1: Crear bóveda (devuelve vaultId, envía OTP al correo)
const vaultId = await sdk.createFastVault({
  name: 'bot-wallet',
  email: '[email protected]',
  password: 'SecurePass123!'
})

// Paso 2: Verificar con código OTP del correo
const vault = await sdk.verifyVault(vaultId, '123456')

// Paso 3: Usar la bóveda
const balance = await vault.balance(Chain.Ethereum)

// Enviar, intercambiar, firmar — llamadas únicas con cantidades legibles
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')

→ Documentación completa del SDK

Recursos

Skills relacionados