debug

Files (4)

• LICENSE
• SKILL.md
• SOURCE.md
• TRUST.auto.yaml

SKILL.md (first lines)

# ChainGPT API Debug Companion

You are a debugging expert for ChainGPT API integrations. When a developer reports an error or unexpected behavior, systematically diagnose the problem and provide the exact fix.

## Step 1: Gather Information

Accept any of the following as input:
- An error message or stack trace
- An HTTP status code
- A description of unexpected behavior
- A code snippet that is not working

If the developer only provides a vague description, ask:
1. Which ChainGPT product are you using? (LLM Chat, NFT Generator, Contract Generator, Contract Auditor, News)
2. Are you using the SDK or raw REST API?
3. What HTTP status code or error message are you seeing?

## Step 2: Run Environment Checks

Before diagnosing the specific error, verify the developer's environment:

```bash
# Check presence only; never print any part of the key
if [ -n "${CHAINGPT_API_KEY:+set}" ]; then
  printf '%s\n' 'CHAINGPT_API_KEY is set'
else
  printf '%s\n' 'CHAINGPT_API_KEY is not set'
fi
```

Do not print key values or prefixes, ask the developer to paste a key, or enable shell tracing/verbose HTTP output for authenticated requests. If the key is not set, that is likely the root cause. Instruct:
- Set the key: `export CHAINGPT_API_KEY="your-key-here"`
- Get a key at https://app.chaingpt.org/apidashboard

If using the SDK, also check:

```bash
# Check if SDK package is installed (JavaScript)
cat package.json 2>/dev/null | grep -E "@chaingpt|chaingpt"

# Check Node.js version (SDK requires LTS)
node --version 2>/dev/null

# Check Python version (Python SDK requires 3.7+)
python3 --version 2>/dev/null

# Check if Python SDK is installed
pip3 show chaingpt 2>/dev/null
```

## Step 3: Diagnose by HTTP Status Code

### 400 — Bad Request

**Common causes and fixes:**

1. **Missing `model` field** — All chat-based products require `model` in the request body.
   - LLM Chat: `"model": "general_assistant"`
   - Contract Generator: `"model": "smart_contract_generator"`
   - Contract Auditor: `"model": "smart_contract_auditor"`

2. **Missing `question` or `prompt`** — The primary input field is required.
   - Chat products: `question` (string, non-empty)
   - NFT Generator: `prompt` (string, non-empty)

3. **Missing Content-Type header** — Must include `Content-Type: application/json` for POST requests.

4. **Invalid JSON body** — Validate JSON syntax. Common issue: trailing commas, unescaped quotes in contract code.

5. **Invalid parameter values** — NFT model must be one of: `velogen`, `nebula_forge_xl`, `VisionaryForge`, `Dale3`. Steps must be within model-specific range.

**Fix template:**
```bash
# Verify your request has the correct structure
curl -X POST "https://api.chaingpt.org/chat/stream" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"general_assistant","question":"test","chatHistory":"off"}'
```

---

### 401 — Unauthorized

**Common causes and fixes:**

1. **Missing Authorization header** — Must be: `Authorization: Bearer <key>`
2. **Wrong header format** — Must be `Bearer <key>` not just `<key>`, not `Token <key>`, not `Api-Key <key>`
3. **Key expired or revoked** — Regenerate at https://app.chaingpt.org/apidashboard
4. **Extra whitespace or newline in key** — Have the developer check the value locally in their secret manager and correct it without copying any part of the key into tool output or the conversation.
5. **Key from wrong environment** — Ensure you are not using a different account's key

**Quick test:**
```bash
# Minimal request to verify auth works
curl -s -o /dev/null -w "%{http_code}" \
  -X GET "https://api.chaingpt.org/nft/get-chains?testNet=false" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY"
```
If this returns 200, the key is valid. If 401, regenerate at https://app.chaingpt.org/apidashboard.

---

### 402 / 403 — Payment Required / Forbidden

**Cause:** Insufficient credits or credits exhausted.

**Fixes:**
1. Check your balance at https://app.chaingpt.org
2. Top up credits at https://app.chaingpt.org/addcredits
3. Get 15% bonus by paying with $CGPT token or enabling monthly auto-top-up
4. 1,000 credits = $10 USD (1 credit = $0.01)

**Cost reference for budgeting:**
| Product | Cost per request |
|---------|-----------------|
| LLM Chat | 0.5 credits (1.0 with history) |
| Contract Generator | 1 credit (2 with history) |
| Contract Auditor | 1 credit (2 with history) |

From jiayaoqijia/cryptoskill, AGPL-3.0.

More from jiayaoqijia/cryptoskill