Desenvolvedores · Agentes
Faça os agentes construírem o caminho de uma chamada primeiro.
O melhor caminho para agentes é curto: carregue a skill, chame offramp(walletClient, params), verifique a delegação e depois adicione webhooks ou dados de rota da Peerlytics apenas se o produto precisar deles.
01
Pacote de contexto do agente
| Recurso | Uso |
|---|---|
| skills/usdctofiat.md | Skill pronta para uso com regras do SDK, plataformas, OTC, webhooks e exemplos |
| llms.txt | Resumo curto e legível por máquina do produto e das rotas |
| llms-full.txt | Referência de máquina completa com contratos, preços, guias e respostas |
| OFFRAMP_DEVELOPER_RESOURCES | Export tipado do SDK com links, config de delegação, upstreamSourceTruths e playbooks |
| OFFRAMP_INTEGRATION_CHECKLIST | Verificações tipadas de integration-doctor para delegação, prevenção de duplicatas, recuperação de extensão e webhooks HMAC |
| getOfframpAgentPrompt(profile) | Construtor de prompt copiável para integrações construídas por agentes |
| Repositório de starters | Exemplos funcionais de Next.js, Vite, bot de Telegram, script e webhook |
02
Sequência de prompts
- 1Diga ao agente para ler a skill e o llms.txt antes de planejar.
- 2Diga a ele para entregar o caminho de uma chamada offramp(walletClient, params) antes de adicionar recursos do data-plane.
- 3Escolha um perfil: app, bot, agent, private-otc, webhooks ou peerlytics.
- 4Peça que ele faça o scaffold a partir do create-offramp-app ou do repositório de starters quando possível.
- 5Exija que ele verifique que todo depósito criado delega para o gerente de taxas da Delegate.
- 6Se ele adicionar a Peerlytics, exija planRoutes() antes de leituras brutas do orderbook.
- 7Se ele adicionar webhooks, exija verificação HMAC do raw-body antes do parse de JSON.
03
O que os agentes não devem inventar
- Não invente um sandbox; o SDK aponta para a mainnet da Base.
- Não remova a delegação; o caminho de depósito do SDK precisa delegar para o vault da Delegate.
- Não trate o fiat como controlado pelo SDK. O fiat se move diretamente entre comprador e vendedor.
- Não fabrique payloads de prova, campos de credencial ou hashes de método de pagamento; verifique upstreamSourceTruths primeiro.
- Não verifique assinaturas de webhook a partir de JSON parseado. Verifique timestamp.rawBody primeiro.
Keep exploring
Common questions
O que um agente deve ler primeiro?
Comece com https://usdctofiat.xyz/skills/usdctofiat.md, depois llms.txt ou llms-full.txt, dependendo de quanto contexto o modelo consegue manter.
Os agentes conseguem descobrir isso a partir do pacote?
Sim. Importe OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, leia OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, chame getOfframpDeveloperResources(profile) ou chame getOfframpAgentPrompt(profile) de @usdctofiat/offramp.