skyinsights: Скилл для анализа и прогнозирования

--- name: skyinsights description: >- Запрос к API CertiK SkyInsights для получения информации о рисках блокчейна. Используйте этот навык, когда пользователь хочет проверить, является ли адрес кошелька или хэш транзакции рискованным, получить информацию о метках или сущностях, или выполнить проверку на соответствие требованиям AML. Подкоманды: kya, labels, screen, kyt. license: MIT metadata: {"url": "https://skyinsights.certik.com/", "script": "./scripts/skyinsights.py", "primary-commands": "kya labels screen kyt", "openclaw": {"requires": {"env": ["SKYINSIGHTS_API_KEY", "SKYINSIGHTS_API_SECRET"], "bins": ["python3"]}, "primaryEnv": "SKYINSIGHTS_API_KEY"}} --- # SkyInsights Risk Intelligence Используйте `{skillDir}/scripts/skyinsights.py` для всех вызовов API. Скрипт обрабатывает учетные данные, форматирование запросов, обработку ошибок, опрос для проверки соответствия требованиям и вывод, удобный для терминала. ## Запуск команд ```bash python {skillDir}/scripts/skyinsights.py <subcommand> [args...] ``` ## Подкоманды - `kya <address> [chain=eth]` — `GET /v4/kya/risk` - `labels <address> [chain=eth]` — `GET /v4/kya/labels` - `screen <address> [chain=eth] [rule_set_id=standard-mode-rule-set]` — `GET /v4/kya/screening_v2` + опрос (⚠️ 5–15 секунд) - `kyt <txn_hash> <chain>` — `GET /v4/kyt/risk` - `help` — показать справку `rule_set_id` варианты: `standard-mode-rule-set` (по умолчанию), `fast-mode-rule-set` ## Поддерживаемые сети Поддержка сети для каждого конечной точки. Используйте **API Value** при указании параметра `chain`. | Сеть | API Value | kya/labels | kya/risk | kya/screening_v2 | kyt/risk | |---|---|:---:|:---:|:---:|:---:| | Bitcoin | `btc` | ✓ | ✓ | ✓ | ✓ | | Bitcoin Cash | `bch` | ✓ | ✓ | | | | Litecoin | `ltc` | ✓ | ✓ | | | | Solana | `sol` | ✓ | ✓ | | | | Ethereum | `eth` | ✓ | ✓ | ✓ | ✓ | | Polygon | `polygon` | ✓ | ✓ | ✓ | ✓ | | Optimism | `op` | ✓ | ✓ | ✓ | ✓ | | Arbitrum | `arb` | ✓ | ✓ | ✓ | ✓ | | Avalanche | `avax` | ✓ | ✓ | ✓ | ✓ | | Binance Smart Chain | `bsc` | ✓ | ✓ | ✓ | ✓ | | Fantom | `ftm` | ✓ | ✓ | | | | Tron | `tron` | ✓ | ✓ | ✓ | ✓ | | Wemix | `wemix` | ✓ | ✓ | ✓ | ✓ | | Base | `base` | ✓ | ✓ | ✓ | ✓ | | Blast | `blast` | ✓ | ✓ | | | | Linea | `linea` | ✓ | ✓ | | | | Sonic | `sonic` | ✓ | ✓ | | | | Unichain | `unichain` | ✓ | ✓ | | | | Polygon zkEVM | `polygon_zkevm` | ✓ | ✓ | | | > `kya/screening_v2` поддерживает: `btc` `eth` `polygon` `op` `arb` `avax` `bsc` `tron` `wemix` `base` > `multi-chain` поддерживается только для `kya/risk`. ## Стандартный рабочий процесс Маршрутизируйте запросы пользователей следующим образом: - Пользователь упоминает **хэш транзакции / tx / txn** → запустить `kyt` - Пользователь спрашивает о **метках / сущности / учреждении / бирже** для адреса → запустить `labels` - Пользователь спрашивает, является ли **адрес рискованным / безопасным / подозрительным** (подкоманда не указана): 1. Сначала запустите `kya` — быстро, проверяет собственные метки и оценку риска адреса. 2. Если `kya` возвращает `None` или `Low`, автоматически выполните `screen` — чистый адрес все равно может иметь косвенную связь с санкционированными или взломанными средствами. Сообщите пользователю: "Этот адрес имеет низкий собственный риск, выполняется проверка соответствия требованиям для проверки наличия рисков, связанных с контрагентами, пожалуйста, подождите (около 5–15 секунд)…" 3. Если `kya` возвращает `Medium`, `High` или `Unknown`, представьте результат напрямую, не запуская `screen`. ## Ожидаемый вывод Формат вывода для каждой подкоманды: ``` # kya Risk: {None|Low|Medium|High|Unknown} (score={0-5}) Reasons: {reason1}, {reason2} ← опускается, если пусто # labels Entity: {name} Type: {type} Labels: {label1}, {label2} ← опускается, если нет # screen Screening: {Pass|Fail|Pending} Flagged counterparties: {count} {counterparty_address} {risk_level} {reason} ← одна строка для каждой отмеченной стороны # kyt Tx Risk: {None|Low|Medium|High|Unknown} (score={0-5}) Transfers: {count} {from} → {to} {amount} {token} ← одна строка для каждого перевода ``` Эмодзи уровня риска: ✅ None / 🟡 Low / 🟠 Medium / 🔴 High / ⚪ Unknown После запуска скрипта кратко изложите основные выводы на простом языке — особенно уровень риска и важные факторы риска. Не просто повторяйте необработанный вывод. ## Обработка ошибок | Код | Значение | |---|---| | 200 | Успех | | 400 | Неверный запрос — неверные параметры (например, неподдерживаемая сеть, неверный адрес) | | 401 | Неавторизовано — отсутствуют, недействительны или истекли `X-API-Key` / `X-API-Secret` | | 402 | Требуется оплата — превышен лимит учетной записи | | 403 | Запрещено — доступ запрещен | | 429 | Слишком много запросов — превышен лимит скорости | | 500 | Внутренняя ошибка сервера | - Отсутствуют учетные данные: сообщите пользователю, чтобы он установил `SKYINSIGHTS_API_KEY` и `SKYINSIGHTS_API_SECRET`. - Неподдерживаемая сеть: попросите пользователя повторить попытку с одним из идентификаторов поддерживаемых сетей. - `risk_level` равен `Unknown`: адрес или транзакция не индексированы в этой сети или не имеют доступной истории рисков. ## Справочник по факторам риска | Фактор риска | Уровень по умолчанию | Описание | |---|---|---| | Sanctioned | High | Связан с международными списками санкций или ограниченными организациями | | TerroristFinancing | High | Причастность к финансированию терроризма или деятельности по поддержке терроризма | | ChildAbuse | High | Связано с эксплуатацией детей или незаконным контентом | | Hack | High | Средства, связанные с инцидентами взлома или нарушения безопасности | | Scam | High | Связано с мошенническими действиями (например, фишингом, схемами "бегство с деньгами") | | Ransomware | High | Связано с атаками программ-вымогателей или вымогательством | | Darkweb | High | Связано с рынками даркнета или незаконными транзакциями | | Laundering | High | Связано с деятельностью по отмыванию денег в цепочке блоков | | Blocked | High | Официально заморожено эмитентами стейблкоинов (например, USDT, USDC) | | Blacklisted | High | Включено в черные списки пользователями или партнерами | | Mixing | Medium | Связано со службами смешивания или маскировки средств | | Gambling | Medium | Связано с платформами азартных игр или ставок | ### Отображение оценки риска и уровня | Оценка | Уровень | Описание | |---|---|---| | 0 | None | Нет известных рисков — нет истории злонамеренного поведения или подозрительных связей | | 1 | Low | Низкая вероятность вовлечения в незаконную деятельность, не обнаружено необычного поведения | | 2–3 | Medium | Умеренный риск из-за косвенной связи или неопределенного поведения | | 4–5 | High | Сильные признаки потенциального участия в злонамеренной или высокорисковой деятельности | ### Формат причин риска Поле `risk_reasons` объясняет, почему был назначен риск. Каждый элемент начинается с типа: - `label: Scam/Rugpull` — риск исходит от определенной метки - `label: Sanction/OFAC` - `entity: huione` — риск связан с известной сущностью без прямой метки - `entity: blender_io` --- ## Инструкция по использованию (для пользователей) Когда пользователь спрашивает, как использовать этот навык, покажите ему следующие команды: ``` /skyinsights kya <address> [chain] Оценка риска адреса / Оценка риска адреса /skyinsights labels <address> [chain] Метки и информация о сущности для адреса / Метки и информация о сущности для адреса /skyinsights screen <address> [chain] Проверка соответствия требованиям (AML) / Проверка соответствия требованиям (AML), требуется 5–15 секунд /skyinsights kyt <txn_hash> <chain> Анализ риска транзакции / Анализ риска транзакции /skyinsights help Показать справку / Показать справку ``` **Предварительные требования / Требования: ** Установите учетные данные в переменной среды или файле `.env`: ``` SKYINSIGHTS_API_KEY=your_key SKYINSIGHTS_API_SECRET=your_secret ```