JasperVault CLI

Trade perpetual contracts with built-in hedge protection on JasperVault. Connect your AI agent, set up your wallet via browser signing, and trade with natural language — your private keys never leave your browser.

Why JasperVault

PPO: On-Chain Hedge Option Protection

JasperVault is the first perpetuals protocol with integrated PPO (Perpetual Protection Option) — an on-chain hedge option that automatically protects your position against sudden price wicks and liquidation cascades.

The problem: In leveraged perpetual trading, flash crashes and price wicks ("pin bars") can liquidate positions in seconds, even when the market quickly recovers. Stop-loss orders often fail to protect against these events because they execute at the wick price, locking in losses.

The solution: PPO attaches a real option contract to your perpetual position. When the market spikes against you:

• Your position survives the wick — the option payoff offsets the unrealized loss, preventing liquidation
• No slippage risk — unlike stop-losses, PPO is peer-to-peer fully collateralized settlement, not dependent on orderbook depth
• Automatic hedge type — LONG positions get PUT protection, SHORT positions get CALL protection
• Flexible configuration — choose ATM or OTM strikes (tiers 1-5, 0.1%–0.5% offset), 30-minute or 8-hour expiry

Without PPO:  Price wick → Liquidation → Position gone → Market recovers → You're out
With PPO:     Price wick → Option payoff absorbs loss → Position survives → Market recovers → You profit

Trade via AI, Not Dashboards

The CLI bridges AI agents and JasperVault — tell your AI what you want in plain language, and it executes the full workflow: wallet setup, deposits, order placement, TP/SL, and PPO management.

Quick Start

# 1. Install
npm install -g jaspervault_cli

# 2. Connect to your AI platform
jv install --ai claude       # Claude Code
jv install --ai cursor       # Cursor
jv install --ai openclaw     # OpenClaw

# 3. Start trading — open your AI agent and say:
# "Long BTC with 100 USDC at 50x leverage"

What You Can Do

| Action | Example | |--------|---------| | Deposit | "Deposit 500 USDC" | | Open position | "Long BTC with 100 USDC at 50x leverage" | | Limit order | "Short BTC with 50 USDC at 95000" | | View positions | "Show my positions" | | Price query | "What's the current BTC price?" | | Take-profit | "Set TP at 110000 for order 99" | | Stop-loss | "Set SL at 88000 for order 99" | | Add PPO | "Add PPO protection to order 42" | | Custom PPO | "Protect order 42 with OTM tier 3 for 8 hours" | | Open with PPO | "Long BTC with 100 USDC and hedge protection" | | Close position | "Close my BTC position" | | Withdraw | "Withdraw 100 USDC" |

Platform Support

| Platform | Install | Integration | |----------|---------|-------------| | Claude Code | jv install --ai claude | MCP server (project-level) | | Claude Code (global) | jv install --ai claude --global | MCP server (user-level) | | Cursor | jv install --ai cursor | MCP server (project-level) | | Cursor (global) | jv install --ai cursor --global | MCP server (user-level) | | OpenClaw | jv install --ai openclaw | Skill-based execution | | All platforms | jv install | Global install to all |

How It Works

You (natural language) → AI Agent → MCP Server → CLI → JasperVault API → Blockchain

1. Browser-based signing — Connect your wallet through a hosted web page. No private key export required.
2. Delegation model — Sign once to authorize a local delegation key. Your AI executes trades without repeated approvals.
3. Cross-chain deposits — Bridge assets from Base to JasperVault via Hyperlane, all through the same conversational interface.

Documentation

• User Guide — Complete CLI reference, PPO details, and configuration
• OpenClaw Guide — Step-by-step setup for OpenClaw users

Security & Trust Model

Non-Custodial — We Never Hold Your Keys

• JasperVault and the CLI do not hold, store, or have access to your private keys at any point — your keys remain exclusively in your browser wallet
• Trade execution uses a locally generated delegation key (~/.jaspervault/keys.json), which is scoped to the operations you explicitly authorized and stored only on your device
• No secrets are shared with AI platforms, MCP servers, or third-party services

On-Chain Settlement

• All perpetual positions and PPO hedge options are peer-to-peer with fully collateralized counterparties — no pooled fund risk
• Every operation is executed and settled on-chain via smart contracts with EIP-712 typed signatures
• Cross-chain deposits use Hyperlane's verified message passing