Geliştiriciler · Agent'lar
Agent'ların önce tek çağrılık yolu oluşturmasını sağlayın.
En iyi agent yolu kısadır: skill'i yükle, offramp(walletClient, params) çağrısı yap, delegasyonu doğrula, ardından yalnızca ürün gerektiriyorsa webhook'ları veya Peerlytics rota verisini ekle.
01
Agent bağlam paketi
| Kaynak | Kullanım |
|---|---|
| skills/usdctofiat.md | SDK kuralları, platformlar, OTC, webhook'lar ve örneklerle doğrudan kullanılabilir skill |
| llms.txt | Kısa makine tarafından okunabilir ürün ve rota özeti |
| llms-full.txt | Kontratlar, fiyatlandırma, kılavuzlar ve cevaplarla tam makine referansı |
| OFFRAMP_DEVELOPER_RESOURCES | Bağlantılar, delegasyon yapılandırması, upstreamSourceTruths ve playbook'larla tipli SDK export'u |
| OFFRAMP_INTEGRATION_CHECKLIST | Delegasyon, çift mevduat önleme, eklenti kurtarma ve HMAC webhook'ları için tipli entegrasyon-doktor kontrolleri |
| getOfframpAgentPrompt(profile) | Agent tarafından oluşturulan entegrasyonlar için kopyalanabilir istem oluşturucu |
| Başlangıç şablonları deposu | Çalışan Next.js, Vite, Telegram-bot, script ve webhook örnekleri |
02
İstem dizisi
- 1Agent'a planlamadan önce skill'i ve llms.txt'i okumasını söyleyin.
- 2Veri-düzlemi özellikleri eklemeden önce tek çağrılık offramp(walletClient, params) yolunu göndermesini söyleyin.
- 3Bir profil seçin: app, bot, agent, private-otc, webhooks veya peerlytics.
- 4Mümkün olduğunda create-offramp-app'ten veya başlangıç şablonları deposundan iskelet oluşturmasını isteyin.
- 5Oluşturulan her mevduatın Delegate oran yöneticisine delege ettiğini doğrulamasını zorunlu kılın.
- 6Peerlytics eklerse, ham orderbook okumalarından önce planRoutes()'u zorunlu kılın.
- 7Webhook eklerse, JSON ayrıştırmadan önce ham gövde HMAC doğrulamasını zorunlu kılın.
03
Agent'ların icat etmemesi gerekenler
- Bir sandbox icat etmeyin; SDK Base mainnet'i hedefler.
- Delegasyonu kaldırmayın; SDK'nın mevduat yolu Delegate vault'a delege etmelidir.
- Fiat'ı SDK kontrollü olarak değerlendirmeyin. Fiat doğrudan alıcı ile satıcı arasında hareket eder.
- Kanıt yüklerini, kimlik bilgisi alanlarını veya ödeme yöntemi hash'lerini uydurmayın; önce upstreamSourceTruths'u kontrol edin.
- Webhook imzalarını ayrıştırılmış JSON'dan doğrulamayın. Önce timestamp.rawBody'yi doğrulayın.
Keep exploring
Common questions
Bir agent önce neyi okumalı?
https://usdctofiat.xyz/skills/usdctofiat.md ile başlayın, ardından modelin ne kadar bağlam tutabileceğine bağlı olarak llms.txt veya llms-full.txt'i okuyun.
Agent'lar bunu paketten keşfedebilir mi?
Evet. OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST'i içe aktarın, OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths'u okuyun, getOfframpDeveloperResources(profile) çağrısı yapın veya @usdctofiat/offramp'ten getOfframpAgentPrompt(profile) çağrısı yapın.