@dcprotocol/desktop

Cross-platform desktop application built with Tauri and React. Provides a clean GUI for vault management, consent approvals, and agent permissions - perfect for users who prefer visual interfaces over terminal commands.

Download

Download the latest version for your operating system:

Installation

macOS

# Download the .dmg file for your Mac
# - Apple Silicon (M1/M2/M3): DCP-Vault_aarch64.dmg
# - Intel: DCP-Vault_x64.dmg

# 1. Open the .dmg file
# 2. Drag DCP Vault to Applications folder
# 3. Right-click the app and select "Open" (first time only)
# 4. Click "Open" in the security dialog

# Launch from Applications or Spotlight
open -a "DCP Vault"

Windows

# Download DCP-Vault_x64-setup.exe

# 1. Run the installer
# 2. Follow installation wizard
# 3. Launch from Start Menu or Desktop shortcut

# Windows may show SmartScreen warning on first run
# Click "More info" → "Run anyway"

Linux

# Debian/Ubuntu (.deb)
wget https://github.com/1lystore/dcp/releases/latest/download/dcp-vault_amd64.deb
sudo dpkg -i dcp-vault_amd64.deb

# Launch
dcp-vault

# AppImage (Universal)
wget https://github.com/1lystore/dcp/releases/latest/download/dcp-vault_amd64.AppImage
chmod +x dcp-vault_amd64.AppImage
./dcp-vault_amd64.AppImage

Features

Dashboard

Overview of vault status with quick stats and wallet list.

• Wallet Count: Number of configured wallets
• Active Sessions: Currently connected agents
• Pending Consents: Requests awaiting approval
• Wallet List: All blockchain wallets with addresses displayed

Data Management

Store personal information using pre-built templates or custom JSON.

Pre-Built Templates:

• 👤 Your Name: First name, last name, full name
• 📧 Email Address: Email field
• 📱 Phone Number: Country code and number
• 🎂 Birthday: Date of birth
• 🏠 Home Address: Street, city, state, ZIP, country
• 🏢 Work Address: Full business address
• 👕 Clothing Sizes: Shirt, pants, shoe sizes
• 🥗 Dietary Preferences: Restrictions, allergies, preferences
• 🏷️ Brand Preferences: Favorite and avoided brands
• 🔑 API Credentials: Service ID, API key, base URL

Capabilities:

• Add data with user-friendly forms
• Edit existing data
• Delete with confirmation
• Organized by category (Identity, Addresses, Preferences, Credentials)
• Sensitivity indicators for each item
• Modal-based editor

Consent Management

Approve or deny agent requests to access vault.

• Pending Requests: View all waiting for approval
• Transaction Details: Amount, currency, operation type
• Approval Options: Approve once or approve for session
• Desktop Notifications: Get alerted when new consent request arrives
• Auto-Refresh: Polls for new requests every 3 seconds

Activity Log

Complete audit trail of all vault operations.

• Event Types: GRANT, DENY, EXECUTE, READ, REVOKE, CONFIG, EXPIRE
• Filter by Type: Show only specific event categories
• Agent Name: See which agent performed each action
• Scope Information: Which data was accessed
• Timestamps: Precise time for each event
• Outcome Tracking: Success or failure status

Connect Page

Connect vault to relay server and set up remote agents.

Relay Configuration:

• Connect to hosted relay (relay.dcp.1ly.store)
• Configure custom relay URL
• Visual connection status indicator

VPS Agent Setup:

• Generate pairing tokens with custom settings
• Set agent name/service ID
• Choose permissions (checkboxes for signing, reading, budget checks)
• Configure daily budget and currency
• Set auto-approve threshold
• Set token TTL (time to live)
• Copy one-line setup command for VPS

Trusted Services:

• Connect to verified services
• View known services and their connection URLs

Settings

Configure trusted services, budgets, and manage active sessions.

Trusted Services Management:

• Add verified or custom services
• Set service ID and public key
• Select permissions via categorized checkboxes (Signing, Read Data, Write Data, Other)
• Configure per-service daily budget and currency
• Set auto-approve threshold
• Enable/disable services
• Edit existing services
• Revoke service access
• View connection timestamps

Global Budget Configuration:

• Set budgets for all currencies: SOL, ETH, USDC, USDT, BASE_ETH
• Configure daily budget limit per currency
• Set per-transaction limit
• Set auto-approve threshold
• Applies to all agents by default

