Communitygithub.com

vultisig/vultisig-sdk

Portefeuille MPC pour agents IA. Opérations cryptographiques sécurisées multi-chaînes avec signature à seuil sur plus de 36 blockchains. Interface CLI (commandes shell) ou SDK (TypeScript) selon votre cas d'usage.

Qu'est-ce que vultisig-sdk ?

Vultisig est un portefeuille MPC (Multi-Party Computation) conçu pour permettre aux agents IA d'effectuer des opérations crypto de manière sécurisée sur plus de 36 blockchains. Contrairement aux portefeuilles traditionnels, les clés privées sont fractionnées entre plusieurs parties à l'aide de la cryptographie à seuil, éliminant tout point de défaillance unique. Cette technologie est particulièrement adaptée aux agents IA et bots d'automatisation car elle permet des signatures instantanées (FastVault) avec un seuil 2-sur-2 (appareil + serveur), sans exposition de phrase mnémonique. Vultisig est disponible via une interface CLI pour les scripts shell et les agents de chat, ou via un SDK TypeScript pour les applications nécessitant un contrôle programmatique, la sécurité des types, et des fonctionnalités avancées comme la découverte de jetons, les flux de prix, la simulation de transactions et les notifications push. Le système prend en charge un large éventail de blockchains couvrant les chaînes EVM, UTXO, Cosmos et d'autres comme Solana, Sui ou Polkadot, et offre des opérations clés telles que création de portefeuilles, envoi, échange, signature et vérification de solde.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vultisig

Vultisig est un portefeuille MPC (Multi-Party Computation) qui permet d'effectuer des opérations cryptographiques sécurisées sur plus de 36 blockchains. Contrairement aux portefeuilles traditionnels, les clés privées sont fractionnées entre plusieurs parties à l'aide de la cryptographie à seuil — il n'existe pas de clé unique à voler.

Pourquoi les portefeuilles MPC pour les agents IA

Les portefeuilles traditionnels stockent une seule clé privée ou phrase mnémonique. En cas de compromission, tous les fonds sont perdus. Le MPC élimine ce risque :

  • Aucun point de défaillance unique : Les clés sont fractionnées entre les parties à l'aide du partage secret cryptographique
  • Sécurité à seuil : Signature 2-sur-2 ou N-sur-M — compromettre une seule partie ne suffit pas
  • Aucune exposition de phrase mnémonique : Aucun mnémonique stocké en texte clair
  • Adapté à l'automatisation : FastVault permet une signature instantanée assistée par serveur pour les bots
  • Confiance programmable : Choisissez la rapidité (FastVault) ou la sécurité maximale (SecureVault)
  • Piste d'audit : Toute signature nécessite une coordination explicite entre plusieurs parties

Choisissez votre interface

Cas d'usageInterfacePourquoi
Chat agent IACLI agent askOpérations crypto en langage naturel en une fois ; utilisez --session pour les échanges multi-tours, --password pour la signature
Scripts shellCLICommandes directes, scriptage facile
Bots d'automatisationCLISimple, pipe vers jq, variables d'environnement
Opérations ponctuellesCLIRapide, pas besoin de code
Applications TypeScript/NodeSDKAPI complète, sécurité des types
Logique de transaction personnaliséeSDKsignBytes, broadcastRawTx
Applications navigateur/ReactSDKSystème d'événements, async/await
Flux de travail complexesSDKContrôle programmatique

Décision rapide

Utilisez Agent Ask si : Vous êtes un agent de codage IA (Claude Code, Opencode, Cursor) qui doit effectuer des opérations crypto via le langage naturel. Chaque appel est unique ; utilisez --session <id> pour poursuivre une conversation précédente. Les opérations de signature nécessitent --password.

Utilisez CLI si : Vous écrivez des scripts shell, avez besoin de commandes rapides, ou souhaitez une sortie JSON redirigée vers d'autres outils.

Utilisez SDK si : Vous développez une application TypeScript, avez besoin d'un contrôle programmatique, ou souhaitez des mises à jour basées sur les événements.

Types de portefeuille

TypeSeuilSignatureMeilleur pour
FastVault2-sur-2 (appareil + serveur)Instantanée (~1-2s)Agents IA, bots, automatisation
SecureVaultN-sur-M (configurable)Coordination multi-appareilsÉquipes, actifs de grande valeur

Pour les agents IA, FastVault est recommandé — signature instantanée sans coordination multi-appareils.

Chaînes prises en charge (36+)

Chaînes EVM (13)

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

Chaînes UTXO (6)

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

Chaînes Cosmos (10)

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

Autres chaînes (7)

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

Opérations principales

CLI et SDK prennent en charge :

  • Créer des portefeuilles : FastVault (instantané) ou SecureVault (multi-appareils)
  • Importer/Exporter : Sauvegarder et restaurer des portefeuilles, importer depuis une phrase mnémonique (BIP39)
  • Adresses : Dériver des adresses pour n'importe quelle chaîne
  • Soldes : Vérifier les soldes natifs et de jetons
  • Envoyer : Transférer des cryptos vers n'importe quelle adresse
  • Échanger : Échanges inter-chaînes via THORChain, intra-chaîne via 1inch et LiFi
  • Signer : Signer des transactions ou des octets arbitraires

Capacités exclusives au SDK :

  • Wrappers composés : send(), swap(), signMessage(), portfolio(), allBalances() — appels uniques avec montants lisibles et résolution automatique des jetons (send/swap prennent en charge dryRun)
  • Découverte de jetons : Rechercher des jetons connus, découvrir des jetons à des adresses
  • Flux de prix : Récupérer les prix des jetons via CoinGecko
  • Analyse de sécurité : Analyse de sites, validation de transactions, simulation de transactions
  • Achat en monnaie fiduciaire : Acheter des cryptos via l'intégration Banxa
  • Signature Cosmos : SignAmino et SignDirect pour les dApps Cosmos
  • Notifications push : Enregistrer des appareils, notifier les membres du portefeuille pour la signature, gérer les événements push entrants
  • Système d'événements : Mises à jour réactives pour les soldes, la signature, et plus

Pour commencer

Démarrage rapide CLI

npm install -g @vultisig/cli

# Créer un portefeuille (non interactif, --two-step ignore la demande OTP)
vultisig create fast --name "bot-wallet" --email "[email protected]" --password "SecurePass123!" --two-step -o json
# Retourne : {"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}

# Vérifier avec l'OTP par e-mail
vultisig verify <vaultId> --code 123456 -o json

# Vérifier les soldes
vultisig balance -o json

→ Documentation complète CLI

Démarrage rapide SDK

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

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

// Étape 1 : Créer un portefeuille (retourne vaultId, envoie OTP par e-mail)
const vaultId = await sdk.createFastVault({
  name: 'bot-wallet',
  email: '[email protected]',
  password: 'SecurePass123!'
})

// Étape 2 : Vérifier avec le code OTP par e-mail
const vault = await sdk.verifyVault(vaultId, '123456')

// Étape 3 : Utiliser le portefeuille
const balance = await vault.balance(Chain.Ethereum)

// Envoyer, échanger, signer — appels uniques avec montants lisibles
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')

→ Documentation complète SDK

Ressources

Skills associés