Sviluppatori · Agenti
Fai costruire agli agenti prima il percorso a chiamata singola.
Il miglior percorso per l'agente è breve: carica la skill, chiama offramp(walletClient, params), verifica la delega, poi aggiungi i webhook o i dati delle route Peerlytics solo se il prodotto ne ha bisogno.
01
Pacchetto di contesto per agenti
| Risorsa | Uso |
|---|---|
| skills/usdctofiat.md | Skill pronta all'uso con regole dell'SDK, piattaforme, OTC, webhook ed esempi |
| llms.txt | Breve riepilogo machine-readable del prodotto e delle route |
| llms-full.txt | Riferimento machine completo con contratti, pricing, guide e risposte |
| OFFRAMP_DEVELOPER_RESOURCES | Export tipizzato dell'SDK con link, configurazione di delega, upstreamSourceTruths e playbook |
| OFFRAMP_INTEGRATION_CHECKLIST | Controlli tipizzati da integration-doctor per delega, prevenzione dei duplicati, recupero dell'estensione e webhook HMAC |
| getOfframpAgentPrompt(profile) | Generatore di prompt copiabile per integrazioni costruite da agenti |
| Repository degli starter | Esempi funzionanti per Next.js, Vite, bot Telegram, script e webhook |
02
Sequenza di prompt
- 1Di' all'agente di leggere la skill e llms.txt prima di pianificare.
- 2Digli di rilasciare il percorso a chiamata singola offramp(walletClient, params) prima di aggiungere funzionalità del data-plane.
- 3Scegli un profilo: app, bot, agent, private-otc, webhooks o peerlytics.
- 4Chiedigli di fare scaffolding da create-offramp-app o dal repository degli starter quando possibile.
- 5Richiedi che verifichi che ogni deposito creato deleghi al rate manager Delegate.
- 6Se aggiunge Peerlytics, richiedi planRoutes() prima delle letture grezze dell'orderbook.
- 7Se aggiunge i webhook, richiedi la verifica HMAC del raw-body prima del parsing JSON.
03
Cosa gli agenti non devono inventare
- Non inventare una sandbox; l'SDK opera sulla mainnet di Base.
- Non rimuovere la delega; il percorso di deposito dell'SDK deve delegare al vault Delegate.
- Non trattare il fiat come controllato dall'SDK. Il fiat si muove direttamente tra acquirente e venditore.
- Non inventare payload di prova, campi delle credenziali o hash dei metodi di pagamento; controlla prima upstreamSourceTruths.
- Non verificare le firme dei webhook dal JSON già parsato. Verifica prima timestamp.rawBody.
Keep exploring
Common questions
Cosa dovrebbe leggere prima un agente?
Inizia con https://usdctofiat.xyz/skills/usdctofiat.md, poi llms.txt o llms-full.txt a seconda di quanto contesto il modello può contenere.
Gli agenti possono scoprire tutto questo dal package?
Sì. Importa OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, leggi OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, chiama getOfframpDeveloperResources(profile) o chiama getOfframpAgentPrompt(profile) da @usdctofiat/offramp.