# Vultisig SDK

The Vultisig SDK gives developers and AI agents direct access to Vultisig's multi-party computation (MPC) technology. Instead of relying on seed phrases that create a single point of failure, the SDK splits wallet keys across multiple devices using threshold signatures. The result: secure, self-custodial wallets that work across 40+ blockchains.

Whether you're building a web app, a backend service, or an AI agent that needs to hold and move crypto — the SDK handles vault creation, balance checks, token swaps, and transaction signing.

## What Can You Build With It?

* **Web3 applications** — Onboard users into seedless, cross-chain wallets with MPC security built in
* **AI agent wallets** — Give autonomous agents their own self-custodial crypto wallets, with optional human co-signing for oversight
* **Backend services** — Programmatic vault creation, balance checks, swaps, and signing from your server
* **Desktop & browser apps** — Works in Electron, any modern browser, and Node.js

## How It Works

The SDK supports two vault types:

* **Fast Vault** — A 2-of-2 setup between your app and VultiServer. Signing is instant. Great for quick setup and individual use.
* **Secure Vault** — A multi-device setup (2-of-3, 3-of-5, etc.) where multiple devices must approve transactions. Other participants join by scanning a QR code with the Vultisig mobile app. Best for teams or high-value wallets.

Both vault types support 40+ chains including Bitcoin, Ethereum, Solana, THORChain, Cosmos, and the broader EVM, UTXO, and Cosmos ecosystems. Cross-chain swaps are powered by THORChain, with 1inch for same-chain DEX trades and LiFi for cross-EVM routes.

There's also a full CLI (`@vultisig/cli`) that mirrors the SDK's capabilities from the command line.

## For AI Agents

AI agents can use the SDK or CLI to create wallets, check balances, send tokens, and execute swaps autonomously. Two trust models are available:

| Mode             | How it works                  | Signing                    | Use case                             |
| ---------------- | ----------------------------- | -------------------------- | ------------------------------------ |
| **Fast Vault**   | Agent + VultiServer (2-of-2)  | Instant, no human needed   | Full agent autonomy                  |
| **Secure Vault** | Agent + human device (2-of-2) | Human approves via QR scan | Human oversight on every transaction |

The CLI makes agent integration simple:

```bash
npm install -g @vultisig/cli

vultisig create
vultisig balance ethereum -o json
vultisig send ethereum 0xRecipient 0.1
vultisig swap ethereum bitcoin 0.1
```

JSON output, silent mode, and environment variable config (`VAULT_PASSWORD`) plug directly into agent pipelines. Stateless usage is also supported — load a vault file, operate, discard.

For the full agent operating procedure, see [vultisig.com/SKILL.md](https://vultisig.com/SKILL.md).

## Getting Started

Install the SDK:

```bash
npm install @vultisig/sdk
```

Create a vault and start using it:

```typescript
import { Vultisig, MemoryStorage } from '@vultisig/sdk'

const sdk = new Vultisig({ storage: new MemoryStorage() })
await sdk.initialize()

const vaultId = await sdk.createFastVault({
  name: 'My Wallet',
  email: 'user@example.com',
  password: 'SecurePassword123!',
})

const vault = await sdk.verifyVault(vaultId, code)

const address = await vault.address('Ethereum')
const balance = await vault.balance('Ethereum')
```

For the full API reference, CLI documentation, and detailed usage guides, head to the developer docs:

{% content-ref url="/pages/wmX4xojbg9FnrrhCOGPW" %}
[SDK](/developer-docs/vultisig-sdk.md)
{% endcontent-ref %}

## Resources

* [SDK Repository on GitHub](https://github.com/vultisig/vultisig-sdk)
* [AI Agent Operating Procedure (SKILL.md)](https://vultisig.com/SKILL.md)
* [Machine-readable Agent Manifest (agent.json)](https://vultisig.com/.well-known/agent.json)
* [Full SDK & CLI Documentation](/developer-docs/vultisig-sdk.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vultisig.com/ecosystem/vultisig-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.