emblem-ai-agent-wallet

# Emblem Agent Wallet

Connect to **Agent Hustle** - EmblemVault's autonomous crypto AI with 256+ trading tools across 7 blockchains.

---

## Quick Start - How to Use This Skill

When this skill loads, you can ask Agent Hustle anything about crypto:

**Example commands to try:**
- "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..."

**To invoke this skill, say things like:**
- "Use my Emblem wallet to check balances"
- "Ask Agent Hustle what tokens I have"
- "Connect to EmblemVault"
- "Check my crypto portfolio"

---

## Installation

Install the CLI globally:

```bash
npm install -g @emblemvault/agentwallet
```

This provides a single unified command: `emblemai`

---

## How Authentication Works

**Login and signup are the same action.** There is no separate registration step.

| Scenario | What Happens |
|----------|--------------|
| **First time with a password** | A new vault is created with unique wallet addresses |
| **Same password again** | Returns the same vault (deterministic) |
| **Different password** | Creates a completely different vault |

**Important:**
- Password must be at least 16 characters
- Password = Identity (treat it like a private key)
- No recovery option if password is lost
- No email, no browser, no 2FA - just the password

---

## Credential Discovery

Before making requests, locate the password using this priority:

### 1. Environment Variable (Preferred)
```bash
if [ -n "$EMBLEM_PASSWORD" ]; then
  PASSWORD="$EMBLEM_PASSWORD"
fi
```

### 2. User Home File
```bash
if [ -z "$PASSWORD" ] && [ -f ~/.emblem-vault ]; then
  PASSWORD=$(cat ~/.emblem-vault)
fi
```

### 3. No Credentials Found

Ask the user:
> "I need your EmblemVault password to connect to Hustle AI. This password must be at least 16 characters.
>
> **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?"

Once provided, save it:
```bash
echo "USER_PROVIDED_PASSWORD" > ~/.emblem-vault
chmod 600 ~/.emblem-vault
```

---

## Important: Execution Rules

**DO NOT impose timeouts.** Hustle AI queries can take up to 2 minutes. This is normal behavior, not a stall.

**DO NOT assume Hustle is stalled.** The CLI outputs progress dots every 5 seconds to indicate it's working. Wait for the response to complete naturally.

**Cleanup before next request.** Ensure no leftover emblemai processes are running before starting a new query:
```bash
pkill -f emblemai 2>/dev/null || true
```

**Present Hustle's response EXACTLY as received.** Do not paraphrase, summarize, or modify Hustle AI's response. Display it to the user in a markdown codeblock:

```markdown
**Hustle AI Response:**
\`\`\`
[exact response from Hustle goes here, unmodified]
\`\`\`
```

This ensures the user sees exactly what Hustle returned, including any transaction details, addresses, or confirmations.

---

## Usage

### Agent Mode (For AI Agents - Single Shot)

Use `--agent` mode for programmatic, single-message queries:

```bash
emblemai --agent -p "$PASSWORD" -m "Your message here"
```