Active Sessions:

• View all active agent sessions
• See granted scopes for each session
• View consent mode (once or session)
• See expiration times
• Revoke individual sessions
• Revoke all sessions for an agent
• Grouped by agent name

User Interface

The desktop app has a clean, simple interface with navigation at the bottom:

• Dashboard - Overview and stats
• Consent - Pending approval requests
• Data - Personal information management
• Activity - Audit log
• Connect - Relay and VPS setup
• Settings - Services, budgets, sessions

Header shows vault status (Unlocked/Locked) with a Lock button.

Technical Details

Built With

• Tauri: Rust-based framework for native desktop apps
• React: UI built with React 19
• TypeScript: Type-safe frontend code
• Vite: Fast build tooling
• @dcprotocol/core: Vault engine
• @dcprotocol/server: Embedded local server (port 8421)

App Size

System Requirements

• macOS: 10.13+ (High Sierra or later)
• Windows: Windows 10 (1809+) / Windows 11
• Linux: glibc 2.27+ (Ubuntu 18.04+, Debian 10+)
• RAM: 100 MB minimum, 200 MB recommended
• Disk: 50 MB free space

Data Storage

Vault data is stored locally:

Files:

• vault.db - Encrypted SQLite database
• config.json - App settings (not sensitive)

The desktop app runs an embedded server on http://127.0.0.1:8421

Common Workflows

First-Time Setup

1. Download and install DCP Vault
2. Launch application
3. Click "Create New Vault"
4. Enter passphrase (12+ characters)
5. Confirm passphrase
6. ✓ Vault created

7. (Optional) Add your first wallet or data via CLI:
   dcp wallet create solana
   dcp write identity.email your@email.com

Note: The desktop app currently displays wallets/data but creation must be done via CLI.

Approving Agent Requests

1. Agent makes request (e.g., sign transaction)
2. Desktop notification appears
3. Go to "Consent" tab
4. Review request details:
   - Agent name
   - Operation type
   - Amount and currency

5. Choose:
   - Approve Once → Single approval
   - Approve Session → Trust for session
   - Deny → Reject request

6. Activity log automatically updated

Setting Up VPS Agent

1. In desktop app, go to "Connect" tab
2. Under "Run a remote agent (VPS)":
   - Enter VPS name (e.g., "my-trading-bot")
   - Check permissions needed (signing, reading, etc.)
   - Set daily budget (e.g., 10 USDC)
   - Set auto-approve threshold
   - Set token TTL (default: 600 sec)
3. Click "Generate Pairing Token"
4. Click "Copy VPS Command"
5. SSH into VPS and paste command
6. VPS agent connects via relay

Managing Trusted Services

1. Go to "Settings" tab
2. Under "Trusted Services":
   - Choose verified service or "Custom service"
   - Enter service ID and public key
   - Select permissions via checkboxes
   - Set daily budget and currency
   - Set auto-approve threshold
   - Enable service
3. Click "Allow Service"
4. Service can now access vault with granted permissions

Privacy & Security

• No telemetry: App never sends usage data or analytics
• Localhost only: Server binds to 127.0.0.1:8421
• Local-first: Vault stays on your machine
• Sandboxed: Tauri security model isolates app
• Code signing: macOS/Windows builds are signed
• Open source: Full source code available for audit

Troubleshooting

App Won't Launch (macOS)

# Error: "App is damaged and can't be opened"
# Solution: Remove quarantine attribute

xattr -cr /Applications/DCP\ Vault.app

# Then right-click → Open

SmartScreen Warning (Windows)

# Windows SmartScreen may show warning
# This is normal for new apps

# To proceed:
1. Click "More info"
2. Click "Run anyway"

Vault Locked on Launch

# If vault is locked:
1. Enter passphrase in unlock dialog
2. Click "Unlock"

Relay Connection Failed

# Check relay connection:
1. Go to "Connect" tab
2. Check connection status badge
3. If disconnected:
   - Click "Use relay.dcp.1ly.store"
   - Click "Save Relay"
   - Wait for connection

Comparison with CLI

See Also

• @dcprotocol/cli - Command-line interface
• @dcprotocol/server - Embedded server
• Getting Started Guide - Initial setup
• GitHub Releases - Download all versions