Communitygithub.com

vultisig/vultisig-sdk

AI 에이전트를 위한 MPC 지갑. 임계값 서명을 사용하여 36개 이상의 블록체인에서 안전한 멀티체인 암호화폐 작업을 지원합니다. 사용 사례에 따라 CLI(쉘 명령어) 또는 SDK(TypeScript)로 연결됩니다.

vultisig-sdk란 무엇인가요?

Vultisig는 MPC(다자간 계산) 지갑으로, AI 에이전트가 36개 이상의 블록체인에서 안전하게 암호화폐 작업을 수행할 수 있도록 합니다. 기존 지갑과 달리 개인 키가 여러 당사자에 분할되어 임계값 암호화 기술로 보호되므로 단일 키 탈취 위험이 없습니다. FastVault는 AI 에이전트 및 봇에 적합한 즉시 서명(약 1-2초)을 제공하고, SecureVault는 다중 장치 조정이 필요한 팀이나 고가치 자산에 적합합니다. CLI(`agent ask` 명령어)는 자연어로 암호화 작업을 수행할 수 있어 Claude Code, Opencode, Cursor 같은 AI 코딩 에이전트에 최적화되어 있으며, SDK는 TypeScript 애플리케이션에 완전한 API와 타입 안전성을 제공합니다. 주요 기능으로는 볼트 생성, 주소 파생, 잔액 조회, 전송, 스왑(THORChain, 1inch, LiFi), 서명, 토큰 검색, 가격 피드, 보안 스캔, 법정화폐 온램프 등이 있습니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Vultisig

Vultisig는 MPC(다자간 계산) 지갑으로, 36개 이상의 블록체인에서 안전한 암호화폐 작업을 가능하게 합니다. 기존 지갑과 달리 개인 키는 임계값 암호화 기술을 사용하여 여러 당사자에 분할됩니다. 탈취할 단일 키가 없습니다.

AI 에이전트를 위한 MPC 지갑의 중요성

기존 지갑은 단일 개인 키나 시드 구문을 저장합니다. 손상되면 모든 자금이 손실됩니다. MPC는 이 위험을 제거합니다:

  • 단일 실패 지점 없음: 키는 암호화 비밀 공유를 통해 당사자 간에 분할됩니다
  • 임계값 보안: 2/2 또는 N/M 서명 - 하나의 당사자가 손상되어도 충분하지 않습니다
  • 시드 구문 노출 없음: 어떤 곳에도 일반 텍스트로 니모닉이 저장되지 않습니다
  • 자동화 친화적: FastVault는 봇을 위한 즉시 서버 지원 서명을 가능하게 합니다
  • 프로그래밍 가능한 신뢰: 속도(FastVault) 또는 최대 보안(SecureVault) 선택 가능
  • 감사 추적: 모든 서명은 명시적인 다자간 조정이 필요합니다

인터페이스 선택

사용 사례인터페이스이유
AI 에이전트 채팅CLI agent ask원샷 자연어 암호화 작업; 다중 턴에는 --session, 서명에는 --password 사용
쉘 스크립트CLI직접 명령어, 쉬운 스크립팅
자동화 봇CLI간단함, jq로 파이프, 환경 변수
일회성 작업CLI빠름, 코드 불필요
TypeScript/Node 앱SDK전체 API, 타입 안전성
사용자 정의 트랜잭션 로직SDKsignBytes, broadcastRawTx
브라우저/React 앱SDK이벤트 시스템, async/await
복잡한 워크플로우SDK프로그램 제어

빠른 결정

다음의 경우 Agent Ask 사용: 자연어로 암호화 작업을 수행해야 하는 AI 코딩 에이전트(Claude Code, Opencode, Cursor)인 경우. 각 호출은 원샷입니다. 이전 대화를 계속하려면 --session <id>를 전달하세요. 서명 작업에는 --password가 필요합니다.

다음의 경우 CLI 사용: 쉘 스크립트를 작성 중이거나, 빠른 명령어가 필요하거나, 다른 도구로 파이프할 JSON 출력이 필요한 경우.

다음의 경우 SDK 사용: TypeScript 애플리케이션을 구축 중이거나, 프로그램 제어가 필요하거나, 이벤트 기반 업데이트를 원하는 경우.

볼트 유형

유형임계값서명최적 용도
FastVault2/2 (장치 + 서버)즉시 (~1-2초)AI 에이전트, 봇, 자동화
SecureVaultN/M (구성 가능)다중 장치 조정팀, 고가치 자산

AI 에이전트의 경우 FastVault를 권장합니다 - 다중 장치 조정 없이 즉시 서명 가능.

지원 체인 (36개 이상)

EVM 체인 (13개)

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

UTXO 체인 (6개)

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

Cosmos 체인 (10개)

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

기타 체인 (7개)

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

핵심 작업

CLI와 SDK 모두 지원:

  • 볼트 생성: FastVault(즉시) 또는 SecureVault(다중 장치)
  • 가져오기/내보내기: 볼트 백업 및 복원, 시드 구문(BIP39)에서 가져오기
  • 주소: 모든 체인에 대한 주소 파생
  • 잔액: 네이티브 및 토큰 잔액 확인
  • 전송: 모든 주소로 암호화폐 전송
  • 스왑: THORChain을 통한 교차 체인 스왑, 1inch 및 LiFi를 통한 동일 체인 스왑
  • 서명: 트랜잭션 또는 임의 바이트 서명

SDK 전용 기능:

  • 컴파운드 래퍼: send(), swap(), signMessage(), portfolio(), allBalances() — 사람이 읽을 수 있는 금액과 자동 토큰 확인을 통한 단일 호출 작업(send/swap은 dryRun 지원)
  • 토큰 검색: 알려진 토큰 조회, 주소에서 토큰 발견
  • 가격 피드: CoinGecko를 통한 토큰 가격 가져오기
  • 보안 스캔: 사이트 스캔, 트랜잭션 검증, 트랜잭션 시뮬레이션
  • 법정화폐 온램프: Banxa 통합을 통한 암호화폐 구매
  • Cosmos 서명: Cosmos dApp용 SignAmino 및 SignDirect
  • 푸시 알림: 장치 등록, 서명을 위한 볼트 멤버 알림, 들어오는 푸시 이벤트 처리
  • 이벤트 시스템: 잔액, 서명 등에 대한 반응형 업데이트

시작하기

CLI 빠른 시작

npm install -g @vultisig/cli

# 볼트 생성 (비대화형, --two-step은 OTP 프롬프트 건너뛰기)
vultisig create fast --name "bot-wallet" --email "[email protected]" --password "SecurePass123!" --two-step -o json
# 반환: {"vaultId": "...", "status": "pending_verification", "verifyCommand": "..."}

# 이메일 OTP로 인증
vultisig verify <vaultId> --code 123456 -o json

# 잔액 확인
vultisig balance -o json

→ 전체 CLI 문서

SDK 빠른 시작

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

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

// 1단계: 볼트 생성 (vaultId 반환, 이메일로 OTP 전송)
const vaultId = await sdk.createFastVault({
  name: 'bot-wallet',
  email: '[email protected]',
  password: 'SecurePass123!'
})

// 2단계: 이메일 OTP 코드로 인증
const vault = await sdk.verifyVault(vaultId, '123456')

// 3단계: 볼트 사용
const balance = await vault.balance(Chain.Ethereum)

// 전송, 스왑, 서명 — 사람이 읽을 수 있는 금액으로 단일 호출
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')

→ 전체 SDK 문서

리소스

관련 스킬