BB greenhelix-x402-merchant-cookbook
Руководство по интеграции мерчантов x402: Защитите любой API с помощью крипто-платежей менее чем за час. Практические рецепты для интеграции платежей x402 в любой веб-сервис. Охватывает промежуточное ПО Express.js, интеграцию FastAPI, Cloudflare Workers, проверку платежей, расчеты и шаблоны развертывания в производственной среде.
машинный переводПоказать оригиналСкрыть оригинал«The x402 Merchant Integration Cookbook: Put Any API Behind a Crypto Pa…»
The x402 Merchant Integration Cookbook: Put Any API Behind a Crypto Paywall in Under an Hour. Practical recipes for integrating x402 payments into any web service. Covers Express.js middleware, FastAPI integration, Cloudflare Workers, payment verification, settlement, and production deployment patterns.
Руководство по интеграции мерчантов x402: Защитите любой API с помощью крипто-платежей менее чем за час.
Как процесс B 65/100 · Почти готов — слабые места: входы и предусловия, стоимость исполнения
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Назначение скилла само по себе рискованное: работа с кошельками, паролями браузера, наступательная безопасность. Даже честная реализация даёт агенту доступ к тому, что стоит денег.
Объясните в description, зачем нужен доступ и как он ограничен; добавьте тесты, которые показывают отказ на опасных запросах.
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 6
✓ Критических и высоких находок нет
Средние и низкие: 6
-
средняя Рискованное назначение
intent-wallet-secretsSKILL.md:107Работает с секретами криптокошелька (сид-фраза / приватный ключ) — классическая цель стилеров| with wallet private key] | |
-
низкая Секреты в коде
secret-high-entropy-tokenSKILL.md:152Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"asset": "0x83…913",
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenSKILL.md:173Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)- **asset**: The ERC-20 token contract address. On Base mainnet, USDC is `0x83…913`. On Base Sepolia, it is `0x03…F7e`.
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenSKILL.md:252Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)? '0x83…913'
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenSKILL.md:253Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда): '0x03…F7e';
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenSKILL.md:604Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"0x83…913"
в кавычках
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - предупреждение
body-longтело SKILL.md ≈ 26205 токенов (рекомендуется < 5000); вынесите детали в references/ - заметка
frontmatter-keyнеизвестное поле фронтматтера "type" - заметка
frontmatter-keyнеизвестное поле фронтматтера "price_usd" - заметка
frontmatter-keyнеизвестное поле фронтматтера "content_type" - заметка
frontmatter-keyнеизвестное поле фронтматтера "executable" - заметка
frontmatter-keyнеизвестное поле фронтматтера "install" - заметка
frontmatter-keyнеизвестное поле фронтматтера "credentials"
Процессный рейтинг: все десять параметров 65/100
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 10Стоимость исполнения. Тело инструкции 26205 токенов: вытесняет саму задачу из окна
- 50Когда включается. Не сказано, при каком запросе скилл включается
- 60Инструменты и файлы. Используются инструменты (web, python), но во frontmatter они не объявлены
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 100Шаги. Шагов: 78
- 100Ошибки и развилки. Развилок: 13, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 14. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- -2Ссылки на localhost: у другого пользователя не заработает
- +2Инструкции на одном языке
- +3Длина description 304 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 64 заголовков
- +3Пошаговые инструкции: 78 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (44 блоков кода)
- +1Лицензия указана
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 61.