fairscale-solana

# FairScale Wallet Reputation ## CRITICAL RULES 1. **ALWAYS call the API** — Never guess, estimate, or reuse data from previous wallets 2. **Each wallet is unique** — Do not assume similarity to other wallets 3. **Use ONLY the values from the API response** — Do not calculate or modify scores 4. **If the API fails, say so** — Do not make up data --- ## API CALL **Endpoint:** `https://api2.fairscale.xyz/score` **Method:** GET **Headers:** - `accept: application/json` - `fairkey: $FAIRSCALE_API_KEY` **Query parameter:** `wallet` = the Solana wallet address **Full example:** ``` GET https://api2.fairscale.xyz/score?wallet=GFTVQdZumAnBRbmaRgN9n3Z5qH5nXvjMZXJ3EyqP32Tn ``` --- ## READING THE RESPONSE The API returns JSON. Use ONLY these fields: | Field | What it is | |-------|------------| | `fairscore` | The score (0-100) — USE THIS EXACT NUMBER | | `tier` | bronze / silver / gold / diamond — USE THIS EXACT VALUE | | `badges` | Array of badges — list each `badge.label` | | `actions` | Array of improvements — list each `action.label` | **DO NOT USE:** `final_score`, `fairscore_base`, `fairscore_previous`, or any `features.*` values in the output. --- ## OUTPUT FORMAT ``` 📊 FairScore: [fairscore]/100 | Tier: [tier] [RISK LINE] 🏅 Badges: [badge labels, comma-separated] 💡 Improve: [action labels, or "None"] ``` **Risk line rules:** - fairscore < 20 → `🚨 HIGH RISK — Do not transact` - fairscore 20-39 → `⚠️ CAUTION — Limited history` - fairscore 40-59 → `⚡ MODERATE — Standard precautions` - fairscore ≥ 60 → `✅ TRUSTED — Safe to proceed` --- ## EXAMPLE **API returns:** ```json { "fairscore": 95.9, "tier": "diamond", "badges": [ {"label": "LST Staker"}, {"label": "Diamond Hands"}, {"label": "Veteran"} ], "actions": [] } ``` **You output:** ``` 📊 FairScore: 95.9/100 | Tier: diamond ✅ TRUSTED — Safe to proceed 🏅 Badges: LST Staker, Diamond Hands, Veteran 💡 Improve: None ``` --- ## ERRORS If the API returns an error or no data: ``` ❌ Could not retrieve FairScore for this wallet. Please try again. ``` **Never invent scores. Never guess. Always call the API.** --- ## GET API KEY https://sales.fairscale.xyz