Packages
| Package | Purpose |
|---|---|
@joyride/core | Shared clients, normalized types, wallet auth (SIWS), keystore encryption, and pricing helpers |
joyride-cli | Human-facing terminal workflow for quoting, trading, wallet management, and streaming |
@joyride/mcp-server | MCP server (23 tools) for Claude, Cursor, Copilot, and other AI agents |
Current role of the SDK
The SDK sits on top of the exchange APIs and does two main jobs:- normalizes wire-format responses into TypeScript-friendly shapes
- packages workflows for humans (CLI) and AI agents (MCP server)
Access and installation
You can integrate directly against Joyride’s hosted HTTP and WebSocket APIs without using SDK packages. For alpha access, Joyride distributes the CLI and MCP server directly to testers. After installation, verify:engineering@joyride.exchange.
Authentication
The SDK uses Solana wallet-based authentication via SIWS (Sign-In with Solana). Wallets are encrypted locally with AES-256-GCM + scrypt and stored as keystore files in~/.joyride/wallets/.
Auth resolution priority:
JOYRIDE_PRIVATE_KEYenv var (Base58 key, bypasses keystore)- Keystore +
JOYRIDE_KEYSTORE_PASSWORDenv var - Keystore + interactive passphrase prompt (CLI only, TTY mode)
Guides
- Agent Quickstart — the fastest path for Claude Code, Cursor, and other local MCP clients
- CLI Guide — install, configure, and trade from the terminal
- MCP Server Guide — connect AI agents to Joyride