Entwickler · Agenten

Agenten dazu bringen, zuerst den Ein-Aufruf-Pfad zu bauen.

Der beste Agentenpfad ist kurz: Skill laden, offramp(walletClient, params) aufrufen, Delegation verifizieren, dann Webhooks oder Peerlytics-Routendaten nur hinzufügen, wenn das Produkt sie benötigt.

01

Agenten-Kontext-Pack

RessourceVerwendung
skills/usdctofiat.mdDrop-in-Skill mit SDK-Regeln, Plattformen, OTC, Webhooks und Beispielen
llms.txtKurze maschinenlesbare Produkt- und Routenzusammenfassung
llms-full.txtVollständige Maschinenreferenz mit Verträgen, Preisgestaltung, Leitfäden und Antworten
OFFRAMP_DEVELOPER_RESOURCESTypisierter SDK-Export mit Links, Delegationskonfiguration, upstreamSourceTruths und Playbooks
OFFRAMP_INTEGRATION_CHECKLISTTypisierte Integrations-Doctor-Prüfungen für Delegation, Duplikatprävention, Extension-Wiederherstellung und HMAC-Webhooks
getOfframpAgentPrompt(profile)Kopierbarer Prompt-Builder für agentenerstellte Integrationen
Starters-RepoFunktionierende Next.js-, Vite-, Telegram-Bot-, Skript- und Webhook-Beispiele
02

Prompt-Sequenz

  1. 1Den Agenten anweisen, den Skill und llms.txt vor der Planung zu lesen.
  2. 2Ihn anweisen, den Ein-Aufruf-Pfad offramp(walletClient, params) vor dem Hinzufügen von Daten-Ebenen-Funktionen zu liefern.
  3. 3Ein Profil wählen: app, bot, agent, private-otc, webhooks oder peerlytics.
  4. 4Ihn bitten, wenn möglich von create-offramp-app oder dem Starters-Repo aus zu scaffolden.
  5. 5Von ihm verlangen, zu verifizieren, dass jede erstellte Einzahlung an den Delegate-Rate-Manager delegiert.
  6. 6Wenn er Peerlytics hinzufügt, von ihm verlangen, planRoutes() vor rohen Orderbook-Lesezugriffen aufzurufen.
  7. 7Wenn er Webhooks hinzufügt, von ihm verlangen, die Raw-Body-HMAC-Verifizierung vor dem JSON-Parsing durchzuführen.
03

Was Agenten nicht erfinden dürfen

  • Keine Sandbox erfinden; das SDK zielt auf das Base-Mainnet ab.
  • Delegation nicht entfernen; der Einzahlungspfad des SDK muss an den Delegate-Vault delegieren.
  • Fiat nicht als SDK-gesteuert behandeln. Fiat wird direkt zwischen Käufer und Verkäufer bewegt.
  • Keine Proof-Payloads, Credential-Felder oder Zahlungsmethoden-Hashes erfinden; erst upstreamSourceTruths prüfen.
  • Webhook-Signaturen nicht aus geparsten JSON verifizieren. Erst timestamp.rawBody verifizieren.

Common questions

Was sollte ein Agent zuerst lesen?

Beginnen Sie mit https://usdctofiat.xyz/skills/usdctofiat.md, dann llms.txt oder llms-full.txt, je nachdem, wie viel Kontext das Modell halten kann.

Können Agenten dies aus dem Paket ableiten?

Ja. Importieren Sie OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST, lesen Sie OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths, rufen Sie getOfframpDeveloperResources(profile) oder getOfframpAgentPrompt(profile) aus @usdctofiat/offramp auf.