Разработчикам · Агенты
Заставьте агентов сначала строить путь одного вызова.
Лучший путь для агента короток: загрузите навык, вызовите offramp(walletClient, params), проверьте делегирование, затем добавляйте webhooks или данные маршрутов Peerlytics только если продукту это нужно.
01
Контекстный пакет для агента
| Ресурс | Использование |
|---|---|
| skills/usdctofiat.md | Готовый к подключению навык с правилами SDK, платформами, OTC, webhooks и примерами |
| llms.txt | Краткая машиночитаемая сводка по продукту и маршрутам |
| llms-full.txt | Полный машинный справочник с контрактами, ценообразованием, руководствами и ответами |
| OFFRAMP_DEVELOPER_RESOURCES | Типизированный экспорт SDK со ссылками, конфигурацией делегирования, upstreamSourceTruths и плейбуками |
| OFFRAMP_INTEGRATION_CHECKLIST | Типизированные проверки integration-doctor для делегирования, предотвращения дублирования, восстановления расширения и HMAC-webhooks |
| getOfframpAgentPrompt(profile) | Копируемый конструктор промптов для интеграций, построенных агентами |
| Репозиторий стартеров | Рабочие примеры Next.js, Vite, Telegram-бота, скрипта и webhook |
02
Последовательность промптов
- 1Скажите агенту прочитать навык и llms.txt перед планированием.
- 2Скажите ему сначала выпустить путь одного вызова offramp(walletClient, params) до добавления функций уровня данных.
- 3Выберите профиль: app, bot, agent, private-otc, webhooks или peerlytics.
- 4Попросите его создать каркас из create-offramp-app или репозитория стартеров, когда это возможно.
- 5Требуйте, чтобы он проверял делегирование каждого созданного депозита менеджеру курсов Delegate.
- 6Если он добавляет Peerlytics, требуйте planRoutes() перед сырым чтением ордербука.
- 7Если он добавляет webhooks, требуйте HMAC-верификации сырого тела до парсинга JSON.
03
Что агенты не должны изобретать
- Не изобретайте песочницу; SDK работает с мейннетом Base.
- Не убирайте делегирование; путь депозита SDK должен делегировать волту Delegate.
- Не считайте фиат управляемым SDK. Фиат перемещается напрямую между покупателем и продавцом.
- Не фабрикуйте полезные нагрузки доказательств, поля учётных данных или хэши способов оплаты; сначала проверьте upstreamSourceTruths.
- Не верифицируйте подписи webhook из распарсенного JSON. Сначала верифицируйте timestamp.rawBody.
Keep exploring
Common questions
Что агенту следует прочитать первым?
Начните с https://usdctofiat.xyz/skills/usdctofiat.md, затем llms.txt или llms-full.txt в зависимости от того, сколько контекста может удержать модель.
Могут ли агенты обнаружить это из пакета?
Да. Импортируйте OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, прочитайте OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, вызовите getOfframpDeveloperResources(profile) или вызовите getOfframpAgentPrompt(profile) из @usdctofiat/offramp.