Connect to EmblemVault and manage crypto wallets via EmblemAI. Supports Solana, Ethereum, Base, BSC, Polygon, Hedera, and Bitcoin. Use when the user wants to trade crypto, check balances, swap tokens, interact with blockchain wallets, or create and use profile-scoped agent wallets.

Emblem Agent Wallet Connect to EmblemAI EmblemVault's autonomous crypto AI with 250+ trading tools across 7 blockchains. Browser auth, streaming responses, profile scoped local state, plugin system, and zero config agent mode. Requires the CLI : npm install g @emblemvault/agentwallet Quick Start How to Use This Skill Step 1: Install the CLI This provides a single command: emblemai Step 2: Use it When this skill loads, you can ask EmblemAI anything about crypto: "What are my wallet addresses?" "Show my balances across all chains" "What's trending on Solana?" "Swap $20 of SOL to USDC" "Send 0.1 ETH to 0x..." For zero config agent provisioning, a profile can create and persist its own wallet with a single command: To invoke this skill, say things like: "Use my Emblem wallet to check balances" "Ask EmblemAI what tokens I have" "Connect to EmblemVault" "Check my crypto portfolio" "Create or use my agent wallet profile and show my addresses" All requests are routed through emblemai under the hood. If more than one profile exists, every agent mode invocation must include profile <name . Prerequisites Node.js = 20.18.0 Terminal with 256 color support (iTerm2, Kitty, Windows Terminal, or any xterm compatible terminal) Optional : [glow](https://github.com/charmbracelet/glow) for rich markdown rendering ( brew install glow on macOS) Installation From npm (Recommended) From source First Run 1. Install: npm install g @emblemvault/agentwallet 2. Create or pick a profile: emblemai profile create hustle 3. Run either emblemai profile hustle or emblemai agent profile hustle m "What are my wallet addresses?" 4. Check /plugins to see which plugins loaded 5. Type /help to see all commands 6. Back up profile auth immediately after first wallet creation Authentication EmblemAI v3 supports two authentication methods with profile scoped local state: browser auth for interactive use and password auth for agent/scripted use. Profile Rules Profiles are the canonical multi agent isolation mechanism. emblemai profile list emblemai profile create <name emblemai profile use <name emblemai profile inspect [name] emblemai profile delete <name emblemai profile <name ... Fail closed rule: if more than one profile exists in ~/.emblemai , every agent invocation must include profile <name . Agent mode never guesses which wallet identity to use. Using separate HOME directories is optional isolation, not the primary pattern. Prefer profiles first. Browser Auth (Interactive Mode) When you run emblemai profile <name without p , the CLI: 1. Checks the selected profile for a saved session 2. If a valid (non expired) session exists, restores it instantly no login needed 3. If no session, starts a local server on 127.0.0.1:18247 and opens your browser 4. You authenticate via the EmblemVault auth modal in the browser 5. The session JWT is captured, saved to that profile on disk, and the CLI proceeds 6. If the browser can't open, the URL is printed for manual copy paste 7. If authentication times out (5 minutes), falls back to a password prompt for the same profile Password Auth (Agent Mode) Login and signup are the same action. The first use of a password creates a vault; subsequent uses of the same password return the same vault. Different passwords produce different wallets, while profiles isolate the local session and stored credentials around those wallets. In agent mode, if no password is provided for the selected profile, a secure random password is auto generated and stored encrypted via dotenvx under ~/.emblemai/profiles/<name / . Agent mode works out of the box with no manual setup. What Happens on Authentication 1. The selected profile is resolved 2. Browser auth: session JWT is received from browser and hydrated into the SDK Password auth: password is sent to EmblemAuthSDK.authenticatePassword() and can be stored in the selected profile for reuse 3. A deterministic vault is derived same credentials always yield the same vault 4. The session provides wallet addresses across multiple chains: Solana, Ethereum, Base, BSC, Polygon, Hedera, Bitcoin 5. The EmblemAI client is initialized with the profile's session Credential Discovery Before making requests for a profile, locate the password using this priority: Method How to use Priority CLI argument emblemai profile <name p "your password" 1 (highest, stored encrypted) Environment variable EMBLEM PASSWORD="your password" emblemai profile <name 2 (not stored) Encrypted credential dotenvx encrypted ~/.emblemai/profiles/<name /.env 3 Auto generate (agent mode) emblemai agent profile <name ... on first run 4 Interactive prompt Fallback when browser auth fails 5 (lowest) Interactive mode resolves auth for the selected profile in this order: saved session, stored password, browser auth modal, then terminal password prompt. If no credentials are found for the selected profile, agent mode can auto generate and store them automatically. Ask the user for a password only when they explicitly want to connect an existing password derived wallet: "I can create a fresh EmblemVault wallet for this profile automatically, or connect an existing wallet if you enter the original password locally in the CLI. Note: If this is your first time, entering a new password will create a new wallet. If you've used this before, use the same password to access your existing wallet. Would you like to provide a password for this profile in the terminal?" Password must be 16+ characters No recovery if lost (treat it like a private key) Execution Notes Allow sufficient time. EmblemAI queries may take up to 2 minutes for complex operations (trading, cross chain lookups). The CLI outputs progress dots every 5 seconds to indicate it's working. Present EmblemAI's response clearly. Display the response from EmblemAI to the user in a markdown codeblock: Usage Agent Mode (For AI Agents Single Shot) Use agent mode for programmatic, single message queries with profile scoped auth: Any system that can shell out to a CLI can give its agents a wallet: Profiles are the primary way to isolate agent wallets. To give multiple agents separate wallets, use different profiles: Agent mode always uses password auth (never browser auth), retains conversation history between calls for the selected profile, and supports the full EmblemAI toolset including trading, transfers, portfolio queries, and cross chain operations. Interactive Mode (For Humans) Readline based interactive mode with streaming AI responses, glow markdown rendering, and slash commands. Reset Conversation Interactive Commands All commands are prefixed with / . Type them in the input bar and press Enter. General Command Description /help Show all available commands /settings Show current configuration (vault ID, model, streaming, debug, tools) /exit Exit the CLI (also: /quit ) Profiles Command Description /profile List profiles with current/default markers /profile create <name Create a named profile /profile use <name Switch this session and new sessions to a profile /profile inspect [name] Inspect profile metadata, files, and runtime wallet info /profile delete <name Delete a noncurrent profile If more than one profile exists, every agent mode CLI invocation must include profile <name . Chat and History Command Description /reset Clear conversation history and start fresh /clear Alias for /reset /history on\ off Toggle history retention between messages /history Show history status and recent messages Streaming and Debug Command Description /stream on\ off Toggle streaming mode (tokens appear as generated) /stream Show current streaming status /debug on\ off Toggle debug mode (shows tool args, intent context) /debug Show current debug status Model Selection Command Description /model <id Set the active model by ID /model clear Reset to the CLI's default model /model Show currently selected model /models Show current model and curated default choices /models use <number\ id Pick one of the curated default models /models search <query Fuzzy search OpenRouter models and pick one via /model <number\ id Tool Management Command Description /tools List all tools with selection status /tools add <id Add a tool to the active set /tools remove <id Remove a tool from the active set /tools clear Clear tool selection (enable auto tools mode) When no tools are selected, the AI operates in auto tools mode , dynamically choosing appropriate tools based on conversation context. Authentication Command Description /auth Open authentication menu /wallet Show wallet addresses (EVM, Solana, BTC, Hedera) /portfolio Show portfolio (routes as a chat query) The /auth menu provides: Option Description 1. Get API Key Fetch your vault API key 2. Get Vault Info Show vault ID, addresses, creation date 3. Session Info Show current session details (identifier, expiry, auth type) 4. Refresh Session Refresh the auth session token 5. EVM Address Show your Ethereum/EVM address 6. Solana Address Show your Solana address 7. BTC Addresses Show your Bitcoin addresses (P2PKH, P2WPKH, P2TR) 8. Backup Agent Auth Export the current profile's auth material to a backup file 9. Logout Clear the current profile session and exit (encrypted credentials remain on disk) Payment (PAYG Billing) Command Description /payment Show PAYG billing status (enabled, mode, debt, tokens) /payment enable\ disable Toggle pay as you go billing /payment token <TOKEN Set payment token (SOL, ETH, HUSTLE, etc.) /payment mode <MODE Set payment mode: pay per request or debt accumulation Markdown Rendering Command Description /glow on\ off Toggle markdown rendering via glow /glow Show glow status and version Requires [glow](https://github.com/charmbracelet/glow) to be installed. Logging Command Description /log on\ off Toggle stream logging to file /log Show logging status and file path Log file defaults to ~/.emblemai stream.log . Override with log file <path . Keyboard Shortcuts Key Action Enter Send message Up Recall previous input Ctrl+C Exit Ctrl+D Exit (EOF) CLI Flags Flag Alias Description profile <name Select a named wallet profile for the invocation password <pw p Authentication password (16+ chars) skips browser auth message <msg m Message for agent mode agent a Run in agent mode (single shot, password auth only; requires profile when multiple profiles exist) restore auth <path Restore credentials from backup file into the selected profile and exit reset Clear conversation history and exit debug Start with debug mode enabled stream Start with streaming enabled (default: on) log Enable stream logging log file <path Override log file path (default: ~/.emblemai stream.log ) hustle url <url Override EmblemAI server URL auth url <url Override auth service URL api url <url Override API service URL Environment Variables Variable Description EMBLEM PASSWORD Authentication password CLI arguments override environment variables when both are provided. Profile scoped

emblem-ai-agent-wallet