Desarrolladores · Agentes
Haz que los agentes construyan primero la vía de una sola llamada.
La mejor vía para un agente es corta: carga el skill, llama a offramp(walletClient, params), verifica la delegación y luego añade webhooks o datos de rutas de Peerlytics solo si el producto los necesita.
01
Paquete de contexto para agentes
| Recurso | Uso |
|---|---|
| skills/usdctofiat.md | Skill listo para usar con reglas del SDK, plataformas, OTC, webhooks y ejemplos |
| llms.txt | Resumen breve y legible por máquina del producto y las rutas |
| llms-full.txt | Referencia completa para máquinas con contratos, precios, guías y respuestas |
| OFFRAMP_DEVELOPER_RESOURCES | Exportación tipada del SDK con enlaces, configuración de delegación, upstreamSourceTruths y playbooks |
| OFFRAMP_INTEGRATION_CHECKLIST | Comprobaciones tipadas tipo integration-doctor para delegación, prevención de duplicados, recuperación de la extensión y webhooks HMAC |
| getOfframpAgentPrompt(profile) | Constructor de prompts copiable para integraciones construidas por agentes |
| Repo de starters | Ejemplos funcionales de Next.js, Vite, bot de Telegram, script y webhook |
02
Secuencia de prompts
- 1Dile al agente que lea el skill y llms.txt antes de planificar.
- 2Dile que entregue la vía de una sola llamada offramp(walletClient, params) antes de añadir funciones del plano de datos.
- 3Elige un perfil: app, bot, agent, private-otc, webhooks o peerlytics.
- 4Pídele que parta de create-offramp-app o del repo de starters cuando sea posible.
- 5Exígele que verifique que cada depósito creado delega en el gestor de tasas de Delegate.
- 6Si añade Peerlytics, exige planRoutes() antes de las lecturas crudas del orderbook.
- 7Si añade webhooks, exige la verificación HMAC del raw-body antes de parsear el JSON.
03
Lo que los agentes no deben inventar
- No inventes un sandbox; el SDK apunta a la mainnet de Base.
- No elimines la delegación; la vía de depósito del SDK debe delegar en el vault de Delegate.
- No trates el fiat como controlado por el SDK. El fiat se mueve directamente entre comprador y vendedor.
- No fabriques payloads de prueba, campos de credenciales ni hashes de método de pago; consulta primero upstreamSourceTruths.
- No verifiques firmas de webhook a partir del JSON parseado. Verifica primero timestamp.rawBody.
Keep exploring
Common questions
¿Qué debería leer primero un agente?
Empieza con https://usdctofiat.xyz/skills/usdctofiat.md, y luego llms.txt o llms-full.txt según cuánto contexto pueda manejar el modelo.
¿Pueden los agentes descubrir esto desde el paquete?
Sí. Importa OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, lee OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, llama a getOfframpDeveloperResources(profile) o llama a getOfframpAgentPrompt(profile) desde @usdctofiat/offramp.