clawdex

# ClawDex — Solana DEX Trading Skill

Trade any Solana token through Jupiter aggregator with simulation, safety guardrails, and full JSON output.

## Prerequisites

Before using this skill, ensure ClawDex is installed and configured:

```bash
which clawdex || npm install -g clawdex@latest
```

If not configured yet, run onboarding:
```bash
clawdex status --json
```
If status fails, set up with:
```bash
clawdex onboarding \
  --jupiter-api-key "$JUPITER_API_KEY" \
  --rpc "${SOLANA_RPC_URL:-https://api.mainnet-beta.solana.com}" \
  --wallet ~/.config/solana/id.json \
  --json
```

## Commands

### Check wallet balances

```bash
clawdex balances --json
```

Returns an array of `{ token, symbol, mint, balance, decimals }` objects. Zero-balance accounts are included in JSON output.

### Get a quote (no execution)

```bash
clawdex quote --in SOL --out USDC --amount 0.01 --json
```

Lightweight price check — no simulation, no wallet needed.

### Simulate a swap (dry run)

```bash
clawdex swap --in SOL --out USDC --amount 0.01 --simulate-only --json
```

Runs full simulation on-chain without broadcasting. Does not require `--yes`. Use this to preview the output amount and route before committing.

### Execute a swap

```bash
clawdex swap --in SOL --out USDC --amount 0.01 --yes --json
```

**`--yes` is required** for non-interactive execution. Without it, ClawDex exits with code 1.

### Health check

```bash
clawdex status --json
```

Verify RPC connectivity, wallet validity, and config state.

## Trading Workflow

Always follow this sequence:

1. **Health check** — `clawdex status --json` — abort if `rpc.healthy` is false
2. **Check balances** — `clawdex balances --json` — verify sufficient funds
3. **Simulate** — `clawdex swap --simulate-only --json` — preview the trade
4. **Execute** — `clawdex swap --yes --json` — only if simulation looks good
5. **Verify** — `clawdex balances --json` — confirm balances updated (may need 5s delay on public RPC)

## Token Specification...