## Script Reference

Run `bash scripts/rugcheck.sh help` for all commands:

| Command | Description |
|---------|-------------|
| `summary <mint>` | Risk score (0-100 normalized), risk flags, LP lock % |
| `report <mint>` | Full report: metadata, holders, markets, creator info |
| `insiders <mint>` | Insider/connected wallet graph |
| `lockers <mint>` | LP vault/locker info (locked liquidity details) |
| `votes <mint>` | Community votes on the token |
| `leaderboard` | Top voters/analysts on the platform |
| `domains` | Registered Solana domains |
| `trending` | Most voted tokens in past 24h |
| `new` | Recently detected tokens |
| `recent` | Most viewed tokens in past 24h |
| `verified` | Recently verified tokens |

## Interpreting Results

### Summary Response

Key fields from `/v1/tokens/{mint}/report/summary`:

- **`score_normalised`** — Risk score 0-100. Higher = riskier. Below 1000 raw score ≈ "Good".
  - 0-30: Low risk (Good)
  - 30-60: Medium risk (caution)
  - 60-100: High risk (danger)
- **`risks[]`** — Array of risk flags, each with:
  - `name`: Risk type (e.g. "Mutable metadata", "Low Liquidity", "Single holder ownership")
  - `level`: `"warn"` or `"danger"`
  - `value`: Human-readable detail (e.g. "$102.55", "40.00%")
  - `description`: Explanation
  - `score`: Raw risk contribution
- **`lpLockedPct`** — Percentage of LP tokens locked (0 = none locked, very risky)
- **`tokenProgram`** — SPL token program used
- **`tokenType`** — Token type classification

### Full Report Response

Additional fields from `/v1/tokens/{mint}/report`:

- **`tokenMeta`** — Name, symbol, URI, `mutable` flag, `updateAuthority`
- **`token`** — Supply, decimals, `mintAuthority`, `freezeAuthority`
- **`creator`** / `creatorBalance` — Token creator wallet and their current balance
- **`topHolders[]`** — Top holders with `address`, `owner`, `pct` (percentage), `uiAmount`
- **`markets[]`** — DEX markets/pools with liquidity data
- **`insiderNetworks`** — Connected insider wallet clusters

## Red Flag Checklist

When analyzing a token, flag these risks to the user:

1. **Mutable metadata** (`tokenMeta.mutable == true`) — Creator can change token name/image
2. **Low liquidity** (risk with `"Low Liquidity"` or check market data) — Easy to manipulate price
3. **High holder concentration** — Top 10 holders > 50% supply
4. **Single holder dominance** — One wallet holds >20% supply
5. **LP not locked** (`lpLockedPct == 0`) — Creator can pull liquidity anytime
6. **Mint authority exists** (`token.mintAuthority != null`) — Can mint infinite tokens
7. **Freeze authority exists** (`token.freezeAuthority != null`) — Can freeze wallets
8. **Few LP providers** — Only 1-2 wallets providing liquidity
9. **Low/zero trade volume** — No real market activity
10. **Creator holds large balance** — Creator still sitting on supply

## Presenting Results

Format findings clearly for the user. Example:

# Get risk summary (score + flags)
bash scripts/rugcheck.sh summary <MINT_ADDRESS>

# Get full detailed report (holders, markets, metadata, LP)
bash scripts/rugcheck.sh report <MINT_ADDRESS>

🔍 RugCheck Analysis: CLWDN (ClawdNation)
Mint: 3zvSRWfjPvcnt8wfTrKhgCtQVwVSrYfBY6g1jPwzfHJG

⚠️ Risk Score: 59/100 (Medium-High Risk)

🚩 Risk Flags:
  🔴 Low Liquidity — $102.55
  ⚠️ Single holder ownership — 40.00%
  ⚠️ High holder concentration — Top 10 hold >50%
  ⚠️ Low amount of holders
  ⚠️ Low LP providers
  ⚠️ Mutable metadata

🔓 LP Locked: 0% (NOT LOCKED)

📊 Top Holders:
  1. 40.0% — 3Y3g...p7rk
  2. 15.0% — 5bNH...4VGj
  3. 15.0% — 4dkX...Ncg6
  4. 10.0% — 8yY2...CKn8
  5. 10.0% — 2MT5...eB3h

Verdict: HIGH RISK — Multiple red flags. No locked liquidity,
concentrated holdings, mutable metadata. Exercise extreme caution.