开发者 · Agent
让 agent 先构建一次调用路径。
最佳的 agent 路径很短：加载 skill，调用 offramp(walletClient, params)，验证委托，然后仅在产品需要时再加入 webhooks 或 Peerlytics 路径数据。
01
Agent 上下文包
| 资源 | 用途 |
|---|---|
| skills/usdctofiat.md | 即插即用的 skill，包含 SDK 规则、平台、OTC、webhooks 和示例 |
| llms.txt | 简短的机器可读产品与路径摘要 |
| llms-full.txt | 完整的机器参考，含合约、定价、指南和解答 |
| OFFRAMP_DEVELOPER_RESOURCES | 类型化 SDK 导出，含链接、委托配置、upstreamSourceTruths 和 playbooks |
| OFFRAMP_INTEGRATION_CHECKLIST | 类型化的集成体检项，覆盖委托、防重复、扩展恢复和 HMAC webhooks |
| getOfframpAgentPrompt(profile) | 面向 agent 构建集成的可复制 prompt 生成器 |
| Starters 仓库 | 可运行的 Next.js、Vite、Telegram 机器人、脚本和 webhook 示例 |
02
Prompt 序列
- 1让 agent 在规划前阅读 skill 和 llms.txt。
- 2让它在加入数据面功能前先交付一次调用的 offramp(walletClient, params) 路径。
- 3选择一个 profile：app、bot、agent、private-otc、webhooks 或 peerlytics。
- 4尽可能让它从 create-offramp-app 或 starters 仓库脚手架起步。
- 5要求它验证每一笔创建的存款都委托给 Delegate 汇率管理器。
- 6如果它加入 Peerlytics，要求在进行原始 orderbook 读取前先调用 planRoutes()。
- 7如果它加入 webhooks，要求在 JSON 解析之前先做原始 body 的 HMAC 验证。
03
Agent 绝不能臆造的内容
- 不要臆造沙盒；SDK 面向 Base 主网。
- 不要移除委托；SDK 的存款路径必须委托给 Delegate 金库。
- 不要把法币当作 SDK 控制的。法币在买卖双方之间直接流转。
- 不要编造证明负载、凭证字段或支付方式哈希；先查 upstreamSourceTruths。
- 不要从已解析的 JSON 来验证 webhook 签名。先验证 timestamp.rawBody。
Keep exploring
Common questions
agent 应该先读什么？
从 https://usdctofiat.xyz/skills/usdctofiat.md 开始，然后根据模型能容纳多少上下文选择 llms.txt 或 llms-full.txt。
agent 能从这个包里发现这些吗？
可以。从 @usdctofiat/offramp 引入 OFFRAMP_DEVELOPER_RESOURCES、OFFRAMP_INTEGRATION_CHECKLIST，读取 OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths，调用 getOfframpDeveloperResources(profile)，或调用 getOfframpAgentPrompt(profile)。