Développeurs · Agents
Faites en sorte que les agents construisent d'abord le chemin en un seul appel.
Le meilleur chemin pour un agent est court : chargez le skill, appelez offramp(walletClient, params), vérifiez la délégation, puis ajoutez des webhooks ou des données de route Peerlytics seulement si le produit en a besoin.
01
Pack de contexte pour agents
| Ressource | Usage |
|---|---|
| skills/usdctofiat.md | Skill prêt à l'emploi avec règles du SDK, plateformes, OTC, webhooks et exemples |
| llms.txt | Résumé produit et route court et lisible par machine |
| llms-full.txt | Référence machine complète avec contrats, tarification, guides et réponses |
| OFFRAMP_DEVELOPER_RESOURCES | Export SDK typé avec liens, config de délégation, upstreamSourceTruths et playbooks |
| OFFRAMP_INTEGRATION_CHECKLIST | Vérifications typées d'integration-doctor pour la délégation, la prévention des doublons, la récupération d'extension et les webhooks HMAC |
| getOfframpAgentPrompt(profile) | Constructeur de prompt copiable pour les intégrations construites par agent |
| Dépôt des starters | Exemples fonctionnels Next.js, Vite, bot Telegram, script et webhook |
02
Séquence de prompts
- 1Dites à l'agent de lire le skill et llms.txt avant de planifier.
- 2Dites-lui de livrer le chemin en un seul appel offramp(walletClient, params) avant d'ajouter des fonctionnalités de plan de données.
- 3Choisissez un profil : app, bot, agent, private-otc, webhooks ou peerlytics.
- 4Demandez-lui de scaffolder depuis create-offramp-app ou le dépôt des starters quand c'est possible.
- 5Exigez qu'il vérifie que chaque dépôt créé délègue au gestionnaire de taux Delegate.
- 6S'il ajoute Peerlytics, exigez planRoutes() avant les lectures brutes d'orderbook.
- 7S'il ajoute des webhooks, exigez la vérification HMAC du raw-body avant le parsing JSON.
03
Ce que les agents ne doivent pas inventer
- N'inventez pas de sandbox ; le SDK cible le mainnet Base.
- Ne supprimez pas la délégation ; le chemin de dépôt du SDK doit déléguer au vault Delegate.
- Ne traitez pas le fiat comme contrôlé par le SDK. Le fiat circule directement entre l'acheteur et le vendeur.
- Ne fabriquez pas de payloads de preuve, de champs d'identifiants ou de hashes de moyen de paiement ; vérifiez d'abord upstreamSourceTruths.
- Ne vérifiez pas les signatures de webhook à partir du JSON parsé. Vérifiez d'abord timestamp.rawBody.
Keep exploring
Common questions
Que devrait lire un agent en premier ?
Commencez par https://usdctofiat.xyz/skills/usdctofiat.md, puis llms.txt ou llms-full.txt selon la quantité de contexte que le modèle peut contenir.
Les agents peuvent-ils découvrir cela depuis le package ?
Oui. Importez OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, lisez OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, appelez getOfframpDeveloperResources(profile), ou appelez getOfframpAgentPrompt(profile) depuis @usdctofiat/offramp.