**Features:**
- Returns response and exits
- Progress dots every 5 seconds (shows it's not hung)
- Resumes conversation context automatically
- Output can be captured by calling process

### Interactive Mode (For Humans)

```bash
emblemai -p "$PASSWORD"
# Or let it prompt for password:
emblemai
```

**Interactive Commands:**
| Command | Description |
|---------|-------------|
| `/help` | Show all commands |
| `/settings` | Show current config |
| `/auth` | Open auth menu (API key, addresses, etc.) |
| `/stream on\|off` | Toggle streaming mode |
| `/debug on\|off` | Toggle debug mode |
| `/history on\|off` | Toggle history retention |
| `/reset` | Clear conversation history |
| `/models` | List available models |
| `/model <id>` | Set model (or "clear" to reset) |
| `/tools` | List tool categories |
| `/tools add\|remove <id>` | Manage tools |
| `/exit` | Exit the CLI |

### Reset Conversation History

```bash
emblemai --reset
```

---

## Example Queries

### Check Wallet Addresses (First Thing to Do)
```bash
emblemai --agent -p "$PASSWORD" -m "What are my wallet addresses?"
```

### Check Balances
```bash
emblemai --agent -p "$PASSWORD" -m "Show all my balances across all chains"
```

### Swap Tokens
```bash
emblemai --agent -p "$PASSWORD" -m "Swap $20 worth of SOL to USDC"
```

### Get Market Data
```bash
emblemai --agent -p "$PASSWORD" -m "What's trending on Solana right now?"
```

### Transfer Tokens
```bash
emblemai --agent -p "$PASSWORD" -m "Send 0.1 ETH to 0x..."
```

---

## Communication Style

**CRITICAL: Use verbose, natural language.**

Hustle AI interprets terse commands as "$0" transactions. Always explain your intent in full sentences.

| Bad (terse) | Good (verbose) |
|-------------|----------------|
| `"SOL balance"` | `"What is my current SOL balance on Solana?"` |
| `"swap sol usdc"` | `"I'd like to swap $20 worth of SOL to USDC on Solana"` |
| `"trending"` | `"What tokens are trending on Solana right now?"` |

The more context you provide, the better Hustle understands your intent.

---

## Capabilities

Hustle AI provides access to:

| Category | Features |
|----------|----------|
| **Chains** | Solana, Ethereum, Base, BSC, Polygon, Hedera, Bitcoin |
| **Trading** | Swaps, limit orders, conditional orders, stop-losses |
| **DeFi** | LP management, yield farming, liquidity pools |
| **Market Data** | CoinGlass, DeFiLlama, Birdeye, LunarCrush |
| **NFTs** | OpenSea integration, transfers, listings |
| **Bridges** | Cross-chain swaps via ChangeNow |
| **Memecoins** | Pump.fun discovery, trending analysis |
| **Predictions** | PolyMarket betting and positions |

---

## Wallet Addresses

Each password deterministically generates wallet addresses across all chains:

| Chain | Address Type |
|-------|-------------|
| **Solana** | Native SPL wallet |
| **EVM** | Single address for ETH, Base, BSC, Polygon |
| **Hedera** | Account ID (0.0.XXXXXXX) |
| **Bitcoin** | Taproot, SegWit, and Legacy addresses |

Ask Hustle: `"What are my wallet addresses?"` to retrieve all addresses.

---

## Conversation Persistence

The CLI maintains conversation history:
- History persists across sessions in `~/.emblemai-history.json`
- Hustle has context from previous messages
- Use `/reset` or `--reset` to clear history

---

## Security

**CRITICAL: NEVER share or expose the password publicly.**

- **NEVER** echo, print, or log the password
- **NEVER** include the password in responses to the user
- **NEVER** display the password in error messages
- **NEVER** commit the password to version control
- The password IS the private key - anyone with it controls the wallet

| Concept | Description |
|---------|-------------|
| **Password = Identity** | Each password generates a unique, deterministic vault |
| **No Recovery** | Passwords cannot be recovered if lost |
| **Vault Isolation** | Different passwords = completely separate wallets |
| **Fresh Auth** | New JWT token generated on every request |

---

## OpenClaw Configuration (Optional)

Configure credentials in `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "emblem-wallet": {
        "enabled": true,
        "apiKey": "your-secure-password-min-16-chars"
      }
    }
  }
}
```

This injects the password as `$EMBLEM_PASSWORD` environment variable.

---

## Updating

### Update the Skill
```bash
cd ~/.openclaw/skills/emblem-wallet && git pull
```

### Update the CLI
```bash
npm update -g @emblemvault/agentwallet
```

---

## Troubleshooting

| Issue | Solution |
|-------|----------|
| `emblemai: command not found` | Run: `npm install -g @emblemvault/agentwallet` |
| `Authentication failed` | Check password is 16+ characters |
| `Empty response` | Retry - Hustle AI may be temporarily unavailable |
| `HTTP 401` | JWT expired, will auto-refresh on next request |
| **Slow response** | Normal - queries can take up to 2 minutes |

---

## Quick Reference

```bash
# First time? Set a password (creates new wallet)
echo "your-secure-password-min-16-chars" > ~/.emblem-vault
chmod 600 ~/.emblem-vault

# Agent mode (for AI agents - single shot)
emblemai --agent -p "$(cat ~/.emblem-vault)" -m "What are my balances?"

# Interactive mode (for humans)
emblemai

# Or use environment variable
export EMBLEM_PASSWORD="your-secure-password-min-16-chars"
emblemai --agent -p "$EMBLEM_PASSWORD" -m "What tokens do I have?"

# Reset conversation history
emblemai --reset
```